通过 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%
:设置通信协议(http
或https
)。
示例代码和输出 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