declared IDs的工作方式、设置过程、代码示例和变量。
不使用或接受永久存储机制的设备或浏览器(如第三方cookies)的用户ID与Audience Manager进行交换和同步。
某些浏览器和大多数移动设备不接受第三方cookies。 这使得很难保留有关站点访客的信息或分配永久ID。 要解决此问题,Audience Manager使用DIL让您在事件调用中传入declared IDs。 此外,declared ID可以充当适用于Experience Cloud中所有解决方案的同一用户的通用ID。 下表描述了ID定位/匹配过程:
过程 | 描述 |
---|---|
事件呼叫 | 要使用,您需要页面上的DIL和Adobe Experience Platform标识服务代码。 DIL 通 过 Adobe Experience Platform身份服 |
匹配ID | Audience Manager尝试将客户端和访客ID与系统中的相应ID匹配。 如果不存在匹配的ID,Audience Manager将创建新ID并将其与客户端和访客ID关联。
注意: 如果您的ID映射到多个Audience ManagerID,则使用最新映射。 |
返回ID | Audience Manager将其同步ID写入客户端域或应用程序中的第一方cookie(或其他可寻址存储空间)。 |
后续事件调用 | 其他事件调用从客户端的域读取Audience ManagerID,并将其发送给Audience Manager。 |
要开始,您需要在要用于数据收集的站点的各个页面中配置Experience Cloud ID服务和DIL。 请参阅DILcreate和声明的ID变量。
declared ID流程接受网站访客偏好,选择退出网站的Audience Manager定位。 当Audience Manager收到退出请求时,由DCS返回的JSON包含错误代码171,其中消息为Encountered opt out tag
,而不是Audience Manager用户ID。
有关选择退出数据收集的详细信息,请参阅数据隐私。
可以使用d_cid
和d_cid_ic
键值对发出declared ID退出请求。 虽然旧版参数(如 d_dpid
和 d_dpuuid
)仍然可用,但已考虑将其弃用。请参阅 CID 取代 DPID 和 DPUUID。在示例中,斜体表示变量占位符。
有关说明和语法,请参阅已声明 ID 的 URL 变量和语法。
选择退出请求所用方式 | 代码示例 |
---|---|
数据提供商 ID 和用户 ID。 |
|
集成代码和用户 ID。 |
|
多个 |
|
这些方法仍然有效,但被认为已弃用。 此信息是为传统目的和参考提供的。 旧版选择退出包括:
退出(已弃用) | 代码示例 |
---|---|
|
|
合作伙伴级别选择退出 |
合作伙伴级别退出会存储为此 |
|
|
下表列表了传递到Audience Manager数据提供程序ID和用户ID或集成代码(如果使用)的键值对。 注意,斜体表示变量占位符。 已添加空格,使这些内容更易于阅读。
在每个键值对中:
=
符号将键与其相关值分开。%01
变量 | 描述 |
---|---|
|
在单个键值对中包含数据提供程序ID和关联的唯一用户ID。 |
|
在单个键值对中包含集成代码和关联的唯一用户ID。 |
如果给定这些键值对及其必需的语法,您将进行事件调用,如下所示。
事件呼叫包括 | 代码示例 |
---|---|
数据提供商 ID 和用户 ID。 |
|
集成代码和用户 ID。 |
|
多个 |
|
描述用于将declared IDs传递到DIL到Audience Manager.的配置变量
当与Adobe Experience Platform身份服务一起使用时,您不再需要使用已弃用的dpid
和dpuuid
变量传入declared IDs。 相反,DIL的当前版本依赖visitorService
函数从Adobe Experience Platform Identity Service的setCustomerIDs
函数获取declared IDs。 有关详细信息,请参阅客户ID和身份验证状态。 您将调用DIL.create
中的visitorService
,如下所示。
var vDil = DIL.create({
partner:"partner name",
visitorService:{
namespace:"INSERT-MCORG-ID-HERE"
}
});
在namespace
键值对中,MCORG
是您的Experience Cloud组织ID。 如果您没有此ID,您可以在Experience Cloud仪表板的Administration部分找到它。 您需要管理员权限才能视图此仪表板。 请参阅管理:核心服务。
对于DIL (6.2+)的最新版本,您无需使用这些键值对即可传入declared IDs。 这是因为DIL现在依赖于上面代码示例中显示的visitorService
函数。 此函数从Adobe Experience Platform Identity Service获取declared IDs。 但是,我们在此引用这些变量以用于历史和传统用途。 有关如何配置DIL.create
以从Visitor ID Service获取declared ID的示例,请参见下面的代码。
下表描述了declaredId
对象使用的旧变量:
名称 | 类型 | 描述 |
---|---|---|
dpid |
字符串 | 由Audience Manager分配的数据合作伙伴ID。 |
dpuuid |
字符串 | 用户的唯一数据提供程序 ID。 |
Audience Manager 将合并后的用户ID DPID
与我 DPUUID
们系统中的相应用户ID进行比较和匹配。如果ID不存在,Audience Manager将创建新的用户ID并将其同步到DPID/DPUUID
组合。 在Audience Manager匹配或创建用户ID(UUID
)后,它会在JSON响应中返回该ID,以响应客户端域(第一方cookie)或其他本地存储。cookie
使用DIL v6.1或更早版本时调用此函数。 但是,已弃用此函数,而使用从Adobe Experience Platform Identity Service获取declared IDs的新版本。
DIL.create({
partner : "partner name",
declaredId : {
dpuuid : dpuuid,
DPID : dpid
}
});
您需要以编程方式开发提供d_dpuuid
和d_dpid
键ID值的代码。
如果使用不同的declaredID
组合进行API调用,则新组合将仅用于该调用。 进一步的常规事件调用将使用原始的DIL.create
declaredID
组合。
DIL.getDil('partner name').api.signals({...}).declaredId({
dpuuid : dpuuid
dpid : dpid
}).submit();
请求将数据提供程序和用户ID发送到Audience Manager:
https://my_domain.net/event?d_rtbd=json&d_cb=myCallback&key=val&d_dpuuid=1234&d_dpid=5678
该响应返回写入到页面域中第一方cookie的Audience ManagerID(例如UUID
)。
myCallback({
...
"uuid":"abc123"
})
declared ID流程接受网站访客偏好,选择退出网站的Audience Manager定位。 当Audience Manager收到退出请求时,DCS返回空的JSON对象,而不是Audience Manager用户ID。