この記事では、新しい VAST パートナーが、Vungle のプログラマティックな広告プラットフォームに VAST のテクノロジーを組み込むために役立つ Vungle のプロセスと仕様を説明します。
コンテンツ
VAST レスポンスの仕様
入札レスポンスは、次の仕様に準拠している必要があります。
- 最大 30 秒の動画再生時間
- 最小ビッドレート 250 kbps
- XML は次のものを含む必要があります。
- .mp4 メディアファイル 1 つ
- ビットレート情報
- 動画の長さに関する情報
- すべてのリダイレクトは最大 1 回のみリダイレクトできます
- レスポンス時間:
- ストリーミングの場合: 250ms 以内
- 事前キャッシュの場合: 750ms 以内
- ランディングページまでクリックする必要があります
- SSL をサポートし、セキュア アセットで応答する必要があります
- 広告がない場合は
‘no-ad’または‘403’で応答します - VAST 拡張は望ましいが、必須ではありません
上記の要件が満たされていない場合は、エラーが返されます。
Vungle のパートナー統合プロトコル
新しい VAST パートナーが、Vungle のプログラマティックな広告プラットフォームに VAST のテクノロジーを組み込むためのプロセスは、2 段階に分かれています。第 1 段階は一般的な検証と捉えることができます。Vungle がタグを検査し、サーバーコールが正しく起動され、値が正しく入力されていることを確認します。第 2 段階では、統計的に有意な一連のインプレッションの間での不一致を検索し、Vungle の数値がパートナーの数値と一致するよう厳格なテストを行います。
第 1 段階
- パートナーが Vungle に技術文書を送信します (ある場合)。
- パートナーが Vungle にテスト用の VAST エンドポイントを送信します。
注意: テスト段階では、重要なテスト結果を生成するために、Vungle の入札リクエストの 100% に回答する必要があります。
- Vungle が、要求に応じてパートナーのエンドポイントを呼び出すためのテスト環境を構築します。
これは、変数値の検証とビーコンの追跡に使用されます。
第 2 段階
- Vungle がパートナーと協力してテスト キャンペーンを立ち上げます。
- パートナーが実際の需要をシミュレートしたテスト エンドポイントを送信します。
- Vungle がテスト キャンペーンを立ち上げ、所定の回数のインプレッションを実行します。
VAST リクエストのサンプル
パラメータが入力されていない VAST リクエストのサンプル URL (VAST タグ)
https://partner.com/vast2/6524rgww153hifw/?duration=15&app_name={{{pub_app_name}}}&app_id={{{market_id}}}&rtb_type=instream_mobile_vast_inter&user_id={{{device_id}}}&ua={{{browser_user_agent}}}&random={{{timestamp}}}&ip_address={{{ip}}} パラメータが入力された VAST リクエストのサンプル URL (VAST タグ)
https://partner.com/vast2/124765432/?duration=15&app_name=My%20Talking%20Tom%20Free%20for%20Android&app_id=com.outfit7.mytalkingtomfree&rtb_type=instream_mobile_vast_inter&user_id=6df43c89-9e3d-43fb-a1e9-bacd51932d41&ua=Mozilla%2F5.0%20(Linux%3B%20Android%204.4.2%3B%20SPH-L720%20Build%2FKOT49H)%20AppleWebKit%2F537.36%20(KHTML%2C%20like%20Gecko)%20Version%2F4.0%20Chrome%2F30.0.0.0%20Mobile%20Safari%2F537.36&random=2015-01-27T21%3A30%3A34%2B00%3A00&ip_address=66.87.114.254 VAST リクエスト パラメータ
| パラメータ名 | マクロ | 値 | 注意: | 例 |
| アプリカテゴリ | {{{pub_app_store_category}}} |
文字列 | カテゴリ一覧 | ゲーム |
| アプリ名 | {{{pub_app_name}}} |
文字列 | iTunes または Play ストアから | にじいろ牧場 |
| アプリストアの URL | {{{pub_app_store_url}}} |
文字列 | エンコードされたアプリストア またはコンテンツの URL。 | https://play.google.com/store/apps/details?id=com.funplus.familyfarm&hl=en |
| バンドル ID | {{{pub_market_app_id}}} |
文字列/整数 | iTunes または Play ストアから | com.funplus.familyfarm&hl=en (Android) 539920547 (iOS) |
| 市町村 | {{{city}}} |
文字列 | エンコード済み | ニューヨーク |
| 接続の種類 | {{{connection_type}}} |
文字列 | Wifi、wwan、モバイル | Wifi、wwan、モバイル |
| 国 | {{{country}}} |
文字列 | 2 文字の国コード | US |
| デバイスの DNT | {{{ad_tracking_disabled}}} |
文字列 | 'True' はユーザーが広告のトラッキングを許可していないことを意味します | True/False |
| デバイスの DNT | {{{ad_tracking_enabled}}} |
文字列 | 'True' はユーザーが広告のトラッキングを許可していることを意味します | True/False |
| デバイスの DNT | {{{boolean_number ad_tracking_disabled}}} |
整数 | トラッキング拒否 (バイナリ形式) | 0 – False 1 - True |
| デバイス ID | {{{device_id}}} |
文字列 | クリアまたはハッシュド | ab4d6cc4-f57f-4309-9d29-b7fb5e35dd74 |
| デバイスのモデル | {{{device_model}}} |
文字列 | エンコード済み | Amazon、KFFOWI samsung、SM-J700T |
| IP | {{{ip}}} |
文字列 | インターネット プロトコル アドレス | 95.118.153.77 |
| 言語 | {{{language}}} |
文字列 | ヘッダーからの 2 文字の言語 | 10.2.1 |
| OS バージョン | {{{os_version}}} |
文字列 | OS バージョン (iOS 7.2 など) | 2014-12-05T00%3A44%3A19%2B00%3A00 |
| プラットフォーム | {{{device_platform}}} |
文字列 | iOS または Android | iOS/Android |
| 画面の高さ | {{{screen_height}}} |
整数 | 画面の高さ (ピクセル) | 768 |
| 画面の向き | {{{screen_orientation}}} |
文字列 | 縦向きまたは横向き | 縦向き/横向き |
| 画面の幅 | {{{screen_width}}} |
整数 | 画面の幅 (ピクセル) | 1024 |
| タイムスタンプ | {{{timestamp}}} |
文字列/整数 | エンコード済み | 2014-12-05T00:44:19+00:00 |
| ユーザー エージェント | {{{browser_user_agent}}} |
文字列 | ヘッダーからのエンコードされた UA。 | Mozilla/5.0 (Linux; Android 5.1.1; VF-1397 Build/LMY47V; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/55.0.2883.91 Safari/537.36 |
| Vungle ID | {{{vungle_id}}} |
文字列 | パフォーマンスを関連付けるための Vungle パブリッシャー ID | 5497c989a3b61ba3660001b1 |