解析 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 分享之前，这些数据会经过混淆处理，并且在实时甄选中，这些数据会以混淆后的形式显示在 SegmentRequest.user.eids.uids.id 中。

如果您的端点配置为使用受众群体信号，则该端点只会接收以下发布商的广告资源细分请求：这些发布商已选择与您的甄选账号共享安全信号。因此，与情境信号端点相比，有资格发送到受众群体信号端点的总展示次数更少。

端点的整理逻辑必须解读受众群体信号，并确定要在 SegmentResponse 中返回的适用数据段。

SegmentRequest 示例

情境信号实时精选端点

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

受众群体信号实时精选端点

{
  "device":{
    "ifa":"OMITTED_IFA"
  },
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }],
    "buyeruid": "OMITTED_BUYERUID",
    "id": "OMITTED_ID"
  }
}

后续步骤