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

レスポンスを作成する

Google からの入札リクエストをアプリケーションで処理したら、アプリケーションでレスポンスを送信します。このガイドでは、アプリケーションをコーディングし、返されます。

入札レスポンスメッセージを作成する

認定バイヤーは、BidRequest を HTTP POST。アプリケーションから送信されるレスポンスには、 Content-Type ヘッダーを application/octet-stream に設定シリアル化されたプロトコルバッファで構成されるメッセージ本文です。プロトコルバッファは、BidResponse メッセージです。 realtime-bidding.proto。アプリケーションが、解析可能な BidRequest ごとに BidResponse を返します。タイムアウト解析できないレスポンスはエラーと見なされ、Google はエラー率の高いビッダーからの入札を除外します

インプレッションに入札したくない場合は、 processing_time_ms フィールドのみ、その他のフィールドはそのままにします。空です。realtime-bidding.proto は、参照データのページをご覧ください。

クリエイティブ ID

BidResponse では、 buyer_creative_id フィールド（64 バイトの上限）。類似のクリエイティブであっても異なる場合は、buyer_creative_id に一意の値を指定する必要があります。主な特徴（サイズ、宣言された URL、クリエイティブの属性、ベンダータイプを指定します。言い換えると、2 つの Pod に次の条件に該当する 2 つの広告に割り当てることができます。

見た目や動作が異なります。
さまざまな画像にレンダリングできます。
さまざまな方法でレンダリングする（例: 1 つの広告が画像で構成され、もう一方には Flash が含まれています）。

アプリケーションを設計する際には、作成するクリエイティブの種類に適した識別子を生成する提出してください。

広告の帰属表示

広告の属性を詳細に説明したクリエイティブ属性を宣言する必要があります。 BidResponse.Ad.attribute での特性とそのターゲティングです。「あります（サポートされている全属性のリストも参照してください）。属性 buyer-declarable-creative-attributes.txt):

7 Tagging: IsTagged
広告には、独自のピクセルまたはウェブビーコンが後続のリマーケティングに使用する Cookie ID のリスト。
8 Remarketing: IsRemarketing
この広告では、Cookie ID またはデバイス ID に基づいてユーザーをターゲティングしています。 Cookie ID またはデバイス ID のリストは、以前に購入者が所有または代理人を務めるサイトとやり取りしたことのあるレポートです。
9 UserInterestTargeting: IsUserInterestTargeted
この広告では、Cookie ID またはデバイス ID に基づいてユーザーをターゲティングしています。 Cookie ID のリストまたはデバイス ID は、購入者が指定した一連の消費者を共通のインタレストグループとして定義されます。
30 InstreamVastVideoType: Vpaid
広告を表示するには VPAID 対応が必要。
32 MraidType: MRAID
広告をレンダリングするには MRAID API が必要です。

さらに、次の属性がサポートされていますが、その宣言は必要ない。認定バイヤーではそうしたオーディエンスが自動的に検出され、宣言ではなく検出された値に基づいてクリエイティブを制御します。詳しくは、クリエイティブ API で、検出されたプロパティに関するフィードバックを取得する方法を作成できます。

34 RichMediaCapabilityType: RichMediaCapabilityFlash
広告を表示するには Flash サポートが必要です。
50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
広告を表示するために Flash を必要としない。
47 RichMediaCapabilityType: RichMediaCapabilitySSL
広告を SSL ページで表示できる。認定バイヤーでは異なるものとして宣言され、異なるものとして識別されます（これらは審査されます）個別の承認ステータスが割り当てられます。そのため SSL と SSL 非対応バージョンの広告がある場合は、それに応じてこの属性を宣言する必要があります。これにより、この区別が AdX に正しく反映されるようになります。

Open Bidding フィールド

Open に参加しているエクスチェンジとネットワーク入札者から送信される入札レスポンス入札は、スタンダードティアの認定バイヤーの入札とリアルタイムビッダーOpen Bidding のお客様は既存の一部のフィールドについては、別の用途がある場合があります。これらの次の内容が含まれます。

