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