Show Menu
主题×

声明的ID

声明的ID的工作方式、设置过程、代码示例和变量。

声明 ID 定位

不使用或接受永久受众机制的设备或浏览器(如第三方Cookie),与存储管理器交换和同步用户ID。

声明ID定位的目的

某些浏览器和大多数移动设备不接受第三方cookie。 这使得很难保留有关站点访客的信息或分配永久ID。 要解决此问题,受众管 DIL 理器允许您通过 declared IDs 事件呼叫。 此外, declared ID 可以充当通用ID,该ID适用于中所有解决方案的同一用户 Experience Cloud。 下表描述了ID定位/匹配过程:
过程 描述
事件呼叫
要正常工作,您需 页面上 的DIL和Adobe Experience Platform Identity Service 代码。 DIL 从Adobe Experience Platform Identity Service提 供的函数获取声 setVisitorID 明的ID,并将 其传递给 受众管理器。
匹配ID
受众管理器尝试在我们的系统中将客户端和访客ID与相应的ID匹配。 如果受众ID不存在,访客管理器将创建新ID并将其与客户端ID和客户ID关联。
注意: 如果您的ID映射到多个受众管理器ID,则使用最新的映射。
返回ID
受众管理器将其同步的ID写入客户端域或应用程序中的第一方cookie(或其他可寻址存储空间)。
后续事件调用
其他事件调用从客户端的域读取受众管理器ID,并将其发送给受众管理器。
要开始,您需要配置ID Experience Cloud 服务, DIL 并在站点上要用于数据收集的页面之间进行配置。 请参 阅DIL创建 和声明ID变量

退出呼叫

该过 declared ID 程将遵守网站访客偏好,根据您的网站选择退出受众管理器定位。 当受众管理器收到退出请求时, JSON 由返 DCS 回的代码包含错误代码171,并显示消息“遇选择退出到标记”,而不是受众管理器用户ID。
  • 受众管理器可以 declared ID 在中与受众管理器一起加入 UUID 选择退出 URL。
  • 退 declared ID 出选项按每个合作伙伴存储在[!UICONTROL用户档案PCS缓存服务器()中。 没有平台级别的退出使用 declared IDs。 此外,受众管理器会选择用户从边缘上的特定区域退出(选择退出不会跨 DCS 区域)。
有关 选择退出数据收 集的更多信息,请参阅数据隐私。

声明的ID退出示例

您可以使 declared ID 用和键值对发出 d_cid 退 d_cid_ic 出请求。 旧参数(如 d_dpid d_dpuuid 仍可用)被视为已弃用。 请参阅 CID 取代 DPID 和 DPUUID 。In the examples, italics indicates a variable placeholder.

使用CID和CID_IC选择退出

有关说明和语法,请参 阅URL变量和Declared ID的语法
使用 代码示例
数据提供程序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。 如果以前没有任何映射,受众管理器将检查请求在cookie中是否包含AAM UUID,如果包含,则使用该AAM UUID存储退出。 否则,受众管理器将生成新的AAM UUID并在其下存储退出。
d_dpuuid + d_dpid 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 下。

声明ID的变量和语法

下表列表了传入数据提供者ID和用户ID或集 Audience Manager 成代码(如果使用)的键值对。 Note, italics indicates a variable placeholder. 已添加空格,使这些内容更易于阅读。
在每个键值对中:
  • 符号 = 将键与其相关值分开。
  • 非打印字 ASCII 符 %01 分隔这些值。
变量 描述
d_cid = data provider ID %01 user ID
在单个键值对中包含数据提供程序ID和关联的唯一用户ID。 d_cid 替换 d_dpid d_dpuuid ,后者被视为已弃用,但仍受支持。 请参阅 CID 取代 DPID 和 DPUUID
d_cid_ic = integration code %01 user 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...

声明的ID变量

描述用于将声明的ID传递给的配置变 DIL 量 Audience Manager.

DIL使用Adobe Experience Platform Identity Service传递声明的ID

与Adobe Experience Platform Identity Service一起使用 ,您不再需要再使用已弃 declared IDs 用的和变 dpid 量进行 dpuuid 传递。 相反,当前版本 DIL 依赖函 visitorService 数从中 declared IDs 的函 setCustomerIDs 数获取 Adobe Experience Platform Identity Service。 For more information, see Customer IDs and Authentication States . 如下所 visitorService 示, DIL.create 您将拨入。
var vDil = DIL.create({
  partner:"partner name",
  visitorService:{
    namespace:"INSERT-MCORG-ID-HERE"
  }
});

在键 namespace 值对中, MCORG 是您的 Experience Cloud 组织ID。 如果您没有此ID,您可以在仪表板的 Administration 部分找到 Experience Cloud 它。 您需要管理员权限才能视图此仪表板。 See Administration: Core Services .

已弃用的函数

使用最新版 DIL 本(6.2+),您无需使用这些键值对即可传入 declared IDs。 这是因为现 DIL 在依赖于上 visitorService 面代码示例中显示的函数。 此函数 declared IDs 来自 Adobe Experience Platform Identity Service。 但是,我们在此引用这些变量以用于历史和传统用途。 有关如何配置以从中获取 DIL.create 的示例,请参 declared ID 阅下面的代 Visitor ID Service码。 下表描述了对象使用的旧变 declaredId 量:
名称 类型 描述
dpid 字符串
由受众管理器分配的数据合作伙伴ID。
dpuuid 字符串
用户的唯一数据提供程序 ID。

DPID DPUUID

受众管理器会比较合并后的用户 DPID ID,并 DPUUID 将其与我们系统中的相应用户ID进行匹配。 如果ID不存在,受众管理器将创建新的用户ID并将其同步到组 DPID/DPUUID 合。 受众管理器匹配或创建用户ID( UUID 即)后,会在响 JSON 应客户端域(第一方cookie)或其他本地存储中的cookie时返回该ID。
使用v6.1或更早版本时 DIL 调用此函数。 但是,已弃用此函数,而改用从中获取的 declared IDs 新版本 Adobe Experience Platform Identity Service。
DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });

注意,您需要以编程方式开发提供和键ID值 d_dpuuid 的代 d_dpid 码。

在DIL实例化后传入ID

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

请求/响应示例

请求会向受众管理器发送数据提供程序和用户ID:
https://my_domain.net/event?d_rtbd=json&d_cb=myCallback&key=val&d_dpuuid=1234&d_dpid=5678

该响应返回写入到页面域的第 UUID 一方cookie的受众管理器ID(例如)。
myCallback({
...
   "uuid":"abc123"
})

不目标和选择退出呼叫

该过 declared ID 程将遵守网站访客偏好,根据您的网站选择退出受众管理器定位。 当受众管理器收到退出请求时,将返 DCS 回一个空 JSON 对象而不是受众管理器用户ID。