构建 SegmentResponse

在您的内容精选端点处理了细分受众群请求中发送的信号后,该端点必须在 50 毫秒内构建 SegmentResponse 对象并向 Google 发送响应,以标识适用于每次展示的数据细分。Google 会忽略在 50 毫秒后收到的响应。

您可以使用 SegmentResponse.segment.segment_id 字段确定与广告机会相关的细分 ID。您可以使用 Marketplace API 中的 dataSegments 资源查找您创建的数据细分的 ID。如需了解详情,请参阅如何区分 API 中的数据段与实时精选中的数据段

在没有适用的数据细分受众群时做出响应

如果您发现没有任何数据段适用于给定的细分请求,请省略 SegmentResponse 对象的构建,并以空的 HTTP 204 状态进行响应。

SegmentResponse 示例

如果 SegmentRequest 对象的内容表明展示与数据段 test-data-segment-1test-data-segment-2 相关,则在 SegmentResponse 对象中返回其 ID:

{
  "segment": [
    {
      "segment_id": "test-data-segment-1",
    },
    {
      "segment_id": "test-data-segment-2",
    }
  ]
}