OpenRTB	認定バイヤー	詳細
`BidResponse.imp[].pmp.deals[].id`	`BidResponse.ad[].adslot[].exchange_deal_id`	これに関連付けられているエクスチェンジの名前空間の取引 ID パブリッシャーに報告されます注: 現在、このフィールドはクローズドベータ版にのみ送信されます。できます。
`BidResponse.seatbid[].bid[].ext.exchange_deal_type`	`BidResponse.ad[].adslot[].exchange_deal_type`	パブリッシャーに報告される取引のタイプ。取引の方法に影響します。関連付けられます注: 現在、このフィールドはクローズドベータ版にのみ送信されます。できます。
`BidResponse.seatbid[].bid[].ext.third_party_buyer_token`	`BidResponse.ad[].adslot[].third_party_buyer_token`	第三者の購入者情報を特定するために使用されるトークン Open Bidding のエクスチェンジが仲介役になります。これは入札で変更されることなく Google に渡される必要があります。レスポンスが返されます。

推奨事項

永続的な HTTPS 接続（「keep-alive」または「接続の再利用」）によって保護するものではありません。タイムアウトを 10 秒に設定します。最小値です。値が大きいほど有益です。Google による確認これは、アプリケーションの最初のレイテンシテスト中に行われます。これは、認定バイヤーは頻繁にリクエストを送信するため、アプリケーションごとに個別の TCP 接続を確立することによるリクエストできます。
必要に応じてインプレッショントラッキング URL も組み込み、落札したときではなく離脱のためレンダリングが分割されるため、精度の高いトラッキングができます。

注: OpenRTB 2.5 以降を使用している場合、標準フィールド BidResponse.seatbid[].bid[].burl です。
ビッダーのコードをサポートが終了したフィールドに依存しないようにしてください。入札が失敗する可能性があります
BidResponse.Ad.width とあなたのBidResponseにBidResponse.Ad.height。複数の広告サイズを含むリクエストに BidResponse するには、 width と height の値を含めないと、オークションから除外された割合です
レスポンスのサイズを 8,000 未満に制限します。回答のサイズが非常に大きいと、タイムアウトの原因となる場合があります
SKAdNetwork アトリビューションが必要な iOS 広告枠に入札する

入札レスポンスの例

次の例は、人間が読める形式の Protobuf サンプルと JSON リクエスト。

Google

例を表示

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 10100
    billing_id: 30279159795
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_766108"
  advertiser_name: "Google"
  width: 320
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 8

OpenRTB JSON

例を表示

{
  "id": "sW2R7543D2w77f0542uu0F",
  "seatbid": [
    {
      "bid": [
        {
          "id": "U4495qveIO2A83s1iOs",
          "impid": "1",
          "price": 0.10701,
          "adid": "test_creative_id_323125",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "54460865479",
          "crid": "test_creative_id_323125",
          "w": 300,
          "h": 250,
          "ext": {
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "1506:2993:976791"
    }
  ],
  "bidid": "WN7415ff-hN7R6080-3txk-r0J45ckY5970"
}

OpenRTB プロトコルバッファ

例を表示

id: "q745y3S4jz5Qg43A6izy2V"
seatbid {
  bid {
    id: "Fi366E0I1RN4Ofm8Ug5"
    impid: "1"
    price: 0.02
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "51570472186"
    crid: "test_creative_id_520474"
    w: 468
    h: 60
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 51570472186
    }
  }
  seat: "1608:1311:489067"
}
bidid: "6930l9D4-1A9090lR-451S-01g3xTZv8382"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 100
}

重要: ここでは、人が読めるテキストとして表されます。しかし、それはメッセージはネットワーク経由で送信されます。Google または OpenRTB プロトコルバッファを使用する場合形式の場合、シリアル化された入札レスポンスメッセージのみ受け入れられます。

BidResponse メッセージを作成してシリアル化するには、次のコマンドを使用します。次の C++ コードは次のようになります。

BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
  // respond to the POST with post_response as the content
} else {
  // return an error to the POST
}

クリエイティブを指定する

