通过 URL 或数据源进行 ID 同步 id-synchronization-by-url-or-data-source

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

语法、属性和宏 section-90ac61617482463aaf4c57009b830332

语法

代码
同步用户 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)。

示例代码和输出 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