說明用於檔案式ID同步的必要欄位、語法和命名慣例。 根據這些規範命名和組織檔案內容。
文字樣式 (monospaced text
、斜體、括號 [ ]
( )
等)在本檔案中指出程式碼元素和選項。 如需詳細資訊,請參閱程式碼與文字元素的樣式慣例。
ID檔案名稱包含下列必要和選用元素:
[adobe_id_]
[c2c_id_]
MASTERDPID_DPID
[_DPID]
_TIMESTAMP.sync
[.SPLIT_NUMBER]
[.gz]
參數 | 說明 |
---|---|
|
靜態首碼,可將檔案識別為ID同步檔案。 在將裝置ID與其他裝置ID或客戶ID(DPUUID)相符時,請使用此首碼。 |
|
靜態首碼,可將檔案識別為以人物為基礎的目的地的ID同步檔案。 比對客戶ID(DPUUID)與以人物為基礎的目的地的雜湊電子郵件地址時,請使用此首碼。 |
MASTERDPID |
主資料提供者ID是檔案名稱中DPID的父ID。 此外,資料檔案中的第一個使用者ID與主ID對應。 後續的DPID是屬於主要的其他識別碼。 同步會將檔案名稱中的DPID對應至檔案中的UUID。 此DPID只能包含裝置ID,例如AAM UUID、GAID、IDFA等。 其不能包含DPUUID。 這麼做可能會導致同步錯誤。 |
|
資料提供者ID。 這些ID代表與主DPID相關聯的實體或資料來源。 同步會將檔案名稱中的DPID對應至檔案中的UUID。 檔案名稱中的DPID數量必須與資料檔案中的UUID數量相符。 例如,假設您的檔案名稱包含主DPID和3個DPID。 您的資料檔案必須包含4個對應的UUID欄,格式如下方檔案內容一節所述。 |
timestamp |
10位數、UNIX時間戳記(以秒為單位)。 時間戳記有助於讓每個檔案名稱都是唯一的。 |
|
表示正常的完全同步。 |
|
整數。 將大型檔案分割為多個較小檔案時使用。 這有助於改善處理時間。 數字表示您要傳入的原始檔案的哪個部分。 請參閱下方的檔案名稱範例。 |
|
指定以選用的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的詳細說明,請參閱Audience Manager中的ID索引 。
請勿在第一欄上使用DPUUIDs。 這麼做可能會導致同步錯誤。
ID同步檔案的用途是使用Audience Manager UUID從您自己的資料來源同步 DPUUID。 同步將主DPID及其相關DPIDs的DPUUIDs映射到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 | DPID 12345 |
---|---|
68079982765673198504052656074456196039 | XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR38 |
67412682083411995725538770443620307584 | XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70 |
89159024796760343733111707646026765593 | XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM |
66552757407517449462805881945288602094 | XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M |
66184778222667870903738139438735041506 | XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw |
步驟1:ID同步程式將從DPID 12345與左欄的Audience Manager UUIDs同步DPUUIDs。 請注意,檔案名稱中的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:步驟1中已將DPID 12345的DPUUIDs與Audience ManagerUUIDs同步。此ID同步的作用是從DPID 67890將DPUUIDs與步驟1的Audience ManagerUUIDs同步。
用戶ID不能:
任何以制表符或空格結尾的列都不會被處理或實現。 請務必清除列的結尾。