入札レスポンスでは、落札した場合に配信するクリエイティブを指定します。入札単価サポートされている広告フォーマット（AMP、動画、ネイティブ）のいずれかを含める必要があります。このこの例では、html_snippet フィールドを使用してクリエイティブを指定しています。

または、次のいずれかを使用してクリエイティブを指定することもできます。（広告フォーマット別）

SDK でレンダリングされた広告 <ph type="x-smartling-placeholder">
- BidResponse.Ad.sdk_rendered_ad
AMP <ph type="x-smartling-placeholder">
- BidResponse.Ad.amp_ad_url
動画
- BidResponse.Ad.video_url、または
- BidResponse.Ad.video_vast_xml
ネイティブ <ph type="x-smartling-placeholder">
- BidResponse.Ad.native_ad

HTML スニペットを使用して、自社サーバーでホストしている広告を BidResponse の html_snippet フィールド。「スニペットがウェブページに挿入された iFrame 内に挿入され、結果として広告が表示されるページの読み込み時に取得とレンダリングが行われますHTML コードを作成し、スニペットを使用して、広告（バナーまたはインタースティシャル）が入札する広告スロットに適したサイズに調整されています。

また、入札レスポンスで宣言される広告サイズは、1 つの広告ユニットと完全に一致する次の場合に、入札リクエストでのサイズの組み合わせが 25% 削減されます。

広告は通常のバナーである（動画、ネイティブ、インタースティシャルではない）。
ビッダーが入札レスポンスでサイズを宣言しました。サイズ宣言: リクエストに複数のサイズがある場合には必須です。
インタースティシャル広告の場合は例外となる。インタースティシャルの場合、幅は画面の幅の 50% 以上、高さを画面の 40% 以上にする必要があります。調整できます。

html_snippet フィールドは、次の文字列を含む有効な HTML コードをサポートします。適切にレンダリングされますが、 [Create BidResponse message] セクションの buyer_creative_id フィールド。1 本 URL の引数に追加情報を含めることです。レンダリングの一環としてサーバーから取得されますこれにより、インプレッションに関する任意のデータを自社のサーバーに送り返すことです。

入札レスポンスで返される HTML スニペットに関するポリシーのほとんどは、使用する必要があります詳しくは、認定バイヤープログラムガイドライン、サードパーティの要件広告配信、宣言広告のリンク先 URL をご確認ください。

マクロを指定する

クリエイティブを定義する HTML スニペットには、1 つ以上の特別な URL をマクロと呼ばれる複合概念です。広告配信時に、値はマクロ。たとえば、クライアント入札アプリケーションでは、 WINNING_PRICE マクロを使用して、広告に支払われた金額、落札しますこのマクロを解析するには、価格確認を復号するアプリです。詳細については、価格の復号化確認ページをご覧ください。

マクロを HTML スニペットの一部として %%MACRO%%（MACRO はサポートされているマクロの一覧表です。

注: AMP 広告の入札レスポンス（amp_ad_url）の場合は、 WINNING_PRICE マクロと WINNING_PRICE_ESC マクロは、サポートしています。

CLICK_URL_UNESC または配信される第三者のクリエイティブ内の CLICK_URL_ESC マクロ表示されます。Google はクリックトラッキングに CLICK_URL マクロを使用します。

マクロを使用するには、広告にマクロを追加して、クリックされます。フェッチの戻り値は、別のリソースへの CLICK_URL に追加する URL。

