文件 Audience Manager Audience Manager 使用手冊

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，則會使用最近一次對應。
傳回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使用者識別碼。

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_uuid https://domain/demoptout.jpg?d_uuid=AAM ID

合作夥伴層級選擇退出

選擇退出（已棄用）	程式碼範例
僅 `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，則選擇退出會儲存在請求中傳遞的AAM UUID下( `d_uuid` )。

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

recommendation-more-help