サーバー間入札

サーバー間のセクションには以下の記載が含まれます:

• 統合
• オークションサーバーの設定
• Androidクライアントのセットアップ
• iOSクライアントのセットアップ
• テスト
• トラブルシューティング

このページの内容:

Facebook Audience Networkは、モバイルウェブサイトだけでなくモバイルアプリでの入札もサポートしています。モバイルアプリ入札の統合は、モバイルクライアントからFacebookのサーバーへ配信することも、あなたのサーバーからFacebookのサーバーへ配信することもできます。この概要では、アプリ入札の一般的な概念について説明します。

• はじめに
• 統合アーキテクチャ
• ORTBリクエスト/応答およびサポートされている広告フォーマット
• 落札/落札失敗/請求可能/タイムアウトの通知
• 支払い、オークション、ビューアビリティ、遅延

はじめに

アプリ入札とは

アプリ入札とは、パブリッシャーが、それぞれの広告掲載機会を複数のデマンドソースにリアルタイムで提供することによって、自社の広告インベントリーに関して公平でオープンなオークションを構築する方法です。すべてのデマンドソースに、すべてのインプレッションで競い、最も高い値を付けて落札するチャンスがあります。

アプリ入札を使用する理由

• リアルタイムのオークションは、広告リクエストごとに最適化できる機会となります。
• 広告インベントリーの真の価値を知ることができます。
• メンテナンスが簡単で、広告運用リソースを削減できます。

統合アーキテクチャ

アプリ入札は、各インプレッション機会で入札を提供するために、Open Real-Time Bidding (ORTB)プロトコルを実装したエンドポイントを介して提供されます。アプリ入札では、以下の処理のためにAudience Network SDKが必要となります。

• buyeruid (Audience Network SDKでは bidderToken )を取得する。これは、入札リクエストの必須項目であり、ユーザーごと、アプリごとに固有のもので、他のユーザーやアプリでは無効になります。
• 入札応答を読み込み、入札者がオークションで落札した時に広告を表示する。
• インプレッション数とクリック数を記録する。

入札フローにおける主なステップ

1. 入札者トークンを取得する。Audience Networkで入札リクエストに応答できるようにするために必要な、不透明型の文字列です。
2. 入札リクエストを送信し、入札応答を取得する。これが、入札エンドポイントとの主なやり取りです。このステップで、ORTB入札のリクエストを送信し、有効な入札応答、またはエラーを受信します。
3. オークションを実行する。オークションを行い、入札応答の中から落札者を選びます。ほとんどのオークションでは、リアルタイム入札と他のデマンドソースからの推定CPM（過去の平均CPMなど）を比較しています。これは、リアルタイム入札に対応していないデマンドソースがあるためです。オークションは、以下のいずれかによって実行されます。
   • 独自のオークションロジックを実行する自社サーバー
   • サードパーティのオークションサーバー
   • ユーザーのデバイス上のクライアント
4. 入札応答を含む広告を取得する。Audience Networkがオークションを落札すると、入札応答の adm フィールドをユーザーのデバイス上のAudience Network SDKに渡して広告を読み込みます。 adm フィールドには実際の広告が含まれていないことに注意してください。それに含まれるのは、SDKがAudience Networkサーバーから広告を取得するための情報です。

統合のタイプ

オークションを実行すると(上記の入札フローの3番目のステップ)、クライアント側または サーバー側にホストされます。以下に3つの統合タイプを示します。

サーバー間の統合アーキテクチャ

サーバー間統合では、オークションサーバーはFacebook Audience Network入札エンドポイントとその他すべてのデマンドソースを呼び出して入札応答を取得します。次に、オークションサーバーはオークションを実行して落札者を選定します。このオークションサーバーとして、パブリッシャーが構築したオークションロジックを実行する自社サーバーか、Audience Networkのアプリ入札と統合されたサードパーティのサーバーを使用できます。こうして、サーバーのリソースと使用可能なネットワークを利用し、デマンドソースの入札エンドポイントを呼び出すことができるようになります。また、クライアントを更新せずに、これらのエンドポイント統合に変更を加えることもできます。

外部広告サーバーの統合

外部のアドサーバーと連携することで、今日のウォーターフォールメディエーションの世界とアプリ入札の橋渡しをすることができます。これは、アプリ入札をサポートするデマンドソースとサーバー間の統合を行い、オークションの落札者をウォーターフォールのメディエーションプラットフォームに渡して、ウォーターフォールを実行し、総合的に落札したデマンドソースを選択するという仕組みです。この統合は、ウォーターフォール型のメディエーションとアプリ入札の世界をつなぐ、暫定的な 橋渡しという意味を持っています。このタイプの統合を行う場合、独自のオークションロジックを作成する必要はありません。

ORTBリクエスト/応答およびサポートされている広告フォーマット

ORTBリクエスト

入札エンドポイントでは、OpenRTBプロトコルv2.5の一部がサポートされています。

注:オークションサーバーのセットアップガイドにあるリクエストの例の全文をご覧ください。

