Declared IDs declared-ids

如何 declared IDs 工作、設定過程、代碼示例和變數。

Declared ID 定位 declared-id-targeting

Exchange和同步用戶ID Audience Manager 來自不使用或接受永久儲存機制的設備或瀏覽器,如第三方 cookies。

目的 Declared ID 目標 declared-id-targeting-purpose

某些瀏覽器和大多數移動設備不接受第三方 cookies。 這使得很難保留有關站點訪問者或分配持久ID的資訊。 為瞭解決這個問題, Audience Manager 使用 DIL 讓你過去 declared IDs 在活動電話上。 另外, declared ID 可以充當通用ID,該通用ID適用於位於 Experience Cloud。 下表介紹了ID目標/匹配過程:

程序
說明
事件調用
要工作,你需要 DIL 和 Adobe Experience Platform身份服務頁碼。 DIL 得 聲明的ID 從 setVisitorID 函式 Adobe Experience Platform身份服務 然後傳到 Audience Manager 。
匹配ID

Audience Manager嘗試將客戶端和訪問者ID與系統中的相應ID匹配。 如果不存在匹配的ID,Audience Manager將建立新ID,並將其與客戶端和訪問者ID關聯。

注:如果ID映射到多個Audience ManagerID,則使用最新映射。

返回ID
Audience Manager將其同步的ID寫入客戶端域或應用程式中的第一方cookie(或其他可定址儲存空間)。
後續事件調用
其他事件調用從客戶端的域讀取Audience ManagerID並將其發送到Audience Manager。

要開始,您需要配置 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。

  • Audience Manager 能通過 declared ID 選擇退出 Audience Manager UUID 的 URL。
  • 的 declared ID opt-out儲存在 Profile Cache Server (PCS),按合作夥伴計算。 沒有平台級別的退出選項,使用 declared IDs。 此外, Audience Manager 從邊緣上的特定區域選擇用戶(opt-out不交叉) DCS 區域)。

請參閱 資料隱私 的子菜單。

Declared ID 退出示例 opt-out-examples

你可以 declared ID 帶有 d_cidd_cid_ic 鍵值對。 舊版參數 (例如 d_dpidd_dpuuid) 仍然有效,但被視為已過時。請參閱 CID 取代 DPID 及 DPUUID。在這些範例中,斜體字 ​代表變數預留位置。

選擇退出 CID 和 CID_IC

如需說明和語法,請參閱 URL 變數和宣告 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 與UUIDAAM對。 如果以前沒有映射,則Audience Manager會檢查請求是否在Cookie中包含AAMUUID,如果包含,則使用該UUID儲存opt-out。 否則,Audience Manager將生AAM成新的UUID並將opt-out儲存在其下。

d_dpuuid + d_dpid 明確 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,opt-out儲存在AAM請求中傳遞的UUID下( d_uuid )。

的變數和語法 Declared IDs variables-and-syntax

下表列出了傳入的鍵值對 Audience Manager 資料提供程式ID和用戶ID或整合代碼(如果使用)。 注意, 斜體 指示變數佔位符。 已添加空格,以便更容易閱讀。

在每個鍵值對中:

  • = 符號將鍵與其相關值分開。
  • 非打印 ASCII 字元 %01 將值分開。
變數
說明
d_cid =data provider ID %01user ID
包含單個鍵值對中的資料提供程式ID和關聯的唯一用戶ID。 d_cid 替換 d_dpid d_dpuuid ,它被視為已棄用,但仍受支援。 請參閱 CID 取代 DPID 及 DPUUID
d_cid_ic =integration code %01user ID
包含單個鍵值對中的整合代碼和關聯的唯一用戶ID。 d_cid_ic 替換 d_dpid d_dpuuid ,已棄用,但仍受支援。 請參閱 CID 取代 DPID 及 DPUUID

示例事件調用 sample-event-calls

給定這些key-value對及其所需的語法,您將進行事件調用,如下所示。

事件呼叫包括
程式碼範例
資料提供者 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...

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身份服務不用再過門了 declared IDs 已棄用 dpiddpuuid 變數。 相反, DIL 依靠 visitorService 函式 declared IDs 從 setCustomerIDs 函式 Adobe Experience Platform Identity Service。 有關詳細資訊,請參見 客戶ID和身份驗證狀態。 你會打電話 visitorServiceDIL.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 去 declared ID 從 Visitor ID Service。
下表介紹了 declaredId 對象:

名稱
類型
說明
dpid
字串
由Audience Manager分配的資料夥伴ID。
dpuuid
字串
資料提供者的使用者唯一 ID。

DPID和DPUUID

Audience Manager 比較和匹配組合 DPIDDPUUID 到系統中相應的用戶ID。 如果ID不存在, Audience Manager 建立新用戶ID並將其與 DPID/DPUUID 的下界。 一次 Audience Manager 匹配或建立用戶ID( UUID)返回 JSON 對 cookie 在客戶端域(第一方) cookie)或其他本地儲存。

使用 DIL v6.1或更低版本。 但是,此函式已被棄用,取而代之的是 declared IDs 從 Adobe Experience Platform Identity Service。

DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });
NOTE
您需要以寫程式方式開發提供ID值的代碼 d_dpuuidd_dpid 按鈕。

在以後傳入ID DIL 實例化

NOTE
如果你 API 用不同的 declaredID 組合,新組合將僅用於該呼叫。 更多常規事件調用將使用 DIL.create declaredID 的下界。
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。

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695