SegmentRequest を解析する

リアルタイム キュレーションでは、Google は 1 つ以上のインプレッションを表すシグナルをキュレーション エンドポイントに送信し、各インプレッションに適用可能なデータ セグメントを特定できるようにします。SegmentRequestこのガイドでは、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" }
      ]
    }]
  }
}

次のステップ