Declared IDs declared-ids

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

Declared ID 目标 declared-id-targeting

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

Declared ID定位的目的 declared-id-targeting-purpose

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

过程
描述
事件调用
若要使用,您需要DIL和页面上的 Adobe Experience Platform Identity服务代码。 DIL从 Adobe Experience Platform Identity服务提供的 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。 请参阅DIL创建声明的ID变量

选择退出调用 opt-out-calls

declared ID进程遵循网站访客首选项以选择退出由您的网站定位的Audience Manager。 当Audience Manager收到选择退出请求时,DCS返回的JSON包含错误代码171,消息为Encountered opt out tag,而不是Audience Manager用户ID。

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

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

Declared ID个选择退出示例 opt-out-examples

您可以使用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,如果包含,则使用该ID存储选择退出。 否则,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的变量和语法 variables-and-syntax

下表列出了传递您的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

示例事件调用 sample-event-calls

根据这些键值对及其所需语法,您可以进行如下所示的事件调用。

事件调用包括
代码示例
数据提供商 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-id-variables

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

DIL使用Adobe Experience Platform Identity Service传递Declared IDs dil-id-service-pass-declared-ids

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

已弃用的函数 deprecated-functions

对于最新版本的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
    }
 });
NOTE
您需要以编程方式开发用于提供d_dpuuidd_dpid键的ID值的代码。

在DIL实例化后传递ID

NOTE
如果您使用不同的declaredID组合进行API调用,则新组合将仅用于该调用。 进一步的常规事件调用将使用原始DIL.create declaredID组合。
DIL.getDil('partner name').api.signals({...}).declaredId({
  dpuuid : dpuuid
  dpid : dpid
}).submit();

请求/响应示例 request-response-examples

该请求向Audience Manager发送数据提供程序和用户ID:

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"
})

不定位和选择退出调用 do-not-target

declared ID进程遵循网站访客首选项以选择退出由您的网站定位的Audience Manager。 当Audience Manager收到选择退出请求时,DCS返回空的JSON对象,而不是Audience Manager用户ID。

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695