Open Bidding の統合を設定する

Open Bidding を使用すると、エクスチェンジや他の購入者は Google のリアルタイム ビッディング インフラストラクチャを活用して、Google アド マネージャーと AdMob の広告枠に入札できます。

Open Bidding に参加するには、Open Bidding のユースケースに合わせてカスタマイズされたリアルタイム ビッダーの統合を設定し、ビッダーのエンドポイントを Google アカウント マネージャーに送信して、統合が正しく機能しているかどうかをテストし、確認します。この統合作業が必要なのは 1 回だけです。

統合を一部のパブリッシャーに限定する

Open Bidding の統合は、どのパブリッシャーからのリクエストも受け付ける準備が整うまで、「非公開モード」のままにできます。プライベート モードでは、アカウント チームと協力して、一部のパブリッシャーと連携し、スケーリングの準備が整うまでこの状態を維持できます。プライベート モードを終了すると、アカウントがすべてのパブリッシャーに表示されます。

サポートされているプロトコルとエンコード

OpenRTB は JSON 形式または Protobuf 形式で使用できます。詳細

Google OpenRTB の実装

Google の OpenRTB 実装では、OpenRTB 仕様のすべての機能がサポートされておらず、認定バイヤーと Open Bidding 固有の機能の拡張機能が追加されています。詳細については、OpenRTB ガイドをご覧ください。

受け取った入札リクエストを処理する

Open Bidding では、認定バイヤーと同じ BidRequest 構造が使用されますが、一部のフィールドは Open Bidding の参加者にのみ送信されます。入札リクエストで送信される Open Bidding 固有のフィールドについて詳しくは、リクエスト ガイドをご覧ください。

入札で応答する

Open Bidding でも、認定バイヤーと同様の BidResponse 構造が使用されます。ただし、Open Bidding の参加者に送信される専用のフィールドがいくつかあります。レスポンス可能な Open Bidding 固有のフィールドについて詳しくは、レスポンス ガイドをご覧ください。

注: Open Bidding 参加者に送信される入札リクエストは、インベントリ形式に応じて 300 ～ 1, 000 ミリ秒以内にレスポンスを受信する必要があります。特定のリクエストの具体的な要件を判断するには、BidRequest.tmax フィールドを確認します。

入札に使用する優先広告フォーマットに応じて、レスポンス構造は大きく異なる場合があります。一般的な広告フォーマットの入札額を返すように入札用アプリケーションを設定するには、次のガイドをご覧ください。

• インタースティシャル広告
• 動画広告
• OpenRTB 動画広告
• ネイティブ広告
• ネイティブ動画広告
• 購入者 SDK の広告

インプレッションをトラッキングして不一致を減らす

オプションの BidResponse.seatbid.bid.ext.impression_tracking_url フィールドを使用して、Google が課金対象イベントを記録した日時に関するインプレッション単位のデータを取得することを強くおすすめします。

Google デマンドの差異解消（ベータ版）

この機能は、エクスチェンジに請求されるインプレッション数と Google ディスプレイ＆ビデオ 360（DV360）から支払われるインプレッション数を一致させることを目的としています。

Open Bidding によって配信されたディスプレイ＆ビデオ 360 のインプレッションを正確に識別することで、広告スパムと請求対象のイベントの差異を調整して、支払いが行われていないインプレッションに対する請求を回避できます。

入札リクエストで google_query_id を渡す

Google デマンド全体で有効なインプレッション数が一致するように、google_query_id は Open Bidding リクエストから Google デマンド プラットフォームにそのまま伝播する必要があります。これは、Open Bidding の差異解消の前提条件です。現在の google_query_id の予想される長さは約 64 バイトです。

入札レスポンスで third_party_buyer_token を返す