'id' => string, // platform's auction identifier,
'imp' => vec< // slots to bid on
shape(
'id' => string, // platform's identifier for this slot auction
// only for banner impression opportunities
'banner' => shape(
'w' => int, // width
'h' => int, // height
),
// only for native impression opportunities
'native' => shape(
'w' => int, // width 
'h' => int, // height 
),
// only for video impression opportunities
'video' => shape(
'w' => int, // width
'h' => int, // height
'linearity' => int, // 1 = instream, optional
'ext' => shape(
'videotype' => string, // 'rewarded' for Rewarded Video impression opportunities, optional
),
),
'tagid' => string, // Placement ID
'instl' => int, // interstitial flag, 1 = On, 0 = Off, optional
)
>,
// app details (in-app bidding only)
'app' => shape( 
'publisher' => shape(
'id' => string, // publisher app ID
),
),
'device' => shape(
'ua' => string, // device user-agent
'ifa' => string, // ID sanctioned for advertiser use
// Do not send ip or ipv6 if you are requesting bids from the client device.
// For server-side bid requests set ip or ipv6.
'ip' => string, // device IPv4
'ipv6' => string, // device IPv6
'dnt' => int, // "do not track", 1 = On, 0 = Off, optional
'lmt' => int, // "limit ad tracking", 1 = On, 0 = Off
),
'regs' => shape( // regulations object
'coppa' => int, // US FTC regulations for Children's Online Privacy Protection Act, 1 = On, 0 = Off, optional
),
'user' => shape(
'buyeruid' => string, // Audience Network Identity Token, mandatory
),
'ext' => shape(
'platformid' => string, // Mediation partner Platform ID or publisher FB app ID, mandatory
'authentication_id' => string // Authentication token to validate the originator of the request                     
),
'at' => int, // auction type: 1 = First Price, 2 = Second Price
'tmax' => int, // auction timeout in milliseconds
'test' => int, // 0 = normal, 1 = test-mode (we bid $99.99, but don't pay out), optional

ORTB応答

入札応答の有効期間は30分です。入札応答を受け取ってから30分以内であれば任意のタイミングで広告をリクエストできます。入札に基づくインプレッションが30分を超えた場合、支払いは行われません。

注: 入札応答で広告をリクエストすると、広告をクライアントでキャッシュできますが、読み込んで60分以内に表示する必要があります。キャッシュされた広告に基づくインプレッションが60分を超えた場合、支払いは行われません。

1  
'id' => string // platform's request identifier
'seatbid' => vec<
    shape(
        'bid' => vec<
            shape(
                'id' => string, // Our identifier for this bid
                'impid' => string, // platform's identifier for this slot auction
                'price' => float, // Our bid price on CPM basis, in USD
                'adm' => string, // Our creative - see Rendering The Ad
                'nurl' => string, // URL to get if we win the impression
                'lurl' => string, // URL to get if we lose the impression
            )
        >,
    ),
>,
'bidid' => string, // Our identifier for this response
'cur' => string, // bid currency: USD

落札/落札失敗/請求可能/タイムアウトの通知

"https://www.facebook.com/audiencenetwork/nurl/?partner=${PARTNER_FBID}&app=${APP_FBID}&placement=${PLACEMENT_FBID}&auction=${AUCTION_ID}&impression=${IMPRESSION_ID}&request=${BID_REQUEST_ID}&bid=${BID_ID}&ortb_loss_code=0&clearing_price=${AUCTION_PRICE}"

"https://www.facebook.com/audiencenetwork/nurl/?partner=${PARTNER_FBID}&app=${APP_FBID}&placement=${PLACEMENT_FBID}&auction=${AUCTION_ID}&impression=${IMPRESSION_ID}&request=${BID_REQUEST_ID}&bid=${BID_ID}&ortb_loss_code=${AUCTION_LOSS}&clearing_price=${AUCTION_PRICE}"

"https://www.facebook.com/audiencenetwork/burl/?partner=${PARTNER_FBID}&app=${APP_FBID}&placement=${PLACEMENT_FBID}&auction=${AUCTION_ID}&impression=${IMPRESSION_ID}&request=${BID_REQUEST_ID}&bid=${BID_ID}&ortb_loss_code=0&clearing_price=${AUCTION_PRICE}"

"https://www.facebook.com/audiencenetwork/nurl/?partner=${PARTNER_FBID}&app=${APP_FBID}&auction=${AUCTION_ID}&ortb_loss_code=2"

支払い、オークション、ビューアビリティ、遅延

価格と支払い

価格はCPMに基づいてUSDで付けられます(たとえば「4.25」は、落札された場合に、1,000インプレッションに対して$4.25支払うことを意味します)。nurl および lurlのクリア価格にも同じ単位を使用する必要があります。支払いは、パブリッシャーに対して直接行われます。

オークションのメカニズム

Facebookでは、常にファーストプライスベースで入札を行います。つまり、入札した金額を支払い、支払う総額を想定して入札します。入札額より少なく支払うことが想定されるため、他の入札者が値段を付けることになるセカンドプライスオークションでは不利な立場に置かれることを意味します。

ビューアビリティ

アプリインプレッションでは、最高入札者であるかどうかにかかわらず、インプレッションが表示された場合にのみ支払われます。

遅延

• 遅延を最小限にするため、APIの呼び出しごとに1つの入札をリクエストします(つまり、5つのスロットをオークションにかける場合、APIを5回呼び出します。それぞれが1つの入札に対応します)。
• 地域固有のエンドポイントは提供していません。Facebook のインフラストラクチャは、入札リクエストを最寄りのデータセンターにルーティングします。
• HTTP/2の永続的な接続を使用します。
• 入札リクエストのORTB tmaxフィールドにオークションタイムアウトを入力し、遅延とパフォーマンスのバランスを取りながら入札戦略を選択します(tmaxの詳細については、上記の入札リクエストの例 を参照してください)。
• 遅延の目標を達成するために、時間を表示する一部の処理を先送りすることもできます(つまり、入札を速くすると広告表示が遅くなり、入札を遅くすると広告表示が速くなります)。
• Facebookでは、遅延の解消に積極的に取り組んでいます。現在、サーバー間の入札に対して800ミリ秒のタイムアウトを設定することをお勧めしています。

参考情報

• 統合
• オークションサーバーの設定
• Androidクライアントのセットアップ
• iOSクライアントのセットアップ
• テスト
• トラブルシューティング