通过 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%:设置通信协议(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

On this page

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now