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

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

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

SegmentRequest

属性 型 説明
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 コンテキスト キュレーション パートナーでのみサポートされます。デバイスに依存しないピクセル（DIPS）単位の高さ。
pos int コンテキスト キュレーション パートナーでのみサポートされます。画面上の広告の掲載順位。配置位置について詳しくは、配置位置のリストを AdCOM 1.0 でご覧ください。

動画

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

ImpExt

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

敷地

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

アプリ

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

パブリッシャー

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

ユーザー

属性 型 説明
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 フィールドはセキュア シグナルです。セキュア シグナルについて詳しくは、Ad Manager のビッダーやキュレーション パートナーとセキュア シグナルを共有するをご覧ください。

デバイス

属性 型 説明
geo Geo コンテキスト キュレーション パートナーでのみサポートされます。ユーザーのデバイスの位置。
devicetype int コンテキスト キュレーション パートナーでのみサポートされます。デバイスの一般的なタイプ。使用可能なデバイスタイプについて詳しくは、AdCOM 1.0 のデバイスタイプのリストをご覧ください。
os 文字列 コンテキスト キュレーション パートナーでのみサポートされます。デバイスのオペレーティング システム（「iOS」など）。
make 文字列 コンテキスト キュレーション パートナーでのみサポートされます。デバイス メーカー（「Apple」など）。

Geo

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

SegmentResponse

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

セグメント

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