動画広告
Unity Exchange を通じてビデオ広告を配信することで、品質とパフォーマンスを確保します。
読み終わるまでの所要時間 22 分最終更新 7日前
動画広告配信テンプレート (VAST) は、デジタル動画プレイヤーに広告を配信するためのユニバーサル XML スキーマです。Unity は VAST 4.0(Internet Advertising Bureau(IAB; インターネット広告局)によって開発および保守されている標準)をサポートし、2.0 とは下位互換性のある(一部の機能を除く)プロトコルです。
Unity SDKはVAST XMLを解析して、ビデオ メディア ファイルとトラッキングURLを取得します。
以下の要件に従っていることを確認します。
- VAST には、動画広告を描画するために必要な要素がすべて含まれている必要があります。詳細については、VASTガイドラインのセクション3.4を参照してください。
<InLine> - サポートされているタイプは
<MediaFile>です。video/mp4、bitrate、delivery、およびwidth属性を含める必要があります。詳細については、VASTガイドラインのセクション3.9を参照してください。height - ビデオ継続時間は 5 秒から 30 秒の間でなければなりません。
- VAST タグは 5 つまでラップできます。
- コンパニオンは、最初の動画広告が終了するかスキップされた後に画面面表示する必要があります。
- すべての HTML マークアップは、とドメインを含む絶対 URL パスで外部でホストされるアセットを参照する必要があります。
https://または相対 URL パスからアセットを指定することはできません。file://
さまざまな環境に合わせて複数のビデオサイズを含める:
- ビデオファイルの最大サイズは 20 MB。
- Wi-Fi接続では、ビデオプレイヤーは5~10 MBのファイルを選択します。
- セルラー接続では、ビデオプレイヤーは 0.5 ~ 3 MB のファイルを選択します。
- 縦向きおよび横向きモードのビデオサイズは、可能な限り含めてください。
スキップ可能な動画広告
パブリッシャーは、ユーザーがアプリケーションの動画広告をスキップできるかどうかをコントロール。ほとんどのスキップ可能な広告では、ユーザーが終了カードにスキップできるようになるまで一定の秒数(パブリッシャーが指定)待機する必要があります。ほとんどのスキップ可能なインベントリではユーザーが終了カードまでスキップできるため、Unity ではビデオ需要に合わせてインベントリを含めることを強くお勧めします。スキップ可能およびスキップ不可のインベントリの詳細については、パートナー マネージャにお問い合わせください。
ビデオコントロール
Unity のビデオコントロールオーバーレイは、ビデオの再生中にビューにフェードします。画面をタップすると、表示/非表示を切り替えることができます。オーバーレイには、画面下部にプログレスバー、プライバシーアイコン、アクション呼び出し (CTA) が含まれます。右上隅の閉じるボタンや左上隅のスキップ アイコンが含まれる場合があります。
ビデオクリックサポート
VAST タグは、ノードに 1 つのビデオクリックスルーを含む必要があり、各ノードに複数のクリックトラッキング URL を含めることができます。詳細については、VASTガイドラインのセクション3.10を参照してください。
<ClickThrough><ClickTracking>以下の要件に従っていることを確認します。
- クリックスルー URL には、それぞれのプラットフォームで、
https://、market://またはitunes://のプレフィクスを使用する必要があります。itms:// - Unity では、長い付加 URL の代わりにサーバー側のリダイレクトを使用することを強く推奨します。
- Unity は、プレフィックスを使用したクリックツーコール広告をサポートしていません。
tel:// - クリックラッパーには、追加のクリックトラッキングを含めることができます。
ビデオ CTA
ビデオ再生中は、画面の右下に CTA (アクション呼び出し) ボタンが表示されます。ユーザーはボタンをタップしてクリックスルーイベントをトリガーし、 URL を開く必要があります。CTA ボタンのデフォルトでは "Learn More" になっています。クリエイティブの入札反応にバンドルIDが含まれている場合、CTAボタンには「Install Now(今すぐインストール)」と表示されます。
<ClickThrough>

