ネイティブ広告

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

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

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

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

メッセージの形式

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

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

ビットフィールドは、バイナリ値の各ビットを使用して true または false ステートメントを格納します。これは、is_logo_required や is_header_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 で記述されます。これらのメッセージには、ネイティブ広告枠に関する次の詳細情報が含まれます。

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

OpenRTB アセット ID

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

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

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

入札リクエストの例

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

OpenRTB ProtobufOpenRTB JSONGoogle
シリアル化されたリクエスト
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
}
 
{
  "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
  }
}
シリアル化されたリクエスト
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 ProtobufOpenRTB JSONGoogle
シリアル化されたレスポンス
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"
 
{
  "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"
}
シリアル化されたレスポンス
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/"
    }
  }
}