您可以访问适用于网站的发布商第一方 ID,并删除关联的广告定位数据。
在网站上访问发布商第一方 ID
您可以直接通过在发布商网域下设置第一方 Cookie 的 JavaScript 访问网站上的发布商第一方 ID。__gpi
Cookie 中包含供发布商和合作伙伴在外部使用的 ID。另一个 Cookie(名为 __gads
)并非供发布商或合作伙伴在外部使用,也不允许用于个性化用途。
__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 的创建时间戳。
另外两个组成部分是内部实现细节,可能会发生变化,不应依赖于它们。
__gpi
和 __gpi
Cookie 目前的最大有效期均为 13 个月,除非浏览器限制会更早清除 Cookie(例如 Safari ITP 对 JavaScript 设置的 Cookie 的限制)。如果 Cookie 被清除,Google 会在允许的情况下尝试使用新值重新填充该 Cookie。
除了 __gpi
和 __gpi
之外,Cookie Jar 可能还包含用户停用 Cookie __gpi
。如果其值为 1,则表示用户已停用在该网域上针对 Google 广告使用个性化功能(通过 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”。