格式化入站特性資料檔案時應遵循的必填欄位、語法和規則。
入站資料檔案中的欄位必須按如下所示的順序顯示。 在此示例中, <
>
已添加符號,以幫助直觀地分隔每個元素。 您不需要將這些內容包括在資料檔案中。
<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...
有關其他接受的檔案內容格式,請參見 定制合作夥伴整合。
對於入站資料檔案中發送的每個用戶ID,我們最多可處理200行。 例如,如果為用戶ID發送300行,則前200行將保留,另外100行將被丟棄。 在下面的示例中,您是不錯的,因為您正在為用戶ID 1和用戶ID 2發送3行。 我們不會對您在一行中包括的特徵或鍵值對的數量實施限制。
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>
該表列出並定義了正確格式化入站資料檔案中使用的變數。 斜體表示變數預留位置。
變數 | 說明 |
---|---|
|
用戶ID可以是:
對於移動ID:
|
|
使用單個制表符分隔符分隔用戶ID和特性ID。 |
|
的 Audience Manager 特徵ID 我們要求您包括 只有已登陸的特徵 入站資料檔案。 在入站資料傳輸中,我們不處理任何其他特性類型。
注:可以使用返回所有特徵詳細資訊的GET方法來找到特徵ID。 有關詳細資訊,請參見 特性API方法 。 |
下表介紹了標識的前置詞 trait 入站資料檔案中的名稱或ID。 查看 示例檔案 的上界。
前置詞 | 說明 |
---|---|
|
的 |
|
資料前置詞為 的 |
|
特質規則 讓你為特質鑑定設定標準。 如果將特徵規則格式為 例如,假設您建立以下3個特性規則:
這些特徵與
|
鍵值對 |
特性資料可以使用字母數字字串格式化為鍵值對。 有幾種格式化鍵值對的方法,如下所示:
"age"="32" 。 "gender"=m 。 model = "pickup truck" 。 product = tablet 都是正確格式鍵值對的示例。 |
Trait IDs 只包含數字字元。 我們要求您包括 僅onboarded traits 入站資料檔案。 我們不處理其他 trait 入站資料傳輸中的類型。
ID 類型 | 需求 |
---|---|
DPUUID |
不要 使用編碼的冒號( |
移動iOS(IDFA)或Android設備ID |
移動設備ID必須嚴格格式化,如下所示:
|
鍵值對中格式不正確的值名稱也會導致問題。 在鍵值對中建立或命名值時,請遵循以下規則:
字元 | 需求 |
---|---|
引號字元 (") |
可以在鍵和鍵值對的值部分使用引號字元,如:
|
破折號字元(-) |
我們忽略鍵頭的破折號。 比如說, |
|
不要 使用 |
|
不使用新行或制表符字元( |
資料檔案格式 | 說明和示例 |
---|---|
與 |
此資料檔案顯示符合特徵24、26、27的用戶,已從特徵28和29中刪除。
注意: 您也可以使用以下語法從用戶配置檔案中刪除traits,而不是使用d_unsid:
|
包含 |
這些特徵被加進了一個特徵規則 數字ID
字串ID
|
帶鍵值對 |
此檔案資料使用鍵值對將資料傳遞到 Audience Manager 。
|
下載 示例資料檔案(如果需要其他示例)。 下載檔案具有 .overwrite
檔案副檔名。 可以使用簡單的文本編輯器開啟它。
下圖顯示了正確格式化入站檔案的示例,具體取決於 ID類型 和您要添加的方法 traits 到配置檔案。
ID類型/操作 | 使用d_sid向用戶配置檔案添加特徵 | 使用d_unsid從用戶配置檔案中刪除特徵 | 發送鍵值對以向用戶配置檔案添加特徵 | 使用ic前置詞向用戶配置檔案添加特徵 |
---|---|---|---|---|
Audience ManagerUUID |
||||
GoogleAndroid設備廣告ID |
||||
AppleIDFA用於iOS設備 |
||||
您自己的CRM ID(DPUUID) |
使用 trait IDs 發送 trait 資格資訊 Audience Manager UUIDs。
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27
使用 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
發送鍵值對以添加 trait 資格資訊 Audience Manager UUIDs。
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone
或
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"
使用 ic
發送前置詞 trait 資格資訊 Audience Manager UUIDs。
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626
或
59767559181262060060278870901087098252 <TAB> ic=52,ic=55
使用 trait IDs 發送 trait 資格資訊 Android 設備。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26
使用 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
發送鍵值對以添加 trait 資格資訊 Android 設備。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone
或
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"
使用 ic
發送前置詞 trait 資格資訊 Android 設備。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626
或
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> ic=52,ic=55
使用 trait IDs 發送 trait 資格資訊 iOS 設備。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26
使用 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
發送鍵值對以添加 trait 資格資訊 iOS 設備。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone
或
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"
使用 ic
發送前置詞 trait 資格資訊 iOS 設備。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626
或
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> ic=52,ic=55
使用 trait IDs 發送 trait 資格資訊 DPUUIDs。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
使用 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
發送鍵值對以添加 trait 資格資訊 DPUUIDs。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone
或
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"
使用 ic
發送前置詞 trait 資格資訊 DPUUIDs。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626
或
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55