SegmentRequest を解析する

リアルタイム キュレーションでは、Google はキュレーション エンドポイントに JSON SegmentRequest を送信して、1 つ以上のインプレッションを表すシグナルを提供します。これにより、各インプレッションに適用可能なデータ セグメントを特定できます。このガイドでは、SegmentRequest を処理するキュレーション ロジックの開発について説明します。

gzip エンコードを使用する

Google は、エンドポイントに SegmentRequest を送信するときに gzip エンコードを使用します。エンドポイントは、gzip エンコードで受信して応答できる必要があります。

コンテキスト シグナルまたはセキュア シグナルのエンドポイントを使用したキュレーション

リアルタイム キュレーション エンドポイントを作成する際に、コンテキスト シグナルとセキュア シグナルのどちらを受け取るかを選択する必要があります。選択したシグナルは、エンドポイントに送信されるセグメント リクエストの入力方法、エンドポイントに送信されるセグメント リクエストを生成するインベントリの量、統合で使用されるキュレーション ロジックに影響します。

コンテキスト シグナルを使用する

コンテキスト シグナルには、インプレッションの発生元を説明するパブリッシャー、デバイス、ユーザーに関する情報が含まれます。使用可能なシグナルは次のとおりです。

  • SegmentRequest.site: インプレッションをレンダリングするウェブサイト（サイトの URL など）を説明します。SegmentRequest に入力できるのは SegmentRequest.site と SegmentRequest.app のいずれか 1 つのみです。
  • SegmentRequest.app: インプレッションをレンダリングするアプリ（アプリのプラットフォーム固有のアプリ ID など）について説明します。SegmentRequest に入力できるのは SegmentRequest.site と SegmentRequest.app のいずれか 1 つのみです。
  • SegmentRequest.pub: インプレッションをレンダリングするメディアのパブリッシャー（パブリッシャーの ID など）を説明します。
  • SegmentRequest.user: 個人データの処理方法に関するユーザーの選択を記述します（TCF 同意文字列など）。
  • SegmentRequest.device: デバイスに関する情報（メトロレベルの精度でのデバイスの地理的位置など）を記述します。

コンテキスト シグナルを使用して、SegmentResponse で返す該当するデータ セグメントを特定できるキュレーション ロジックを実装できます。

セキュア シグナルを使用する

セキュア シグナルは、パブリッシャーが作成し、1 つ以上のパートナーと共有することを選択したデータです。これらの値は、広告リクエストで 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"
      }
    }
  }
}

セキュア シグナルのリアルタイム キュレーション エンドポイント

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

次のステップ