Show Menu
主題×

宣告的ID

宣告的ID如何運作、設定程式、程式碼範例和變數。

宣告的 ID 定位

從不使用或接受永久儲存機制(例如協力廠商Cookie)的裝置或瀏覽器,將使用者ID與Audience Manager交換及同步化。

宣告ID定位的目的

某些瀏覽器和大部分行動裝置不接受協力廠商Cookie。 因此,很難保留網站訪客的相關資訊或指派永久性ID。 若要解決此問題,Audience Manager會 DIL 讓您在事件呼叫 declared IDs 時傳入。 此外, declared ID 您也可以使用通用ID,在中的所有解決方案中套用至相同的使用者 Experience Cloud。 下表說明ID定位/符合程式:
程序 說明
事件呼叫
若要運作,您需 要DIL 頁面上的Adobe Experience Platform Identity Service 程式碼。 DIL從 Adobe Experience Platform Identity Service提供的函式取得宣告的ID ,並將 setVisitorID 其傳遞至 Audience Manager。
符合ID
Audience Manager會嘗試將用戶端和訪客ID與我們系統中的對應ID相符。 如果相符的ID不存在,Audience Manager會建立新的ID,並將其與用戶端和訪客ID關聯。
注意: 如果您的ID對應至多個Audience Manager ID,則會使用最新的對應。
傳回ID
Audience Manager會將其同步化ID寫入用戶端網域或應用程式中的第一方Cookie(或其他可定址儲存空間)。
後續事件呼叫
其他事件呼叫會從用戶端網域讀取Audience Manager ID,並將它傳送至Audience Manager。
若要開始,您必須設定 Experience Cloud ID服務 DIL ,以及您網站上要用於資料收集的頁面。 請參 閱DIL create and Declared ID變數

退出呼叫

此程 declared ID 序會接受網站訪客的偏好設定,以選擇退出Audience Manager並依您的網站進行定位。 當Audience Manager收到退出請求時, JSON 由傳回的 DCS 錯誤碼會包含171,並顯示訊息「Encounted opt out tag」,而非Audience Manager使用者ID。
  • Audience Manager可以在 declared ID 的Audience Manager中同時傳入選擇退 UUID 出選項 URL。
  • 退 declared ID 出選項按合作夥伴儲存在[!UICONTROL配置式快取服務PCS器()中。 沒有使用平台層級的退出選項 declared IDs。 此外,Audience Manager會從邊緣的特定區域選擇使用者退出(退出不會跨越區 DCS 域)。
如需 退出資料收集的詳細資訊 ,請參閱資料隱私權。

宣告的ID選擇退出範例

您可以使 declared ID 用和金鑰值配對 d_cid 提出 d_cid_ic 選擇退出請求。 舊有參數(例如 d_dpid 和) d_dpuuid 仍然有效,但被視為已過時。 請參閱 CID 取代 DPID 及 DPUUID 。In the examples, italics indicates a variable placeholder.

使用CID和CID_IC退出

如需說明和語法,請參 閱URL變數和Declared 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 新對應至AAM UUID。 如果先前沒有現有的對應,Audience Manager會檢查請求中是否包含AAM UUID,如果包含,則會使用該AAM 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 ID的變數和語法

下表列出傳入資料提供者ID和使用者ID或整合 Audience Manager 代碼(如果使用)的金鑰值配對。 Note, italics indicates a variable placeholder. 已新增空格,讓這些字元更容易閱讀。
在每個鍵值對中:
  • 符號 = 會將索引鍵與其相關值分開。
  • 非列印字 ASCII 元 %01 會分隔值。
變數 說明
d_cid = data provider ID %01 user ID
在單一索引鍵值對中包含資料提供者ID和相關聯的唯一使用者ID。 d_cid 取代 d_dpid d_dpuuid ,這些被視為已過時但仍受支援。 請參閱 CID 取代 DPID 及 DPUUID
d_cid_ic = integration code %01 user ID
在單一金鑰值配對中包含整合程式碼和相關聯的唯一使用者ID。 d_cid_ic 取代 d_dpid d_dpuuid (已過時但仍受支援)。 請參閱 CID 取代 DPID 及 DPUUID

範例事件呼叫

若有這些鍵值配對及其必要語法,您會進行下列事件呼叫。
事件呼叫包含 程式碼範例
資料提供者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...

宣告的ID變數

說明將宣告的ID傳遞至的組態變 DIL 數 Audience Manager.

DIL使用Adobe Experience Platform Identity Service傳遞宣告的ID

當與 Adobe Experience Platform Identity Service搭配使用時 ,您不再需要與已過時的 declared IDs 和變數一起 dpid 傳入 dpuuid 。 相反,當前版本的 DIL 依賴函 visitorService 數從中 declared IDs 的函 setCustomerIDs 數中獲取 Adobe Experience Platform Identity Service。 For more information, see Customer IDs and Authentication States . 如下所示, 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 到。 您需要管理員權限才能檢視此控制面板。 See Administration: Core Services .

已過時的函式

有了最新版 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會比較並比對合併後的 DPID DPUUID 我們系統中的對應使用者ID。 如果ID不存在,Audience Manager會建立新的使用者ID並將其同步至組 DPID/DPUUID 合。 一旦Audience Manager符合或建立使用者ID( UUID ),就會在回應用戶端網域(第一方Cookie)或其他本機儲存 JSON 中的Cookie時傳回該ID。
當您使用v6.1或更舊版本時, DIL 請呼叫此函式。 不過,此函式已過時,而改用從中取得的新 declared IDs 版本 Adobe Experience Platform Identity Service。
DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });

請注意,您需要以程式設計方式開發提供和索引鍵ID值 d_dpuuid 的程 d_dpid 式碼。

在DIL實例化後傳入ID

如果您使用不 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

回應會傳回寫入至頁面網域中第一方Cookie的 UUID Audience Manager ID(例如)。
myCallback({
...
   "uuid":"abc123"
})

不定位和選擇退出呼叫

此程 declared ID 序會接受網站訪客的偏好設定,以選擇退出Audience Manager並依您的網站進行定位。 當Audience Manager收到退出請求時,會傳回 DCS 空白物 JSON 件,而非Audience Manager使用者ID。