解析 SegmentRequest

在实时内容精选中，Google 会向您的内容精选端点发送 JSON SegmentRequest，以提供描述一次或多次展示的信号，从而让您确定每个展示适用的数据段。本指南介绍了如何开发处理 SegmentRequest 的内容整理逻辑。

使用 gzip 编码

Google 会在向您的端点发送 SegmentRequest 时使用 gzip 编码。您的端点必须能够接收和响应 gzip 编码。

通过情境信号或安全信号端点进行甄选

创建实时内容精选端点时，您必须选择是接收情境信号还是安全信号。您选择的信号会影响发送到端点的细分请求的填充方式、产生发送到端点的细分请求的广告资源量，以及集成中使用的内容精选逻辑。

使用情境信号

内容相关信号包括有关发布商、设备和用户的信息，用于描述展示的来源。以下列表介绍了可用的信号：

  • SegmentRequest.site： 描述展示广告的网站，例如网站的网址。在 SegmentRequest 中，只能填充 SegmentRequest.site 和 SegmentRequest.app 中的一个。
  • SegmentRequest.app： 描述展示广告的应用，例如应用的平台专用应用标识符。在 SegmentRequest 中，只能填充 SegmentRequest.site 和 SegmentRequest.app 中的一个。
  • SegmentRequest.pub： 描述展示所呈现媒体的发布者；例如，发布者的 ID。
  • SegmentRequest.user： 描述用户对其个人数据处理方式的选择；例如，使用 TCF 意见征求字符串。
  • SegmentRequest.device：描述设备的相关信息，例如设备在城市级精度下的地理位置。

您可以使用情境信号来实现可确定要在 SegmentResponse 中返回的适用数据段的整理逻辑。

使用安全信号

安全信号是发布商创建的数据，发布商可以选择与一个或多个合作伙伴分享这些数据。在广告请求中与 Google 分享之前，这些 ID 会经过混淆处理，并且在实时甄选中会以混淆后的形式显示在 SegmentRequest.user.eids.uids.id 中。

如果您的端点配置为使用安全信号，则该端点只会收到发布商的细分请求，前提是这些发布商已选择与您的精选账号共享安全信号。因此，与上下文信号端点相比，符合条件可发送到安全信号端点的总展示次数更少。

端点的内容甄选逻辑必须解读安全信号，并使用安全信号来确定要在 SegmentResponse 中返回的适用数据细分受众群。

SegmentRequest 示例

情境信号实时精选端点

{
  "site":{
    "page":"https://dfpgpt.appspot.com/smd/"
  },
  "pub":{
    "id":"pub-1234567890987654"
  },
  "device":{
    "geo":{
      "country":"US",
        "metro":"501"
      }
    }
  }
}

安全信号实时精选端点

{
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }]
  }
}

后续步骤