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
將檔案標識為基於人員的目標的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
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的索引 的子菜單。

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

同步將DPUUID與UUID匹配 sync-matches-dpuuids-uuids

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開始。

其他格式要求 other-format-reqs

用戶ID不能:

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

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

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