このページは Cloud Translation API によって翻訳されました。

ネイティブ広告

ネイティブ広告は、周囲のコンテンツやデザインに合わせて表示されるので、ユーザーが目を留めてクリックする可能性が高くなります。ネイティブ広告枠は、モバイルアプリ、パソコン向けウェブサイト、モバイルウェブサイトで利用できます。ネイティブ広告の詳細については、ネイティブ広告の概要をご覧ください。

ネイティブ広告は、認定バイヤーと Open Bidding の両方でサポートされています。

ネイティブ広告のワークフローは次のとおりです。

ネイティブ広告の募集が Google に送信されます。呼び出しで、次のネイティブ広告テンプレートの 1 つまたは両方を指定します。それぞれ、優先するネイティブフィールドを指定します。
Google から購入者に、リクエストされたフィールドのリストを含む RTB 入札リクエストが送信されます。
興味を持った購入者が応答し、リクエストされたフィールドの値を返します。
Google でオークションが開かれ、落札者が決まると、落札者から提供されたクリエイティブアセットがパブリッシャーに送信されます。
パブリッシャー側で、そのアセットを使って、サイトのデザインに合ったスタイルのネイティブ広告が作成されます。

メッセージの形式

Google は、JSON と Protobuf の両方で OpenRTB 仕様をサポートしています。

OpenRTB Protobuf ネイティブ広告の場合、次のフィールドは仕様と異なります。

JSON	JSON 型	Protobuf	Protobuf タイプ
`BidRequest.imp[].native.request`	`string`	`BidRequest.imp[].native.request_native`	`NativeRequest`
`BidResponse.seatbid[].bid[].adm`	`string`	`BidResponse.seatbid[].bid[].adm_native`	`NativeResponse`

OpenRTB Protobuf フィールドは、文字列ではなく Protobuf メッセージです。

OpenRTB Protobuf 実装を使用する場合、エンドポイントは BidRequest.imp.native.request ではなく BidRequest.imp.native.request_native を含む入札リクエストを受信します。また、エンドポイントは、BidResponse.seatbid.bid.adm ではなく BidResponse.seatbid.bid.adm_native に値を設定する入札レスポンスを返す必要があります。そうしないと、オークションから除外されます。

購入者 SDK を使用してネイティブ広告をレンダリングする場合は、クリエイティブを審査に送信するときに、declared_ad に画像 type を含める必要があります。

ネイティブ広告テンプレート

ネイティブ広告テンプレートは、ネイティブ広告のコンポーネントを記述し、入札リクエスト内の OpenRTB の NativeRequest または非推奨の Google RTB プロトコルの NativeAdTemplate のコンテンツと構造を決定します。Google では、動画以外のネイティブ広告と動画ネイティブ広告の、最も一般的な 2 つのネイティブ広告テンプレートがサポートされています。

アプリインストール広告テンプレート - モバイルアプリのインストールを促進します。
コンテンツ広告テンプレート - ブランド広告やウェブ広告向けのテキストと画像の一般的な組み合わせ。
アプリインストール動画広告テンプレート
コンテンツ動画広告テンプレート

上記以外のテンプレートもありますが、フィールドや掲載面積、広告サイズの要件は、テンプレートによって異なる場合があります。

アプリインストール広告テンプレート

必須フィールドと推奨フィールド

次の表に、[必須] または [推奨] とラベル付けされたフィールドを示します。次のルールが適用されます。

[必須] とマークされているフィールドは、入札者が必須としています。
[推奨] とマークされたフィールドは入札者にとって必須ではありません。また、指定されたフィールド（星評価など）をパブリッシャーが表示するかどうかは任意です。
行動を促すフレーズ（CTA）は常に [推奨] とマークされます。これは、ビッダーから送信されなかった場合、デフォルトが割り当てられるためです。ただし、送信された場合は常に表示されます。

次の表に、アプリインストール広告テンプレートのフィールドを示します。モバイルアプリでは、これらのフィールドを使用してネイティブアプリインストール広告を作成します。

