ID 同步檔案的名稱和內容要求

說明用於檔案式ID同步的必填欄位、語法和命名慣例。 根據這些規格命名和組織檔案內容。

注意

文字樣式 (monospaced text、斜體、括號 [ ] ( ) 等)在本檔案中指出程式碼元素和選項。 如需詳細資訊，請參閱程式碼與文字元素的樣式慣例。

檔案名語法和示例

ID檔案名稱包含下列必要和選用元素：

[adobe_id_] [c2c_id_]MASTERDPID_DPID[_DPID]_TIMESTAMP.sync[.SPLIT_NUMBER][.gz]

參數 說明

adobe_id

將檔案標識為ID同步檔案的靜態前置詞。 當將裝置ID與其他裝置ID或客戶ID(DPUUID)相符時，請使用此首碼。

c2c_id

靜態首碼，可將檔案識別為以人為本的目的地的ID同步檔案。 將客戶ID(DPUUID)與雜湊的「人員型目標」電子郵件地址相符時，請使用此首碼。

MASTERDPID

主資料提供者ID是檔案名稱中DPID的父ID。 此外，資料檔案中的第一個使用者ID對應主ID。 後續的DPID是屬於主要的其他識別碼。 同步會將檔案名稱中的DPID對應至檔案中的UUID。

此DPID只能包含裝置ID,AAM例如UUID、GAID、IDFA等。 它不能包含DPUUID。 這樣做會導致同步不正確。

DPID

資料提供者ID。 這些ID代表與主DPID相關的實體或資料來源。 同步會將檔案名稱中的DPID對應至檔案中的UUID。

檔案名稱中的DPID數量必須與資料檔案中的UUID數量相符。 例如，假設您的檔案名稱包含主DPID和3個DPID。 您的資料檔案必須包含4個對應的UUID欄，格式如下方的檔案內容區段所述。

timestamp

10位數的UNIX時間戳記（以秒為單位）。 時間戳記有助於使每個檔案名稱都是唯一的。

.sync

表示正常的完全同步。

[.SPLIT_NUMBER]

整數。 將大型檔案分割為多個小型檔案時使用。 這有助於縮短處理時間。 數字表示您要傳送的原始檔案的哪個部分。 請參閱下方的檔案名稱範例。

[.gz]

指定您的檔案會以選用的gzip壓縮進行壓縮。

檔案名稱範例

下列範例顯示格式正確的檔案名稱。 您的檔案名稱可能看起來類似。

  • adobe_id_111_222_333_444_1454442149.sync
  • adobe_id_123_898_456_1454442149.sync.1.gz
  • adobe_id_123_898_456_1454442149.sync.2.gz
  • c2c_id_123_898_1454442149.sync.gz
注意

檔案內容語法與範例

ID檔案的內容包含下列元素：

UUID <tab>UUID<tab>UUID<tab>UUID

檔案包含使用者ID(UUID)。 在每一行中，使用標籤分隔ID。 下列範例顯示格式正確的ID檔案。 您的內容看起來可能很類似。

abc123 def456 ghi789 xyz987

檔案內容注意事項

建立傳入檔案時，請確定第一欄僅填入裝置ID，例如AAM UUID、GAID、IDFA等。 請參閱Audience Manager🔗中的 ID索引，以取得Audience Manager支援的ID的詳細說明。

重要

請勿在第一欄使用DPUUIDs。 這樣做會導致同步不正確。

同步匹配DPUUID與UUID

ID同步檔案的用途是從您自己的Data Sources將DPUUID與Audience Manager UUID同步。 同步將DPUUIDs從主DPID及其相關DPIDs映射到Audience Manager UUIDs。將ID放在檔案名稱和內文中的位置，會決定這些識別碼如何彼此對應。 例如，請取下列兩個範例檔案：

  • 檔案1: adobe_id_0_12345_1476312152.sync

  • 檔案2: adobe_id_12345_67890_1476312876.sync


給定範例名稱和內容，ID會以下列方式對應在一起：

檔案1 ( 下載範例檔案)

DPID 0 =Adobe Audience ManagerUUID DPID 12345
68079982765673198504052656074456196039 XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-Trj6E4njaMR38
67412682083419957253870443620307584 XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
89159024796760343733111170764602676593 XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
66552757407517449462805881945288602094 XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M
6618477822667870903738139438735041506 XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

步驟1:id同步程式將從DPID 12345將DPUUIDs與左欄中的Audience Manager UUIDs同步。 請注意，檔案名稱中的DPID "0"代表Audience Manager UUIDs。

檔案2 ( 下載範例檔案)

DPID 郵編：12345 DPID 郵編：67890
XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-Trj6E4njaMR38 4598060374
XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70 4581274262
XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM 4392434426
XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M 2351382994
XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw 4601584763

步驟2:在步驟1中，來自DPID 12345的DPUUIDs與Audience ManagerUUIDs同步。此ID同步將從DPID 67890將DPUUIDs與步驟1的Audience ManagerUUIDs同步。


其他格式要求

使用者ID無法：

  • 在ID本身具有標籤。 標籤僅用於分隔資料檔案中的個別ID。
  • 包含個人識別資訊(PII)。
  • 使用URL編碼。 僅傳遞未編碼的ID。

任何以制表符或空格結尾的行都不會被處理或實現。 通常，請務必清楚列的結尾。

本頁內容