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

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

檔案內容語法

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

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

定義的檔案變數

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

變數 說明

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 GET 方法傳回特徵ID。 請參閱特徵API方法

d_unsid=

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

d_unsid= 首碼會告訴我們的系統ID是Audience Manager特徵ID。 這是使用者介面中顯示的相同ID。 您也可以使用API GET 方法傳回特徵ID。 請參閱特徵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和鍵值對中的字元無效

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&nbsp;&nbsp;d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29

注意:

您也可以使用下列語法,從使用者描述檔移除特徵,而不是使用d_unsid:

59767559181262060060278870901087098252&nbsp;28:0,&nbsp;29:0

59767559181262060060278870901087098252&nbsp;28:-1,&nbsp;29:-1

包含 ic==

這些特徵已新增至具有 ic 首碼的特徵規則。 因此,您可以將檔案新增至資料檔案,並以逗號分隔,如所示。 標籤可分隔UUID和特徵ID。 檔案中不需要 ic 前置詞。

數值ID

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1&nbsp;&nbsp;30608,50354,50338,50352,30626

字串ID

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1&nbsp;&nbsp;ic=52,ic=55

具有鍵值對

此檔案資料使用鍵值對將資料傳遞到Audience Manager

59767559181262060060278870901087098252&nbsp;“gender”=”female”,“luxury_shopper”=”yes”

[如果] (assets/ftp_dpm_1234_1445374061.overwrite) 您需要其他範例,請下載範例資料檔案。下載檔案的副檔名為.overwrite。 您可以使用簡單的文字編輯器來開啟它。

範例矩陣

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

ID類型/操作 使用d_sid將特徵新增至使用者設定檔 使用d_unsid從使用者設定檔移除特徵 傳送索引鍵值配對,以新增特徵至使用者描述檔 使用ic首碼將特徵新增至使用者描述檔

Audience ManagerUUID

範例 1

範例 2

範例3

範例4

Android裝置專用的Google廣告ID

範例5

範例6

範例7

範例8

iOS裝置專用的Apple IDFA

範例9

範例10

範例11

範例12

您自己的CRM ID(DPUUID)

範例13

範例14

範例15

範例16

範例1

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

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

傳送索引鍵值配對,以新增Audience Manager UUIDs的trait資格資訊。

59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

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

範例5

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

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

59767559181262060060278870901087098252 <TAB> ic=52,ic=55

範例4

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

傳送鍵值配對,以新增Android裝置的trait資格資訊。

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

傳送鍵值配對,以新增iOS裝置的trait資格資訊。

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

傳送索引鍵值配對,以新增DPUUIDs的trait資格資訊。

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

本頁內容

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now