您可以存取網站的發布商第一方 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 關聯的使用者資料
發布商可以要求刪除與特定第一方 ID 關聯的使用者資料。您可以使用資料刪除 API，對單一 ID 提交要求，有兩種做法，且第一個選項支援 IAB 資料刪除要求架構。
選項 1 (支援 IAB 資料刪除要求架構)
dsrdelete.json 檔案的代管網域資料。提交要求
必要屬性
請參閱下表，瞭解資料刪除要求的必要屬性。如需參數、程式碼範例和其他規定的完整詳細資料，請參閱 IAB 資料刪除要求架構。
| 屬性 | 說明 | 範例值 |
|---|---|---|
| sub.identifierType | ID 類型 | pfpid_domain |
| sub.identifierValue | 您要求刪除資料的 ID | 0000128ff97be809 |
| sub.identifierFormat | 使用者 ID 格式 | plaintext |
選項 2 (已淘汰)
如果要求刪除與特定 __gpi 的 UID 元件關聯的資料，發布商應以下列格式傳送 HTTPS 要求：
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
預期的回應
如果這三個參數都存在且具備有效值，則會傳回 HTTPS 回應狀態碼「200」，表示要求成功：
- 「id」值是 16 個字元的十六進制值。
- 「iu」值是有效的 Ad Manager 聯播網代碼。
- 「idtype」值應為「sco」，代表這是網站上發布商的第一方 ID。
如果要求的格式不正確，則會傳回 HTTPS 回應狀態碼「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 |