Show Menu
主題×

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

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

檔案內容語法

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

格式化特徵ID

下表說明識別傳入資料檔案中特徵名稱或ID的字首。 如需範例, 請參閱範例檔
首碼 說明
d_sid=
d_sid 碼會告訴我們的系統ID是 Audience manager特 徵ID。 這是使用者介面中顯示的相同ID。 您也可以使用API方法傳回特徵 GET ID。 請參閱 特徵API方法
d_unsid=
前置詞為的資 d_unsid 料會從該特徵中移除使用者。 檔案 d_unsid 中將忽略前置詞 overwrite
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 都是格式正確的鍵值對的示例。

特徵ID、使用者ID和索引鍵值配對中的無效字元

特徵ID

特徵ID只包含數值字元。 我們要求您在傳入的資 料檔案中僅包含已登入的特徵 。 我們不會在傳入資料傳輸中處理任何其他特徵類型。

使用者 ID

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”
如果您需要 其他範例,請下載範例資料檔案。 下載檔案的副檔 .overwrite 名為。 您可以使用簡單的文字編輯器來開啟它。

範例矩陣

下圖顯示正確格式化傳入檔案的範例,視ID類型 和要新增特徵至描述檔的方法而定
ID類型/操作 使用d_sid將特徵新增至使用者設定檔 使用d_unsid從使用者設定檔移除特徵 傳送索引鍵值配對,以新增特徵至使用者描述檔 使用ic首碼將特徵新增至使用者描述檔
Audience Manager UUID
Android裝置專用的Google廣告ID
iOS裝置專用的Apple IDFA
您自己的CRM ID(DPUUID)

Example 1

使用特徵ID來傳送Audience Manager UUID的特徵資格資訊。
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27

Example 2

使用特徵ID來傳送Audience Manager UUID的特徵不再限定資訊。
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

Example 3

傳送索引鍵值配對,以新增Audience Manager UUID的特徵資格資訊。
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

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

Example 4

使用ic首碼來傳送Audience Manager UUID的特徵資格資訊。
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626

59767559181262060060278870901087098252 <TAB> ic=52,ic=55

Example 5

使用特徵ID來傳送Android裝置的特徵資格資訊。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26

Example 6

使用特徵ID來傳送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

Example 7

傳送索引鍵值配對,以新增Android裝置的特徵資格資訊。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone

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

Example 8

使用ic首碼來傳送Android裝置的特徵資格資訊。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> ic=52,ic=55

Example 9

使用特徵ID來傳送iOS裝置的特徵資格資訊。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26

Example 10

使用特徵ID來傳送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

Example 11

傳送索引鍵值配對,以新增iOS裝置的特徵資格資訊。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone

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

Example 12

使用ic首碼來傳送iOS裝置的特性資格資訊。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> ic=52,ic=55

Example 13

使用特徵ID來傳送DPUUID的特徵資格資訊。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26

Example 14

使用特徵ID來傳送DPUUID的特徵不合格資訊。
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

Example 15

傳送索引鍵值配對,以新增DPUUID的特徵資格資訊。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

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

Example 16

使用ic首碼來傳送DPUUID的特徵資格資訊。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55