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目標/匹配過程:
setVisitorID
函式 Adobe Experience Platform身份服務 然後傳到 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 收到退出請求, 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_cid
和 d_cid_ic
鍵值對。 舊版參數 (例如 d_dpid
和 d_dpuuid
) 仍然有效,但被視為已過時。請參閱 CID 取代 DPID 及 DPUUID。在這些範例中,斜體字 代表變數預留位置。
選擇退出 CID 和 CID_IC
如需說明和語法,請參閱 URL 變數和宣告 ID 的語法。
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_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
d_cid_ic =integration code %01user ID
示例事件調用 sample-event-calls
給定這些key-value對及其所需的語法,您將進行事件調用,如下所示。
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身份服務不用再過門了 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 控制項欄。 您需要管理員權限才能查看此儀表板。 請參閱 管理:核心服務。
已棄用的函式 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
dpuuid
DPID和DPUUID
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
}
});
d_dpuuid
和 d_dpid
按鈕。在以後傳入ID DIL 實例化
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。