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

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

檔案內容語法

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

<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...

如需其他接受的檔案內容格式，請參閱自訂合作夥伴整合。

注意

我們有200行的限制，可針對傳入資料檔案中傳送的每個使用者ID進行處理。例如，若您針對使用者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可以是：由Audience Manager(Audience ManagerUUID )指派的不重複使用者ID。在您的CRM系統中指派的唯一使用者ID( 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。我們要求您在傳入資料檔案中僅包含已上線的特徵。我們不會在傳入資料傳輸中處理任何其他特徵類型。注意：特徵ID可使用GET方法來找到，方法會傳回所有特徵的詳細資訊。如需詳細資訊，請參閱特徵API方法。

User ID

使用者ID可以是：

由Audience Manager(Audience ManagerUUID )指派的不重複使用者ID。
在您的CRM系統中指派的唯一使用者ID( 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。我們要求您在傳入資料檔案中僅包含已上線的特徵。我們不會在傳入資料傳輸中處理任何其他特徵類型。

注意：特徵ID可使用GET方法來找到，方法會傳回所有特徵的詳細資訊。如需詳細資訊，請參閱特徵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 類型需求

ID 類型	需求
DPUUID	請勿使用編碼的冒號( `%3A` )或未編碼的冒號(:)符號。
行動iOS(IDFA)或Android裝置ID	行動裝置ID必須嚴格格式化，如下所示： IDFA格式：ID必須為大寫，而非雜湊。例如， `6D92078A-8246-4BA4-AE5B-76104861E7DC` Android格式：ID必須小寫，而非雜湊。例如， `97987bca-ae59-4c7d-94ba-ee4f19ab8c21`

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` 注意: 您也可以使用下列語法，從使用者設定檔中移除特徵，而不使用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”`

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

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

範例矩陣

下圖顯示設定入檔格式的正確方式範例，具體取決於類型的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

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

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

範例2

使用trait IDs發送traitAudience 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"

範例4

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

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發送traitDPUUIDs的資格資訊。

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前置詞發送traitDPUUIDs的資格資訊。

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

或

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55

特徵產生器

adobe.com 上的資源

Third Party Integrations Third Party Data Identity Management Cohort Analysis General Data Protection Regulation Web Analytics

全新的改善搜尋