ID 同步文件的名称和内容要求 name-and-content-requirements-for-id-synchronization-files

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

NOTE
文本样式(monospaced text斜体、括号 [ ] ( ) 等)檔案中會指示程式碼元素和選項。 请参阅代码和文本元素的样式约定,以了解更多信息。

檔案名稱語法和範例 file-name-syntax

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

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

参数
描述
adobe_id
將檔案識別為ID同步檔案的靜態首碼。 比對裝置ID與其他裝置ID或客戶ID (DPUUID)時,請使用此首碼。
c2c_id
將檔案識別為People-Based Destinations之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
NOTE
如需以人物為基礎的目的地的ID同步檔案命名(c2c首碼),請參閱 工作流程A — 以所有線上活動和離線資料為基礎的個人化工作流程B — 以僅限離線資料為基礎的個人化.

檔案內容語法和範例 file-content-syntax

ID檔案的內容包括下列元素:

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

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

abc123 def456 ghi789 xyz987

檔案內容考量事項 considerations

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

IMPORTANT
不要使用 DPUUID 在第一欄中。 這樣做可能會導致不正確的同步。

同步會比對DPUUID與UUID sync-matches-dpuuids-uuids

ID同步檔案的用途是同步 DPUUID 從您自己的資料來源,使用 Audience Manager UUID。 同步對應 DPUUID來自主版 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 MANAGER UUID
DPID12345定
68079982765673198504052656074456196039
XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR38
67412682083411995725538770443620307584
XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
89159024796760343733111707646026765593
XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
66552757407517449462805881945288602094
XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M
66184778222667870903738139438735041506
XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

步驟1: ID同步程式會同步 DPUUIDs from DPID 使12345 Audience Manager UUIDs在左欄。 請注意 DPID 檔案名稱中的「0」代表 Audience Manager UUIDs.

檔案2 ( 下載範例檔案)

DPID 12345
DPID 67890
XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR38
4598060374
XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
4581274262
XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
4392434426
XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M
2351382994
XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw
4601584763

步驟2: DPUUIDs from DPID 12345已在步驟1中與Audience Manager同步 UUIDs.此ID同步會同步處理 DPUUIDs from DPID 67890用Audience Manager UUID步驟1中的。

其他格式需求 other-format-reqs

使用者ID不能:

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

系統不會處理或實現任何以定位字元或空格結尾的列。 通常,請確定列尾保持清晰。

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695