访问发布商第一方 ID 并删除关联的用户数据

您可以访问适用于网站的发布商第一方 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”。

该内容对您有帮助吗?

您有什么改进建议?
搜索
清除搜索内容
关闭搜索框
主菜单
5613876553703515230
true
搜索支持中心
true
true
true
true
true
148
false
false