Declared IDs

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

Declared ID 定位

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

目的 Declared ID 目標

某些瀏覽器和大多數移動設備不接受第三方 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變數

選擇退出呼叫

的 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 退出示例

你可以 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

下表列出了傳入的鍵值對 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

示例事件調用

給定這些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 IDs 通 DIL 至 Audience Manager.

DIL 使用 Adobe Experience Platform Identity Service 傳遞 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 控制項欄。 您需要管理員權限才能查看此儀表板。 請參閱 管理:核心服務

已棄用的函式

使用 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
    }
 });
注意

您需要以寫程式方式開發提供ID值的代碼 d_dpuuidd_dpid 按鈕。

在以後傳入ID DIL 實例化

注意

如果你 API 用不同的 declaredID 組合,新組合將僅用於該呼叫。 更多常規事件調用將使用 DIL.create declaredID 的下界。

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

響應返回Audience ManagerID(例如, UUID),寫入到頁面域的第一方cookie中。

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

不瞄準和選擇退出呼叫

的 declared ID 流程授予站點訪問者首選項以選擇退出 Audience Manager 以你的網站為目標。 當 Audience Manager 收到退出請求, DCS 返回空 JSON 對象而不是 Audience Manager 用戶ID。

本頁內容