Declared IDs

declared IDs如何運作、設定程式、程式碼範例和變數。

Declared ID 定位

從不使用或接受永久性儲存機制的裝置或瀏覽器(例如第三方cookies),將使用者ID與Audience Manager交換並同步。

Declared ID目標定位的用途

某些瀏覽器和大部分行動裝置不接受第三方cookies。 這使得您很難保留網站訪客的相關資訊或指派永久性ID。 若要解決此問題,Audience Manager使用DIL,讓您在事件呼叫時傳入declared IDs。 此外,declared ID也可當作適用於Experience Cloud中所有解決方案的相同使用者的通用ID。 下表說明ID目標定位/比對程式:

程序 說明
事件呼叫

若要運作,您需要頁面上的DIL Adobe Experience Platform Identity Service 程式碼。 DIL 會從 Adobe Experience Platform Identity Service提 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變數

退出呼叫

declared ID程式會依照網站訪客的偏好設定,選擇退出您的網站所定位的Audience Manager。 當Audience Manager收到選擇退出請求時,DCS返回的JSON包含錯誤代碼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 退出範例

您可以使用d_cidd_cid_ic索引鍵值配對,提出declared ID選擇退出請求。 舊版參數 (例如 d_dpidd_dpuuid) 仍然有效,但被視為已過時。請參閱 CID 取代 DPID 及 DPUUID。在這些範例中,斜體字​代表變數預留位置。

使用CID和CID_IC選擇退出

如需說明和語法,請參閱 URL 變數和宣告 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,如果包含,則會使用該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,則選擇退出會儲存在傳入要求的AAM UUID下( d_uuid )。

Declared IDs的變數和語法

下表列出傳入Audience Manager資料提供者ID、使用者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

事件呼叫範例

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

事件呼叫包括 程式碼範例

資料提供者 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 IDs至DIL至Audience Manager.的設定變數

DIL 使用 Adobe Experience Platform Identity Service 來傳遞 Declared IDs

Adobe Experience Platform Identity Service搭配使用時,您不再需要使用已棄用的dpiddpuuid變數傳入declared IDs。 相反地,當前版本的DIL依賴於visitorService函式從Adobe Experience Platform Identity Service中的setCustomerIDs函式獲取declared IDs。 如需詳細資訊,請參閱客戶ID和驗證狀態。 您可以呼叫DIL.create中的visitorService,如下所示。

var vDil = DIL.create({
  partner:"partner name",
  visitorService:{
    namespace:"INSERT-MCORG-ID-HERE"
  }
});

namespace機碼值組中,MCORG是您的Experience Cloud組織ID。 如果您沒有此ID,可以在Experience Cloud控制面板的Administration區段中找到。 您需要管理員權限才能檢視此控制面板。 請參閱管理:核心服務

已棄用的函式

若使用最新版本的DIL (6.2+),您不需要使用這些機碼值組來傳遞declared IDs。 這是因為DIL現在仰賴上述程式碼範例中顯示的visitorService函式。 此函式從Adobe Experience Platform Identity Service獲取declared IDs。 不過,我們會在這裡參照這些變數,以用於歷史和舊版用途。 如需如何設定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響應中返回該ID,以響應客戶端域(第一方cookie)或其他本地儲存。cookie

當您使用DIL v6.1或更舊版本時,請呼叫此函式。 不過,此函式已遭取代,改用從Adobe Experience Platform Identity Service取得declared IDs的新版本。

DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });
注意

您需要以程式設計方式開發提供d_dpuuidd_dpid鍵ID值的程式碼。

在DIL實例化之後傳遞ID

注意

如果您使用不同的declaredID組合進行API呼叫,則新組合將僅用於該呼叫。 進一步的一般事件呼叫將使用原始的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的Audience ManagerID(例如UUID)。

myCallback({
...
   "uuid":"abc123"
})

請勿鎖定目標和選擇退出呼叫

declared ID程式會依照網站訪客的偏好設定,選擇退出您的網站所定位的Audience Manager。 當Audience Manager收到選擇退出請求時, DCS會傳回空的JSON物件,而非Audience Manager使用者ID。

本頁內容