Declared IDs

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

Declared ID 定位

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

Declared ID定位的用途

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

要开始，您需要在要用于数据收集的站点的各个页面中配置Experience Cloud ID服务和DIL。 请参阅DILcreate和声明的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 to Pass Declared IDs

当与Adobe Experience Platform身份服务一起使用时，您不再需要使用已弃用的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部分找到它。 您需要管理员权限才能视图此仪表板。 请参阅管理：核心服务。

已弃用函数

对于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 将合并后的用户ID DPID 与我 DPUUID 们系统中的相应用户ID进行比较和匹配。如果ID不存在，Audience Manager将创建新的用户ID并将其同步到DPID/DPUUID组合。 在Audience Manager匹配或创建用户ID(UUID)后，它会在JSON响应中返回该ID，以响应客户端域（第一方cookie）或其他本地存储。cookie

使用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();

请求／响应示例

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

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

不目标和退出调用

declared ID流程接受网站访客偏好，选择退出网站的Audience Manager定位。 当Audience Manager收到退出请求时，DCS返回空的JSON对象，而不是Audience Manager用户ID。