マクロ	説明
`ADVERTISING_IDENTIFIER`	購入者がインプレッションのレンダリング時に iOS IDFA または Android の広告 ID を受け取ることができます。広告主 ID の復号をご覧ください。をご覧ください。
`CACHEBUSTER`	ランダムな 4 バイトの符号なし整数の文字列表現。
`CLICK_URL_UNESC`	エスケープされていない広告のクリック URL。スニペットでは、マクロの直後に第三者クリック URL を指定する必要があります。たとえば、第三者のクリック URL が `http://my.adserver.com/some/path/handleclick?click=clk`, この場合、次のコードを、3 つ目のマクロ呼び出しに続く第三者クリック URL を追加します。 <a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> 広告配信時には、次のように拡張されます。 <a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> この URL は、まずクリックを Google に登録してから、第三者のクリック URL にリダイレクトします。
`CLICK_URL_ESC`	エスケープされた広告のクリック URL。代わりに使用するコード: 最初に値を渡す必要がある場合は、`CLICK_URL_UNESC` リダイレクトを返す別のサーバーです。たとえば、次のコードを HTML スニペットで使用できます。 <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a> 広告配信時には、次のように拡張されます。 <a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a> これにより、クリックが `my.adserver.com` に登録され、その後、渡された URL へのリダイレクトを担当します。 `google_click_url` パラメータ。これは、 `my.adserver.com` は `google_click_url` のエスケープを解除します。パラメータを指定します。二重エスケープされた URL を `%%CLICK_URL_ESC%%`。エスケープ解除が完了すると `my.adserver.com`: シングルエスケープバージョンの URL が残ります。 `google_click_url` に追加されます。Google `google_click_url` が取得されると、もう一度エスケープ解除され、自動的にリダイレクトされます。
`CLICK_URL_ESC_ESC`	二重にエスケープされた広告の URL。代わりに使用するコード: 最初に値を渡す必要がある場合は、`CLICK_URL_UNESC` リダイレクトを返す別のサーバーです。たとえば、次のコードを HTML スニペットで使用できます。 <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a> 広告配信時には、次のように拡張されます。 <a href="http://my.otheradserver.com/click?google_click_url=http%3A%2F%2Fmy.adserver.com%2Fclick%3Fgoogle_click_url%3Dhttp%3A%2F%2Fgoogle-click-%20url%253F...%2526ad_url%253D"></a>
`SCHEME`	入札リクエストで SSL が必須でない、または SSL 対応が必須でない場合は、`http:` に展開されます。入札リクエストで SSL が必須の場合は `https:`。
`SITE`	コンテンツ URL の URL がエスケープされたドメイン、または匿名広告枠の匿名 ID。
`SITE_URL`	非推奨です。同じ機能を提供する SITE マクロに置き換えられます。
`TZ_OFFSET`	タイムゾーンオフセット。
`VERIFICATION`	本番環境ごとに異なる値と、クリエイティブをスキャンするタイミング説明します形式は `%%?VERIFICATION:true-val:false-val%%` です。ここで、マクロを除く値は `true-val` と `false-val` に使用可能です。空の文字列を含みます。Open Bidding の場合は、エクスチェンジでこのマクロを使用することをおすすめします。一度変更した後に、デマンドサイドプラットフォームに変更を加える必要はありません。たとえば、クリエイティブに `%%?VERIFICATION:-1:5000%%` が含まれているとします。テキストの置換は、配信時は `5000`、検索時は `-1` になります。検証パイプラインを構築しますこれは、2 つの ping を区別しやすくするためです。
`WINNING_PRICE`	エンコードされたインプレッション費用（CPM ではなく CPI）は、アカウントの通貨の 100 万倍の額。たとえば落札 CPM が 5 米ドル 5,000,000 マイクロ CPM または 5,000 マイクロ CPI に相当します。デコードされたこの場合の `WINNING_PRICE` の値は 5,000 になります。落札価格は CPI で指定します。
`WINNING_PRICE_ESC`	URL がエスケープされた `WINNING_PRICE`。

マクロ内の URL エスケープには、次のスキームが使用されます。

スペース文字はプラス記号（+）に置き換えられます。
英数字（0 ～ 9、a ～ z、A ～ Z）とセットの !()*、-./:_~ の文字は変更されません。
その他の文字はすべて %XX に置き換えられます。ここで、XX は 16 進数です。文字を表す数値。

パブリッシャー向け制限コンテンツ

パブリッシャーは BidRequest を使用して、どの広告に関する制限を渡すことができますできます。以下のフィールドで制限を適用する必要があります。

allowed_vendor_type
excluded_attribute
excluded_sensitive_category