Google デマンド プラットフォームがエクスチェンジの内部オークションで落札した場合、third_party_buyer_token フィールドは、Open Bidding インプレッションを介して入札レスポンスでそのまま伝播される必要があります。これにより、Google パブリッシャー プラットフォームは、Open Bidding パートナーの落札額が同じインプレッションの機会に対する Google デマンドの代理入札であることを確認できます。このフィールドの現在の最大長は 150 バイトです。

入札レスポンスで Google クリエイティブ マークアップをそのまま渡す

不一致の解決が Google デマンドの入札に適用されるようにするには、エクスチェンジでラッパー（スクリプトタグ、iframe、VAST ラッパー）なしで Google クリエイティブ マークアップを伝播する必要があります。不一致の解決のため、Google のデマンド プラットフォームでカウントされなかったオープン ビッディングのインプレッションについては、Google が無効化し、請求しない場合があります。Google はクリエイティブ マークアップを定期的にチェックし、third_party_buyer_token を含む入札が他の購入者ではなく Google デマンドを代表して送信されたことを確認します。

HTML5 クリエイティブ

エクスチェンジは、通常適用されるエクスチェンジ固有のマクロ拡張を含め、Google HTML マークアップをそのまま送信する必要があります。また、必要に応じて、エクスチェンジが通常追加するトラッカー ピクセルやスクリプトを追加することもできます。

Google HTML クリエイティブをタグ（script、iframe、またはその他の手法）でラップし、そのタグで Google HTML コードを読み込むかレンダリングする場合、Google は不一致の解決を適用できません。

技術要件を満たしている

この例では、Google（ディスプレイ＆ビデオ 360）の入札レスポンスのクリエイティブ HTML コードがそのまま渡され、エクスチェンジ固有の HTML コードが先頭と末尾に追加されます。

<!-- START exchange-specific HTML header -->
<iframe src="https://exchange.example.com/impression?…" width="0" height="0" frameborder="0" scrolling="no" style="display:none;" marginheight="0" marginwidth="0"></iframe>
<!-- END exchange-specific HTML header -->
<!-- START HTML code as returned by Google in the bid response -->
<DIV STYLE="position: absolute; left: 0px; top: 0px; visibility: hidden;"><IMG SRC="https://pagead2.googlesyndication.com/pagead/gen_204?id=xbid&dbm_b=…" BORDER=0 WIDTH=1 HEIGHT=1 ALT="" STYLE="display:none"></DIV><iframe title="Blank" src="https://googleads.g.doubleclick.net/xbbe/pixel?d=…" style="display:none" aria-hidden="true"></iframe><div><div style="position:relative; display:inline-block;"><div class="GoogleActiveViewClass" id="DfaVisibilityIdentifier_…"><script>var url = 'https://googleads.g.doubleclick.net/dbm/ad?…';document.write('<script src="' + (window.rfl ? window.rfl(url) : url) + '"></s' + 'cript>');</script>…
<!-- END HTML code as returned by Google in the bid response -->
<!-- START exchange-specific HTML footer -->
<img src='https://exchange.example.com/track?…' width='0' height='0' style='display:none;'>
<!-- END exchange-specific HTML footer -->

技術要件を満たしていません

この例では、Google から返されたクリエイティブの HTML コードが、エクスチェンジから提供された入札レスポンスで難読化されており、入札レスポンスにそのまま表示されていません。Google が提供する HTML コードは、ブラウザでエクスチェンジが提供するラッパーによってレンダリングされることがあります。

<!-- START exchange ad tag that encodes / renders Google creative in the browser -->
<!-- Google creatives markup from the bid response (adm) is not present verbatim -->
<span class="ad"><script type='text/javascript' src='https://exchange.example.com/ad?p=%%WINNING_PRICE%%&m=n_ybbRoVpsLlXSo8gVHRn-W0tynBt-Hoe8t8m0qwKhLFiaF-0gB0U4w-5pjeB8IMIkg7PcRri5iCIjBMMKDqg
…'></script></span>
<!-- END exchange ad tag that encodes / renders Google creative in the browser -->

