如何 declared IDs 工作、設定過程、代碼示例和變數。
Exchange和同步用戶ID Audience Manager 來自不使用或接受永久儲存機制的設備或瀏覽器,如第三方 cookies。
某些瀏覽器和大多數移動設備不接受第三方 cookies。 這使得很難保留有關站點訪問者或分配持久ID的資訊。 為瞭解決這個問題, Audience Manager 使用 DIL 讓你過去 declared IDs 在活動電話上。 另外, declared ID 可以充當通用ID,該通用ID適用於位於 Experience Cloud。 下表介紹了ID目標/匹配過程:
程序 | 說明 |
---|---|
事件調用 | 要工作,你需要 DIL 和 Adobe Experience Platform身份服務 頁碼。 DIL 得 聲明的ID 從 |
匹配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。
請參閱 資料隱私 的子菜單。
你可以 declared ID 帶有 d_cid
和 d_cid_ic
鍵值對。 舊版參數 (例如 d_dpid
和 d_dpuuid
) 仍然有效,但被視為已過時。請參閱 CID 取代 DPID 及 DPUUID。在這些範例中,斜體字代表變數預留位置。
如需說明和語法,請參閱 URL 變數和宣告 ID 的語法。
使用以下項目執行選擇退出 | 程式碼範例 |
---|---|
資料提供者 ID 和使用者 ID。 |
|
整合程式碼和使用者 ID。 |
|
多重 |
|
這些方法仍然有效,但被視為已棄用。 此資訊供傳統用途和參考。 舊有選擇退出包括:
選擇退出(不建議使用) | 程式碼範例 |
---|---|
|
|
合作夥伴級別選擇退出 |
儲存合作夥伴級別的退出選項,以獲取此項的最新映射 |
|
|
下表列出了傳入的鍵值對 Audience Manager 資料提供程式ID和用戶ID或整合代碼(如果使用)。 注意, 斜體 指示變數佔位符。 已添加空格,以便更容易閱讀。
在每個鍵值對中:
=
符號將鍵與其相關值分開。%01
將值分開。變數 | 說明 |
---|---|
|
包含單個鍵值對中的資料提供程式ID和關聯的唯一用戶ID。 |
|
包含單個鍵值對中的整合代碼和關聯的唯一用戶ID。 |
給定這些key-value對及其所需的語法,您將進行事件調用,如下所示。
事件呼叫包括 | 程式碼範例 |
---|---|
資料提供者 ID 和使用者 ID。 |
|
整合程式碼和使用者 ID。 |
|
多重 |
|
描述用於傳遞的配置變數 declared IDs 通 DIL 至 Audience Manager.
與 Adobe Experience Platform身份服務不用再過門了 declared IDs 已棄用 dpid
和 dpuuid
變數。 相反, DIL 依靠 visitorService
函式 declared IDs 從 setCustomerIDs
函式 Adobe Experience Platform Identity Service。 有關詳細資訊,請參見 客戶ID和身份驗證狀態。 你會打電話 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 控制項欄。 您需要管理員權限才能查看此儀表板。 請參閱 管理:核心服務。
使用 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。 |
Audience Manager 比較和匹配組合 DPID
和 DPUUID
到系統中相應的用戶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_dpuuid
和 d_dpid
按鈕。
如果你 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。