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

若要開始，您必須在網站上要用於資料收集的頁面上，設定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_cid和d_cid_ic索引鍵值配對，提出declared ID選擇退出請求。 舊版參數 (例如 d_dpid 和 d_dpuuid) 仍然有效，但被視為已過時。請參閱 CID 取代 DPID 及 DPUUID。在這些範例中，斜體字​代表變數預留位置。

使用CID和CID_IC選擇退出

如需說明和語法，請參閱 URL 變數和宣告 ID 的語法。

選擇退出（包含DPID、DPUUID和UUID）（已廢止）

這些方法仍可運作，但被視為已淘汰。 本資訊僅供舊版使用及參考。 舊版選擇退出包括：

Declared IDs的變數和語法

下表列出傳入Audience Manager資料提供者ID、使用者ID或整合代碼（若有使用）的機碼值組。 注意， 斜體​表示變數預留位置。 已新增空格，讓這些字元更容易閱讀。

在每個機碼值組中：

• =符號將鍵與其相關值分開。
• 非打印的ASCII字元%01分隔值。

事件呼叫範例

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

Declared ID 變數

說明用來傳遞declared IDs至DIL至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。 如果您沒有此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和DPUUID

Audience Manager 會將結合的和 DPID 比 DPUUID 對到系統中的對應使用者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
    }
 });

在DIL實例化之後傳遞ID

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。