Declared IDs

declared IDs的工作方式、设置过程、代码示例和变量。

Declared ID 目标

使用或接受永久存储机制(如第三方cookies)的设备或浏览器中的Audience Manager与用户ID进行交换和同步。

Declared 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 提供 setVisitorID 的函数中获取 声明的 ID,并将其传递 到Audience Manager

匹配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。

  • Audience Manager 可以在中 declared ID 传递选择退 Audience Manager UUID 出和 URL。
  • declared ID选择退出按合作伙伴存储在Profile Cache Server (PCS)中。 没有使用declared IDs的平台级别选择退出。 此外,Audience Manager会从边缘上的特定区域选择用户退出(选择退出不会跨DCS区域)。

有关选择退出数据收集的更多信息,请参阅数据隐私

Declared ID 选择退出示例

您可以使用d_cidd_cid_ic键值对发出declared ID选择退出请求。 虽然旧版参数(如 d_dpidd_dpuuid)仍然可用,但已考虑将其弃用。请参阅 CID 取代 DPID 和 DPUUID。在示例中,斜体​表示变量占位符。

使用CID和CID_IC选择退出

有关说明和语法,请参阅已声明 ID 的 URL 变量和语法

选择退出请求所用方式 代码示例

数据提供商 ID 和用户 ID。

https://domain name/demoptout.jpg?d_cid=123%01987...

集成代码和用户 ID。

https://domain name/demoptout?d_cid_ic=456%01321...

多个 d_cid d_cid_ic 键值对。

https://domain name/demoptout?d_cid=123%01987&d_cid_ic=456%01321...

选择退出条件:DPID、DPUUID和UUID(已弃用)

这些方法仍可用,但视为已弃用。 此信息仅供旧版参考之用。 旧版选择退出包括:

选择退出(已弃用) 代码示例

d_uuid

https://domain/demoptout.jpg?d_uuid=AAM ID

合作伙伴级别的选择退出

https://demoptout.jpg?d_dpuuid= user ID&d_dpid= data provider ID

将存储合作伙伴级别的选择退出,以便将此 dpid + dpuuid 对的最新映射到AAM UUID。 如果之前没有现有映射,则Audience Manager会检查请求在Cookie中是否包含AAM UUID,如果包含,则会使用该UUID来存储选择退出。 否则,Audience Manager会生成一个新的AAM UUID,并将选择退出存储在该UUID下。

d_dpuuid + d_dpid 和显式 d_uuid

https://domain/demoptout.jpg?d_uuid= user ID&d_dpuuid= data provider's user ID&d_dpid=data provider ID

d_uuid 始终优先。如果 dpid + dpuuid 组合映射到其他AAM UUID,则选择退出会存储在请求中传递的AAM UUID( d_uuid )下。

Declared IDs的变量和语法

下表列出了在Audience Manager数据提供程序ID和用户ID或集成代码(如果使用)中传递的键值对。 请注意, 斜体​表示变量占位符。 添加了空格,以便更便于阅读。

在每个键值对中:

  • =符号将键值与其相关值分隔开。
  • 非打印的ASCII字符%01用于分隔值。
变量 描述

d_cid =data provider ID %01user ID

在单个键值对中包含数据提供程序ID和关联的唯一用户ID。 d_cid 替换 d_dpid d_dpuuid ,后者被视为已弃用,但仍受支持。请参阅 CID 取代 DPID 和 DPUUID

d_cid_ic =integration code %01user ID

在单个键值对中包含集成代码和关联的唯一用户ID。 d_cid_ic 替换 d_dpid d_dpuuid ,尽管已弃用但仍受支持。请参阅 CID 取代 DPID 和 DPUUID

事件调用示例

鉴于这些键值对及其所需的语法,您将发起事件调用,如下所示。

事件调用包含 代码示例

数据提供商 ID 和用户 ID。

https://domain name/event?d_cid=123%01987...

集成代码和用户 ID。

https://domain name/event?d_cid_ic=456%01321...

多个 d_cid d_cid_ic 键值对。

https://domain name/event?d_cid=123%01987&d_cid_ic=456%01321...

Declared ID 变量

描述用于将declared IDs传递到DIL到Audience Manager.的配置变量

DIL 使用 Adobe Experience Platform Identity Service 传递 Declared IDs

Adobe Experience Platform Identity Service一起使用时,您不再需要使用已弃用的dpiddpuuid变量传入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。

DPID 和 DPUUID

Audience Manager 将和组合的与 DPIDDPUUID 配到我们系统中的相应用户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_dpuuidd_dpid键ID值的代码。

在DIL实例化之后传递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。

在此页面上