Google は、ターゲット設定された広告枠に一致する広告リクエストに基づいて、リアルタイム キュレーション統合に SegmentRequest を送信します。SegmentRequest オブジェクトは、コンテキスト シグナルまたはセキュア シグナルのいずれかを提供します。これらのシグナルを使用して、SegmentResponse で指定された広告枠にどのセグメントが適用されるかを特定できます。リアルタイム キュレーションは、JSON 形式で送信される SegmentRequest オブジェクトと SegmentResponse オブジェクトをサポートしています。
このガイドは、統合の構築に役立つリアルタイム キュレーション プロトコルのリファレンスです。
SegmentRequest
| 属性 | 型 | 説明 |
|---|---|---|
site |
サイト | コンテキスト キュレーション パートナーのみがサポート対象です。 ウェブサイトの記述子。広告でサポートされているコンテンツがブラウザ以外のアプリケーションではなくウェブサイトの場合、 |
app |
アプリ | コンテキスト キュレーション パートナーのみがサポート対象です。 アプリの説明。広告サポート コンテンツがウェブサイトではなくブラウザ以外のアプリケーションの場合、 |
pub |
パブリッシャー | コンテキスト キュレーション パートナーのみがサポート対象です。 パブリッシャーの記述子。 |
user |
ユーザー | セグメント リクエストを開始したパブリッシャー コンテンツを閲覧しているユーザーの記述子。 |
device |
デバイス | コンテキスト キュレーション パートナーのみがサポート対象です。 ユーザーのデバイスの記述子。 |
segment_ |
文字列 | 他のすべてのセグメント リクエストとは別にセグメント リクエストを識別するために使用される一意の識別子。 |
サイト
| 属性 | 型 | 説明 |
|---|---|---|
page |
文字列 | コンテキスト キュレーション パートナーのみがサポート対象です。 インプレッションが表示されているページの URL。 |
アプリ
| 属性 | 型 | 説明 |
|---|---|---|
bundle |
文字列 | コンテキスト キュレーション パートナーのみがサポート対象です。 アプリに固有のプラットフォーム固有のアプリケーション識別子。Android では、 |
パブリッシャー
| 属性 | 型 | 説明 |
|---|---|---|
id |
文字列 | コンテキスト キュレーション パートナーのみがサポート対象です。 ウェブ プロパティ コードのパブリッシャー コード接尾辞で定義されるパブリッシャー ID。たとえば、ウェブ プロパティ コードが |
ユーザー
| 属性 | 型 | 説明 |
|---|---|---|
consent |
文字列 | パブリッシャーの IAB 同意管理プラットフォーム（CMP）から取得された、ウェブセーフな base64 エンコード形式の IAB 透明性と同意に関するフレームワーク（TCF）v2 同意文字列。 パブリッシャーが TCF v2 の CMP と統合しており、その CMP が広告リクエストに GDPR が適用されることを示し、有効な同意文字列を提供している場合、 同意文字列に記載されているベンダーの詳細については、IAB グローバル ベンダー リスト（vendor-list.consensu.org/v2/vendor-list.json）をご覧ください。 |
eids |
EID 配列 | セキュア シグナルのキュレーション パートナーのみがサポート対象です。 拡張 ID インスタンス。 キュレーションでは、 |
EID
| 属性 | 型 | 説明 |
|---|---|---|
source |
文字列 | セキュア シグナルのキュレーション パートナーのみがサポート対象です。 含まれるデータのセットを担当するソースまたはテクノロジー プロバイダ。トップレベル ドメインとして表されます。 |
uids |
UID 配列 | セキュア シグナルのキュレーション パートナーのみがサポート対象です。 指定されたソースの UID オブジェクトの配列。 |
UID
| 属性 | 型 | 説明 |
|---|---|---|
id |
文字列 | セキュア シグナルのキュレーション パートナーのみがサポート対象です。 識別子。 キュレーションでは、 |
デバイス
| 属性 | 型 | 説明 |
|---|---|---|
geo |
Geo | コンテキスト キュレーション パートナーのみがサポート対象です。 ユーザーのデバイスの位置情報。 |
地域
| 属性 | 型 | 説明 |
|---|---|---|
country |
文字列 | コンテキスト キュレーション パートナーのみがサポート対象です。 ISO-3166-1 Alpha-3 標準を使用する国。 |
region |
文字列 | コンテキスト キュレーション パートナーのみがサポート対象です。 ISO-3166-2 標準を使用する地域コード。米国の場合、2 文字の州コード。 |
metro |
文字列 | コンテキスト キュレーション パートナーのみがサポート対象です。 Google のメトロコードは geo-table.csv ファイルにあります。 |
SegmentResponse
| 属性 | 型 | 説明 |
|---|---|---|
segment |
セグメント配列 | セグメントの記述子。 |
セグメント
| 属性 | 型 | 説明 |
|---|---|---|
segment_id |
文字列 | セグメントの ID。ID は、Marketplace API の curators.dataSegments リソースのセグメント名にある curatorDataSegmentId と一致する必要があります。 |