ネイティブ広告は、周囲のコンテンツとビジュアル デザインに溶け込むフォーマットで、ユーザーに見てもらいやすく、クリックされる可能性も高くなります。ネイティブ広告広告枠は、モバイルアプリ、パソコン、モバイルサイトで利用できます。ネイティブ広告について詳しくは、ネイティブ広告の概要 をご覧ください。
ネイティブ広告は、認定バイヤーと Open Bidding の両方でサポートされています。
ネイティブ広告のワークフローは次のとおりです。
ネイティブ広告の呼び出しが Google に対して行われます。この呼び出しでは、優先するネイティブ フィールドをそれぞれ指定している以下のネイティブ広告テンプレートのいずれかまたは両方を指定します。
リクエストされたフィールドのリストを含む RTB 入札リクエストが Google から購入者に送信されます。
興味を持った購入者は、リクエストされたフィールドを返します。
Google はオークションを実施して落札単価を選択し、購入者から提供されたクリエイティブ アセットをパブリッシャーに送信します。
パブリッシャーはアセットを組み合わせてネイティブ広告を作成し、サイトのデザインに合わせてスタイルを設定します。
Google では、JSON と Protobuf の両方で
OpenRTB の仕様 をサポートしています。
OpenRTB Protobuf ネイティブ広告の場合、以下のフィールドと仕様が異なります。
JSON 仕様 (PROTOCOL_OPENRTB_2_4)
JSON 型
OpenRTB の実装 (PROTOCOL_OPENRTB_PROTOBUF_2_4)
OpenRTB のタイプ
BidRequest.imp[].native.request
string
BidRequest.imp[].native.request_native
NativeRequest
BidResponse.seatbid[].bid[].adm
string
BidResponse.seatbid[].bid[].adm_native
NativeResponse
OpenRTB フィールドは、文字列ではなく Protobuf メッセージです。
OpenRTB Protobuf 実装を使用する場合は、BidRequest.imp[].native.request
が返されず、BidResponse.seatbid[].bid[].adm_native
で応答する必要があります。BidResponse.seatbid[].bid[].adm
の入札レスポンスは除外されます。OpenRTB Protobuf の入札レスポンスにアセット ID は必要ありません。
購入者 SDK を使用してネイティブ広告をレンダリングする場合は、審査のためにクリエイティブを送信 する際に、declared_ad
に画像 type
を含める必要があります。
ネイティブ広告テンプレート
動画以外のネイティブ広告と動画のネイティブ広告では、最も一般的な次の 2 つのネイティブ広告テンプレートがサポートされています。
他のテンプレートも存在し、フィールド、ディメンション、サイズの要件が異なる場合があります。
アプリ インストール広告テンプレート
必須項目と推奨項目
次の表に、「必須」 または「推奨」 のラベルが付いたフィールドを示します。次のルールが適用されます。
[必須 ] のマークが付いているフィールドは、ビッダーが必須としています。
「Recommended 」とマークされているフィールドは、ビッダーは必須ではないフィールドです。パブリッシャーが指定する場合(星評価など)は、このフィールドを表示する場合とされない場合があります。
行動を促すフレーズ(CTA)は常に [推奨 ] とマークされます。これは、ビッダーから送信されなかった場合はデフォルトが割り当てられますが、送信された場合は常に表示されるためです。
次の表に、アプリ インストール広告テンプレートのフィールドを示します。モバイルアプリでは、これらのフィールドを使ってネイティブ アプリ インストール広告が作成されます。
項目
説明
必須 / 推奨
常に表示しますか?
推奨画像サイズ/最大文字数
例
見出し
アプリのタイトル
必須
○
25 文字
Flood-It!
画像
アプリのスクリーンショット、または関連する別の画像
必須
×
パブリッシャーが求めるアスペクト比に応じて、1,200 x 627 ピクセルまたは 600 x 600 ピクセル。
<Flood-It! ゲームのスクリーンショット>
本体
アプリのメインテキスト
必須
×
90 文字以内
一見単純で、魅力的でやりがいがあり、うれしくて中毒になります。
アプリアイコン
アプリアイコン
必須
×
128 × 128 ピクセル
<Flood-it! アプリアイコン>
行動を促すフレーズ
優先するユーザー アクション
おすすめ
○
15 文字
インストール
評価
アプリストアでのアプリの評価を表す星の数(0 ~ 5)
おすすめ
×
0 ~ 5
4.5
価格
アプリのコスト
おすすめ
×
15 文字
無料
テキストの長さに関する注意事項
購入者が推奨の最大文字数を超えるテキスト アセット(本文など)を送信すると、Google またはパブリッシャーによってテキストが切り捨てられ、省略される場合があります。中国語、日本語、韓国語では、短縮の上限は半角の半分です。たとえば、見出しの上限は、英語では 90、中国語では 45 です。
画像サイズに関する注意事項
パブリッシャー様には次のことが許可されています。
メインの画像を、縦または横の縦横比で最大 20% 対称になるように切り抜きます。
アスペクト比を変更せずに画像を拡大縮小します。
高さや幅から得られるアスペクト比が大きく異なる画像は、フィルタされる可能性があります。
コンテンツ広告テンプレート
次の表に、コンテンツ広告テンプレートのフィールドを示します。パブリッシャーは、これらのフィールドを使用してネイティブ コンテンツ広告を作成します。
項目
説明
必須 / 推奨
常に表示しますか?
推奨画像サイズ/最大文字数
*
例
見出し
広告ヘッダー
必須
○
25 文字
最低住宅ローン金利
画像
広告のメイン画像
必須
×
パブリッシャーが求めるアスペクト比に応じて、1,200 x 627 ピクセルまたは 600 x 600 ピクセル。
<広告のメイン画像>
本体
広告内容
必須
×
90 文字以内
ブルックリンの快適な暮らしをお届け。
ロゴ
広告主様のロゴまたは関連する別の小さな画像
おすすめ
×
128 × 128 ピクセル
<NY Mortgage Inc. のロゴ>
行動を促すフレーズ
ユーザーが希望する操作
おすすめ
×
15 文字
見積もりを依頼
広告主様
広告主またはブランドを識別するテキスト
必須
×
25 文字
NY Motgage Inc.
アプリ インストール動画広告テンプレート
項目
説明
必須 / 推奨
常に表示しますか?
推奨画像サイズ/最大文字数 *
例
動画
動画広告の再生に必要なすべてのアセットを含む動画の VAST レスポンス。
必須
×
-
Flood-It! を含む VAST XML の URL。動画広告
見出し
アプリのタイトル
必須
○
25 文字
Flood-It!
画像
動画広告がクリックされる前または読み込み中にプレーヤーに表示される画像(サムネイル)。
必須
×
動画のアスペクト比と一致する必要があります(例: 16x9 の動画は 1280x720、640x480 の動画は 4x3)。
ゲーム「Flood-It!」のスクリーンショット。または動画から
本文
アプリのメインテキスト
必須
×
90 文字
一見単純で、魅力的でやりがいがあり、うれしくて中毒になります。
アプリアイコン
アプリアイコン
必須
×
128 x 128 px
Flood-it! アプリアイコン
行動を促すフレーズ
優先するユーザー アクション
必須
○
15 文字
インストール
星評価
アプリストアでのアプリの評価を表す星の数(0 ~ 5)
推奨
×
0 ~ 5
4.5
料金
アプリの費用
推奨
×
15 文字
無料
制限
動画 : 動画はすべて VAST URL または VAST タグの形式にする必要があります。WebM や MP4 などの未加工の動画ファイルは指定できません 。
テキストの長さ : 購入者がレスポンスの body
などのテキスト アセットを指定すると、Google またはパブリッシャーによって切り捨てられ、省略される場合があります。中国語、日本語、韓国語の場合、切り捨ての上限は半分のサイズになります。たとえば、見出しの上限は、英語では 90 文字、中国語では 45 文字です。
画像のサイズ : パブリッシャー様が許可しているコンテンツは次のとおりです。
メインの画像を、縦または横の縦横比で最大 20% 対称になるように切り抜きます。
アスペクト比を変更せずに画像を拡大縮小します。
アプリ インストール広告の例
動画コンテンツ広告テンプレート
項目
説明
必須 / 推奨
常に表示しますか?
推奨画像サイズ/最大文字数 *
例
動画
動画広告の再生に必要なすべてのアセットを含む動画の VAST レスポンス。
必須
○
-
Flood-It! を含む VAST XML の URL。動画広告
見出し
広告ヘッダー
必須
○
25 文字
最低住宅ローン金利
画像
動画広告がクリックされる前または読み込み中にプレーヤーに表示される画像(サムネイル)。
必須
×
動画のアスペクト比と一致する必要があります(例: 16x9 の動画は 1280x720、640x480 の動画は 4x3)。
動画のスクリーンショット
本文
広告コンテンツ
必須
×
90 文字
ブルックリンの快適な暮らしをお届け。
ロゴ
広告主様のロゴまたは関連する別の小さな画像
推奨
×
128 x 128 px
NY Mortgage Inc. のロゴ
行動を促すフレーズ
ユーザーが希望する操作
必須
×
15 文字
見積もりを依頼
広告主
広告主やブランドを識別するテキスト
必須
×
25 文字
ニューヨークローン株式会社
次のメタフィールドは、サポートされているすべての広告テンプレートで共有されます。
認定バイヤーのリアルタイム プロトコル バッファ
認定バイヤー OpenRTB の同等の機能
説明
NativeAd.click_link_url
Link.url
ユーザーが広告をクリックしたときにブラウザが呼び出す URL。
最終的にランディング ページにつながるリダイレクト チェーンの最初のステップとして設定できます。ネイティブ広告では、ユーザーが最終的に到達する到達ページを設定するフィールドとして click_link_url
を使用することをおすすめします。動的なランディング ページの場合、このフィールドを使用する必要があります。
Ad.click_through_url
Bid.adomain
入札者が入札する場合に設定する必要があります。これはスニペットのリンク先 URL のセットです。これには、ユーザーが表示された広告をクリックしたときに表示される URL と、レンダリングされた広告に表示されるすべての URL が含まれます。最終的なランディング ページに関係のない、広告サーバーへの中間呼び出しは含めないでください。スニペットまたは動画広告を返しても click_through_url
が宣言されていない BidResponse は破棄されます。このフィールドは、html_snippet
、video_url
、または native_ad
が設定されている場合にのみ設定します。このデータはリンク先 URL の宣言に使用されます。たとえば、パブリッシャーがブロックされている URL のポストフィルタリングや広告の分類に使用されます。ネイティブ広告を使用する場合は、上記のNativeAd.click_link_url
を参照してください。
ネイティブ以外の広告では、クリック トラッキングなどの広告機能には使用されません。リンク先 URL の宣言としてのみ使用されます。
ネイティブ広告で NativeAd.click_link_url
が設定されていない場合、click_through_url
の最初の値を使用してユーザーをランディング ページに誘導します。また、すべての値がリンク先 URL の宣言として使用されます(ネイティブ以外の場合と同様)。
NativeAd.click_tracking_urls
Link.clicktrackers
(省略可)広告主が広告に対するユーザーのクリックをトラッキングするための追加の URL。
Ad.ad_choices_destination_url
BidExt.ad_choices_destination_url
広告表示設定またはオプトアウト ページへのリンク。標準の AdChoices アイコンがネイティブ クリエイティブに追加され、この URL にリンクされます。これはネイティブ広告でサポートされますが、入札レスポンスのネイティブ メッセージには含まれません。
Ad.impression_tracking_url
NativeResponse.imptrackers
ネイティブ インプレッションは、認定バイヤーのリアルタイム ビッダー プロトコルでは impression_tracking_url
、OpenRTB ではネイティブ インプトラッカーを使用してトラッキングする必要があります。
必須項目と推奨項目
required_fields
と recommended_fields
はパブリッシャーが指定します。これらのビットフィールドを変換して、フィールドが必須か推奨かを判断する方法を示します。
ビットフィールドは 2 進値の各ビットを使用して true または false のステートメントを格納します。これは、is_logo_required
や is_header_required
などの多くのブール型シグナルをすべてまとめて送信するのと同じことです。
例
この例では、1085
の required_fields
値を使用します。
まず、同等の 2 進数値 を見つけます。10000111101
バイナリ値を取得したら、ビットをチェックして、フィールドが必須(1)か必須ではない(0)かを確認できます。
次の表に、各フィールドを 2 進数値での位置にマッピングします。バイナリを右から左に読み取ります。1 ビットはバイナリ値の右端に対応します。
項目
バイナリ値の配置(右から左)
HEADLINE
1
BODY
2
CALL_TO_ACTION
4
ADVERTISER
8
IMAGE
16
LOGO
32
APP_ICON
64
STAR_RATING
128
PRICE
256
STORE
512
VIDEO
1024
バイナリ値 10000111101
の例を見ると、1 ビット(右端)は 1
で、必須の値を示しています。この表によると、1 ビットは HEADLINE
に相当します。
2 ビット(右から 2 番目の値)は 0
で、不要であることを示します。 2 ビットは BODY
に対応します。
この例で解釈される必須フィールドは次のとおりです。
値
説明
必須 / 任意
1
VIDEO
○
0
STORE
×
0
PRICE
×
0
STAR_RATING
×
0
APP_ICON
×
1
LOGO
○
1
IMAGE
○
1
ADVERTISER
○
1
CALL_TO_ACTION
○
0
BODY
×
1
HEADLINE
○
NativeAdTemplate メッセージ
ネイティブ広告枠を含む入札リクエストを受信すると、入力された BidRequest.adSlot[].native_ad_template が含まれます。NativeAdTemplate
メッセージでは、以下の仕様を指定します。
必須フィールドまたは推奨フィールド。
画像、ロゴ、アプリアイコンのサイズ。
広告が表示されるスタイルの仕様。
注: style_layout_type
フィールドの場合、PIXEL
はネイティブ ユニットが固定サイズであることを示し、FLUID
は列の幅いっぱいに拡大され、アスペクト比が保持されるように高さが調整されることを意味します。FLUID
を指定した場合、高さと幅は 1x1 になります。
message BidRequest {
//...
message AdSlot {
//...
message NativeAdTemplate {
// Defines the bits used in required_fields and recommended_fields.
// There is one bit for each of the fields in BidResponse.Ad.NativeAd
enum Fields {
NO_FIELDS = 0x0;
HEADLINE = 0x1;
BODY = 0x2;
CALL_TO_ACTION = 0x4;
ADVERTISER = 0x8;
IMAGE = 0x10;
LOGO = 0x20;
APP_ICON = 0x40;
STAR_RATING = 0x80;
PRICE = 0x100;
DEPRECATED_STORE = 0x200;
VIDEO = 0x400;
}
// Bitfield describing which fields are required by the publisher. Bid
// responses with no value for these fields will be rejected. Click
// and view tracking urls are always implicitly required.
optional int64 required_fields = 1;
// Bitfield describing which fields are recommended by the publisher.
// All recommended field are supported, but not all recommended fields
// are required.
optional int64 recommended_fields = 2;
// max_safe_length indicates the maximum number of Unicode characters that
// are guaranteed to be shown without truncation. Longer strings may be
// truncated and ellipsized by Ad Exchange or the publisher during
// rendering.
optional int32 headline_max_safe_length = 3;
optional int32 body_max_safe_length = 4;
optional int32 call_to_action_max_safe_length = 5;
optional int32 advertiser_max_safe_length = 6;
optional int32 price_max_safe_length = 15;
// The width and height from which to calculate the required aspect ratio.
// You can provide a larger image in the response. Images that have aspect
// ratios substantially different than those implied by the height and
// width may be filtered.
optional int32 image_width = 7;
optional int32 image_height = 8;
optional int32 logo_width = 9;
optional int32 logo_height = 10;
optional int32 app_icon_width = 11;
optional int32 app_icon_height = 12;
// Globally distinct id for the specific style, HTML, and CSS with which
// the native ad is rendered.
optional int32 style_id = 16;
// Type of style layout for each native ad template.
enum LayoutType {
PIXEL = 0;
FLUID = 1;
}
optional LayoutType style_layout_type = 17 [default = PIXEL];
// If the style_layout_type is Pixel, width and height of the
// entire native ad after rendering. If the style_layout_type is
// Fluid, the style_height and style_width may optionally
// not be populated.
optional int32 style_height = 18;
optional int32 style_width = 19;
}
repeated NativeAdTemplate native_ad_template = 51;
}
// NativePlacementType describes placement of native ad slot with respect to
// surrounding context.
enum NativePlacementType {
PLACEMENT_UNKNOWN = 0;
// In the feed of content - for example as an item inside the organic
// feed/grid/listing/carousel.
PLACEMENT_IN_FEED = 1;
// In the atomic unit of the content - for example, in the article page or single
// image page.
PLACEMENT_ATOMIC_UNIT = 2;
// Outside the core content - for example in the ads section on the right
// rail, as a banner-style placement near the content, etc.
PLACEMENT_OUTSIDE = 3;
// Recommendation widget, most commonly presented below the article
// content.
PLACEMENT_RECOMMENDATION = 4;
}
optional NativePlacementType native_placement_type = 45;
// ...
}
ブロードキャスト メッセージ
ネイティブ広告枠に入札する場合、購入者は BidResponse.ad[].native_ad に、対応する BidRequest.adSlot[].native_ad_template
で宣言されている必須フィールドを入力する必要があります。
注 : BidResponse.Ad
にある追加フィールドの一部は、ネイティブ広告に関連しているため、以下にも記載しています。
message BidResponse {
//...
message Ad {
//...
message NativeAd {
// A short title for the ad.
optional string headline = 1;
// A long description of the ad.
optional string body = 2;
// A label for the button that the user is supposed to click.
optional string call_to_action = 3;
// The name of the advertiser or sponsor, to be displayed in the ad
// creative.
optional string advertiser = 4;
// Next tag to use: 4
message Image {
optional string url = 1;
// Image width and height are specified in pixels. You may provide a
// larger image than was requested, so long as the aspect ratio is
// preserved.
optional int32 width = 2;
optional int32 height = 3;
}
// A large image.
optional Image image = 5;
// A smaller image, for the advertiser's logo.
optional Image logo = 6;
// The app icon, for app download ads.
optional Image app_icon = 7;
// The video file. Only set this field if the video field is requested.
oneof video {
// The URL to fetch a video ad. The URL should return an XML response
// that conforms to VAST standards.
string video_url = 13;
// The VAST document to be returned.
string video_vast_xml = 16;
}
// The app rating in the app store. Must be in the range [0-5].
optional double star_rating = 8;
// The URL that the browser/SDK will load when the user clicks the ad.
// This can be the landing page directly, or the first step of a redirect
// chain that eventually leads to it. For backward compatibility, if this
// is not set, the first Ad.click_through_url is used.
optional string click_link_url = 14;
// The URL to use for click tracking. The SDK pings click tracking url on
// a background thread. When resolving the url, HTTP 30x redirects are
// followed. The SDK ignores the contents of the response; this URL
// has no effect on the landing page for the user.
// This field is planned to be deprecated and we are moving to the
// repeated click_tracking_urls field.
optional string click_tracking_url = 11;
// The URLs to use for click tracking. This will be used throughout the
// serving stack and will incorporate any URL in click_tracking_urls.
repeated string click_tracking_urls = 15;
// The price of the promoted app including the currency info.
optional string price = 10;
};
optional NativeAd native_ad = 18;
// The set of destination URLs for the snippet. This includes the URLs that
// the user will go to if they click on the displayed ad, and any URLs that
// are visible in the rendered ad. Do not include intermediate calls to the
// adserver that are unrelated to the final landing page. A BidResponse that
// returns a snippet or video ad but declares no click_through_url will be
// discarded. Only set this field if html_snippet or video_url or native_ad
// are set. This data is used as a destination URL declaration, for example
// for post-filtering of publisher-blocked URLs or ad categorization.
//
// For non-native ads, it is not used for click tracking or any
// other ad functionality; it is only used as a destination URL
// declaration.
//
// For native ads, if NativeAd.click_link_url is not set, the first
// value of click_through_url is used to direct the user to the landing
// page. In addition, all values are used as destination
// URL declarations (similar to the non-native case).
repeated string click_through_url = 4;
//...
// The URLs to call when the impression is rendered. The SDK pings
// impression urls on a background thread and ignores the contents
// of the response.
repeated string impression_tracking_url = 19;
// Link to ad preferences page. This is only supported for native ads.
// If present, a standard AdChoices icon is added to the native ad creative and
// linked to this URL.
optional string ad_choices_destination_url = 21;
// ...
}
}
入札リクエストの例
注: レスポンスに含めることが必須または任意の内容を理解するには、以下の Google リクエストの BidRequest.adslot.native_ad_template
を参照してください。OpenRTB JSON の場合、要件は BidRequest.imp.native
の request
フィールドにあります。OpenRTB のプロトコル バッファについては、BidRequest.imp.native
の request_native
フィールドをご覧ください。 動画以外の入札リクエスト
Google
例を表示
id: "\226M\242\204\324\r\2019\256\362F\020[\323\205n\320\003\257\0179\274\034"
ip: "\300\250"
user_agent: "Mozilla/5.0 (Linux; Android 13; Pixel 6a) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.127 Mobile Safari/537.36 RakutenWebsearch/5.100.08"
url: "https://www.google.com"
detected_language: "ja"
adslot {
id: 1
excluded_attribute: 20
excluded_attribute: 21
allowed_vendor_type: 42
allowed_vendor_type: 144
matching_ad_data {
billing_id: 34438877165
minimum_cpm_micros: 1000000
}
slot_visibility: NO_DETECTION
excluded_product_category: 10015
excluded_product_category: 10611
ad_block_key: 4801919744
publisher_settings_list_id: 9565076710629580954
publisher_settings_list_id: 9122016041291349488
allowed_restricted_category: 32
allowed_restricted_category: 33
iframing_state: UNKNOWN_IFRAME_STATE
viewability: 0
allowed_restricted_category_for_deals: 33
allowed_restricted_category_for_deals: 32
click_through_rate: 0.00012890543
sticky_settings {
bottom_horizontal_stickiness: IS_STICKY
}
allowed_ad_types: ALLOWED_AD_TYPE_NATIVE
is_amp_page: DIALECT_HTML
amp_ad_requirement_type: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
session_depth: 19
native_placement_type: PLACEMENT_IN_FEED
native_ad_template {
required_fields: 25
recommended_fields: 0
headline_max_safe_length: 25
body_max_safe_length: 90
call_to_action_max_safe_length: 15
advertiser_max_safe_length: 25
image_width: 1200
image_height: 627
style_id: 221281
style_layout_type: FLUID
style_height: 1
style_width: 1
}
creative_enforcement_settings {
policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
}
auction_environment: SERVER_SIDE_AUCTION
impression_expiration_seconds: 3600
}
is_test: false
cookie_version: 1
google_user_id: "F6U2fpw3K08HSZGB73seQ5Pbk31"
mobile {
is_app: false
is_mobile_web_optimized: true
}
cookie_age_seconds: 12960000
hosted_match_data: "\312B\314fj@}h\3168\373\376D\335B\007\362\245\253"
geo_criteria_id: 1009637
encrypted_hyperlocal_set: "\\\253\006\362\017\201L\262\200\255z\2076g,\346\304\0279\273(\314\303\2402\3667\004\215W\353\225i\316\3302\035\t\273\220\330Eu\3106\337\352\331\'AX\377[\022\302\3254rtI\025W\316V\336\366\260\177_\355:QU\225t\300\315E\036\220\r\214\360\206\030\230\332HW\362&"
seller_network_id: 10468
publisher_type: PUBLISHER_REPRESENTED
partner_id: 6586746035199562167
hyperlocal_set {
hyperlocal {
corners {
latitude: 0.0
longitude: 0.0
}
corners {
latitude: 0.0
longitude: 0.0
}
corners {
latitude: 0.0
longitude: 0.0
}
corners {
latitude: 0.0
longitude: 0.0
}
}
center_point {
latitude: 0.0
longitude: 0.0
}
}
device {
device_type: HIGHEND_PHONE
platform: "android"
brand: "google"
model: "pixel 6a"
os_version {
major: 13
}
carrier_id: 0
screen_width: 376
screen_height: 835
screen_pixel_ratio_millis: 2875
limit_ad_tracking: false
}
publisher_country: "JP"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 300
google_query_id: "ANy-z65c3V-K51171Fi2prC2Yn4f0X1I970y576HVOU2BXJn0lf2XSziKevRK1vpMGHD153A"
auction_type: FIRST_PRICE
geo {
lat: 34.59
lon: 133.89
country: "JPN"
region: "JP-33"
city: "Okayama"
accuracy: 19507
}
user_agent_data {
platform {
brand: "Android"
version: "13"
version: "0"
}
mobile: true
model: "Pixel 6a"
browsers {
brand: "(Not(A:Brand"
version: "8"
version: "0"
}
browsers {
brand: "Chromium"
version: "100"
version: "0"
}
}
page_visibility: VISIBILITY_STATE_VISIBLE
supply_chain {
complete: true
nodes {
advertising_system_identifier: "i-mobile.co.jp"
seller_identifier: "pub-1111111111111111"
handles_payment: true
}
nodes {
advertising_system_identifier: "google.com"
seller_identifier: "pub-1111111111111111"
handles_payment: true
}
version: "1.0"
}
frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_BROWSER
privacy_treatments {
allow_user_data_collection: false
}
inventory_partner_domain: "OMITTED"
OpenRTB JSON
例を表示
{
"id": "8C7058U3s20928AGBP5Yij",
"imp": [
{
"id": "1",
"tagid": "9593912945",
"bidfloor": 0.01,
"bidfloorcur": "USD",
"secure": 1,
"native": {
"request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"data\":{\"type\":1,\"len\":25}},{\"id\":3,\"required\":1,\"img\":{\"type\":3,\"wmin\":600,\"hmin\":313}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}]}",
"ver": "1.2",
"api": [
1,
2
]
},
"metric": [
{
"type": "click_through_rate",
"value": 0,
"vendor": "EXCHANGE"
},
{
"type": "viewability",
"value": 0,
"vendor": "EXCHANGE"
}
],
"ext": {
"billing_id": [
19693706542
],
"publisher_settings_list_id": [
3575046024785253379,
8093493698074697754
],
"allowed_vendor_type": [
331,
4680
],
"ampad": 2,
"excluded_creatives": [
{
"buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
}
],
"creative_enforcement_settings": {
"policy_enforcement": 2,
"publisher_blocks_enforcement": 1,
"is_default": 1
},
"auction_environment": 0
}
}
],
"site": {
"page": "https://www.google.com",
"publisher": {
"id": "pub-1111111111111111",
"ext": {
"country": "VN"
}
},
"content": {
"livestream": 0,
"language": "en"
},
"mobile": 1,
"ext": {
"amp": 0,
"page_visibility": 1,
}
},
"device": {
"ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 15_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.4 Mobile/15E148 Safari/604.1",
"geo": {
"lat": 0.0,
"lon": 0.0,
"country": "USA",
"region": "FL",
"metro": "539",
"city": "Bradenton",
"zip": "34207",
"type": 2,
"accuracy": 2905
},
"ipv6": "2603:9000:a403::",
"make": "apple",
"model": "iphone",
"os": "iOS",
"osv": "15.4.4",
"devicetype": 4,
"lmt": 0,
"w": 428,
"h": 926,
"pxratio": 3,
"ext": {
"user_agent_data": {
"platform": {
"brand": "iPhone",
"version": [
"15",
"4"
]
},
"mobile": 1,
"browsers": [
{
"brand": "Safari",
"version": [
"15",
"4"
]
},
{
"brand": "Mozilla",
"version": [
"5",
"0"
]
},
{
"brand": "AppleWebKit",
"version": [
"605",
"1"
]
}
],
"bitness": "64"
}
}
},
"user": {
"ext": {}
},
"at": 1,
"tmax": 300,
"cur": [
"USD"
],
"source": {
"ext": {
"schain": {
"complete": 1,
"nodes": [
{
"asi": "google.com",
"sid": "pub-1028650221795432",
"hp": 1
}
],
"ver": "1.0"
}
}
},
"ext": {
"google_query_id": "ANy-zfKua9-G5R316N638Mn0xgl3iu68F0u72M7r0aT9dMS24U7VNy3D391xb7K41155r533",
"fcap_scope": 5,
"privacy_treatments": {
"allow_user_data_collection": 1
}
}
}
OpenRTB プロトコル バッファ
例を表示
id: "CW335Jn7Z9302AoiHaJ457"
imp {
id: "1"
tagid: "6556451022"
bidfloor: 0.01
bidfloorcur: "USD"
secure: true
native {
ver: "1.2"
api: VPAID_1
api: VPAID_2
request_native {
ver: "1.2"
assets {
id: 1
required: true
title {
len: 25
}
}
assets {
id: 2
required: true
data {
type: DESC
len: 90
}
}
assets {
id: 3
data {
type: CTATEXT
len: 15
}
}
assets {
id: 4
required: true
img {
type: MAIN
wmin: 1200
hmin: 627
}
}
eventtrackers {
event: IMPRESSION
methods: IMG
}
[com.google.doubleclick.native_ext] {
style_id: 476037
style_height: 1
style_width: 1
style_layout_type: FLUID
}
}
}
exp: 3600
metric {
type: "click_through_rate"
value: 0.0006219408242031932
vendor: "EXCHANGE"
}
metric {
type: "viewability"
value: 0.11
vendor: "EXCHANGE"
}
[com.google.doubleclick.imp] {
billing_id: 43493646043
dfp_ad_unit_code: "/4297145/google/test"
ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
open_bidding {
is_open_bidding: true
}
creative_enforcement_settings {
policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY
publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_OVERRIDDEN
}
auction_environment: SERVER_SIDE_AUCTION
}
}
site {
page: "https://www.google.com"
publisher {
id: "pub-1111111111111111"
[com.google.doubleclick.publisher] {
country: "BR"
}
}
content {
livestream: false
language: "pt"
}
[com.google.doubleclick.site] {
amp: DIALECT_HTML
page_visibility: VISIBILITY_STATE_HIDDEN
inventorypartnerdomain: "OMITTED"
}
}
device {
ua: "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/109.0"
geo {
lat: 0.0
lon: 0.0
country: "BRA"
region: "BR-SP"
city: "Sao Paulo"
}
ipv6: "2804:7f0:b1c0::"
os: "Windows"
devicetype: PERSONAL_COMPUTER
lmt: false
pxratio: 1.0
sua {
platform {
brand: "Firefox"
version: "5"
version: "0"
}
}
[com.google.doubleclick.device] {
}
}
user {
[com.google.doubleclick.user] {
}
}
at: FIRST_PRICE
tmax: 300
cur: "USD"
regs {
[com.google.doubleclick.regs] {
lgpd: true
}
}
source {
[com.google.doubleclick.source] {
schain {
complete: 1
nodes {
asi: "google.com"
sid: "pub-6330791094260149"
hp: 1
}
ver: "1.0"
}
}
}
[com.google.doubleclick.bid_request] {
google_query_id: "ANy-z1n1nk-p8G11E7E4Mg3tk38VNZWB88ijTr0zpZ22Lg363603SMcty7L78211J0e34Mc3"
fcap_scope: FREQUENCY_CAPPING_SCOPE_SITE
privacy_treatments {
}
}
動画の入札リクエスト数
表示
{
id: "\\\123/f\000\t\456&\n\789\1234\"\001a\123",
ip: "\0338\355",
google_user_id: "CAESEJ1ur2l94_8ruuu",
cookie_version: 1,
cookie_age_seconds: 5184000,
hosted_match_data: "W9ABDAAAAGR67nl0",
user_agent: "Mozilla/5.0 (Linux; Android 5.1; CP8298_I00) Mobile Safari/537.36",
publisher_country: "IN",
geo_criteria_id: 1007796,
timezone_offset: 330,
publisher_id: "pub-2230723027927371",
seller_network_id: 989,
url: "https://m.example.com",
detected_language: [en],
google_query_id: "ANy-zJEgdus4l0MishbSmH0eOcXUA1Fbo4_tKROsbR37q",
auction_type: "SECOND_PRICE",
device: {
device_type: "HIGHEND_PHONE",
platform: "android",
brand: "coolpad",
model: "cp8298_i00",
os_version: {
major: 5,
minor: 1
},
carrier_id: 70210,
screen_width: 360,
screen_height: 640,
screen_pixel_ratio_millis: 2000
},
mobile: {
is_app: false,
is_mobile_web_optimized: true,
DEPRECATED_platform: "android",
DEPRECATED_mobile_device_type: "HIGHEND_PHONE",
DEPRECATED_brand: "coolpad",
DEPRECATED_model: "cp8298_i00",
DEPRECATED_os_version: {
os_version_major: 5,
os_version_minor: 1
},
DEPRECATED_screen_width: 360,
DEPRECATED_screen_height: 640,
DEPRECATED_carrier_id: 70210,
DEPRECATED_device_pixel_ratio_millis: 2000
},
publisher_type: "ADX_PUBLISHER_OWNED_AND_OPERATED",
adslot: [{
id: 1,
ad_block_key: 2882274820,
width: [300,250],
height: [250,250],
excluded_attribute: [114,22,34,25,27,13,14,15,16,17,18,19,20,25,27,22],
allowed_vendor_type: [42,144,575,698,704,743,776,785,793,797,808,828,832,885],
excluded_sensitive_category: [36,27,19,4,23,30,10,3,31,5,8,37,18],
excluded_product_category: [10031,11669,13423,13525,13566,13589,13612,13740],
excluded_creatives: [{
buyer_creative_id: "1234567.1234567890-ssl"
}],
matching_ad_data: [{
billing_id: [6629616415,51386650457],
minimum_cpm_micros: 1380000,
direct_deal: [{
direct_deal_id: 410401,
fixed_cpm_micros: 1360000,
deal_type: "PREFERRED_DEAL",
publisher_blocks_overridden: true
},{
direct_deal_id: 240644,
fixed_cpm_micros: 1500000,
deal_type: "PREFERRED_DEAL",
publisher_blocks_overridden: true
}]
},{
billing_id: [1234567890],
minimum_cpm_micros: 1380000
}],
publisher_settings_list_id: [12109930661871909476,11138951146123409010],
slot_visibility: "BELOW_THE_FOLD",
viewability: 30,
click_through_rate: 0.0010072842,
iframing_state: "UNKNOWN_IFRAME_STATE",
native_ad_template: [{
required_fields: 1065,
recommended_fields: 4,
headline_max_safe_length: 25,
body_max_safe_length: 90,
call_to_action_max_safe_length: 15,
advertiser_max_safe_length: 25,
logo_width: 100,
logo_height: 100,
style_id: 199892,
style_height: 250,
style_width: 300
}],
sticky_settings: {
},
renderer: "GOOGLE",
is_amp_page: "DIALECT_HTML",
amp_ad_requirement_type: "AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED",
allowed_ad_types: [ALLOWED_AD_TYPE_BANNER,ALLOWED_AD_TYPE_NATIVE],
session_depth: 1,
internal_data: {
}
}],
response_deadline_ms: 122,
is_test: false
}
入札レスポンスの例
これらのレスポンスの値は、上記の対応するリクエストと一致するものではありません。ただし、リクエストのテンプレートで必須フィールドまたは省略可能なフィールドが示されている場合、レスポンスはそれらの要件に準拠しています。
動画以外の入札レスポンス
Google
例を表示
ad {
adslot {
id: 1
max_cpm_micros: 3000000
billing_id: 34438877165
deal_id: 1
buyer_reporting_id: "DjA6yW8"
}
click_through_url: "google.com"
attribute: 47
buyer_creative_id: "test_creative_id_845142"
native_ad {
headline: "Luxury Mars Cruises"
body: "Visit the planet in a luxury spaceship."
call_to_action: "Book today"
advertiser: "Galactic Luxury Cruises"
image {
url: "https://native.test.com/image?id=123456"
width: 1200
height: 627
}
logo {
url: "https://native.test.com/logo?id=123456"
width: 200
height: 200
}
app_icon {
url: "https://native.test.com/icon?id=123456"
width: 200
height: 200
}
click_link_url: "https://www.google.com"
}
impression_tracking_url: "https://test.com/imp?id=123456"
ad_choices_destination_url: "https://test.com/preferences"
event_notification_token: "token"
}
processing_time_ms: 5
OpenRTB JSON
例を表示
{
"id": "j53Z8GLLnSq8N97uXu029T",
"seatbid": [
{
"bid": [
{
"id": "0kcWm8o4Q44BV54eOX8",
"impid": "1",
"price": 0.0612,
"adid": "test_creative_id_838714",
"adm": "{\"assets\": [{\"id\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"data\": {\"value\": \"Galactic Luxury Cruises\"}}, {\"id\": 3, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"w\": 1200, \"h\": 627}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"]}",
"adomain": [
"google.com"
],
"cid": "19693706542",
"crid": "test_creative_id_838714",
"ext": {
"ad_choices_destination_url": "https://test.com/preferences"
}
}
],
"seat": "8710:9087:596625"
}
],
"bidid": "50x4472o-qpci0H0b-Ovbp-6C470CnUTyA2"
}
OpenRTB プロトコル バッファ
例を表示
id: "W4E2PD2Vr8Gl4Eq70eoT6v"
seatbid {
bid {
id: "uz3aH5W5Tzvc42GkuXT"
impid: "1"
price: 0.04632
adomain: "google.com"
cid: "43493646043"
crid: "test_creative_id_877701"
cat: "IAB13-7"
adm_native {
ver: "1.0"
assets {
id: 1
required: true
title {
text: "Luxury Mars Cruises"
}
}
assets {
id: 2
required: true
data {
value: "Visit the planet in a luxury spaceship."
}
}
assets {
id: 4
required: true
img {
url: "https://native.test.com/image?id=123456"
w: 1200
h: 627
}
}
link {
url: "https://www.google.com"
}
imptrackers: "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
}
[com.google.doubleclick.bid] {
ad_choices_destination_url: "https://test.com/preferences"
billing_id: 43493646043
}
}
bid {
id: "19794j5G3x4mpfzvr4m"
impid: "1"
price: 0.032292
adomain: "google.com"
cid: "43493646043"
crid: "test_creative_id_877701"
cat: "IAB7-44"
adm_native {
ver: "1.0"
assets {
id: 1
required: true
title {
text: "Luxury Mars Cruises"
}
}
assets {
id: 2
required: true
data {
value: "Visit the planet in a luxury spaceship."
}
}
assets {
id: 4
required: true
img {
url: "https://native.test.com/image?id=123456"
w: 1200
h: 627
}
}
link {
url: "https://www.google.com"
}
imptrackers: "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
}
[com.google.doubleclick.bid] {
ad_choices_destination_url: "https://test.com/preferences"
billing_id: 43493646043
}
}
seat: "6718:8545:950241"
group: false
}
bidid: "ah128WV2-1j995674-5243-f57Et5RtZLF7"
cur: "USD"
動画の入札レスポンス
表示
bid_response {
ad {
...
click_through_url: "https://www.exampleDomain.com"
impression_tracking_url: "https://my_impression_tracking_url.com/"
ad_choices_destination_url: "https://my_ad_choices_destination_url.com/"
...
native_ad {
headline: "Lowest mortgage rates"
video_url: "https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/124319096/external/single_ad_samples&ciu_szs=300x250&impl=s&gdfp_req=1&env=vp&output=vast"
call_to_action: "Get a quote"
advertiser: "NY Mortgage Inc."
image {
url: "https://www.example.net/mypromoimage.png"
width: 1200
height: 700
}
logo {
url: "https://www.example.net/mylogo.png"
width: 200
height: 200
}
click_link_url: "https://r1.example.com/r/u1dhfh3cow00/b1_googleadx/830/41972/ ?_b_ctrl=1"
click_tracking_urls: "https://my_click_tracking_url.com/"
}
}
}