declared IDs的工作方式、设置过程、代码示例和变量。
使用或接受永久存储机制(如第三方cookies)的设备或浏览器中的Audience Manager与用户ID进行交换和同步。
某些浏览器和大多数移动设备不接受第三方cookies。 这使得很难保留有关网站访客或分配永久ID的信息。 要解决此问题,Audience Manager使用DIL在事件调用中允许您传入declared IDs。 此外,declared ID可以充当一个通用ID,该ID适用于Experience Cloud中所有解决方案中的同一用户。 下表介绍了ID定位/匹配流程:
过程 | 描述 |
---|---|
事件调用 | 要使用,您需要页面上的DIL和 Adobe Experience Platform Identity Service 代码。 DIL 从Adobe Experience Platform Identity Service 提供 |
匹配ID | Audience Manager会尝试将客户端ID和访客ID与我们系统中的相应ID进行匹配。 如果不存在匹配的ID,则Audience Manager会创建一个新ID,并将其与客户端ID和访客ID关联。
注意: 如果您的ID映射到多个Audience ManagerID,则会使用最新的映射。 |
返回ID | Audience Manager将其同步的ID写入客户端域或应用程序中的第一方Cookie(或其他可寻址存储空间)。 |
后续事件调用 | 其他事件调用会从客户端的域中读取Audience ManagerID,并将其发送给Audience Manager。 |
要开始配置,您需要在网站上要用于数据收集的页面上配置Experience Cloud ID服务和DIL。 请参阅DIL创建和声明的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 Identity Service一起使用时,您不再需要使用已弃用的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部分找到此ID。 您需要管理员权限才能查看此功能板。 请参阅管理:核心服务。
对于最新版本的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 将和组合的与 DPID
匹 DPUUID
配到我们系统中的相应用户ID。如果ID不存在,则Audience Manager会创建一个新的用户ID,并将其同步到DPID/DPUUID
组合。 在Audience Manager匹配或创建用户ID(UUID
)后,它会在对客户端域(第一方cookie)或其他本地存储中的cookie的JSON响应中返回该ID。
使用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();
该请求会向Audience Manager发送数据提供程序和用户ID:
https://my_domain.net/event?d_rtbd=json&d_cb=myCallback&key=val&d_dpuuid=1234&d_dpid=5678
响应会返回Audience ManagerID(例如UUID
),该ID会写入页面域中的第一方Cookie。
myCallback({
...
"uuid":"abc123"
})
declared ID过程遵循网站访客首选项来选择退出您网站的Audience Manager定位。 当Audience Manager收到选择退出请求时,DCS会返回空的JSON对象,而不是Audience Manager用户ID。