发布商提供的标识符简介

通过发布商提供的标识符 (PPID)，发布商可以向 Google Ad Manager 发送一个标识符，以用于跨设备实现以下功能：控制广告展示频次不超过频次上限、进行受众群细分和受众群体定位、依序轮播广告以及进行其他基于受众群体的广告投放控制。#PPID

跳转到：

• PPID 的运作方式
• 使用第一方数据创建 PPID
• 删除 PPID
• 设置标识符 
• 限制和要求 
• 为程序化交易启用 PPID 
• 在报表中显示有无 PPID 
• 包含多个标识符的请求

PPID 的运作方式

• 向 Ad Manager 发送的标识符必须经过哈希处理或加密，使 Google 无法识别它的含义，而不能是未经处理的个人身份信息。
• 如果 Google 发现某位用户已选择停用个性化广告（例如，使用广告设置、欧盟地区用户意见征求控件或受限的数据处理 (RDP) 设置选择停用），则会停用允许使用 PPID 将广告定位到该用户的网络浏览器的功能。
• 必须为用户提供一种机制来选择停用个性化广告。

• 如果用户选择不再允许发布商使用 PPID 投放广告，或者删除自己的账号，发布商必须立即停止向 Google 发送与此用户关联的 PPID。

使用第一方数据创建 PPID

如果发布商使用受众群体解决方案，则可借助 PPID 根据识别出的用户构建长效且注重隐私保护的细分受众群，而不必依赖第三方 Cookie 或 ID。PPID 可以基于用户的登录信息，也可以基于假名化第一方 Cookie。您首先要确定有哪些可用的第一方数据，以便识别具体用户。

如果您有已登录的用户，可以根据登录数据（例如与特定用户相关联的电子邮件地址或唯一 ID）来创建 PPID。此外，这也有助于您识别在多台设备上登录的同一用户。

如果没有已登录的用户，则可以使用由发布商（通常在服务器端）设置的网域专用第一方 Cookie 或标识符来创建 PPID。为了避免为每个用户会话生成新的 PPID，特定用户在多个会话中应具有持久、一致的假名化标识符。

删除 PPID

如果用户请求发布商删除其用户数据，发布商可向 Ad Manager 发送该用户的数据删除请求，以确保从 Google 的内部存储系统中删除用户数据。

如需请求删除 PPID 数据，发布商应使用以下网址发起请求：

https://securepubads.g.doubleclick.net/user_data_deletion?ppid={user's_PPID}&iu={publisher's_AdManager_network_code}

预期响应

成功的请求会返回 HTTP 响应状态代码“200”。不成功的请求会返回 HTTP 响应状态代码“400”。如果未启用 PPID 数据删除 API，则会返回 HTTP 响应状态代码“404”。

设置标识符

如果您的网站/应用连续 180 天没有发送任何包含给定 PPID 的 Google Ad Manager 广告请求（或受众群体像素请求），则需要重新发送请求，才能使相应 PPID 有效。Google 可能会移除在更短时间内未使用过的 PPID，以便智能地优化 PPID 资源。

Google 发布商代码

对于网站，请使用 PublisherProvidedId 方法：

pubService 的方法详情

pubService.setPublisherProvidedId(identifier)

为发布商提供的 ID 设定值，以用于控制广告展示频次不超过频次上限以及其他基于受众群体的活动。

参数

string 类型的标识符：发布商提供的一个由字母和数字组成的 ID（建议不超过 150 个字符）。

示例

Google 移动广告 SDK

GoogleAdManagerExtras 类中包含 setPublisherProvidedId(string ID) 方法。有关详情，请参阅 Google 移动广告 SDK 文档。

Google IMA SDK

HTML5、iOS 和 Android SDK 提供以下用于设置 PPID 的方法或属性。

• HTML5 - ima.ImaSdkSettings.setPpid()

• iOS - IMASettings.ppid（可变对象属性，并非方法）

• Android - ImaSdkSettings.setPpid()

非 JS 请求（亦称为无代码请求）

使用 /adx 或 /ad+/jump 直接发送到 Google Ad Manager 且需要传递 PPID 的请求必须包含参数 ppid=。

受众群体解决方案像素代码

使用受众群体解决方案像素代码直接向 Google Ad Manager 发出的请求必须包含参数 ppid=。

适用于网站的代码示例

适用于应用的代码示例

限制和要求

如果 PPID 值不满足下文所述要求，我们的系统可能会忽视或舍弃相应的 PPID。

PPID 值必须符合以下条件：

• 只包含字母和数字（[0-9a-zA-Z]、“+”“.’”“=”“/”“_”“-”“$”“,”“{”“}”）或采用 UUID 十六进制表示法 (8-4-4-4-12)。

  示例

  以下是正确 PPID 的示例：

  • 12JD92JD8078S8J29SDOAKC0EF230337
  • 12jd92jd8078s8j29sdoakc0ef230337
  • 12Jd92jD8078s8j29sDoakc0ef230337
  • 123e4567-e89b-12d3-a456-426614174000

  发布商可以在以下工具中使用此正则表达式来检查 PPID 是否正确：
  ^[0-9a-zA-Z+.=\/_\-$,{}]{22,150}$

  工具

  • https://www.regexpal.com/ 
  • https://regex101.com/ 或 
  • https://www.regextester.com/

