傳入資料檔案內容:語法、無效字元、變數和範例 inbound-data-file-contents-syntax-invalid-characters-variables-and-examples
格式化入站特性資料檔案時應遵循的必填欄位、語法和規則。
檔案內容語法 file-content-syntax
入站資料檔案中的欄位必須按如下所示的順序顯示。 在此示例中, <
>
已添加符號,以幫助直觀地分隔每個元素。 您不需要將這些內容包括在資料檔案中。
<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...
有關其他接受的檔案內容格式,請參見 定制合作夥伴整合。
code language-none |
---|
|
定義的檔案變數 file-variables-defined
該表列出並定義了正確格式化入站資料檔案中使用的變數。 斜體 表示變數預留位置。
User ID
用戶ID可以是:
- 由分配的唯一用戶ID Audience Manager ( Audience ManagerUUID)。
- 在CRM系統中分配的唯一用戶ID( DPUUID,在Audience Manager)。
- 移動作業系統所暴露的Android或iOS設備ID的原始未修改形式。
對於移動ID:
- IDFA格式:ID必須是大寫且不散列。 例如,
6D92078A-8246-4BA4-AE5B-76104861E7DC
- Android格式:ID必須小寫且不散列。 例如,
97987bca-ae59-4c7d-94ba-ee4f19ab8c21
TAB
trait ID
的 Audience Manager 特徵ID 我們要求您包括 只有已登陸的特徵 入站資料檔案。 在入站資料傳輸中,我們不處理任何其他特性類型。
注:可以使用返回所有特徵詳細資訊的GET方法來找到特徵ID。 有關詳細資訊,請參見 特性API方法。
格式 Trait IDs formatting-trait-ids
下表介紹了標識的前置詞 trait 入站資料檔案中的名稱或ID。 查看 示例檔案 的上界。
d_sid=
d_unsid=
資料前置詞為 d_unsid
將用戶從該特性中刪除。 的 d_unsid
在 overwrite
的子菜單。
的 d_unsid=
前置詞告訴我們系統ID是 Audience Manager 特徵ID 這與用戶介面中顯示的ID相同。 也可以使用API返回特性ID GET
的雙曲餘切值。 請參閱 特性API方法。
ic=
特質規則讓你為特質鑑定設定標準。 如果將特徵規則格式為 ic == trait ID
,可以在簡單逗號格式清單中發送trait。
例如,假設您建立以下3個特性規則:
ic == "123"
ic == "456"
ic == "789"
這些特徵與 ic
按鈕 這允許您在資料檔案中建立一個更簡單的特性清單。 而且,你不需要把 ic
前置詞。 因此,資料檔案的內容可能如下所示:
user ID <TAB> 123,456,789
特性資料可以使用字母數字字串格式化為鍵值對。 有幾種格式化鍵值對的方法,如下所示:
key = value
"key" = value
key = "value"
"key" = "value"
"age"="32"
。 "gender"=m
。 model = "pickup truck"
。 product = tablet
都是正確格式鍵值對的示例。
中的字元無效 Trait IDs。 User IDs 和鍵值對 invalid-chars
Trait IDs
Trait IDs 只包含數字字元。 我們要求您包括 僅onboarded traits 入站資料檔案。 我們不處理其他 trait 入站資料傳輸中的類型。
User IDs
%3A
)或未編碼的冒號(:)符號。移動設備ID必須嚴格格式化,如下所示:
- IDFA格式:ID必須是大寫且不散列。 例如,
6D92078A-8246-4BA4-AE5B-76104861E7DC
- Android格式:ID必須小寫且不散列。 例如,
97987bca-ae59-4c7d-94ba-ee4f19ab8c21
鍵值對
鍵值對中格式不正確的值名稱也會導致問題。 在鍵值對中建立或命名值時,請遵循以下規則:
可以在鍵和鍵值對的值部分使用引號字元,如:
-
d_city = "New York", d_city = "San Francisco"
-
"d_city" = "New York", "d_city" = "San Francisco"
-product = camera
解釋為 product = camera
。TAB
TAB
而不是鍵值對中的空值。 僅使用 TAB
以在入站資料檔案中分離變數。\n, \t
\n, \t
)。資料檔案示例 data-file-examples
d_sid
或 d_unsid
此資料檔案顯示符合特徵24、26、27的用戶,已從特徵28和29中刪除。
59767559181262060060278870901087098252 d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29
注意:
您也可以使用以下語法從用戶配置檔案中刪除traits,而不是使用d_unsid:
59767559181262060060278870901087098252 28:0, 29:0
59767559181262060060278870901087098252 28:-1, 29:-1
ic==
這些特徵被加進了一個特徵規則 ic
前置詞。 因此,可以將它們添加到以逗號分隔的資料檔案中,如所示。 制表符分隔UUID和特性ID。 的 ic
檔案中不需要前置詞。
數字ID
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 30608,50354,50338,50352,30626
字串ID
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 ic=52,ic=55
此檔案資料使用鍵值對將資料傳遞到 Audience Manager 。
59767559181262060060278870901087098252 “gender”=”female”,“luxury_shopper”=”yes”
下載 示例資料檔案(如果需要其他示例)。 下載檔案具有 .overwrite
檔案副檔名。 可以使用簡單的文本編輯器開啟它。
示例矩陣 examples-matrix
下圖顯示了正確格式化入站檔案的示例,具體取決於 ID類型 和您要添加的方法 traits 到配置檔案。
範例 1 example-1
使用 trait IDs 發送 trait 資格資訊 Audience Manager UUIDs。
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27
範例 2 example-2
使用 trait IDs 發送 trait 取消資格資訊 Audience Manager UUIDs。
59767559181262060060278870901087098252 <TAB> d_unsid=24, d_unsid=26, d_unsid=27
或
59767559181262060060278870901087098252 <TAB> 24:0, 26:0, 27:0
或
59767559181262060060278870901087098252 <TAB> 24:-1, 26:-1, 27:-1
範例 3 example-3
發送鍵值對以添加 trait 資格資訊 Audience Manager UUIDs。
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone
或
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"
示例4 example-4
使用 ic
發送前置詞 trait 資格資訊 Audience Manager UUIDs。
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626
或
59767559181262060060278870901087098252 <TAB> ic=52,ic=55
示例5 example-5
使用 trait IDs 發送 trait 資格資訊 Android 設備。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26
示例6 example-6
使用 trait IDs 發送 trait 取消資格資訊 Android 設備。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_unsid=24, d_unsid=25, d_unsid=26
或
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:0, 26:0, 27:0
或
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:-1, 26:-1, 27:-1
示例7 example-7
發送鍵值對以添加 trait 資格資訊 Android 設備。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone
或
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"
示例8 example-8
使用 ic
發送前置詞 trait 資格資訊 Android 設備。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626
或
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> ic=52,ic=55
示例9 example-9
使用 trait IDs 發送 trait 資格資訊 iOS 設備。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26
示例10 example-10
使用 trait IDs 發送 trait 取消資格資訊 iOS 設備。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_unsid=24, d_unsid=25, d_unsid=26
或
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:0, 26:0, 27:0
或
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:-1, 26:-1, 27:-1
示例11 example-11
發送鍵值對以添加 trait 資格資訊 iOS 設備。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone
或
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"
示例12 example-12
使用 ic
發送前置詞 trait 資格資訊 iOS 設備。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626
或
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> ic=52,ic=55
示例13 example-13
使用 trait IDs 發送 trait 資格資訊 DPUUIDs。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
示例14 example-14
使用 trait IDs 發送 trait 取消資格資訊 DPUUIDs。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_unsid=24, d_unsid=25, d_unsid=26
或
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:0, 26:0, 27:0
或
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:-1, 26:-1, 27:-1
示例15 example-15
發送鍵值對以添加 trait 資格資訊 DPUUIDs。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone
或
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"
示例16 example-16
使用 ic
發送前置詞 trait 資格資訊 DPUUIDs。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626
或
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55