フィールド	説明	必須または推奨	常に表示されますか？	推奨される画像サイズ/最大文字数	例
広告見出し	アプリのタイトル	必須	○	25 文字	Flood-It!
画像	アプリのスクリーンショット、または関連する画像	必須	いいえ	パブリッシャーが求めるアスペクト比に応じて、1,200 ピクセル x 627 ピクセルまたは 600 ピクセル x 600 ピクセル。	<ゲーム「Flood-It!」のスクリーンショット>
本文	アプリのメインのテキスト	必須	いいえ	90 文字	一見シンプルで、挑戦しがいのあるゲーム。一度始めるとやめられない！
アプリのアイコン	アプリアイコン	必須	いいえ	128 x 128 px	<Flood-it! アプリアイコン>
行動を促すフレーズ	推奨されるユーザー操作	推奨	○	15 文字	インストール
評価	アプリストアでのアプリの評価を示す星の数（0 ～ 5）	推奨	いいえ	0 ～ 5	4.5
価格	アプリの費用	推奨	いいえ	15 文字	無料

テキストの長さに関するメモ

推奨される最大文字数を超えるテキストアセット（本文など）をバイヤーが送信した場合、Google またはパブリッシャーによってテキストが切り捨てられ、切り捨てられた部分が省略文字で示されることがあります。なお、切り捨て上限は、中国語、日本語、韓国語では半分の文字数になります。たとえば、英語の見出しの制限は 90 文字ですが、日本語では 45 文字となります。

画像サイズに関する注意事項

パブリッシャーは以下を行うことができます。

メイン画像の幅または高さのいずれかのサイズを最大 20% 切り詰めることができます。その際は、両端から均等に切り詰めます。
アスペクト比を変更せずに画像を拡大縮小します。
高さと幅から想定されるアスペクト比と大幅に異なる画像は、フィルタされる場合があります。

コンテンツ広告テンプレート

次の表に、コンテンツ広告テンプレートのフィールドを示します。パブリッシャーはこれらのフィールドを使用してネイティブコンテンツ広告を作成します。

フィールド	説明	必須または推奨	常に表示されますか？	推奨画像サイズ/最大文字数 *	例
広告見出し	広告ヘッダー	必須	○	25 文字	住宅ローンの最低金利
画像	広告のメイン画像	必須	いいえ	パブリッシャーが求めるアスペクト比に応じて、1,200 ピクセル x 627 ピクセルまたは 600 ピクセル x 600 ピクセル。	<広告のメイン画像>
本文	広告内容	必須	いいえ	90 文字	ブルックリンの夢のマイホーム - 思ったより安く、早く手に入る
ロゴ	広告主のロゴまたは関連する小さな画像	推奨	いいえ	128 x 128 px	<NY Mortgage Inc. のロゴ>
行動を促すフレーズ	ユーザーが希望するアクション	推奨	いいえ	15 文字	見積もりを依頼
広告主様	広告主またはブランドを識別するテキスト	必須	いいえ	25 文字	NY Mortgage Inc.

アプリインストール動画広告テンプレート

フィールド	説明	必須または推奨	常に表示されますか？	推奨画像サイズ/最大文字数 *	例
動画	動画広告の再生に必要なすべてのアセットを含む動画 VAST レスポンス。	必須	いいえ	-	Flood-It! を含む VAST XML の URL。動画広告
見出し	アプリのタイトル	必須	○	25 文字	Flood-It!
画像	動画広告のクリック前または読み込み中に、プレーヤーに表示される画像（サムネイル）。	必須	いいえ	動画のアスペクト比に一致する必要があります（例: アスペクト比が 16:9 の場合は 1280x720、4:3 の場合は 640x480）。	ゲーム「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 文字	住宅ローンの最低金利
画像	動画広告のクリック前または読み込み中に、プレーヤーに表示される画像（サムネイル）。	必須	いいえ	動画のアスペクト比に一致する必要があります（例: アスペクト比が 16:9 の場合は 1280x720、4:3 の場合は 640x480）。	動画のスクリーンショット
本文	広告コンテンツ	必須	いいえ	90 文字	ブルックリンの夢のマイホーム - 思ったより安く、早く手に入る！
ロゴ	広告主のロゴまたは関連する小さな画像	推奨	いいえ	128 x 128 px	NY Mortgage Inc. のロゴ
行動を促すフレーズ	ユーザーが希望するアクション	必須	いいえ	15 文字	見積もりを依頼する
広告主	広告主またはブランドを識別するテキスト	必須	いいえ	25 文字	NY Mortgage Inc.

