Show Menu
主题×

声明的ID

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

声明 ID 定位

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

声明ID定位的目的

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

退出呼叫

该过 declared ID 程支持网站访客偏好,以便根据您的网站选择退出Audience manager定位。 当Audience manager收到退出请求时,由返回的 DCS 包含错误代码171,并显示消息“遇到退出标记”,而不是Audience manager用户ID。
  • Audience manager可以与中的Audience Manager declared ID 一起通过选择退出 UUID 方式 URL。
  • 退 declared ID 出按合作伙伴存储在[!UICONCONTROL配置文件缓存服务器(PCS)中。 没有平台级别的退出使用 declared IDs。 此外,Audience manager还会选择用户从边缘的特定区域退出(选择退出不会跨区域 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。 如果之前没有现有映射,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

声明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使用Experience Cloud ID服务传递声明的ID

Experience Cloud ID服务一起使用时 ,您不再需要传递已弃用 declared IDs 的变量和 dpid dpuuid 量。 相反,当前版本的 DIL 依赖函 visitorService 数从中的函 declared IDs 数 setCustomerIDs 获取该函数 Experience Cloud ID 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 ID。 您需要管理员权限才能查看此功能板。 See Administration: Core Services .

已弃用的函数

使用最新版本 DIL (6.2+),您无需使用这些键值对即可传入 declared IDs。 这是因为现 DIL 在依赖于上面的 visitorService 代码示例中显示的函数。 此函数 declared IDs 来自 Experience Cloud ID 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)或其他本地存储中对Cookie的响应中返回该ID。
使用v6.1或更早版本时, DIL 调用此函数。 但是,已弃用此函数,而改用从中获取的 declared IDs 新版本 Experience Cloud ID 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();

请求/响应示例

此请求会向Audience manager发送数据提供者和用户ID:
https://my_domain.net/event?d_rtbd=json&d_cb=myCallback&key=val&d_dpuuid=1234&d_dpid=5678

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

不定位和退出呼叫

该过 declared ID 程支持网站访客偏好,以便根据您的网站选择退出Audience manager定位。 当Audience manager收到退出请求时,将返 DCS 回空对象而 JSON 非Audience manager用户ID。