Google 会根据与您的目标广告资源匹配的广告请求，向您的实时甄选集成发送 SegmentRequest。SegmentRequest 对象提供上下文信号或安全信号，您可以使用这些信号来确定哪些细分受众群适用于 SegmentResponse 中的指定广告资源。
实时内容精选支持以 JSON 格式发送的 SegmentRequest 和 SegmentResponse 对象。
本指南是实时精选协议的参考文档，可帮助您构建集成。
SegmentRequest
| 属性 | 类型 | 说明 |
|---|---|---|
site |
网站 | 仅适用于情境化精选合作伙伴。 网站的描述符。如果广告支持的内容是网站而非非浏览器应用，则会填充 |
app |
应用广告系列 | 仅适用于情境化精选合作伙伴。 应用的描述符。如果含广告支持的内容是浏览器以外的应用，则会填充 |
pub |
发布商 | 仅适用于情境化精选合作伙伴。 发布商的描述符。 |
user |
用户 | 发起细分请求的浏览发布商内容的用户描述符。 |
device |
设备 | 仅适用于情境化精选合作伙伴。 用户设备的描述符。 |
segment_ |
字符串 | 用于独立于所有其他细分请求来标识细分请求的唯一标识符。 |
网站
| 属性 | 类型 | 说明 |
|---|---|---|
page |
字符串 | 仅适用于情境化精选合作伙伴。 展示所在网页的网址。 |
应用
| 属性 | 类型 | 说明 |
|---|---|---|
bundle |
字符串 | 仅适用于情境化精选合作伙伴。 特定于平台的应用标识符，旨在确保应用的唯一性。在 Android 上， |
发布商
| 属性 | 类型 | 说明 |
|---|---|---|
id |
字符串 | 仅适用于情境化精选合作伙伴。 由网络媒体资源代码的发布商代码后缀定义的发布商 ID。例如，如果发布商的网络媒体资源代码为 |
用户
| 属性 | 类型 | 说明 |
|---|---|---|
consent |
字符串 | 从发布商的 IAB 意见征求管理平台 (CMP) 中提取的基于网络安全的 base64 编码的 IAB 透明度和用户意见征求框架 (TCF) v2 用户意见征求字符串。 如果发布商已集成 CMP 以支持 TCF v2，并且该 CMP 表明 GDPR 适用于相应广告请求并提供有效的用户意见征求字符串，则会填充 如需详细了解用户意见征求字符串中列出的供应商，请访问 vendor-list.consensu.org/v2/vendor-list.json 查看 IAB 全球供应商列表。 |
eids |
EID 数组 | 仅适用于安全信号甄选合作伙伴。 扩展 ID 实例。 在“精选”中， |
EID
| 属性 | 类型 | 说明 |
|---|---|---|
source |
字符串 | 仅适用于安全信号甄选合作伙伴。 负责所含数据组的来源或技术提供商。以顶级网域的形式表示。 |
uids |
UID 数组 | 仅适用于安全信号甄选合作伙伴。 指定来源中的 UID 对象数组。 |
UID
| 属性 | 类型 | 说明 |
|---|---|---|
id |
字符串 | 仅适用于安全信号甄选合作伙伴。 标识符。 在内容精选中， |
设备
| 属性 | 类型 | 说明 |
|---|---|---|
geo |
地理位置 | 仅适用于情境化精选合作伙伴。 用户设备的位置。 |
地理位置
| 属性 | 类型 | 说明 |
|---|---|---|
country |
字符串 | 仅适用于情境化精选合作伙伴。 国家/地区，采用 ISO-3166-1 Alpha-3 标准。 |
region |
字符串 | 仅适用于情境化精选合作伙伴。 使用 ISO-3166-2 标准的地区代码；如果是美国，则为 2 个字母的州代码。 |
metro |
字符串 | 仅适用于情境化精选合作伙伴。 在 geo-table.csv 文件中找到的 Google 地铁代码。 |
SegmentResponse
| 属性 | 类型 | 说明 |
|---|---|---|
segment |
细分数组 | 细分的描述符。 |
Segment
| 属性 | 类型 | 说明 |
|---|---|---|
segment_id |
字符串 | 细分的 ID。该 ID 应与 Marketplace API 的 curators.dataSegments 资源中细分的名称中的 curatorDataSegmentId 相匹配。 |