Google は、リアルタイム ビッダー オークションでデータ セグメントが落札に使用され、インプレッションが発生したことを検出すると、インプレッション通知を送信します。データ セグメントの使用状況を把握するため、インプレッション通知と統合することをおすすめします。インプレッション通知を有効にするには、アカウント マネージャーにお問い合わせください。
インプレッション通知のエンドポイントを設定する
インプレッション通知を受信するには、HTTP エンドポイントを作成し、その URL を Google と共有する必要があります。インプレッション通知の送信先 URL は、次のいずれかの方法で設定できます。
- リアルタイム キュレーションの呼び出しごとにインプレッション通知のエンドポイント URL を設定する。
SegmentResponse.burlフィールドに値を入力すると、受信するリアルタイム キュレーションのコールアウトごとに、インプレッション通知に使用する URL を動的に設定できます。- 特定のリアルタイム キュレーションのコールアウトに対してインプレッション通知を受信するには、
SegmentResponse.burlフィールドを設定する必要があります。SegmentResponse.burlフィールドに値が入力されていない場合、以前の呼び出しでSegmentResponse.burlフィールドが設定されていても、その呼び出しに対する通知は送信されません。
- アカウント単位のインプレッション通知のエンドポイント URL を設定する。
- アカウント マネージャーにお問い合わせいただくと、アカウント単位のインプレッション通知のエンドポイント URL を設定できます。エンドポイント URL が頻繁に変更されない場合に最適です。
- 個々のリアルタイム キュレーションの呼び出しに対して
SegmentResponse.burlフィールドを設定してアカウント単位の URL をオーバーライドしない限り、すべてのリアルタイム キュレーションの呼び出しで、アカウントに設定したアカウント単位のインプレッション通知 URL が使用されます。
インプレッション通知を解析する
インプレッション通知で送信される情報は、インプレッション通知のエンドポイント URL の設定によって異なります。エンドポイント URL にはクエリ パラメータを含めることができ、マクロを使用して、インプレッションが発生した落札でデータ セグメントがどのように使用されたかに関する追加のコンテキストを含めることができます。
マクロの展開方法を理解する
エンドポイント URL に、マクロに設定された 1 つ以上のクエリ パラメータが含まれるように設定すると、エンドポイントに送信されるインプレッション通知でこれらのマクロが展開され、マクロが対応する値に置き換えられます。
たとえば、インプレッション通知のエンドポイント URL を次のように設定できます。
https://testendpoint.com/impressions?segmentReqId=${SR_ID}&segmentIds=${SEGMENT_IDS}
インプレッション通知を受信すると、マクロが置き換えられ、URL は次のようになります。
https://testendpoint.com/impressions?segmentReqId=8Mbl39sMOX5yg1NZgS35ET&segmentIds=test-ds-1|test-ds-2
サポートされているマクロについて
インプレッション通知のエンドポイント URL のクエリ パラメータに含めることができるマクロは次のとおりです。これらのマクロは、1 つ以上のデータ セグメントが貢献した落札に関連する値に置き換えられます。
| マクロ | 説明 |
|---|---|
${SR_ID}
|
対応するリアルタイム キュレーションの呼び出しの SegmentRequest.segment_request_id フィールドに相当する一意の文字列 ID。これは、落札に貢献した 1 つ以上のデータ セグメント ID で応答したセグメント リクエストを指します。 |
${SEGMENT_IDS}
|
落札に貢献した文字列データ セグメント ID のリスト。リスト内の各アイテムは「|」文字で区切られます。たとえば、
これは次のような値のリストに展開できます。
"segmentId1|segmentId2|segmentId3"
リストに入力される各データ セグメント ID は、
Marketplace API の対応する
curators.dataSegmentsリソースのリソース ID を指します。 |
${AUCTION_PRICE}
|
オークションの落札価格を表す文字列。
価格は、マイクロ米ドルで表される 1 回のインプレッションの費用（CPI）です。たとえば、リアルタイム ビッダーの入札額が 5 米ドル CPM の場合、リアルタイム キュレーションのインプレッション通知では ${AUCTION_PRICE} マクロが 5000 マイクロ米ドル CPI に展開されます。 |
${DEAL_ID}
|
オークションを落札した取引またはパッケージの ID。これは、${SEGMENT_IDS} マクロで識別できる 1 つ以上のデータ セグメント ID をターゲットとする取引またはパッケージです。 |
${BUYER_SEAT_ID}
|
落札した入札でビッダーが指定した、インプレッションを落札した購入者シートの ID。たとえば、購入者シートは代理店または広告主になります。 |
次のステップ
- リアルタイム キュレーション プロトコルのリファレンス: リアルタイム キュレーションで使用されるリクエストとレスポンスの構造について説明します。
- リアルタイム キュレーションのリクエストを解析する: リアルタイム キュレーションのリクエストを解析する方法について説明します。
- リアルタイム キュレーションのレスポンスを作成する: リアルタイム キュレーションのレスポンスを作成する方法について説明します。