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 固有のフィールドの詳細については、レスポンス ガイドをご覧ください。

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

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

インプレッションをトラッキングして差異を減らす

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

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 は、クリエイティブ マークアップを定期的にチェックし、third_party_buyer_token を含む入札が他の購入者ではなく Google デマンドに代わって送信されたことを確認します。

HTML5 クリエイティブ

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

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

<!-- 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 -->

<!-- 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. DV360 では、エクスチェンジへの入札レスポンスで VAST ドキュメントの URL を BidResponse.seatbid.bid.adm.nurl フィールドに入力できます。エクスチェンジは、VASTTagURI タグを使用してその値を渡すことができます。エクスチェンジ固有のマクロは、必要に応じて通常どおり展開されます。

エクスチェンジは、必要に応じて VAST XML ドキュメント内に追加の 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 -->

<!-- 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 とタイプは次のように指定する必要があります。

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 マッチング アシスト: ビッダーとのエクスチェンジ主導のマッチング 詳細

レイテンシの管理

ピアリング ガイドに記載されている取引ロケーションを使用して、受信した入札リクエストにビッダー エンドポイントが応答する際のレイテンシを推定する必要があります。

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

クリック マクロ

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

API

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

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

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

参考情報

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

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

サポートされているすべてのプロトコルの入札リクエストとレスポンスのサンプルについては、リクエストとレスポンスのガイドをご覧ください。