构建 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",
    }
  ]
}