1 つのフィールドで広告で許可される機能を指定し、もう 1 つのフィールドで許可されません。許可されていない機能を含む広告は返してはなりません。許可される使用する場合、そのベンダータイプが BidRequest の allowed_vendor_type リスト。詳しくは、 BidRequest プロトコルバッファ内のこれらのフィールドに関するコメント定義をご覧ください。

HTML スニペットが BidResponse で返される場合、次のようになります。 attribute、category、および click_through_url のフィールドをBidResponseします。広告内のこれらのフィールドに適用可能な値が複数ある場合は、すべての値が含まれます。これらのフィールドのコメントについては、 BidResponse プロトコルバッファの定義をご覧ください。これらのフィールドが設定されていないレスポンスは破棄されます。

BidRequest.excluded_attribute に指定できる値は次のとおりです。（publisher-excludable-creative-attributes.txt をご覧ください）。

7 Tagging: IsTagged
広告のリストを作成する目的でピクセルやウェブビーコンが含まれている場合、広告は許可されません Cookie ID を生成して、その後のリマーケティングに使用できます。
8 CookieTargeting: IsCookieTargeted
Cookie ID のリストが表す Cookie ID に基づいてユーザーをターゲティングしている広告は、許可されません。購入者が所有または代理人を務めるサイトとやり取りしたことのある一連の消費者
9 UserInterestTargeting: IsUserInterestTargeted
Cookie ID のリストが表す Cookie ID に基づいてユーザーをターゲティングしている広告は、許可されません。共通のインタレストグループとして購入者が定義したユーザーグループ。
21 CreativeType: Html
広告で html_snippet または snippet_template を使用することはできません。（BidResponse.Ad のフィールド）
22 CreativeType: VastVideo
広告で BidResponse.Ad の video_url フィールドを使用することはできません。
30 InstreamVastVideoType: Vpaid
広告を表示するために VPAID 対応を必須とすることは許可されていません。
32 MraidType: MRAID
広告のレンダリングに MRAID API を要求することは禁止されています。
34 RichMediaCapabilityType: RichMediaCapabilityFlash
広告を表示する際に Flash 対応を必須とすることは許可されていません。
39 RichMediaCapabilityType: RichMediaCapabilityHTML5
HTML5 機能を必須にした広告は許可されません。
48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
広告で SSL 以外のリクエストを行うことは許可されません。

したがって、excluded_attribute フィールドに値が含まれていると、ピクセルやウェブビーコンを使用する広告は、リストを作成します。なお、広告でこれを行う場合は、 BidResponse の属性フィールド。同様に、excluded_attribute フィールドの値が 48 の場合、 SSL で表示できる広告のみを返すようにします属性 47 の richCapabilityType: richCapabilitySSL を宣言）。

また、excluded_sensitive_category BidRequest では、 ad-sensitive-categories.txt ファイルは参照データのページから入手できます。こちらのこのコードの一部の説明:

3 Politics
政治問題や物議を醸す社会問題を含む。問題に関して偏った視点を持っていると一般に考えられていないニュースメディアの広告は含まれません。
4 Dating
出会い系サービスやオンラインの出会い系コミュニティなど。
5 Religion
宗教的な広告や、宗教に関する賛成または反対の見解を支持する広告を含む。星占いや、特定の教派に属さないスピリチュアルな内容は含まれません。
7 Video Games (Casual & Online)
ビデオゲーム、オンラインゲーム、ダウンロード可能なゲームを含む。ビデオゲーム機は対象外です。
8 Ringtones & Downloadables
着メロを含むモバイル用アドオン、パソコン用のスクリーンセーバーや壁紙、ソーシャルネットワーク用のプロフィールのレイアウトや画像などのダウンロード可能なコンテンツ。
10 Get Rich Quick
急な収益を約束する仕組み。
18 Weight Loss
減量、ダイエットに関連する商品やプログラムを含む。健康的な食事や一般的なフィットネスに関する広告は含まれていない。
19 Cosmetic Procedures & Body Modification
フェイスリフト、脂肪吸引、レーザー施術、脱毛、植毛、タトゥー、美容整形などに関するサイトが含まれます。
23 Drugs & Supplements:
医薬品、ビタミン剤、サプリメント、関連する販売店を含む薬物に関する情報を提供するリソースが含まれていない。
24 Sexual & Reproductive Health
性機能や不妊対策に関する広告が含まれます。通常の妊娠に関するリソースは含まれません。
35 Social Casino Games
価値のあるもの（金銭や賞品など）を獲得する機会のないギャンブルのシミュレーションゲーム（ポーカー、スロット、ビンゴ、宝くじ、スポーツ賭博、レースベッティング、その他のカードゲーム、カジノゲームなど）が含まれます。
36 Significant Skin Exposure
胸から太ももまでで、一部の肌が露出している人物の広告画像。または、下着、水着、ランジェリーなど、透けて見える服、またはタオルやシーツなど衣服以外のものを身に着けている。
37 Sensationalism
ユーザーの好奇心を訴えてクリックを促すことを目的とする広告で、多くの場合、誇張的な言葉や画像を使ったティーザーメッセージが使用されています。扇情的なテーマ（有名人の逮捕、死、離婚など）を中心とした広告や、衝撃を与えることを目的とする広告が含まれます。