VAST 動画クリエイティブ

差異解消の対象となるには、エクスチェンジは次のいずれかの方法で VAST XML レスポンスの VASTTagURI を入力する必要があります。

1. エクスチェンジは、Google が返す VAST XML ドキュメントの一部として、VASTTagURI 要素の値を BidResponse.seatbid.bid.adm フィールドにそのまま保存できます。この際、通常適用されるエクスチェンジ固有のマクロ展開も行われます。
2. ディスプレイ＆ビデオ 360 は、エクスチェンジへの入札レスポンスで BidResponse.seatbid.bid.adm.nurl フィールドに VAST ドキュメント URL を入力できます。その後、取引所は VASTTagURI タグでその値を渡すことができます。取引所固有のマクロは必要に応じて通常どおりに展開されます。

必要に応じて、エクスチェンジは VAST XML ドキュメント内で追加の VAST イベントとエラー トラッカーを指定できます。

技術要件を満たしている

この例では、Google（ディスプレイ＆ビデオ 360）の入札レスポンスのクリエイティブ VAST URI がそのまま渡され、エクスチェンジが特定 VAST イベントとエラー トラッカーを追加しています。

<!-- START exchange VAST tag referencing Google creative -->

<?xml version="1.0" encoding="UTF-8"?><VAST version="2.0"><Ad id="123456789"><Wrapper>

