傳入資料檔案內容:語法、無效字元、變數和範例 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 Manager UUID)。
  • 在您的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。 這是顯示在使用者介面中的ID。 您也可以使用API GET 方法傳回特徵識別碼。 請參閱特徵API方法
d_unsid=

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

d_unsid= 首碼會告訴系統,識別碼是 Audience Manager 特徵ID。 這是顯示在使用者介面中的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 MANAGER UUID
範例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
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695