Declared IDs declared-ids
declared IDs的工作方式、设置过程、代码示例和变量。
Declared ID 目标 declared-id-targeting
在不使用或接受永久存储机制的设备或浏览器（如第三方cookies）中，将用户ID与Audience Manager交换并同步。
Declared ID定位的目的 declared-id-targeting-purpose
某些浏览器和大多数移动设备不接受第三方cookies。 这使得保留有关网站访客的信息或分配永久ID变得困难。 要解决此问题，Audience Manager使用DIL允许您在事件调用中传入declared IDs。 此外，declared ID可以充当通用ID，在Experience Cloud的所有解决方案中应用于同一用户。 下表介绍了ID定位/匹配过程：
setVisitorID 函数中获取个声明的ID ，并将其传递给Audience Manager。Audience Manager会尝试将客户端和访客ID与系统中的相应ID进行匹配。 如果不存在匹配的ID，Audience Manager会创建一个新ID，并将其与客户端和访客ID关联。
注意：如果您的ID映射到多个Audience ManagerID，则使用最近的映射。
若要开始，您需要在要用于数据收集的网站页面上配置Experience Cloud ID服务和DIL。 请参阅DIL创建和声明的ID变量。
选择退出调用 opt-out-calls
declared ID进程遵循网站访客首选项以选择退出由您的网站定位的Audience Manager。 当Audience Manager收到选择退出请求时，DCS返回的JSON包含错误代码171，消息为Encountered opt out tag，而不是Audience Manager用户ID。
- Audience Manager可以在URL中与Audience Manager UUID一起传递declared ID选择退出。
- declared ID选择退出以每个合作伙伴为基础存储在Profile Cache Server (PCS)中。 没有使用declared IDs的平台级别选择退出。 此外，Audience Manager会从边缘上的该特定区域选择退出用户（选择退出不会跨越DCS区域）。
有关选择退出数据收集的详细信息，请参阅数据隐私。
Declared ID个选择退出示例 opt-out-examples
您可以使用d_cid和d_cid_ic键值对发出declared ID个选择退出请求。 虽然旧版参数（如 d_dpid 和 d_dpuuid）仍然可用，但已考虑将其弃用。请参阅 CID 取代 DPID 和 DPUUID。在示例中，斜体 表示变量占位符。
通过CID和CID_IC选择退出
有关说明和语法，请参阅已声明 ID 的 URL 变量和语法。
https://domain name/demoptout.jpg?d_cid=123%01987...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_uuidhttps://domain/demoptout.jpg?d_uuid=AAM IDhttps://demoptout.jpg?d_dpuuid= user ID&d_dpid= data provider ID
为该 dpid + dpuuid 对到AAM UUID的最新映射存储了合作伙伴级别的选择退出。 如果之前没有映射，则Audience Manager会检查请求在Cookie中是否包含AAM UUID，如果包含，则使用该ID存储选择退出。 否则，Audience Manager会生成一个新的AAM UUID并将选择退出存储在该UUID下。
d_dpuuid + d_dpid 和显式 d_uuidhttps://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的变量和语法 variables-and-syntax
下表列出了传递您的Audience Manager数据提供程序ID和用户ID或集成代码（如果已使用）的键值对。 请注意，斜体 表示变量占位符。 已添加空格以使其更易于阅读。
在每个键值对中：
=符号将键与其相关值分开。- 非打印ASCII字符
%01用于分隔值。
d_cid =data provider ID %01user IDd_cid_ic =integration code %01user ID示例事件调用 sample-event-calls
根据这些键值对及其所需语法，您可以进行如下所示的事件调用。
https://domain name/event?d_cid=123%01987...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-id-variables
描述用于将declared IDs通过DIL传递到Audience Manager.的配置变量
DIL使用Adobe Experience Platform Identity Service传递Declared IDs dil-id-service-pass-declared-ids
与Adobe Experience Platform Identity服务一起使用时，您不再需要通过已弃用的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部分中找到它。 您需要管理员权限才能查看此仪表板。 请参阅管理：核心服务。
已弃用的函数 deprecated-functions
对于最新版本的DIL (6.2+)，您无需使用这些键值对即可传入declared IDs。 这是因为DIL现在依赖于上面代码示例中显示的visitorService函数。 此函数从Adobe Experience Platform Identity Service获取declared IDs。 但是，出于历史和旧版目的，我们在此引用这些变量。 有关如何配置DIL.create以从Visitor ID Service获取declared ID的示例，请参阅下面的代码。
下表描述了declaredId对象使用的旧版变量：
dpiddpuuidDPID 和 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
}
});
d_dpuuid和d_dpid键的ID值的代码。在DIL实例化后传递ID
declaredID组合进行API调用，则新组合将仅用于该调用。 进一步的常规事件调用将使用原始DIL.create declaredID组合。DIL.getDil('partner name').api.signals({...}).declaredId({
dpuuid : dpuuid
dpid : dpid
}).submit();
请求/响应示例 request-response-examples
该请求向Audience Manager发送数据提供程序和用户ID：
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"
})
不定位和选择退出调用 do-not-target
declared ID进程遵循网站访客首选项以选择退出由您的网站定位的Audience Manager。 当Audience Manager收到选择退出请求时，DCS返回空的JSON对象，而不是Audience Manager用户ID。