您可以存取網站的發布商第一方 ID，並刪除關聯的指定廣告目標資料。
存取網站的發布商第一方 ID
您可以直接透過 JavaScript 在發布商網域下設定的第一方 Cookie，存取網站的發布商第一方 ID。__gpi Cookie 內含供發布商和合作夥伴在外部使用的 ID。另一個名為 __gads 的 Cookie 無法供發布商或合作夥伴在外部使用，也不得用於個人化用途。
__gpi Cookie 的值採用以下格式：
UID=<unique_user_ID>:T=<creation_unix_timestamp_in_seconds>:RT=<refresh_unix_timestamp_in_seconds>:S=<google_generated_authenticity_signature>
__gpi 值範例：
UID=00000a1b2c3def45:T=1709171636:RT=1709171636:S=ALNI_Ma_CBr2wmXJhLdNKG9z4FWhjVVIog
只有 ID (UID) 和時間戳記 (T) 元件的值，可供發布商和合作夥伴在外部使用：
- UID 目前是 16 個字元的十六進制字串，但長度日後可能會變動，不應視為固定。
- T 是十進制整數，代表建立 ID 的 Unix 時間戳記。
另外兩個元件是內部導入詳細資料，隨時可能變動，因此不應依賴這兩個元件。
__gpi 和 __gads Cookie 目前最長的有效期限為 13 個月，除非瀏覽器相關限制提早抹除了 Cookie (例如 Safari ITP 會限制 JavaScript 設定的 Cookie)。如果 Cookie 遭到抹除，Google 會在獲得許可後，嘗試重新填入新的值。
除了 __gpi 和 __gads 外，Cookie jar 也可能內含 __gpi_opt_out，供使用者選擇不採用 Cookie。若其值為 1，表示使用者已透過 Google 的廣告選項控制項，在該網域停用 Google Ads 的個人化功能。
存取這些 Cookie 之前，請確認您使用 Cookie 的方式遵守適用管轄區的所有隱私權、資料安全性和資料保護相關法律、指令、法規和規則。
查看用於擷取 ID 的 JavaScript 方法範例
/**
* 傳回發布商第一方 ID 和時間戳記。
* @returns {{UID: string|undefined, T: string|undefined}} 物件
* 包含 UID 和時間戳記字串 (如有)。
*/
function getPublisherFirstPartyIdAndCreationTimestamp() {
// 取得 Cookie 鍵值
const gpiCookie = document.cookie.split('; ').find(cookie => cookie.startsWith('__gpi='));
if (!gpiCookie) {
return {UID: undefined, T: undefined};
}
// 使用規則運算式剖析
const regex_match = gpiCookie.match(/UID=([^:]+):T=([^:]+)/);
if (!regex_match) {
return {UID: undefined, T: undefined};
}
// 傳回擷取的值
return {
UID: regex_match[1],
T: regex_match[2]
};
}
查看用法範例
try {
const parsedValues = getPublisherFirstPartyIdAndCreationTimestamp();
console.log(parsedValues);
console.log(parsedValues['UID']); // ID 的值
console.log(parsedValues['T']); // 建立時間戳記
} catch (error) {
console.error(error.message);
}刪除與網站的發布商第一方 ID 關聯的使用者資料
發布商可以要求從 Google 的內部指定廣告目標儲存系統中，刪除與特定 __gpi 關聯的使用者資料。
如果要求刪除與特定 __gpi 的 UID 元件關聯的資料，發布商應採用以下格式傳送 HTTP 要求：
https://securepubads.g.doubleclick.net/user_data_deletion?id={id_value}&iu={network_code}&idtype=sco
請留意格式中的這些值：
- id 是指 ID 的值。這個值應為 16 個字元的十六進制數字，亦即上述存取方法所擷取的 UID 元件。
- iu 是指發布商的 Ad Manager 聯播網代碼。
- idtype 代表 ID 的類型。如果是網站的發布商第一方 ID，這個值應為「sco」，代表網站範圍的 Cookie。
範例：
https://securepubads.g.doubleclick.net/user_data_deletion?id=123456789012345&iu=12345&idtype=sco
預期的回應
如果這三個參數都存在且具備有效值，系統會傳回 HTTP 回應狀態碼「200」，表示要求成功：
- 「id」值是 16 個字元的十六進制值
- 「iu」值是有效的 Ad Manager 聯播網代碼
- 「idtype」值應為「sco」，代表這是網站的發布商第一方 ID
如果要求的格式不正確，系統會傳回 HTTP 回應狀態碼「400」。
刪除與 IDFV 關聯的使用者資料 (iOS 14 以上版本)
Ad Manager 發布商可以要求刪除與特定供應商 ID (IDFV) 關聯的使用者資料。您可以使用資料刪除 API，針對單一 ID 提交要求。資料刪除 API 需符合 IAB 的資料刪除要求架構。
提交資料刪除要求前，請先與帳戶管理員聯絡，要求將您新增至 IAB 架構的註冊資料庫。您必須提交 dsrdelete.json 檔案的代管網域資料。向 Google 註冊網域後，請建立 dsrdelete.json 檔案，並置於網域根路徑下。如要進一步瞭解 dsrdelete.json 檔案，以及其必填和選填欄位，請參閱 IAB 的說明文件。
提交 IDFV 資料刪除要求
如要提出 IDFV 資料刪除要求，請使用以下網址提出請求：
必要屬性
請參閱下表，瞭解 IDFV 資料刪除要求的必要屬性。如需參數、程式碼範例和其他規定的完整詳細資料，請參閱 IAB 資料刪除要求架構。
| 屬性 | 說明 |
範例值 |
|---|---|---|
| sub.identifierType | ID 類型 | idfv |
| sub.identifierValue | 您要求刪除的 ID | 82e812aa-1972-49ad-aad8-6092387e1275 |
| sub.identifierFormat | 使用者 ID 格式 | plaintext |