Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。
リアルタイム キュレーションの仕様について
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
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
デバイス
| 属性 |
型 |
説明 |
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 と一致する必要があります。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2026-09-23 UTC。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2026-09-23 UTC。"],[],[]]