Show Menu
主题×

通过 URL 或数据源进行 ID 同步

ID 服务函数 idSyncByURL 和 idSyncByDataSource 允许您在目标发布 iFrame 中手动实施 ID 同步。VisitorAPI.js 版本 1.10 或更高版本中提供了这些函数。

语法、属性和宏

语法
代码 同步用户 ID
visitor.idSyncByURL();
通过自定义 ID 同步 URL 在不同数据合作伙伴和 Audience Manager 之间同步。
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 )。

示例代码和输出

如果运行成功,这两个函数都将返回 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