CTA アイコン
VAST 3.0 以上ではアイコンの使用がサポートされています。Unity ビデオプレイヤーは、バンドル ID を含む入札レスポンスの動画再生中に "Install Now ボタンの横に正方形のアイコンを表示します。カスタムアイコンを VAST タグにネストできます。詳細については、VASTガイドラインのセクション3.11を参照してください。
アイコンは宣伝対象のアプリケーションを表します。Unity はビデオ上に他のアイコンを表示することをサポートしません。次のアイコン要件に従っていることを確認します。
- アイコンは、、
.png、または.jpg拡張子を持つ.jpeg画像にする必要があります。<StaticResource> - アイコンは 25 x 25 ピクセルの正方形で表示されます。
- Unity はアイコン継続時間と機能をサポートしていません。
<IconClickThrough>
<Icons> <Icon width="25" height="25"> <StaticResource creativeType="image/png"> <![CDATA[ https://Unity.com/DSP/square_icon_name ]]> </StaticResource> </Icon></Icons>
すべてのコンパニオンには、以下のサイズ制限内に and 属性を含める必要があります。
heightwidth- 正正方形の幅/高ささの最小値は 200 ピクセルです。
- 横向きの最小幅/最小高ささは480 x 320ピクセルです。
- 縦向きの最小幅/最小高ささは 320 x 480 ピクセルです。
コンパニオン広告
VAST コンパニオンは、ビデオの再生が完了すると全画面の終了カードとして表示されます。推奨されるベストプラクティスは、コンパニオンを使用してクリックスルーを最大化することです。ほとんどのパブリッシャーは終了カードへのスキップを許可しているため、スキップ可能なインベントリでもユーザーが広告体験を終了する前に終了カードが表示されます。
コンパニオン クリック サポート
終了カードが表示されている間、ユーザーは画面上の任意の場所をタップしてとイベントをトリガーできます。終了カードの上に Unity CTA は配置されません。
<CompanionClickTracking><CompanionClickThrough>詳細については、VASTガイドラインのセクション3.13を参照してください。
終了カードリソースタイプ
型 | 説明 | ノート |
|---|---|---|
| HTML マークアップ。 |
|
| |
|
サポートされている VAST 4.x マクロ
以下のリストは、Unity がサポートする VAST 4.x マクロがトラッキング URL で提供されている場合の詳細です。
[ERRORCODE]- エラー コード を参照してください。
[OMIDPARTNER]- OM SDKインテグレーションの識別子。
- これは、オブジェクトの
OMIDPartnerおよびnameパラメータと同じです。versionString
[REASON]- 検証を実行しなかった理由コード。
[TIMESTAMP]- (タイムスタンプ)
[IFA]- デバイス固有の広告 ID スキームからのリセット可能な広告 ID。UUID 形式か、Guidelines For Identifier On Advertising On OTT Platforms に関する IAB ドキュメントに基づく。Apple の広告主 ID や Android の広告 ID など。
[IFATYPE]- マクロに含まれる IFA のタイプを示す文字列値。
[IFA]
[APIFRAMEWORKS]- プレイヤーがサポートするフレームワークのリスト。
- 値は AdCOM 1.0 API Frameworks リストで定義されます。
[APPBUNDLE(required)]- アプリケーション広告の場合は、プラットフォーム固有のアプリケーション識別子、バンドル、またはパッケージ名。この ID には、Apple App Store ID などのアプリストア ID は使用できません。
- 不明または使用できない場合は、-1 または -2 に設定されます。
- 必須で適用できない場合(アプリケーションなど)は、0 に設定します。
- アプリケーション広告の場合は、プラットフォーム固有のアプリケーション識別子、バンドル、またはパッケージ名。この ID には、Apple App Store ID などのアプリストア ID は使用できません。
トラブルシューティング
インプレッションが低い
特定の動画キャンペーンやクリエイティブについて、高い成約率を示しているもののインプレッションが少ない場合は、以下のください。
原因 | 推奨アクション |
|---|---|
ラップされた VAST タグは、XML を返さない | キャンペーンが稼働していることを確認します。メディア ファイルは、受信後最大 2 時間後に表示される場合があります。 |
| ビデオファイルサイズが大きすぎます | 20 MB 未満のメディアファイルを少なくとも 1 つ提供します。 |
| プラットフォームまたはモバイルブラウザーがメディアファイルを再生できません。 | メディアファイルとトラッキング URL が安全であることを確認します。URL の末尾に |
クリックスルー URL
ビデオのクリックスルーURLのクエリ文字列にフォワードスラッシュ()またはプラス記号()が含まれている場合、その記号はUTF-8でエンコードされたURLになります。これは、一部のクリックリダイレクトを妨げ、インプレッションの低下につながる可能性があります。
/+Character | UTF-8 code |
|---|---|
| |
| |
例を次に示します。
https://domain.com/anything_here_is_fine?this_is_a/query+stringは以下のようにエンコードされます。
https://domain.com/anything_here_is_fine?this_is_a%2Fquery%2Bstringクリックスルー URL に特殊文字が含まれている場合は、Unity がそれらをエンコードするときに、その文字が機能(解決またはリダイレクト)していることを確認してください。
エラーコード
Unity は VAST タグのトラッキング URL に VAST エラーを送信し、 マクロを以下のエラーコードのいずれかに置き換えます。これらのエラーは、広告が表示されようとしているとき、またはすでに表示されているときに発生します。
<Error>[ERRORCODE]コード | 説明 |
|---|---|
| XML 解析エラーです。 |
| VAST スキーマ検証エラー。 |
| VAST バージョンはサポートされていません。 |
| VAST 形式はサポートされていません。 |
| ビデオ継続時間が長すぎるか、 |
| ラッパーエラー。 |
| |
| ラッパーの最大数(5)を超えました。 |
| アンラップ後に |
| サポートされているメディアファイルが見つかりません。 |
| メディアファイルの URI がタイムアウトしました。 |
| サポートされていないメディアファイルです。 |
| メディア ファイルの URI は iOS ではサポートされていません。 |
| クリックスルー URL がありません。 |
| 一般的なコンパニオン広告エラー。 |
| サポートされていないコンパニオン広告のサイズ。 |
| コンパニオン広告を表示できません。 |
| コンパニオン広告リソースを取得できません。 |
| 有効なコンパニオン広告リソース URL が見つかりません。 |
| コンパニオン広告に有効なクリックスルー URL が含まれていません。 |
| 未定義のエラー |
| VAST XML コンテンツに無効な URL が含まれています。 |
| 不明なエラー |