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

idSyncByURL 和 idSyncByDataSource 這兩個 ID 服務函數可讓您在 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%;設定通訊協定 (httphttps)。

範例程式碼和輸出 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
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a