- Audience Manager 指南
- 概述
- 功能
- 報表
- API 和 SDK 程式碼
- Data Integration Library (DIL) API
- 實作與整合指南
- 參考
- 常見問題解答
- 協助與法律
- 常見客戶支援問題
- 文件更新
- 字彙表
傳入資料檔案內容：語法、無效字元、變數和範例
格式化傳入特徵資料檔案時，您應遵循的必填欄位、語法和規則。
檔案內容語法
傳入資料檔案中的欄位必須依下列順序顯示。 在此範例中，已新增 < 符號， > 以協助以視覺化方式分隔每個元素。 您不需要將這些項目納入資料檔案中。
<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...
如需其他接受的檔案內容格式，請參閱自 訂合作夥伴整合。
對於傳入資料檔案中傳送的每個使用者ID，我們可處理的行數上限為200行。 例如，如果您傳送300行作為使用者ID，則會保留前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 IDs
下表說明了用於標識傳入資料 trait 檔案中的名稱或ID的前置詞。 如需範例， 請參閱範例檔 。
| 首碼 | 說明 |
|---|---|
| |
首 |
| |
前置詞為的資 首 |
| |
特徵規則 可讓您設定特徵資格的准則。 如果您將特徵規則格式化為 例如，假設您建立這3個特徵規則：
這些特徵與密鑰相
|
| 鍵值對 |
特徵資料可使用英數字串格式化為鍵值配對。 有幾種格式化鍵值對的方法，如下所示：
"age"="32" 、 、 "gender"=m 、 model = "pickup truck" 、 product = tablet 都是格式正確的鍵值對的示例。 |
無效的字 Trait IDs元和 User IDs 鍵值配對
Trait IDs
Trait IDs 只包含數字字元。 我們要求您僅將內 嵌onboarded traits資料檔案納入傳入。 我們不會處理傳入trait資料傳輸中的任何其他類型。
User IDs
| ID 類型 | 需求 |
|---|---|
| DPUUID |
請勿使用 「編碼」冒號( |
| 行動iOS(IDFA)或Android裝置ID |
行動裝置ID必須嚴格格式化，如下所示：
|
鍵值對
鍵值對中的值名稱格式不正確也會導致問題。 建立或命名鍵值對中的值時，請遵循以下規則：
| 字元 | 需求 |
|---|---|
| 引號字元(") |
您可以在鍵和鍵值對的值部分使用引號字元，例如：
|
| 破折號字元(-) |
我們忽略鍵開頭的破折號。 例如， |
| |
請勿在鍵 -值 |
| |
請勿在鍵或值中使用新的行或 |
資料檔案範例
| 資料檔案格式 | 說明與範例 |
|---|---|
| 使用 |
此資料檔案顯示符合特徵24、26、27的使用者，且已從特徵28和29移除。
注意: 您也可以使用下列語法，從使用者描述檔移除特徵，而不是使用d_unsid:
|
| 包含 |
這些特徵已新增至具有首碼的特徵 數值ID
字串ID
|
| 具有鍵值對 |
此檔案資料使用金鑰值配對，將資料傳入 Audience Manager 。
|
[如果您需要] (assets/ftp_dpm_1234_1445374061.overwrite) 其他範例，請下載範例資料檔案。 下載檔案的副檔 .overwrite 名為。 您可以使用簡單的文字編輯器來開啟它。
範例矩陣
下圖顯示了正確格式化傳入檔案的範例，視ID類 型 ，以及您要新增至描述檔的 traits 方法而定。
| ID類型／操作 | 使用d_sid將特徵新增至使用者設定檔 | 使用d_unsid從使用者設定檔移除特徵 | 傳送索引鍵值配對，以新增特徵至使用者描述檔 | 使用ic首碼將特徵新增至使用者描述檔 |
|---|---|---|---|---|
| Audience Manager UUID |
||||
| Android裝置專用的Google廣告ID |
||||
| iOS裝置專用的Apple IDFA |
||||
| 您自己的CRM ID(DPUUID) |
Example 1
使用 trait IDs 來傳送 trait 資格資訊 Audience ManagerUUIDs。
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27
Example 2
用 trait IDs 於發送 trait 取消資格資訊 Audience ManagerUUIDs。
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
Example 3
傳送索引鍵值配對，以新增 trait 資格資訊 Audience ManagerUUIDs。
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone
或
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"
Example 4
使用首 ic 碼傳送 trait 資格資訊 Audience ManagerUUIDs。
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626
或
59767559181262060060278870901087098252 <TAB> ic=52,ic=55
Example 5
使用 trait IDs 來傳送 trait 裝置的資格 Android 資訊。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26
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
Example 7
傳送金鑰值配對，以新增裝 trait 置的資格 Android 資訊。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone
或
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"
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
Example 9
使用 trait IDs 來傳送 trait 裝置的資格 iOS 資訊。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26
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
Example 11
傳送金鑰值配對，以新增裝 trait 置的資格 iOS 資訊。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone
或
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"
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
Example 13
使用 trait IDs 來傳送 trait 的資格資訊 DPUUIDs。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
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
Example 15
傳送索引鍵值配對，以新增 trait 資格資訊 DPUUIDs。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone
或
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"
Example 16
使用首 ic 碼來傳送 trait 的資格資訊 DPUUIDs。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626
或
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55