Open Bidding の統合を設定する

Open Bidding エクスチェンジやその他の購入者が Google のリアルタイム ビッダーを Google アド マネージャーと AdMob の広告枠に入札するためのインフラストラクチャです。

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

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

Open Bidding の統合は「プライベート モード」のままで構いません すべてのパブリッシャーからのリクエストを受け入れる準備が整っています。プライベート モードでは、 Google のアカウント担当者と連携し この状態を維持する必要があります。プライベート モードを終了すると、 アカウントはすべてのパブリッシャーに表示されます。

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

Google の OpenRTB 実装の使用をおすすめします。Google RTB プロトコル は非推奨です。 詳細

Google OpenRTB の実装

Google の OpenRTB 実装では、 OpenRTB 仕様への対応と、認定バイヤーと OpenRTB 向けの拡張機能の追加 入札固有の機能Google の OpenRTB の詳細については、 認定バイヤーとの取引との関係について リアルタイム ビッダー プロトコルについて詳しくは、OpenRTB ガイドをご覧ください。

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

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

入札単価を設定する

Open Bidding でも、これと似た BidResponse 構造が使用されます。 一部の専用フィールドは Open Bidding に送信される できます。対応ガイドを参照 をご覧ください。

注: Open Bidding の参加者に送信された入札リクエストは、 広告枠のフォーマットに応じて 300 ～ 1, 000 ミリ秒。特定の要件を BidRequest.tmax フィールドを確認します。

レスポンスは、入札に使用する広告フォーマットに応じて その構造には大きな違いがあります。リソースの構成方法については、次のガイドをご確認ください。 一般的な広告フォーマットの入札で応答するビッダー アプリケーション:

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

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

オプションの impression_tracking_url を使用することを強くおすすめします。 を使って、Google が請求対象を記録するタイミングについてインプレッション単位のデータを取得します。 イベント数を表します。OpenRTB の場合は BidResponse.seatbid[].bid[].ext.impression_tracking_url として公開されます。 BidResponse.ad[].impression_tracking_url として、Google 構成されます。

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

これは、特定のキャンペーンに対する過去の 広告主の支払いに使用されるインプレッション数に Google ディスプレイ&動画 360（DV360）。

「オープン」から配信されたディスプレイ&ビデオ 360 インプレッションを正確に識別する それにより、Google が広告スパムと請求対象イベントの差異を調整できるようになります。 料金が発生していないインプレッションに対して料金が発生しないようにします。

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

すべての有効なインプレッション数を google_query_id はそのまま伝播する必要があります。 Google デマンド プラットフォームへの Open Bidding リクエスト。これは、Google Cloud で Open Bidding の差異解消現在想定される長さ google_query_id は約 64 バイトです。

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

Google デマンド プラットフォームがエクスチェンジの内部で落札した場合 third_party_buyer_token フィールドはそのまま伝播する必要があります。 Open Bidding のインプレッションを通じて入札レスポンスを返します。これにより、 Google パブリッシャープラットフォームを使用して 入札パートナーは、Google のデマンドに代わって同じインプレッションに入札しています 学びます。このフィールドの現在の最大長は 150 です あります。

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

差異の解消が適用されるようにするために、 Google クリエイティブのマークアップを反映するにはエクスチェンジが必要です ラッパー（スクリプトタグ、iframe、VAST ラッパー）なしで配信できます。これは、 ただし、Google は「Open」のディールを無効にし、請求しない場合があります。 Google デマンド プラットフォームでカウントされなかった入札インプレッション数。Google 定期的にクリエイティブのマークアップをチェックし、 Google デマンドに代わって third_party_buyer_token が送信されました。 他の購入者には関連付けられません

HTML5 クリエイティブ

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

交換が Google HTML クリエイティブをタグ（script、iframe、 そのうえで Google HTML コードの読み込みやレンダリングが行われることを指します。

技術要件を満たしている

この例では、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 動画クリエイティブ

差異解消の対象となるには、交換で以下を行う必要があります。 次のいずれかの方法を使用して、VASTTagURI を VAST XML レスポンス:

1. エクスチェンジは VASTTagURI 要素の値を以下のように保持できます。 Google から adm フィールドで返される VAST XML ドキュメントの一部 現状のまま、通常はエクスチェンジ固有のマクロ展開が適用されます。
2. ディスプレイ&ビデオ 360 では、nurl フィールドに、 エクスチェンジへの入札レスポンスです取引所では Google（ディスプレイ&ビデオ 360）が VASTTagURI で応答するnurl タグで指定し、必要に応じてエクスチェンジ固有のマクロを通常どおり展開します。

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

技術要件を満たしている

この例では、入札レスポンスに含まれる 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 -->

技術要件を満たしていない

この例では、クリエイティブの VAST コードまたは URI が Google から返されます 入札レスポンスにそのまま表示されることはなく、代わりに エクスチェンジ固有の VAST ラッパーが使用されている。Google 提供の VAST コードが読み込まれる可能性があります エクスチェンジから提供された VAST ラッパーを使用（VASTAdTagURI で定義） SDK の要素、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 に参加しているエクスチェンジでは 優先取引 （PD）、プライベート オークション （PA）と Open Bidding を併用できます。取引 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 へのアクセスに必要なアカウント ID の取得や API の使用に必要な できます。これらの API の使用に関するテクニカル サポートについては、 Ћ[e-mail] のサポート エイリアス

参考情報

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

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

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