Declared IDs

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

Declared ID 定位

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

定位目 Declared ID 標

某些瀏覽器和大部分行動裝置不接受協力廠商 cookies。 因此，很難保留網站訪客的相關資訊或指派永久性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 退出您的網站定位。 When Audience Manager receives an opt-out request, the JSON returned by the DCS contains the error code 171, with the message Encountered opt out tag, instead of the Audience Manager user ID.

• Audience Manager 可以傳入 declared ID 退出選項旁 Audience Manager 邊的 UUID​URL。
• 退 declared ID 出選項會依每個 Profile Cache Server 合作伙PCS伴儲存在()中。 沒有使用平台層級的退出選項 declared IDs。 此外， Audience Manager 選擇使用者離開邊緣上的特定區域(選擇退出不跨越區 DCS 域)。

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

Declared ID 退出範例

You can make a declared ID opt-out requests with the d_cid and d_cid_ic key-value pairs. 舊版參數 (例如 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
合作夥伴層級選擇退出	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 IDs

下表列出傳入資料提供者ID和使用者ID或整合 Audience Manager 代碼（如果使用）的金鑰值配對。 Note, italics indicates a variable placeholder. 已新增空格，讓這些字元更容易閱讀。

在每個鍵值對中：

• 符號 = 會將索引鍵與其相關值分開。
• 非列印字 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搭配使用時，您不再需要與已過時的 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。 如果ID不存在，請 Audience Manager 建立新的使用者ID並將其同步至 DPID/DPUUID 組合。 匹 Audience Manager 配或建立用戶ID( UUID)後，在響應客戶端的域(第一方 JSON​cookie​cookie)或其他本地儲存時返回該ID。

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

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的 UUIDAudience Manager ID（例如）。

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

不定位和選擇退出呼叫

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