Open Measurement

Open Measurement では、独自の測定と測定を行う第三者ベンダーを指定できますモバイルアプリ環境に配信される広告向けのベリフィケーションサービス。

現在サポートされている広告フォーマットには、動画広告、バナー広告、インタースティシャル広告があります。詳細情報これらのフォーマットを含む入札レスポンスで Open Measurement を使用する方法については、ヘルプセンターの Open Measurement SDK をご覧ください。の記事を参照してください。

入札レスポンスの例

以下のセクションでは、広告タイプ別の入札レスポンスの例を示します。

Google

例を表示

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 31014
    billing_id: 16751333146
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 50
  category: 0
  buyer_creative_id: "test_creative_id_173035"
  advertiser_name: "Google"
  width: 300
  height: 250
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 10

OpenRTB JSON

例を表示

{
  "id": "SwkWZ9w3I3gJ803j84253U",
  "seatbid": [
    {
      "bid": [
        {
          "id": "ro22H780p349mF6oe0h",
          "impid": "1",
          "price": 0.04001,
          "adid": "test_creative_id_978541",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "82346236545",
          "crid": "test_creative_id_978541",
          "w": 390,
          "h": 61,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "5c39728P",
              "campaign": "10199716",
              "itunesitem": "640052147",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "0HY71438fqxkY2tqD14kV9DY1q3Fi77sc99e0D97Qo833M266T75c28Y5NM23wiL61WyNCe0277ER5eM32UxaKGf99GUM1jI",
                  "timestamp": "1714079463090"
                },
                {
                  "fidelity": 0,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "J6RVg1KI31q1lB68f6F16fA07kY93DAYU2IL5ETDuvczR48oMr3S3X9tIohWi4L2VcE0w4mi42o0Mqa174U7o65951z44ru4",
                  "timestamp": "1714079463090"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "4372:2283:725828"
    }
  ],
  "bidid": "Z8aZJEk4-r2e3z85n-je52-q0E586r76K4T"
}

OpenRTB プロトコルバッファ

例を表示

id: "m7T91l3qg177P4b39N26W1"
seatbid {
  bid {
    id: "5viGQ43x3HI44d22DW3"
    impid: "1"
    price: 0.040404
    adid: "test_creative_id_566440"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "67427969102"
    crid: "test_creative_id_566440"
    cat: "IAB3"
    cat: "IAB13"
    w: 320
    h: 50
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      billing_id: 67427969102
    }
  }
  seat: "1912:1424:626226"
  group: false
}
bidid: "38508qU5-957YGflD-M2rg-7B19HjXU00n2"
cur: "USD"

アプリインタースティシャル

Google

例を表示

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 1079285
    billing_id: 37034094959
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 105
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_903208"
  advertiser_name: "Google"
  width: 398
  height: 744
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  skadn {
    version: "4.0"
    network: "41dEOEaD"
    itunesitem: "151251861"
    sourceapp: "500811620"
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "p1f6bi578Q0jX163o5ws6n630p142H1v75rziXPtoak952g0Be18230732OkYu7epL9elCJ25078L09G5Mi6u7s7MyO2j5sI"
    }
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "JFtn495ab0EX97ci69Ru9c39ot9TWn5T0052F4439Y2a9u7zN2do7Q9AH4N584irpJmS8K877980K14iQgO74I33vgx231Cf"
    }
    skadn_options {
      always_open_appstore: true
    }
    source_identifier: 72
  }
}
processing_time_ms: 70

