リアルタイム キュレーションの仕様について

Google は、ターゲット設定された広告枠に一致する広告リクエストに基づいて、リアルタイム キュレーション統合に SegmentRequest を送信します。SegmentRequest オブジェクトは、コンテキスト シグナルまたはオーディエンス シグナルのいずれかを提供します。これらのシグナルを使用して、SegmentResponse の指定された広告枠にどのセグメントが適用されるかを特定できます。リアルタイム キュレーションは、JSON 形式で送信される SegmentRequest オブジェクトと SegmentResponse オブジェクトをサポートしています。

このガイドは、統合の構築に役立つリアルタイム キュレーション プロトコルのリファレンスです。

SegmentRequest

属性 型 説明
imp Imp 配列 コンテキスト キュレーション パートナーのみがサポート対象です。提供されているインプレッション獲得の機会を表します。
site 敷地 コンテキスト キュレーション パートナーのみがサポート対象です。ウェブサイトの記述子。広告サポート コンテンツがブラウザ以外のアプリケーションではなくウェブサイトの場合、site フィールドが入力されます。
app アプリ コンテキスト キュレーション パートナーのみがサポート対象です。アプリの説明。広告サポート コンテンツがウェブサイトではなくブラウザ以外のアプリケーションの場合、app フィールドが入力されます。
pub パブリッシャー コンテキスト キュレーション パートナーのみがサポート対象です。パブリッシャーの記述子。
user ユーザー セグメント リクエストを開始したパブリッシャー コンテンツを閲覧しているユーザーの記述子。
device デバイス コンテキスト キュレーション パートナーのみがサポート対象です。ユーザーのデバイスの記述子。
segment_request_id 文字列 他のすべてのセグメント リクエストとは別にセグメント リクエストを識別するために使用される一意の識別子。

表示回数

属性 型 説明
id 文字列 コンテキスト キュレーション パートナーのみがサポート対象です。セグメント リクエストのコンテキスト内でのこのインプレッションの一意の識別子。値は 1 から始まり、n 回のインプレッションに対して n まで増分します。
banner バナー コンテキスト キュレーション パートナーのみがサポート対象です。このフィールドは、インプレッションがバナー広告の機会として提供された場合に設定されます。
video 動画 コンテキスト キュレーション パートナーのみがサポート対象です。このフィールドは、インプレッションが動画広告の機会として提供される場合に設定されます。
ext ImpExt ここには Imp オブジェクトの拡張機能が入力されます。

バナー

属性 型 説明
w int コンテキスト キュレーション パートナーのみがサポート対象です。デバイス非依存ピクセル(DIPS)単位の幅。
h int コンテキスト キュレーション パートナーでのみサポートされます。デバイスに依存しないピクセル(DIP)単位の高さ。
pos int コンテキスト キュレーション パートナーでのみサポートされます。画面上の広告の位置。配置可能な位置について詳しくは、AdCOM 1.0 のリスト: プレースメント ポジションをご覧ください。

動画

属性 型 説明
w int コンテキスト キュレーション パートナーでのみサポートされます。動画プレーヤーの幅(デバイス非依存ピクセル(DIPS)単位)。
h int コンテキスト キュレーション パートナーのみがサポート対象です。デバイスに依存しないピクセル(DIP)単位の動画プレーヤーの高さ。
pos int コンテキスト キュレーション パートナーのみがサポート対象です。画面上の広告の位置。配置可能な位置について詳しくは、AdCOM 1.0 のリスト: プレースメント ポジションをご覧ください。

ImpExt

属性 型 説明
gpid 文字列 コンテキスト キュレーション パートナーのみがサポート対象です。グローバル プレースメント ID について説明します。パブリッシャーが指定する、ページ上の各広告ユニットのサプライパス全体で一貫性のある、個別の永続的な ID。こちらの記事をご覧ください。

サイト

属性 型 説明
page 文字列 コンテキスト キュレーション パートナーでのみサポートされます。インプレッションが表示されたページの URL。
mobile int コンテキスト キュレーション パートナーでのみサポートされます。モバイル デバイスで表示されたときにレイアウトを最適化するようにサイトがプログラムされているかどうかを示します。0 は「いいえ」、1 は「はい」です。

アプリ