• 最少包含 22 个字符。

• 最多 150 个字符。

• 经过哈希处理或加密，使 Google 无法识别其含义。

• 如果包含 +、=、/ 或 $，则采用网址编码。

  可在有效 PPID 值中使用的一些字符在添加到网址后具有特殊含义。如果用于混淆标识符的字符集包含 +、=、/ 或 $，您需要先对值进行网址编码，然后再将其插入网址占位符。这与使用 SDK 方法（例如 GPT 的 pubService.setPublisherProvidedId(identifier)）时不同。在该方法中，SDK 会对所提供的值进行网址编码。
  示例

  使用 AES 加密时，您可以对用户 ID 进行混淆处理，得到的 PPID 值为 n6lvihJocabdNhFQqRbBt552lNGh74k7/1kZ2dC0dXk=。值中的 / 和 = 字符必须进行网址编码，然后才能将标识符插入 PPID 网址参数。

   

  经过正确编码的网址参数将变为 ppid=n6lvihJocabdNhFQqRbBt552lNGh74k7%2F1kZ2dC0dXk%3D。

• 仅在可以为多个会话标识用户的情况下发送（例如，可以在多个会话中使用的第一方 Cookie 就可用来生成 PPID）。

请避免更改用于生成 PPID 值的算法，否则会导致各种功能遭到重置，包括频次上限、受众群细分和定位、依序广告轮播以及其他基于受众群体的广告投放功能。

在报表中显示有无 PPID

在 Ad Manager 报告中使用“PPID 状态”维度可查看按包含（“有”值）或不含（“无”值）PPID 的广告请求细分的覆盖率。预订流量和程序化流量都在此维度的适用范围内。

• 使用“PPID 状态”维度可针对程序化流量和预订流量排查 PPID 覆盖率问题。例如，若要了解某些广告资源是否缺少正确的 PPID 配置，您可让系统按广告单元和/或请求类型报告广告请求总数，并依次添加 PPID 状态、为以下任何一项和无过滤条件。
• 用于程序化交易的 PPID 仅适用于第三方标识符不可用时获得的那部分流量。也就是说，它不会对第三方 Cookie 可用时获得的程序化流量造成任何影响。因此，在有 PPID 的情况下分析程序化广告效果时，我们建议您依次选择第三方 ID 状态、为以下任何一项和无过滤条件，以限制对无法使用第三方 Cookie 或设备 ID 的广告请求进行的分析。
• “PPID 状态”维度不能用于准确确定收入影响，但可用于衡量效果。为了更好地了解收入升幅，我们建议发布商自行进行 A/B 测试、考虑不同的广告资源类型以及是否存在第三方标识符。

包含多个标识符的请求

如前所述，PPID 是对 Google Ad Manager 使用的其他标识符（例如，桌面环境中使用的 Cookie，或 AdID 和 IDFA 等可重置的移动广告 ID）进行补充，而不是取代这些标识符。也就是说，在大多数情况下，向 Google Ad Manager 发出的已启用 PPID 的广告请求属于多标识符请求，其中既包含主要的 PPID 标识符，也包含辅助的桌面/移动标识符。每个广告请求只能传递一个 PPID。

这可能会在许多方面影响 Google Ad Manager 行为，详细情况如下所述。

细分受众群定位

系统会为次要标识符和 PPID 单独维护细分受众群成员资格。在收到多标识符请求后，系统可以根据此请求，跨两个标识符投放定位到细分受众群成员资格组合中任意一个细分受众群的订单项。

细分受众群共享

PPID 专门针对一个广告资源网。也就是说，每个广告资源网都有自己的 PPID 命名空间，以免因两个广告资源网向不同的用户分配同一 PPID 而产生冲突。根据一个广告资源网的 PPID 构建而成的细分受众群不能与其他广告资源网或产品共享（更准确地说，一个广告资源网所发请求中的 PPID 绝不会与另一个广告资源网的细分受众群中的 PPID 一致）。只有根据 Cookie 或设备 ID 构建而成的细分受众群才能在多个广告资源网之间共享。包含 PPID 和次要 ID 的细分受众群可以共享，但只有当多标识符广告请求上的次要标识符与此细分受众群中的次要标识符一致时，系统才能根据这个广告请求投放定位到此细分受众群的广告。

细分受众群成员资格

如果收到多标识符请求，系统会认为只有主要 PPID 可用于触发或刷新细分受众群成员资格，而不会认为请求中传递的次要标识符有此用途。

频次上限

如果收到多标识符请求，系统会认为只有主要 PPID 可用于计算频次上限，而不会认为请求中传递的次要标识符有此用途。

广告素材依序轮播

如果收到多标识符请求，系统会认为只有主要 PPID 可用于确定依序轮播中下一个要投放的广告素材，而不会认为请求中传递的次要标识符有此用途。

数据传输报表

在多标识符请求中传递的两种标识符都会传输到数据传输报表中，但在报表中会进行加密。发布商无法撤消加密过程（即无法将 PPID 或次要标识符恢复为原始形式）。不过，可以将这些加密的标识符批量上传到受众群体名单中，以供日后用于再营销/定位。