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"
      }
  }
}

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

{
  "device":{
    "ifa":"OMITTED_IFA"
  },
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }],
    "buyeruid": "OMITTED_BUYERUID",
    "id": "OMITTED_ID"
  }
}

次のステップ