格式化傳入特徵資料檔案時,應遵循的必要欄位、語法和規則。
傳入資料檔案中的欄位必須依下列順序顯示。 在此範例中, <
>
已新增符號,以幫助以視覺方式分隔每個元素。 您不需要將這些包含在資料檔案中。
<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。 我們要求您包含 僅限已上線的特徵 傳入資料檔案中。 我們不會在傳入資料傳輸中處理任何其他特徵型別。
注意:特徵ID可使用傳回所有特徵詳細資訊的GET方法來找到。 如需詳細資訊,請參閱 特徵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的格式必須嚴格,如下所示:
|
機碼 — 值配對中格式不正確的值名稱也會造成問題。 在索引鍵/值配對中建立或命名值時,請遵循下列規則:
字符 | 要求 |
---|---|
引号字符 (") |
您可以在索引鍵和索引鍵 — 值組的值部分中使用引號字元,如下所示:
|
虛線字元(-) |
我們忽略鍵開頭的破折號。 例如, |
|
不要 use |
|
請勿使用新的行或定位字元( |
資料檔案格式 | 說明與範例 |
---|---|
替換為 |
此資料檔案顯示符合特徵24、26、27的使用者,且已從特徵28和29中移除。
注释: 您也可以使用下列語法,從使用者設定檔中移除特徵,而不使用d_unsid:
|
通过 |
這些特徵已新增至的特徵規則,包含 數值ID
字串ID
|
使用索引鍵值配對 |
此檔案資料使用機碼值組將資料傳遞至 Audience Manager .
|
下載 範例資料檔案(若您需要其他範例)。 下載檔案具有 .overwrite
副檔名。 您可以使用簡單的文字編輯器將其開啟。
下圖顯示格式化傳入檔案的正確方式範例,取決於 ID型別 以及您想要新增的方法 traits 至設定檔。
ID型別/作業 | 使用d_sid將特徵新增至使用者設定檔 | 使用d_unsid從使用者設定檔中移除特徵 | 傳入索引鍵/值組,將特徵新增至使用者設定檔 | 使用ic首碼將特徵新增至使用者設定檔 |
---|---|---|---|---|
AUDIENCE MANAGERUUID |
||||
Android裝置的Google Advertising ID |
||||
適用於iOS裝置的Apple IDFA |
||||
您自己的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