文档Audience ManagerAudience Manager 用户指南

入站数据文件内容：语法、无效字符、变量和示例 inbound-data-file-contents-syntax-invalid-characters-variables-and-examples

Last update: Sat May 20 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

格式化傳入特徵資料檔案時，應遵循的必要欄位、語法和規則。

檔案內容語法 file-content-syntax

傳入資料檔案中的欄位必須依下列順序顯示。 在此範例中， < > 已新增符號，以幫助以視覺方式分隔每個元素。 您不需要將這些包含在資料檔案中。

<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...

如需其他接受的檔案內容格式，請參閱 自訂合作夥伴整合.

NOTE
對於傳入資料檔案中傳送的每個使用者ID，我們最多可處理200行。 例如，如果您為使用者ID傳送300行，則會保留前200行，並捨棄其他100行。 在以下範例中，您符合要求，因為您會分別針對使用者ID 1和使用者ID 2傳送3行。 我們並未對行中包含的特徵或索引鍵值配對數量實施限制。
code language-none 
<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>

已定義的檔案變數 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
使用單一定位點分隔符號將使用者ID和特徵ID分開。
trait ID

此 Audience Manager 特徵ID。 我們要求您包含 僅限已上線的特徵 傳入資料檔案中。 我們不會在傳入資料傳輸中處理任何其他特徵型別。

注意：特徵ID可使用傳回所有特徵詳細資訊的GET方法來找到。 如需詳細資訊，請參閱 特徵API方法.

格式設定 Trait IDs formatting-trait-ids

下表說明用來識別 trait 傳入資料檔案中的名稱或ID。 請參閱 範例檔案 例如。

前置詞
描述
d_sid=
此 d_sid 前置詞會告訴系統，ID是 Audience Manager 特徵ID。 這是顯示在使用者介面中的ID。 您也可以使用API傳回特徵ID GET 方法。 另請參閱 特徵API方法.
d_unsid=

前置詞為 d_unsid 會從該特徵中移除使用者。 此 d_unsid 前置詞會在 overwrite 檔案。

此 d_unsid= 前置詞會告訴系統，ID是 Audience Manager 特徵ID。 這是顯示在使用者介面中的ID。 您也可以使用API傳回特徵ID GET 方法。 另請參閱 特徵API方法.

ic=

特徵規則可讓您設定特徵資格條件。 如果您將特徵規則的格式設為 ic == trait ID ，您便能以簡單的逗號格式清單傳送特徵。

例如，假設您建立了這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

ID 类型
要求
DPUUID
不要 使用編碼冒號( %3A )或未編碼的冒號( ： )符號。
行動iOS (IDFA)或Android裝置ID

行動裝置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
不要 use 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

注释:

您也可以使用下列語法，從使用者設定檔中移除特徵，而不使用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 至設定檔。

ID型別/作業
使用d_sid將特徵新增至使用者設定檔
使用d_unsid從使用者設定檔中移除特徵
傳入索引鍵/值組，將特徵新增至使用者設定檔
使用ic首碼將特徵新增至使用者設定檔
AUDIENCE MANAGERUUID
範例1
範例2
範例3
範例4
Android裝置的Google Advertising ID
範例5
範例6
範例7
範例8
適用於iOS裝置的Apple IDFA
範例9
範例10
範例11
範例12
您自己的CRM ID (DPUUID)
範例13
範例14
範例15
範例16

示例 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
Related Articles
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695