OpenRTB JSON

例を表示

{
  "id": "BQig8glrLj2K7p818w3s0S",
  "seatbid": [
    {
      "bid": [
        {
          "id": "v0x1j4q0B388Z5lv600",
          "impid": "1",
          "price": 0.25109,
          "adid": "test_creative_id_654733",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "73848702501",
          "crid": "test_creative_id_654733",
          "w": 428,
          "h": 846,
          "ext": {
            "skadn": {
              "version": "4.0",
              "network": "43D4r5x9",
              "sourceidentifier": "6217",
              "itunesitem": "950280085",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "8fZn83e3d0742gU7E8Ra7Vif4v1vK61X899f7G7q9Dl998035Gq81Zd4r3032814bQ03HP49709yf38n6U35YY29D0w2Ac5B",
                  "timestamp": "1714058970102"
                },
                {
                  "fidelity": 1,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "zs0k0e335UoH9M6mp1V228I8JAl2526LCKF0dc2l8x7o4270lsQ37B12Cf91a770RcNqSG7Kl667xsw97Eo4nA23o41h3c0H",
                  "timestamp": "1714058970102"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "9150:1636:894279"
    }
  ],
  "bidid": "taiup4HY-42ggR62I-120u-3kyZ4831M9Yt"
}

OpenRTB プロトコルバッファ

例を表示

id: "wqZn032336g5U2Saroj8Lc"
seatbid {
  bid {
    id: "mTD7EYxAyF6n763v7pJ"
    impid: "1"
    price: 0.033932000398635864
    adid: "test_creative_id_237493"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    adomain: "google.com"
    cid: "42834631855"
    crid: "test_creative_id_237493"
    cat: "IAB2-18"
    cat: "IAB20"
    w: 360
    h: 711
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      attribute: 8
      event_notification_token {
        payload: "token"
      }
      billing_id: 42834631855
    }
  }
}
bidid: "62i6224k-ada8764U-y4Fi-2z760VkR3s35"
cur: "USD"

アプリインタースティシャル動画

Google

例を表示

ad {
  adslot {
    id: 1
    max_cpm_micros: 5037989
    billing_id: 82632801525
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_497252"
  advertiser_name: "Google"
  width: 720
  height: 1280
  video_vast_xml: "OMITTED_VAST_XML"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 70

OpenRTB プロトコルバッファ

例を表示

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

アプリネイティブ

Google

例を表示

ad {
  adslot {
    id: 1
    max_cpm_micros: 1581987
    billing_id: 32132054378
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_285893"
  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\254106.40"
    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"
}
processing_time_ms: 20

OpenRTB JSON

例を表示

{
  "id": "3u95d40fy46B0y3CEL73uy",
  "seatbid": [
    {
      "bid": [
        {
          "id": "d501820Aa099K69Ia64",
          "impid": "1",
          "price": 1.63,
          "burl": "https://test.com/imp?id=123456",
          "adm": "{\"assets\": [{\"id\": 1, \"required\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"required\": 1, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\", \"label\": \"\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\", \"label\": \"\"}}, {\"id\": 4, \"required\": 1, \"data\": {\"value\": \"Galactic Luxury Cruises\", \"label\": \"\"}}, {\"id\": 5, \"required\": 1, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"h\": 628, \"w\": 1200}}, {\"id\": 6, \"img\": {\"url\": \"https://native.test.com/logo?id=123456\", \"h\": 640, \"w\": 640}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"], \"privacy\": \"\"}",
          "adid": "test_creative_id_237765",
          "adomain": [
            "google.com"
          ],
          "cid": "30567639040",
          "crid": "test_creative_id_237765",
          "cat": [
            "IAB8"
          ],
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "345vh5bv",
              "campaign": "62744790",
              "itunesitem": "608550422",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "4063Vhn5W7oGEcJ202oj6k990Y3H7f9sJ6luK3O65RbQ3S9kp45VK84le4a424c6SU79384DTdXS1cHWcxl9SB98563Y38K9"
                },
                {
                  "fidelity": 1,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "r1852LY7j0f25q2s868j1Ub7r07S16e607BC5909O272F8i528732r22W7D138t3706205Ez139N73Iho3vJKp257Pp4vmet"
                }
              ]
            },
            "app_promotion_type": 1,
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "3512:7802:295531"
    }
  ],
  "cur": "USD"
}

OpenRTB プロトコルバッファ

例を表示

id: "P3mh232944yQx803R73ayZ"
seatbid {
  bid {
    id: "79B1S3h454910R471JL"
    impid: "1"
    price: 0.044748470187187195
    adomain: "google.com"
    cid: "52078759229"
    crid: "test_creative_id_537521"
    cat: "IAB20"
    burl: "https://test.com/imp?id=123456"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
          type: MAIN
        }
      }
      assets {
        id: 6
        required: false
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 100
          h: 100
          type: LOGO
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
          type: DESC
        }
      }
      assets {
        id: 3
        required: false
        data {
          value: "Book today"
          type: CTATEXT
        }
      }
      assets {
        id: 4
        required: true
        data {
          value: "Galactic Luxury Cruises"
          type: SPONSORED
        }
      }
      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"
      }
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 52078759229
    }
  }
  seat: "2237:7356:617887"
}
cur: "USD"

