傳入資料檔案內容:語法、無效字元、變數和範例

格式化入站特性資料檔案時應遵循的必填欄位、語法和規則。

檔案內容語法

入站資料檔案中的欄位必須按如下所示的順序顯示。 在此示例中, < > 已添加符號,以幫助直觀地分隔每個元素。 您不需要將這些內容包括在資料檔案中。

<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>

定義的檔案變數

該表列出並定義了正確格式化入站資料檔案中使用的變數。 斜體​表示變數預留位置。

變數 說明

User ID

用戶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方法來找到特徵ID。 有關詳細資訊,請參見 特性API方法

格式 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 ,可以在簡單逗號格式清單中發送trait。

例如,假設您建立以下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 和鍵值對

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

不要 使用 TAB 而不是鍵值對中的空值。 僅使用 TAB 以在入站資料檔案中分離變數。

\n, \t

不使用新行或制表符字元( \n, \t )。

資料檔案示例

資料檔案格式 說明和示例

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

注意:

您也可以使用以下語法從用戶配置檔案中刪除traits,而不是使用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 檔案副檔名。 可以使用簡單的文本編輯器開啟它。

示例矩陣

下圖顯示了正確格式化入站檔案的示例,具體取決於 ID類型 和您要添加的方法 traits 到配置檔案。

ID類型/操作 使用d_sid向用戶配置檔案添加特徵 使用d_unsid從用戶配置檔案中刪除特徵 發送鍵值對以向用戶配置檔案添加特徵 使用ic前置詞向用戶配置檔案添加特徵

Audience ManagerUUID

範例 1

範例 2

示例3

示例4

GoogleAndroid設備廣告ID

示例5

示例6

示例7

示例8

AppleIDFA用於iOS設備

示例9

示例10

示例11

示例12

您自己的CRM ID(DPUUID)

示例13

示例14

示例15

示例16

範例 1

使用 trait IDs 發送 trait 資格資訊 Audience Manager UUIDs。

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

範例 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

發送鍵值對以添加 trait 資格資訊 Audience Manager UUIDs。

59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

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

示例4

使用 ic 發送前置詞 trait 資格資訊 Audience Manager UUIDs。

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

59767559181262060060278870901087098252 <TAB> ic=52,ic=55

示例5

使用 trait IDs 發送 trait 資格資訊 Android 設備。

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

示例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

發送鍵值對以添加 trait 資格資訊 Android 設備。

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

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

示例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

使用 trait IDs 發送 trait 資格資訊 iOS 設備。

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

示例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

發送鍵值對以添加 trait 資格資訊 iOS 設備。

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

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

示例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

使用 trait IDs 發送 trait 資格資訊 DPUUIDs。

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

示例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

發送鍵值對以添加 trait 資格資訊 DPUUIDs。

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

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

示例16

使用 ic 發送前置詞 trait 資格資訊 DPUUIDs。

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

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55

本頁內容