Declared IDs

最後更新： 2024年7月20日
  • 主題：

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

Declared ID 定位

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

Declared ID目標定位的用途

某些瀏覽器和大多數行動裝置不接受協力廠商cookies。 這使得保留有關網站訪客的資訊或指派永久ID變得困難。 為解決此問題，Audience Manager使用DIL讓您在事件呼叫中傳入declared IDs。 此外，declared ID可作為通用ID，套用至Experience Cloud中所有解決方案的相同使用者。 下表說明ID目標定位/比對程式：

程序說明
事件呼叫若要運作，您需要在頁面上使用DIL和 Adobe Experience Platform Identity服務程式碼。 DIL從 Adobe Experience Platform Identity Service 提供的 setVisitorID 函式中取得個宣告識別碼，並將其傳遞至Audience Manager。
符合ID

Audience Manager會嘗試將使用者端和訪客ID與系統中的對應ID比對。 如果相符的ID不存在，Audience Manager會建立新的ID，並將其與客戶端和訪客ID建立關聯。

注意：如果您的ID對應至多個Audience ManagerID，則會使用最近一次對應。

傳回IDAudience 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使用者識別碼。

  • Audience Manager可以與URL中的Audience Manager UUID一起傳入declared ID選擇退出。
  • declared ID選擇退出會依每個合作夥伴儲存在Profile Cache Server (PCS)中。 沒有使用declared IDs的平台層級選擇退出。 此外，Audience Manager會選擇讓使用者退出邊緣上的該特定區域（選擇退出不會跨DCS區域）。

如需選擇退出資料收集的詳細資訊，請參閱資料隱私權。

Declared ID個選擇退出範例

您可以使用d_cid和d_cid_ic機碼值組發出declared ID個選擇退出請求。 舊版參數 (例如 d_dpid 和 d_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_uuidhttps://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，則選擇退出會儲存在請求中傳遞的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 變數

說明用來透過DIL傳遞declared IDs至Audience Manager.的設定變數

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

與Adobe Experience Platform Identity Service搭配使用時，您不再需要以已棄用的dpid和dpuuid變數傳入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，可以在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比較並比對合併的DPID和DPUUID與系統中的對應使用者ID。 如果ID不存在，Audience Manager會建立新的使用者ID並將其同步至DPID/DPUUID組合。 一旦Audience Manager符合或建立使用者ID (UUID)，它就會在使用者端的網域（第一方cookie）或其他本機儲存體中的cookie的JSON回應中傳回該ID。

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

DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });
NOTE
您必須以程式設計方式開發提供d_dpuuid和d_dpid索引鍵識別碼值的程式碼。

在DIL例項化之後傳遞ID

NOTE
如果您使用不同的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使用者識別碼。

Related Articles

有關此主題的更多說明

上一頁全域資料來源
下一頁衍生訊號

Audience Manager