<!-- Google VAST URI from the bid response is present verbatim -->
<AdSystem>XBid</AdSystem><VASTAdTagURI><![CDATA[https://bid.g.doubleclick.net/dbm/vast?…]]></VASTAdTagURI>

<!-- START Exchange-specific event trackers -->

<Error><![CDATA[https://video.exchange.example.com/vast_error?error=[ERRORCODE]&…]]></Error><Impression><![CDATA[https://video.exchange.example.com/impression?price=%%WINNING_PRICE%%&…]]></Impression><Creatives><Creative id="1234567890" sequence="1"><Linear><TrackingEvents><Tracking event="creativeView"><![CDATA[https://video.exchange.example.com/track/view?…]]></Tracking><Tracking event="start"><![CDATA[https://video.exchange.example.com/track/start?…]]></Tracking><Tracking event="midpoint"><![CDATA[https://video.exchange.example.com/track/midpoint?…]]></Tracking></TrackingEvents><VideoClicks><ClickTracking><![CDATA[https://video.exchange.example.com/click?…]]></ClickTracking></VideoClicks>

<!-- END Exchange-specific event trackers -->

</Linear></Creative></Creatives></Wrapper></Ad></VAST>

<!-- END exchange VAST tag referencing Google creative -->

技術要件を満たしていません

この例では、Google から返されたクリエイティブの VAST コードまたは URI が入札レスポンスにそのまま表示されることはありません。代わりに、エクスチェンジ固有の VAST ラッパーが使用されます。Google が提供する VAST コードは、SDK が広告を読み込む際に、エクスチェンジが提供する VAST ラッパー（VASTAdTagURI 要素、https://video.exchange.example.com/creative?… で定義）によって読み込まれることがあります。

<!-- START exchange VAST tag that encodes or loads Google VAST creative subsequently -->
<!-- Google VAST URI or VAST document from the bid response is not present verbatim -->

<?xml version="1.0" encoding="UTF-8"?><VAST version="2.0"><Ad id="1234567890"><Wrapper><AdSystem version="0.1">VideoExchange</AdSystem><VASTAdTagURI><![CDATA[https://video.exchange.example.com/creative?…]]></VASTAdTagURI><Error><![CDATA[https://video.exchange.example.com/error?ec=[ERRORCODE]]]></Error><Impression><![CDATA[https://video.exchange.example.com/imp?…]]></Impression><Creatives><Creative></Creative></Creatives></Wrapper></Ad></VAST>
<!-- END exchange VAST tag that encodes or loads Google VAST creative subsequently -->

特価

Open Bidding に参加しているエクスチェンジは、Open Bidding で優先取引（PD）、プライベート オークション（PA）を使用できます。取引 ID とタイプは次のように指定する必要があります。

フィールド	説明
BidResponse.seatbid.bid.dealid	入札に関連付けられ、パブリッシャーに報告されたエクスチェンジの名前空間の取引 ID。任意の UTF8 テキストで、64 バイト以下にする必要があります。
BidResponse.seatbid.bid.ext.exchange_deal_type	取引のタイプを指定する列挙型。これはパブリッシャーに報告され、オークションでの取引の扱い方に影響します。指定できる値は次のとおりです。 OPEN_AUCTION = 0; PRIVATE_AUCTION = 1; PREFERRED_DEAL = 2; EXCHANGE_AUCTION_PACKAGE = 3;

PD/PA の入札レスポンスの例を次に示します。

id: "ECHO_BIDREQUEST_ID"
seatbid {
  bid {
    id: "BID_ID"
    impid: "1"
    price: 1.23
    adm: "AD_TAG"
    adomain: "DECLARED_LANDING_PAGE_URL"
    cid: "BILLING_ID"
    crid: "CREATIVE_ID"
    dealid: "DEAL_ID"
    w: 300
    h: 250
    [com.google.doubleclick.bid] {
      impression_tracking_url: "IMPRESSION_TRACKING_URL"
      exchange_deal_type: "DEAL_TYPE"
    }
  }
}

Cookie マッチング

Google ホスト型の照合テーブルにデータを入力するために、Open Bidding の参加者は、ニーズに最も適した次のいずれかのオプションを使用できます。

• Cookie マッチング: 購入者またはエクスチェンジが開始するマッチング 詳細
• ピクセル マッチング: Google が開始するマッチング 詳細
• Cookie マッチング アシスト: エクスチェンジがビッダーとのマッチングを開始します。 詳細

注: 現時点では、Open Bidding の参加者はユーザー リストの作成、入力、ターゲティングを行うことはできません。

レイテンシの管理

ピアリング ガイドに記載されている取引場所を使用して、入札リクエストへのレスポンス時にビッダー エンドポイントで発生するレイテンシを推定する必要があります。

通常、広告枠は最も近い取引場所を経由して送信されますが、保証されるものではありません。すべてのインプレッションへのアクセスを保証する唯一の方法は、すべての取引場所にビッダー エンドポイントを配置することです。

入札リクエストを大量に受け取る大規模なエクスチェンジは、レイテンシとレイテンシの変動を減らすために、Google とのピアリング契約を検討する必要があります。ピアリングの詳細

クリック マクロ

クリック マクロを実装することをおすすめします。これにより、アカウントと提携しているパブリッシャーのクリック数とクリック数から派生した指標を含むレポートを作成できます。詳細

API

Open Bidding のお客様は、認定バイヤーの REST API を使用して、トラブルシューティングに役立つ可能性のあるデータにアクセスできます。現在アクセスできる API リソースは次のとおりです。

• v1.4 パフォーマンス レポート
• v2beta1 RTB のトラブルシューティング

これらの API にアクセスするようにアカウントを構成し、API 呼び出しに必要なアカウント ID を取得するには、テクニカル アカウント マネージャーにお問い合わせください。これらの API の使用に関するテクニカル サポートについては、[e-mail] のサポート エイリアスにお問い合わせください。

参考情報

• 接続を管理するためのベスト プラクティス
• 入札単価 URL マクロの使用
• WINNING_PRICE マクロを使用している場合の価格確認の復号
• テストの推奨事項とベスト プラクティス

入札リクエストとレスポンスの例

サポートされているすべてのプロトコルの入札リクエストとレスポンスのサンプルは、リクエスト ガイドとレスポンス ガイドで確認できます。