属性 型 説明
bundle 文字列 コンテキスト キュレーション パートナーでのみサポートされます。アプリに固有のプラットフォーム固有のアプリケーション ID。Android では、bundle フィールドはバンドル名またはパッケージ名です。iOS では、数値 ID です。

パブリッシャー

属性 型 説明
id 文字列 コンテキスト キュレーション パートナーのみがサポート対象です。ウェブ プロパティ コードのパブリッシャー コード接尾辞で定義されたパブリッシャー ID。たとえば、ウェブ プロパティ コードが ca-pub-123 のパブリッシャーの場合、ID は pub-123 に設定されます。

ユーザー

属性 型 説明
id 文字列 Google ユーザー ID。
buyeruid 文字列 Cookie マッチング サービスでアップロードされたホストされたマッチデータ。デフォルトでは、パディングなしのウェブセーフな Base64 エンコードで指定されます。このフィールドは、アカウント マネージャーにお問い合わせいただくことで、エンコードせずに値を入力するように設定することもできます。
consent 文字列 パブリッシャーの IAB 同意管理プラットフォーム(CMP)から取得された、ウェブセーフな base64 エンコード形式の IAB 透明性と同意に関するフレームワーク(TCF)v2 同意文字列。パブリッシャーが TCF v2 の CMP と統合しており、その CMP が広告リクエストに GDPR が適用されることを示し、有効な同意文字列を提供している場合、consent フィールドには値が入力されます。同意文字列に記載されているベンダーについて詳しくは、IAB グローバル ベンダーリスト(vendor-list.consensu.org/v2/vendor-list.json)をご覧ください。
eids EID 配列 オーディエンス キュレーション パートナーのみがサポート対象です。拡張 ID インスタンス。キュレーションでは、eids フィールドはパブリッシャーが利用可能にするデータ(セキュア シグナルなど)です。

EID

属性 型 説明
source 文字列 オーディエンス キュレーション パートナーのみがサポート対象です。含まれるデータのセットを担当するソースまたはテクノロジー プロバイダ。トップレベル ドメインとして表されます。
uids UID 配列 オーディエンス キュレーション パートナーのみがサポート対象です。指定されたソースの UID オブジェクトの配列。

UID

属性 型 説明
id 文字列 オーディエンス キュレーション パートナーのみがサポート対象です。識別子。キュレーションでは、id フィールドはセキュア シグナルです。セキュア シグナルの詳細については、アド マネージャーのビッダーやキュレーション パートナーとセキュア シグナルを共有するをご覧ください。

デバイス

属性 型 説明
geo Geo コンテキスト キュレーション パートナーのみがサポート対象です。ユーザーのデバイスの場所。
devicetype int コンテキスト キュレーション パートナーのみがサポート対象です。デバイスの一般的なタイプ。使用可能なデバイスタイプについて詳しくは、AdCOM 1.0 のリスト: デバイスタイプをご覧ください。
os 文字列 コンテキスト キュレーション パートナーのみがサポート対象です。デバイスのオペレーティング システム(「iOS」など)。
make 文字列 コンテキスト キュレーション パートナーのみがサポート対象です。デバイスのメーカー(例: 「Apple」)。
ifa 文字列 暗号化されていないデバイス広告 ID(ハッシュ化されていない)。Google のリアルタイム キュレーション プロトコルでは、通常、これは 36 文字の UUID です。Android ID は小文字で、IDFA は大文字です。Samsung デバイスの場合、これらは 32 文字の英数字の値です。

地域

属性 型 説明
country 文字列 コンテキスト キュレーション パートナーのみがサポート対象です。ISO-3166-1 Alpha-3 標準を使用する国。
region 文字列 コンテキスト キュレーション パートナーのみがサポート対象です。ISO-3166-2 標準を使用する地域コード。米国の場合、2 文字の州コード。
metro 文字列 コンテキスト キュレーション パートナーのみがサポート対象です。geo-table.csv ファイルに記載されている Google の都市圏コード。
city 文字列 コンテキスト キュレーション パートナーでのみサポートされます。国連貿易輸送所在地コードを使用している都市。

SegmentResponse

属性 型 説明
segment Segment 配列 セグメントの記述子。

セグメント

属性 型 説明
segment_id 文字列 セグメントの ID。ID は、Marketplace API の curators.dataSegments リソースのセグメント名にある curatorDataSegmentId と一致する必要があります。