SegmentResponse を作成する

キュレーション エンドポイントは、セグメント リクエストで送信されたシグナルを処理した後、各インプレッションに適用可能なデータ セグメントを識別する SegmentResponse オブジェクトを 50 ミリ秒以内に作成して Google にレスポンスを返す必要があります。Google は 50 ミリ秒後に受信したレスポンスを無視します。

SegmentResponse.segment.segment_id フィールドを使用して、広告機会に関連するセグメント ID を特定できます。作成したデータ セグメントの ID は、Marketplace API の dataSegments リソースを使用して確認できます。詳しくは、API とリアルタイム キュレーションでデータ セグメントを特定する方法をご覧ください。

データ セグメントが該当しない場合は応答する

特定のセグメント リクエストに適用できるデータ セグメントがない場合は、SegmentResponse オブジェクトの作成を省略し、空の HTTP 204 ステータスで応答します。

SegmentResponse の例

SegmentRequest オブジェクトの内容が、インプレッションがデータ セグメント test-data-segment-1 と test-data-segment-2 に関連していることを示している場合は、それらの ID を SegmentResponse オブジェクトで返します。

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