ウェブ動画

Google

例を表示

ad {
  adslot {
    id: 1
    max_cpm_micros: 16000000
    billing_id: 34223090460
    deal_id: 17775265
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_551392"
  advertiser_name: "Google"
  event_notification_token: "token"
}
processing_time_ms: 7

OpenRTB プロトコルバッファ

例を表示

id: "878w58e050dSf05LS9l424"
seatbid {
  bid {
    id: "478u6K990C990n7FPTX"
    impid: "1"
    price: 0.03
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "46483683815"
    crid: "test_creative_id_527097"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 46483683815
    }
  }
  seat: "6954:3639:781296"
}
bidid: "7a2CAWgt-IKR8mp06-0E3d-TPNq4zO9l767"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 120
}

レスポンスを作成する

入札レスポンス メッセージを作成する

クリエイティブ ID

広告の帰属表示

Open Bidding フィールド

推奨事項

入札レスポンスの例

Google

例を表示

OpenRTB JSON

例を表示

OpenRTB プロトコル バッファ

例を表示

クリエイティブを指定する

マクロを指定する

パブリッシャー向け制限コンテンツ

Open Measurement

入札レスポンスの例

アプリバナー

Google

例を表示

OpenRTB JSON

例を表示

OpenRTB プロトコル バッファ

例を表示

アプリ インタースティシャル

Google

例を表示

OpenRTB JSON

例を表示

OpenRTB プロトコル バッファ

例を表示

アプリ インタースティシャル動画

Google

例を表示

OpenRTB プロトコル バッファ

例を表示

アプリ ネイティブ

Google

例を表示

OpenRTB JSON

例を表示

OpenRTB プロトコル バッファ

例を表示

ウェブ動画

Google

例を表示

エクスチェンジ入札者のモバイルウェブ バナー

OpenRTB プロトコル バッファ

例を表示

入札レスポンスメッセージを作成する

OpenRTB プロトコルバッファ

OpenRTB プロトコルバッファ

アプリインタースティシャル

OpenRTB プロトコルバッファ

アプリインタースティシャル動画

OpenRTB プロトコルバッファ

アプリネイティブ

OpenRTB プロトコルバッファ

エクスチェンジ入札者のモバイルウェブバナー

OpenRTB プロトコルバッファ