Declared IDs

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

Declared ID 定位

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

Declared ID定位的用途

某些浏览器和大多数移动设备不接受第三方cookies。 这使得很难保留有关站点访客的信息或分配永久ID。 要解决此问题,Audience Manager使用DIL让您在事件调用中传入declared IDs。 此外,declared ID可以充当适用于Experience Cloud中所有解决方案的同一用户的通用ID。 下表描述了ID定位/匹配过程:

过程 描述
事件呼叫

要使用,您需要页面上的DILAdobe Experience Platform标识服务代码。 DIL Adobe Experience Platform身份服 setVisitorID 务提供的 函数获取声 明的ID,并 将其传递给 Audience Manager。

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

  • 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,如果包含,则使用它存储退出。 否则,Audience Manager将生成新的AAM UUID并在其下存储退出。

d_dpuuid + d_dpid and explicit 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 replace d_dpid d_dpuuid ,它们被视为已弃用,但仍受支持。请参阅 CID 取代 DPID 和 DPUUID

d_cid_ic =integration code %01user ID

在单个键值对中包含集成代码和关联的唯一用户ID。 d_cid_ic replace 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 to Pass Declared IDs

当与Adobe Experience Platform身份服务一起使用时,您不再需要使用已弃用的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部分找到它。 您需要管理员权限才能视图此仪表板。 请参阅管理:核心服务

已弃用函数

对于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 将合并后的用户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_dpuuidd_dpid键ID值的代码。

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

在此页面上

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free