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只能包含設備IDAAM,如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同步檔案命名(c2c前置詞),請參見 工作流A — 基於所有聯機活動和離線資料的個性化工作流B — 基於僅離線資料的個性化

檔案內容語法和示例

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

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

檔案包含用戶ID(UUID)。 在每行中,用頁籤分隔ID。 以下示例顯示了格式正確的ID檔案。 你的內容可能看起來很相似。

abc123 def456 ghi789 xyz987

檔案內容注意事項

建立入站檔案時,確保第一列僅填充了設備ID,如 AAM UUID。 GAID。 IDFA等等。 請參閱 Audience Manager中ID的索引 的子菜單。

重要

不使用 DPUUID 列中。 這樣做可能導致同步不正確。

同步將DPUUID與UUID匹配

ID同步檔案的目的是同步 DPUUID 使用 Audience Manager UUID。 同步映射 DPUUID來自主人 DPID 及其相關 DPID至 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
67412682083411995725538770443620307584 XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
89159024796760343733111707646026765593 XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
66552757407517449462805881945288602094 XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M
66184778222667870903738139438735041506 XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

步驟1:ID同步進程將同步 DPUUID從 DPID 12345 Audience Manager UUID的下界。 請注意 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:這樣 DPUUID從 DPID 12345已在步驟1與Audience Manager同步 UUIDs此ID同步將執行的是同步 DPUUID從 DPID 小行星67890 UUID從步驟1開始。


其他格式要求

用戶ID不能:

  • 在ID本身中具有頁籤。 制表符僅用於在資料檔案中分離單個ID。
  • 包含個人身份資訊(PII)。
  • 使用 URL 編碼。 僅傳遞未編碼的ID。

任何以制表符或空格結尾的行都不會被處理或實現。 作為規則,確保清除行末。

本頁內容