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。

On this page

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now