メタフィールド

次のメタフィールドは、サポートされているすべての広告テンプレートで共有されます。

Google RTB プロトコル	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 のネイティブインプレッショントラッカーでトラッキングする必要があります。

Google RTB プロトコルの必須フィールドと推奨フィールド

required_fields と recommended_fields はパブリッシャーが指定します。これらのビットフィールドを変換して、フィールドが必須か推奨かを確認する方法について説明します。

ビットフィールドは、バイナリ値の各ビットを使用して true または false ステートメントを格納します。これは、is_logo_required や is_header_required などの多くのブール値シグナルを送信するのと同じですが、すべてまとめてパックされます。

注: OpenRTB では、BidRequest.imp.native.request_native.assets.required フィールドで特定のフィールドが必須か推奨かを判断します。

例

この例では、required_fields 値として 1085 を使用します。

まず、同等のバイナリ値 10000111101 を見つけます。

バイナリ値を取得したら、ビットをチェックして、フィールドが必須（1）か必須でない（0）かを確認できます。

次の表に、フィールドとバイナリ値の位置を示します。バイナリ値の右端のビットに相当する 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`	○

入札リクエストでのネイティブ広告テンプレートの表現

ネイティブ広告枠を含む入札リクエストを受信すると、使用されているプロトコルによって異なる形式のネイティブ広告テンプレートが含まれます。Google プロトコルは非推奨になっているため、OpenRTB の使用をおすすめします。

OpenRTB では、ネイティブ広告テンプレートは NativeRequest メッセージで記述されます。Google RTB プロトコルでは、NativeAdTemplate で記述されます。これらのメッセージには、ネイティブ広告枠に関する次の詳細情報が含まれます。

必須または推奨のフィールド。
画像、ロゴ、アプリアイコンのサイズ。
広告のレンダリングスタイルの仕様。

注: style_layout_type フィールドで、PIXEL はネイティブユニットが固定サイズであることを示します。FLUID は、ネイティブユニットが、囲む列の幅いっぱいになるようにスケーリングされ、アスペクト比を維持するために高さが調整されることを意味します。FLUID が指定されている場合、高さと幅は 1x1 として渡されることがあります。

OpenRTB アセット ID

OpenRTB は、レスポンスで返すネイティブ広告の構造を記述するアセットの配列を入札リクエストで渡します。リクエスト内の各アセットには ID があり、レスポンスで対応するアセットに指定する必要があります。これらの ID がリクエストとレスポンスでどのように対応しているかの例については、ネイティブ入札リクエストのサンプルとネイティブ入札レスポンスのサンプルをご覧ください。

入札レスポンスでのネイティブ広告の表現

ネイティブ広告枠に入札する場合、購入者は入札リクエストで特定された必須フィールドに値を入力する必要があります。OpenRTB では、Protobuf を使用する場合は BidResponse.seatbid.bid.adm_native、JSON の場合は BidResponse.seatbid.bid.adm を使用して、この操作を行うことができます。サポートが終了した Google プロトコルでは、BidResponse.ad.native_ad フィールドを使用して行います。

入札リクエストの例

注: レスポンスで必須または省略可能な項目については、入札リクエストのネイティブ広告テンプレートをご確認ください。OpenRTB の場合は BidRequest.imp.native にあります。非推奨の Google プロトコルの場合は、BidRequest.adslot.native_ad_template で確認できます。

動画以外の入札リクエスト

OpenRTB Protobuf

例を表示

シリアル化されたリクエスト

id: "l6210s8bS8Uc726V81B821"
imp {
  id: "1"
  tagid: "3019814809"
  bidfloor: 0.06
  bidfloorcur: "USD"
  secure: true
  native {
    ver: "1.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
        }
      }
      assets {
        id: 5
        img {
          type: LOGO
          wmin: 100
          hmin: 100
        }
      }
      eventtrackers {
        event: IMPRESSION
        methods: IMG
      }
      privacy: true
      [com.google.doubleclick.native_ext] {
        style_id: 497439
        style_height: 1
        style_width: 1
        style_layout_type: FLUID
      }
    }
  }
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.0006697923527099192
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.05
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 50577321529
    dfp_ad_unit_code: "/3711494/google/test"
    ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
    buyer_generated_request_data {
      data: "Test Data"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    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
    ae: SERVER_SIDE_AUCTION
  }
}
site {
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "FR"
    }
  }
  content {
    livestream: false
    language: "fr"
  }
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_VISIBLE
    inventorypartnerdomain: ""
    ntype: NAVIGATION_TYPE_NAVIGATE
  }
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "FRA"
    region: "FR-C"
    zip: "63120"
    type: IP
    utcoffset: 120
    accuracy: 6948
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9112278
    }
  }
  ipv6: "2a01:cb14:8183::"
  os: "Windows"
  devicetype: PERSONAL_COMPUTER
  lmt: false
  pxratio: 1.0
  sua {
    browsers {
      brand: "Chromium"
      version: "130"
      version: "0"
    }
    browsers {
      brand: "Microsoft Edge"
      version: "130"
      version: "0"
    }
    platform {
      brand: "Windows"
      version: "15"
      version: "0"
    }
    mobile: false
    architecture: "x86"
    bitness: "64"
    source: CLIENT_HINTS_HIGH_ENTROPY
  }
}
user {
  [com.google.doubleclick.user] {
    consented_providers_settings {
      consented_providers: 1712
      consented_providers: 2316
      additional_consent: "OMITTED"
    }
    consent: "OMITTED"
    eids {
      source: "OMITTED"
      uids {
        id: "12JD92JD8078S8J29SDOAKC0EF230337"
      }
    }
  }
}
at: FIRST_PRICE
tmax: 350
cur: "USD"
regs {
  gpp: "OMITTED"
  [com.google.doubleclick.regs] {
    gdpr: true
  }
}
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    schain {
      complete: 1
      nodes {
        asi: "testssp.com"
        sid: "pub-1111111111111111"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_NONE
}

OpenRTB JSON

例を表示

{
  "id": "l6210s8bS8Uc726V81B821",
  "imp": [
    {
      "id": "1",
      "tagid": "3019814809",
      "bidfloor": 0.06,
      "bidfloorcur": "USD",
      "secure": 1,
      "native": {
        "ver": "1.2",
        "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"data\":{\"type\":2,\"len\":90}},{\"id\":3,\"data\":{\"type\":12,\"len\":15}},{\"id\":4,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":5,\"img\":{\"type\":2,\"wmin\":100,\"hmin\":100}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1,\"ext\":{\"style_id\":497439,\"style_height\":1,\"style_width\":1,\"style_layout_type\":1}}"
      },
      "exp": 3600,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.0006697923527099192,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.05,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "50577321529"
        ],
        "dfp_ad_unit_code": "/3711494/google/test",
        "ampad": 3,
        "buyer_generated_request_data": [
          {
            "data": "Test Data"
          }
        ],
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "open_bidding": {
          "is_open_bidding": 1
        },
        "creative_enforcement_settings": {
          "policy_enforcement": 1,
          "publisher_blocks_enforcement": 2
        },
        "auction_environment": 0,
        "ae": 0
      }
    }
  ],
  "site": {
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "FR"
      }
    },
    "content": {
      "livestream": 0,
      "language": "fr"
    },
    "ext": {
      "amp": 0,
      "page_visibility": 1,
      "inventorypartnerdomain": "OMITTED",
      "ntype": 1
    }
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "FRA",
      "region": "FR-C",
      "zip": "63120",
      "type": 2,
      "utcoffset": 120,
      "accuracy": 6948,
      "ext": {
        "geo_criteria_id": 9112278
      }
    },
    "ipv6": "2a01:cb14:8183::",
    "os": "Windows",
    "devicetype": 2,
    "lmt": 0,
    "pxratio": 1.0,
    "sua": {
      "browsers": [
        {
          "brand": "Chromium",
          "version": [
            "130",
            "0"
          ]
        },
        {
          "brand": "Microsoft Edge",
          "version": [
            "130",
            "0"
          ]
        }
      ],
      "platform": {
        "brand": "Windows",
        "version": [
          "15",
          "0"
        ]
      },
      "mobile": 0,
      "architecture": "x86",
      "bitness": "64",
      "source": 2
    }
  },
  "user": {
    "ext": {
      "consented_providers_settings": {
        "consented_providers": [
          "1712",
          "2316"
        ],
        "additional_consent": "OMITTED"
      },
      "consent": "OMITTED",
      "eids": [
        {
          "source": "OMITTED",
          "uids": [
            {
              "id": "12JD92JD8078S8J29SDOAKC0EF230337"
            }
          ]
        }
      ]
    }
  },
  "at": 1,
  "tmax": 350,
  "cur": [
    "USD"
  ],
  "regs": {
    "gpp": "OMITTED",
    "ext": {
      "gdpr": 1
    }
  },
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "testssp.com",
            "sid": "pub-1111111111111111",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v",
    "fcap_scope": 1
  }
}

Google

例を表示

シリアル化されたリクエスト

id: "\213\371#\236Mh\214uJ\356\225qW88=7|\2448\315Wx"
ip: "\300\250"
user_agent: "OMITTED"
url: "https://www.google.com"
detected_language: "it"
adslot {
  id: 1
  excluded_attribute: 14
  excluded_attribute: 32
  allowed_vendor_type: 42
  allowed_vendor_type: 144
  excluded_sensitive_category: 36
  excluded_sensitive_category: 19
  matching_ad_data {
    billing_id: 74792558829
    billing_id: 11204117851
    minimum_cpm_micros: 390000
  }
  matching_ad_data {
    billing_id: 44428418146
    billing_id: 91112044263
    minimum_cpm_micros: 110000
  }
  slot_visibility: BELOW_THE_FOLD
  excluded_product_category: 10366
  excluded_product_category: 11504
  ad_block_key: 8767661977
  publisher_settings_list_id: 7807286827624818876
  publisher_settings_list_id: 8186380472781289268
  allowed_restricted_category: 32
  allowed_restricted_category: 33
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  iframing_state: UNKNOWN_IFRAME_STATE
  viewability: 6
  allowed_restricted_category_for_deals: 32
  allowed_restricted_category_for_deals: 33
  click_through_rate: 0.0010397299
  allowed_ad_types: ALLOWED_AD_TYPE_NATIVE
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
  secure_signals {
    data: "Test Data: bw44G12BFZ"
    source: "OMITTED"
  }
  consented_providers_settings {
    tcf_consent_string: "OMITTED"
    additional_consent_string: "OMITTED"
  }
  regs_gdpr: true
  native_ad_template {
    required_fields: 17
    recommended_fields: 0
    headline_max_safe_length: 90
    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: 749853
    style_layout_type: FLUID
    style_height: 1
    style_width: 1
  }
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY
    publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
  }
  auction_environment: SERVER_SIDE_AUCTION
  impression_expiration_seconds: 3600
  supported_auction_environment: SERVER_SIDE_AUCTION
}
is_test: false
timezone_offset: 120
geo_criteria_id: 1008463
bid_response_feedback {
  request_id: "\314\354d\177=@0\271\226a^\250\302u\037\301"
  creative_status_code: 1
  event_notification_token: "token"
  buyer_creative_id: "test_creative_id_744913"
  minimum_bid_to_win: 220000
  feedback_type: BID_FEEDBACK
}
bid_response_feedback {
  request_id: "\2354\335\340\347!\341~\265\n\206\327\300\005\370G"
  creative_status_code: 80
  event_notification_token: "token"
  buyer_creative_id: "test_creative_id_744913"
  minimum_bid_to_win: 3450000
  feedback_type: BID_FEEDBACK
}
publisher_type: PUBLISHER_OWNED_AND_OPERATED
device {
  device_type: PERSONAL_COMPUTER
  platform: "Windows"
  screen_pixel_ratio_millis: 1000
  limit_ad_tracking: false
}
publisher_country: "IT"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 350
google_query_id: "ANy-zJXQF6-ob5v09r508m39543114QNHDY20RX67Ajs996K62nkEpcMuvWam950XP9486e6"
auction_type: FIRST_PRICE
geo {
  lat: 0.0
  lon: 0.0
  country: "ITA"
  region: "IT-MI"
  city: "Milan"
  utcoffset: 120
  accuracy: 6821
}
user_agent_data {
  platform {
    brand: "Windows"
    version: "10"
    version: "0"
  }
  mobile: false
  architecture: "x86"
  browsers {
    brand: "Chromium"
    version: "128"
    version: "0"
  }
  browsers {
    brand: "Not;A=Brand"
    version: "24"
    version: "0"
  }
  bitness: "64"
  source: CLIENT_HINTS_HIGH_ENTROPY
}
page_visibility: VISIBILITY_STATE_VISIBLE
supply_chain {
  complete: true
  nodes {
    advertising_system_identifier: "testdomain.com"
    seller_identifier: "pub-1111111111111111"
    handles_payment: true
  }
  version: "1.0"
}
frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_NONE
privacy_treatments {
  allow_user_data_collection: true
}
inventory_partner_domain: "OMITTED"

動画入札リクエスト

{
  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
}

入札レスポンスの例

動画以外の入札レスポンス

OpenRTB Protobuf

例を表示

シリアル化されたレスポンス

id: "22i22S9494PQl819H7Ld5K"
seatbid {
  bid {
    id: "2GTnPXOn76gg1C6574T"
    impid: "1"
    price: 0.24
    adid: "test_creative_id_713312"
    adomain: "google.com"
    crid: "test_creative_id_713312"
    exp: 300
    language: "xx"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        data {
          value: "Visit the planet in a luxury spaceship."
        }
      }
      assets {
        id: 3
        data {
          value: "Book today"
        }
      }
      assets {
        id: 4
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      assets {
        id: 5
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 1200
          h: 1200
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
      privacy: "https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 50577321529
      third_party_buyer_token: "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7"
    }
  }
  seat: "5249:9218:332606"
}
cur: "USD"

OpenRTB JSON

例を表示

{
  "id": "22i22S9494PQl819H7Ld5K",
  "seatbid": [
    {
      "bid": [
        {
          "id": "2GTnPXOn76gg1C6574T",
          "impid": "1",
          "price": 0.24,
          "adid": "test_creative_id_713312",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_713312",
          "exp": 300,
          "language": "xx",
          "ext": {
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "50577321529",
            "third_party_buyer_token": "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7"
          },
          "adm": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}},{\"id\":5,\"img\":{\"url\":\"https://native.test.com/logo?id=123456\",\"w\":1200,\"h\":1200}}],\"link\":{\"url\":\"https://www.google.com\",\"clicktrackers\":[\"https://native.test.com/click?id=123456\"]},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"},{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"
        }
      ],
      "seat": "5249:9218:332606"
    }
  ],
  "cur": "USD"
}

Google

例を表示

シリアル化されたレスポンス

ad {
  adslot {
    id: 1
    max_cpm_micros: 110734
    min_cpm_micros: 0
    billing_id: 74792558829
    deal_id: 0
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_907643"
  advertiser_name: "Google"
  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: 800
      height: 800
    }
    logo {
      url: "https://native.test.com/logo?id=123456"
      width: 200
      height: 200
    }
    price: "\342\202\254 225"
    click_link_url: "https://www.google.com"
  }
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  ad_choices_destination_url: "https://test.com/preferences"
  event_notification_token: "token"
  dsa_transparency {
    buyer_render: true
  }
}
processing_time_ms: 27

動画の入札レスポンス

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/"
    }
  }
}

ネイティブ広告

メッセージの形式

ネイティブ広告テンプレート

アプリ インストール広告テンプレート

必須フィールドと推奨フィールド

テキストの長さに関するメモ

画像サイズに関する注意事項

コンテンツ広告テンプレート

アプリ インストール動画広告テンプレート

制限事項

アプリ インストール広告の例

動画コンテンツ広告テンプレート

メタフィールド

Google RTB プロトコルの必須フィールドと推奨フィールド

例

入札リクエストでのネイティブ広告テンプレートの表現

OpenRTB アセット ID

入札レスポンスでのネイティブ広告の表現

入札リクエストの例

動画以外の入札リクエスト

OpenRTB Protobuf

例を表示

OpenRTB JSON

例を表示

Google

例を表示

動画入札リクエスト

入札レスポンスの例

動画以外の入札レスポンス

OpenRTB Protobuf

例を表示

OpenRTB JSON

例を表示

Google

例を表示

動画の入札レスポンス

アプリインストール広告テンプレート

アプリインストール動画広告テンプレート

アプリインストール広告の例