依 URL 或資料來源執行 ID 同步作業 id-synchronization-by-url-or-data-source

最後更新： 2025年12月4日

建立對象：

{"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"},{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"f8a45b24-4be7-4f1b-909b-60d06b483a20"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

訪客ID服務函式idSyncByURL和idSyncByDataSource可讓您在Destination Publishing iFrame中手動實作ID同步。這些在VisitorAPI.js 1.10或更新版本中可用。

語法、屬性和巨集 section-90ac61617482463aaf4c57009b830332

語法

程式碼

同步用戶 ID

visitor.idSyncByURL();

在不同的資料合作夥伴和 Audience Manager 之間，使用自訂 ID 同步 URL。

visitor.idSyncByDataSource();

已知 DPID 和 DPUUID，並想使用標準 ID 同步 URL 格式將其傳送給 Audience Manager。

屬性

下表羅列及定義了兩個函數皆可使用的屬性。

名稱

類型

說明

dpid

字串

Audience Manager 指派的資料提供者 ID。

dpuuid

字串

資料提供者獨一無二的用戶 ID。

minutesToLive

數字

(選用) 設定 Cookie 過期時間。值必須是整數。預設值為 20160 分鐘 (14天)。

url

字串

目的地 URL。

巨集

這兩個函數都接受以下巨集：

%TIMESTAMP%：產生時間戳記 (單位為毫秒)。用於快取破壞。
%DID%：插入用戶的 Audience Manager ID。
%HTTP_PROTO%；設定通訊協定 (http 或 https)。

範常式式碼和輸出 section-0115615c37584a19a2ab11e917c4e7e9

如果執行成功，兩個函數會傳回 Successfully queued。如果失敗則傳回錯誤訊息字串。

visitor.idSyncByURL

範例程式碼

   //Instatiate Visitor
    var visitor = Visitor.getInstance
    ("MARKETING-CLOUD-ORG-ID-HERE",{});
   // Fires url with macros replaced
    visitor.idSyncByURL({
    dpid: '24', // must be a string
    url: '//su.addthis.com/red/usync?pid=16&puid=%DID%&url=%HTTP_PROTO%://
    dpm.demdex.net/ibs:dpid=420&dpuuid={{uid}}',
    minutesToLive: 20160 // optional, defaults to 20160 minutes (14 days) });

範例輸出

http://su.addthis.com/red/usync?pid=16&puid=28777806459181003670799219185178493848&url=http%3A%2F%2Fdpm.demdex.net%2Fibs%3Adpid%3D420%26dpuuid%3D%7B%7Buid%7D%7D

visitor.idSyncByDataSource

範例程式碼

  //Instantiate Visitor
   var visitor = Visitor.getInstance
   ("MARKETING-CLOUD-ORG-ID-HERE",{});
  // Fires 'http:/https:' + '//dpm.demdex.net/ibs:dpid=&dpuuid='
   visitor.idSyncByDataSource({
     dpid: '24', // must be a string
     dp     minutesToLive: 20160 // optional, defaults to 20160 minutes (14 days) });

範例輸出

http://dpm.demdex.net/ibs:dpid=24&dpuuid=98765

recommendation-more-help

id-service-help