Declared IDs declared-ids
declared IDs如何運作、設定程式、程式碼範例和變數。
Declared ID 定位 declared-id-targeting
從不使用或接受永久儲存機制的裝置或瀏覽器（例如協力廠商cookies），將使用者ID與Audience Manager交換及同步。
Declared ID目標定位的用途 declared-id-targeting-purpose
某些瀏覽器和大多數行動裝置不接受協力廠商cookies。 這使得保留有關網站訪客的資訊或指派永久ID變得困難。 為解決此問題，Audience Manager使用DIL讓您在事件呼叫中傳入declared IDs。 此外，declared ID可作為通用ID，套用至Experience Cloud中所有解決方案的相同使用者。 下表說明ID目標定位/比對程式：
setVisitorID 函式中取得個宣告識別碼，並將其傳遞至Audience Manager。Audience Manager會嘗試將使用者端和訪客ID與系統中的對應ID比對。 如果相符的ID不存在，Audience Manager會建立新的ID，並將其與客戶端和訪客ID建立關聯。
注意：如果您的ID對應至多個Audience ManagerID，則會使用最近一次對應。
若要開始使用，您必須在您要用於資料收集的網站頁面上設定Experience Cloud ID服務和DIL。 請參閱DIL建立和宣告ID變數。
選擇退出呼叫 opt-out-calls
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個選擇退出範例 opt-out-examples
您可以使用d_cid和d_cid_ic機碼值組發出declared ID個選擇退出請求。 舊版參數 (例如 d_dpid 和 d_dpuuid) 仍然有效，但被視為已過時。請參閱 CID 取代 DPID 及 DPUUID。在這些範例中，斜體字 代表變數預留位置。
使用CID和CID_IC選擇退出
如需說明和語法，請參閱 URL 變數和宣告 ID 的語法。
https://domain name/demoptout.jpg?d_cid=123%01987...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 IDhttps://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_uuidhttps://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的變數和語法 variables-and-syntax
下表列出傳入您的Audience Manager資料提供者ID和使用者ID或整合程式碼（若已使用）的索引鍵/值組。 請注意，斜體 表示變數預留位置。 已新增空格，讓這些內容更易於閱讀。
在每個機碼值組中：
=符號將金鑰與其相關值分開。- 非列印ASCII字元
%01會分隔值。
d_cid =data provider ID %01user IDd_cid 取代 d_dpid 和 d_dpuuid ，這兩個專案已視為過時，但仍受支援。 請參閱 CID取代DPID及DPUUID。d_cid_ic =integration code %01user ID範例事件呼叫 sample-event-calls
根據這些機碼值組及其必要的語法，您可以進行事件呼叫，如下所示。
https://domain name/event?d_cid=123%01987...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-id-variables
說明用來透過DIL傳遞declared IDs至Audience Manager.的設定變數
DIL使用Adobe Experience Platform Identity Service傳遞Declared IDs dil-id-service-pass-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區段中找到。 您需要管理員許可權才能檢視此儀表板。 請參閱管理：核心服務。
已棄用的函式 deprecated-functions
使用最新版DIL (6.2+)時，您不需要使用這些機碼值組來傳入declared IDs。 這是因為DIL現在依賴以上程式碼範例中顯示的visitorService函式。 此函式從Adobe Experience Platform Identity Service取得declared IDs。 不過，我們在此處參考這些變數，是為了歷史和舊版用途。 如需如何設定DIL.create以從Visitor ID Service取得declared ID的範例，請參閱下列程式碼。
下表說明declaredId物件使用的舊版變數：
dpiddpuuidDPID和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
}
});
d_dpuuid和d_dpid索引鍵識別碼值的程式碼。在DIL例項化之後傳遞ID
declaredID組合進行API呼叫，則新組合將僅用於該呼叫。 進一步的定期事件呼叫將使用原始DIL.create declaredID組合。DIL.getDil('partner name').api.signals({...}).declaredId({
dpuuid : dpuuid
dpid : dpid
}).submit();
請求/回應範例 request-response-examples
要求會將資料提供者和使用者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"
})
不要鎖定和選擇退出呼叫 do-not-target
declared ID程式遵循網站訪客偏好設定，以選擇退出您網站的Audience Manager目標定位。 當Audience Manager收到選擇退出要求時，DCS會傳回空的JSON物件，而非Audience Manager使用者識別碼。