依 URL 或資料來源執行 ID 同步作業

idSyncByURL 和 idSyncByDataSource 這兩個 ID 服務函數可讓您在 Destination Publishing iFrame 中手動實作 ID 同步。VisitorAPI.js 1.10 (含) 以上版本均已提供這些函數。

語法、屬性和巨集

語法

程式碼 同步使用者 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)。

範例程式碼和輸出

如果執行成功,兩個函數會傳回 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
     dpuuid: '98765', // must be a string 
     minutesToLive: 20160 // optional, defaults to 20160 minutes (14 days) });

範例輸出

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

本頁內容