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目標定位/比對程式:

过程
描述
事件呼叫
若要运行,您需要 在页面上 DIL 和 Adobe Experience Platform Identity Service代码。 DIL 从 Adobe Experience Platform Identity 服务 提供 的函数中 setVisitorID 获取 声明的 id ,并将其传递到 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 選擇退出會儲存在 Profile Cache Server (PCS)依每個合作夥伴而定。 使用的平台層級沒有選擇退出 declared IDs. 此外, Audience Manager 將使用者從邊緣上的特定區域選擇退出(選擇退出不會超過 DCS 區域)。

另請參閱 資料隱私權 以取得選擇退出資料收集的詳細資訊。

Declared ID 選擇退出範例 opt-out-examples

您可以建立 declared ID 使用的選擇退出請求 d_cidd_cid_ic 機碼值組。 虽然旧版参数(如 d_dpidd_dpuuid)仍然可用,但已考虑将其弃用。请参阅 CID 取代 DPID 和 DPUUID。在示例中,斜体 ​表示变量占位符。

CID选择禁用和CID_IC

有关说明和语法,请参阅已声明 ID 的 URL 变量和语法

选择退出请求所用方式
代码示例
数据提供商 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 配對至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
包含一个键-值对中的数据提供程序 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

根據這些機碼值組及其必要的語法,您可以進行事件呼叫,如下所示。

事件呼叫包括
代码示例
数据提供商 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.

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
字符串
由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或更早版本。 但是,此函数已被弃用,取而代之的是从 Adobe Experience Platform Identity Service 获取 declared IDs 的新版本。

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