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目標定位/比對程式:
setVisitorID
获取 声明的 id ,并将其传递到 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 選擇退出會儲存在 Profile Cache Server (PCS)依每個合作夥伴而定。 使用的平台層級沒有選擇退出 declared IDs. 此外, Audience Manager 將使用者從邊緣上的特定區域選擇退出(選擇退出不會超過 DCS 區域)。
另請參閱 資料隱私權 以取得選擇退出資料收集的詳細資訊。
Declared ID 選擇退出範例 opt-out-examples
您可以建立 declared ID 使用的選擇退出請求 d_cid
和 d_cid_ic
機碼值組。 虽然旧版参数(如 d_dpid
和 d_dpuuid
)仍然可用,但已考虑将其弃用。请参阅 CID 取代 DPID 和 DPUUID。在示例中,斜体 表示变量占位符。
CID选择禁用和CID_IC
有关说明和语法,请参阅已声明 ID 的 URL 变量和语法。
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
配對至AAM UUID。 如果沒有先前存在的對應,Audience Manager會檢查要求是否在Cookie中包含AAM UUID,如果包含,會使用該UUID儲存選擇退出。 否則,Audience Manager會產生新的AAM UUID並在其下儲存選擇退出。
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,则选择禁用会存储在请求( d_uuid
)中传递的 AAM UUID 下。
的变量和语法 Declared IDs variables-and-syntax
下表列出了在数据提供程序 ID 中 Audience Manager 传递的键值对,以及用户 id 或集成代码(如果使用)。 注意, 斜体 表示变量占位符。 添加了空格以使其更易于阅读。
在每个键值对中:
- 此
=
符號會將金鑰與其相關值分開。 - 非列印 ASCII 字元
%01
分隔值。
d_cid =data provider ID %01user ID
d_cid_ic =integration code %01user ID
範例事件呼叫 sample-event-calls
根據這些機碼值組及其必要的語法,您可以進行事件呼叫,如下所示。
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.
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
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
}
});
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。