您可以在網站上存取發布商第一方 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
和 __gpi
Cookie 目前的有效期限上限為 13 個月,除非瀏覽器限制會提早刪除 Cookie (例如 Safari ITP 會限制 JavaScript 設定的 Cookie)。如果 Cookie 遭到清除,Google 會在獲得許可後,嘗試重新填入新值。
除了 __gpi
和 __gpi
之外,Cookie jar 也可能包含使用者選擇停用 Cookie __gpi
。如果值為 1,表示使用者已停用該網域上的 Google Ads 個人化功能 (透過 Google 的廣告選項控制項)。
存取這些 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」。