Declared IDs declared-ids

如何 declared IDs 工作、設定程式、程式碼範例和變數。

Declared ID 目标 declared-id-targeting

與交換及同步使用者ID Audience Manager 來自未使用或接受永久儲存機制的裝置或瀏覽器，例如協力廠商 cookies.

用途 Declared ID 目標定位 declared-id-targeting-purpose

有些瀏覽器和大部分行動裝置不接受協力廠商 cookies. 這使得保留有關網站訪客的資訊或指派永久ID變得困難。 若要解決此問題， Audience Manager 使用 DIL 讓您傳入 declared IDs 事件呼叫時。 此外， declared ID 可作為通用ID，套用至中所有解決方案的相同使用者。 Experience Cloud. 下表說明ID目標定位/比對程式：

若要開始使用，您需要設定 Experience Cloud ID服務與 DIL 橫跨您要用於資料收集的網站頁面。 另請參閱 DIL建立 和 宣告ID變數.

選擇退出呼叫 opt-out-calls

此 declared ID 程式會遵循網站訪客選擇退出的偏好設定 Audience Manager 依您的網站鎖定目標。 時間 Audience Manager 會收到選擇退出請求， JSON 傳回 DCS 包含錯誤代碼171，並出現訊息 Encountered opt out tag，而非 Audience Manager 使用者ID。

另請參閱 資料隱私權 以取得選擇退出資料收集的詳細資訊。

Declared ID 選擇退出範例 opt-out-examples

您可以建立 declared ID 使用的選擇退出請求 d_cid 和 d_cid_ic 機碼值組。 虽然旧版参数（如 d_dpid 和 d_dpuuid）仍然可用，但已考虑将其弃用。请参阅 CID 取代 DPID 和 DPUUID。在示例中，斜体 ​表示变量占位符。

CID选择禁用和CID_IC

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

選擇退出，透過 DPID， DPUUID、和 UUID （已棄用）

這些方法仍然有效，但被視為已過時。 此資訊僅供舊版參考之用。 舊版選擇退出包括：

的变量和语法 Declared IDs variables-and-syntax

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

在每个键值对中：

範例事件呼叫 sample-event-calls

根據這些機碼值組及其必要的語法，您可以進行事件呼叫，如下所示。

Declared ID 变量 declared-id-variables

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

DILAdobe Experience Platform Identity Service使用来传递Declared IDs dil-id-service-pass-declared-ids

与 Adobe Experience Platform Identity 服务一起使用时，您不再需要与已弃用 dpid 的和 dpuuid 变量一起传递 declared IDs 。而是依赖于函数的当前版本 DIL 从 setCustomerIDs 获取 declared IDs 函数 Adobe Experience Platform Identity Service 。 visitorService有关详细信息，请参阅 客户 id 和 Authentication 状态。 您可以按如下所示进行调用 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 找到它。 您需要管理員許可權才能檢視此儀表板。 另請參閱 管理：核心服務.

已棄用的函式 deprecated-functions

使用最新版本的 DIL (6.2+)，您不需要使用這些機碼值組來傳入 declared IDs. 這是因為 DIL 現在仰賴 visitorService 函式如上述程式碼範例所示。 此函式取得 declared IDs 從 Adobe Experience Platform Identity Service. 不過，我們在此參考這些變數，是為了歷史記錄和舊版用途。 请参阅下面的代码，以了解有关如何配置 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)它會傳回 JSON 對的回應 cookie 在使用者端的網域中（第一方） cookie)或其他本機儲存空間。

使用時呼叫此函式 DIL v6.1或更早版本。 但是，此函数已被弃用，取而代之的是从 Adobe Experience Platform Identity Service 获取 declared IDs 的新版本。

DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });

在以下時間後傳遞ID： DIL 具現化

DIL.getDil('partner name').api.signals({...}).declaredId({
  dpuuid : dpuuid
  dpid : dpid
}).submit();

請求/回應範例 request-response-examples

該請求會將資料提供者和使用者ID傳送至 Audience Manager：

https://my_domain.net/event?d_rtbd=json&d_cb=myCallback&key=val&d_dpuuid=1234&d_dpid=5678

回應會傳回Audience ManagerID (例如 UUID)，會寫入頁面網域中的第一方Cookie。

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

不要鎖定和選擇退出呼叫 do-not-target

此 declared ID 程式會遵循網站訪客選擇退出的偏好設定 Audience Manager 依您的網站鎖定目標。 時間 Audience Manager 會收到選擇退出請求， DCS 傳回空白 JSON 物件而非 Audience Manager 使用者ID。