Declared IDs

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

Declared ID 目标

使用或接受永久存储机制（如第三方cookies）的设备或浏览器中的Audience Manager与用户ID进行交换和同步。

Declared ID定位的用途

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

要开始配置，您需要在网站上要用于数据收集的页面上配置Experience Cloud ID服务和DIL。 请参阅DIL创建和声明的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_cid和d_cid_ic键值对发出declared ID选择退出请求。 虽然旧版参数（如 d_dpid 和 d_dpuuid）仍然可用，但已考虑将其弃用。请参阅 CID 取代 DPID 和 DPUUID。在示例中，斜体​表示变量占位符。

使用CID和CID_IC选择退出

有关说明和语法，请参阅已声明 ID 的 URL 变量和语法。

选择退出条件：DPID、DPUUID和UUID（已弃用）

这些方法仍可用，但视为已弃用。 此信息仅供旧版参考之用。 旧版选择退出包括：

Declared IDs的变量和语法

下表列出了在Audience Manager数据提供程序ID和用户ID或集成代码（如果使用）中传递的键值对。 请注意， 斜体​表示变量占位符。 添加了空格，以便更便于阅读。

在每个键值对中：

• =符号将键值与其相关值分隔开。
• 非打印的ASCII字符%01用于分隔值。

事件调用示例

鉴于这些键值对及其所需的语法，您将发起事件调用，如下所示。

Declared ID 变量

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

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

与Adobe Experience Platform Identity Service一起使用时，您不再需要使用已弃用的dpid和dpuuid变量传入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部分找到此ID。 您需要管理员权限才能查看此功能板。 请参阅管理：核心服务。

已弃用的函数

对于最新版本的DIL (6.2+)，您无需使用这些键值对即可传入declared IDs。 这是因为DIL现在依赖于上述代码示例中显示的visitorService函数。 此函数从Adobe Experience Platform Identity Service获取declared IDs。 但是，我们在此处将引用这些变量以用于历史和旧版目的。 有关如何配置DIL.create以从Visitor ID Service获取declared ID的示例，请参阅以下代码。
下表描述了declaredId对象使用的旧版变量：

DPID 和 DPUUID

Audience Manager 将和组合的与 DPID 匹 DPUUID 配到我们系统中的相应用户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
    }
 });

在DIL实例化之后传递ID

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

响应会返回Audience ManagerID（例如UUID），该ID会写入页面域中的第一方Cookie。

myCallback({
...
   "uuid":"abc123"
})

不定位和选择退出调用

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