Open Bidding の統合を設定する

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

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

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

Open Bidding の統合は、パブリッシャーからのリクエストを受け入れる準備が整うまで、「非公開モード」のままで構いません。限定公開モードでは、アカウント チームと連携して一部のパブリッシャーと接続し、拡張の準備が整うまでこの状態を維持できます。非公開モードを終了すると アカウントはすべてのパブリッシャーに表示されます

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

Open Bidding は、独自の認定バイヤーと OpenRTB のリアルタイム ビッダー RTB プロトコルを使用します。詳細

Google OpenRTB の実装

Google の OpenRTB 実装は、OpenRTB 仕様に記載されているすべての機能をサポートしているわけではありません。また、認定バイヤーおよび Open Bidding 固有の機能の拡張機能が追加されています。Google の OpenRTB の実装と、独自の認定バイヤー リアルタイム ビッダー プロトコルとの関係については、OpenRTB ガイドをご覧ください。

受信した入札リクエストを処理する

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

入札で応答する

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

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

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

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

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

オプションの impression_tracking_url フィールドを使用して、課金対象のイベントが Google で記録されるタイミングに関するインプレッション単位のデータを取得することを強くおすすめします。OpenRTB の場合は、BidResponse.seatbid[].bid[].ext.impression_tracking_url として、Google プロトコルで BidResponse.ad[].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 デマンドからの入札に差異解消が確実に適用されるようにするには、エクスチェンジで Google クリエイティブ マークアップをラッパー（スクリプトタグ、iframe、VAST ラッパー）なしで反映させる必要があります。差異解消を実装すると、Google デマンド プラットフォームでカウントされなかった Open Bidding のインプレッションは無効になり、請求が行われないこともあります。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 要素の値を、adm フィールドにそのまま保持できます。また、通常はエクスチェンジ固有のマクロ展開が適用されます。
2. ディスプレイ&ビデオ 360 では、エクスチェンジに対する入札レスポンスの nurl フィールドに VAST ドキュメント URL を入力できます。その後、エクスチェンジは Google（ディスプレイ&ビデオ 360）が VASTTagURI タグで応答する nurl の値を、必要に応じてエクスチェンジ固有のマクロを通常どおり展開して渡すことができます。

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

技術要件を満たしている

この例では、Google（DV360）の入札レスポンスからのクリエイティブの 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 とタイプは、次のように指定する必要があります。

項目	説明
OpenRTB プロトコル: BidResponse.seatbid[].bid[].dealid Google プロトコル: BidResponse.ad[].adslot[].exchange_deal_id	入札に関連付けられ、パブリッシャーに報告されるエクスチェンジの名前空間の取引 ID。 これは任意の UTF8 テキストで、64 バイト以内にする必要があります。
OpenRTB プロトコル: BidResponse.seatbid[].bid[].ext.exchange_deal_type Google プロトコル: BidResponse.ad[].adslot[].exchange_deal_type	取引のタイプを指定する列挙型。これはパブリッシャーに報告され、オークションでの取引方法に影響します。有効な値は次のとおりです。 OPEN_AUCTION = 0; PRIVATE_AUCTION = 1; PREFERRED_DEAL = 2; EXCHANGE_AUCTION_PACKAGE = 3;

以下は、PD/PA の OpenRTB 入札レスポンスの例です。

以下のサンプルでは、PD/PA 用に OpenRTB フィールド（dealid、exchange_deal_type）を使用しています。認定バイヤー プロトコルを使用している場合、PD/PA の入札レスポンス フィールドは exchange_deal_id と exchange_deal_type になります。

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 マクロを使用した場合の価格の確認の復号
• テストに関する推奨事項とベスト プラクティス

入札リクエストとレスポンスのサンプル

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