Show Menu
主题×

Declared IDs

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

Declared ID 定位

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

定位目 Declared ID 的

某些浏览器和大多数移动设备不接受第三方 cookies。 这使得很难保留有关站点访客的信息或分配永久ID。 要解决此问题, Audience Manager 请 DIL 使用允许您通过 declared IDs 事件呼叫。 此外, declared ID 可以充当通用ID,该ID适用于中所有解决方案的同一用户 Experience Cloud。 下表描述了ID定位/匹配过程:
过程 描述
事件呼叫
要正常工作,您需 要页 面上的 DIL和 Adobe 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。
要开始,您需要配置ID Experience Cloud 服务, DIL 并在站点上要用于数据收集的页面之间进行配置。 请参 阅DIL创建 和声明ID变量

退出呼叫

该过 declared ID 程将遵守网站访客首选项,以选择 Audience Manager 退出网站定位。 When Audience Manager receives an opt-out request, the JSON returned by the DCS contains the error code 171, with the message Encountered opt out tag , instead of the Audience Manager user ID.
  • Audience Manager 可以在中 declared ID 加入退出选项 Audience Manager 并 UUID 进行退 URL出
  • 退 declared ID 出选项按每个合作伙伴存储在[!UICONTROL用户档案PCS缓存服务器()中。 没有平台级别的退出使用 declared IDs。 此外, Audience Manager 选择用户从边缘上的特定区域退出(选择退出不会跨越 DCS 区域)。
有关 选择退出数据收 集的更多信息,请参阅数据隐私。

Declared ID 退出示例

You can make a declared ID opt-out requests with the d_cid and d_cid_ic key-value pairs. 虽然旧版参数(如 d_dpid d_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,如果包含,则使用该AAM UUID存储退出。 否则,Audience Manager将生成新的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 下。

变量和语法 Declared IDs

下表列表了传入数据提供者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...

Declared ID 变量

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

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

与Adobe Experience Platform标 识服务一起使用 ,您不再需要随已弃用 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 字符串
由Audience Manager分配的数据合作伙伴ID。
dpuuid 字符串
用户的唯一数据提供程序 ID。

DPID 和 DPUUID

Audience Manager 将合并后的用户ID与 DPID 我们 DPUUID 系统中的相应用户ID进行比较和匹配。 如果ID不存在,则创 Audience Manager 建新的用户ID并将其同步到 DPID/DPUUID 组合。 匹 Audience Manager 配或创建用户ID( UUID )后,在响应客户端域(第一方)或其他本地 JSON 存储中 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发送到 Audience Manager:
https://my_domain.net/event?d_rtbd=json&d_cb=myCallback&key=val&d_dpuuid=1234&d_dpid=5678

该响应返回写入到页面域中 UUID 第一方cookie的Audience ManagerID(例如)。
myCallback({
...
   "uuid":"abc123"
})

不目标和选择退出呼叫

该过 declared ID 程将遵守网站访客首选项,以选择 Audience Manager 退出网站定位。 当 Audience Manager 收到退出请求时,将返 DCS 回一个空 JSON 对象而不是 Audience Manager 用户ID。