傳入資料檔案內容:語法、無效字元、變數和範例 inbound-data-file-contents-syntax-invalid-characters-variables-and-examples

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

檔案內容語法 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可以是:

  • 由Audience Manager指派的不重複使用者識別碼(Audience ManagerUUID)。
  • 在您的CRM系統中指派的不重複使用者識別碼( 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可使用傳回所有特徵詳細資訊的GET方法來找到。 如需詳細資訊,請參閱特徵API方法

正在格式化Trait IDs formatting-trait-ids

下表說明在傳入資料檔案中識別trait名稱或ID的前置詞。 如需範例,請參閱範例檔案

前置詞
說明
d_sid=
d_sid 首碼會告訴系統,識別碼是Audience Manager特徵識別碼。 這是顯示在使用者介面中的ID。 您也可以使用API GET 方法傳回特徵識別碼。 請參閱特徵API方法
d_unsid=

前置詞為 d_unsid 的資料會從該特徵中移除使用者。 在 overwrite 檔案中忽略 d_unsid 首碼。

d_unsid= 首碼會告訴系統,識別碼是Audience Manager特徵識別碼。 這是顯示在使用者介面中的ID。 您也可以使用API 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
請勿 在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
不要 使用 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傳送Audience Manager UUIDs的trait資格資訊。

59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27

範例 2 example-2

使用trait IDs傳送Audience Manager UUIDs的trait取消資格資訊。

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

傳送機碼值組以新增Audience Manager UUIDs的trait資格資訊。

59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"

範例4 example-4

使用ic首碼來傳送Audience Manager UUIDs的trait資格資訊。

59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626

59767559181262060060278870901087098252 <TAB> ic=52,ic=55

範例5 example-5

使用trait IDs傳送Android裝置的trait資格資訊。

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26

範例6 example-6

使用trait IDs傳送Android裝置的trait取消資格資訊。

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

傳送機碼值組以新增Android裝置的trait資格資訊。

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"

範例8 example-8

使用ic首碼來傳送Android裝置的trait資格資訊。

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傳送iOS裝置的trait資格資訊。

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26

範例10 example-10

使用trait IDs傳送iOS裝置的trait取消資格資訊。

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

傳送機碼值組以新增iOS裝置的trait資格資訊。

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"

範例12 example-12

使用ic首碼來傳送iOS裝置的trait資格資訊。

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傳送DPUUIDs的trait資格資訊。

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26

範例14 example-14

使用trait IDs傳送DPUUIDs的trait取消資格資訊。

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

傳送機碼值組以新增DPUUIDs的trait資格資訊。

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"

範例16 example-16

使用ic首碼來傳送DPUUIDs的trait資格資訊。

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695