# 動画広告

> Unity Exchange を通じてビデオ広告を配信することで、品質とパフォーマンスを確保します。

動画広告配信テンプレート ([VAST](https://www.iab.com/wp-content/uploads/2016/04/VAST4.0_Updated_April_2016.pdf)) は、デジタル動画プレイヤーに広告を配信するためのユニバーサル XML スキーマです。Unity は VAST 4.0（Internet Advertising Bureau（[IAB](https://www.iab.com/)； インターネット広告局）によって開発および保守されている標準）をサポートし、2.0 とは下位互換性のある（一部の機能を除く）プロトコルです。

Unity SDKはVAST XMLを解析して、ビデオ メディア ファイルとトラッキングURLを取得します。

以下の要件に従っていることを確認します。

* VAST `<InLine>`には、動画広告を描画するために必要な要素がすべて含まれている必要があります。詳細については、[VASTガイドライン](https://www.iab.com/wp-content/uploads/2016/04/VAST4.0_Updated_April_2016.pdf)の**セクション3.4**を参照してください。
* サポートされている`<MediaFile>`タイプは `video/mp4` です。`bitrate`、`delivery`、`width`、および `height` 属性を含める必要があります。詳細については、[VASTガイドライン](https://www.iab.com/wp-content/uploads/2016/04/VAST4.0_Updated_April_2016.pdf)の**セクション3.9**を参照してください。
* ビデオ継続時間は 5 秒から 30 秒の間でなければなりません。
* VAST タグは 5 つまでラップできます。
* コンパニオンは、最初の動画広告が終了するかスキップされた後に画面面表示する必要があります。
* すべての HTML マークアップは、`https://`とドメインを含む絶対 URL パスで外部でホストされるアセットを参照する必要があります。`file://` または相対 URL パスからアセットを指定することはできません。

さまざまな環境に合わせて複数のビデオサイズを含める:

* ビデオファイルの最大サイズは 20 MB。
* Wi-Fi接続では、ビデオプレイヤーは5\~10 MBのファイルを選択します。
* セルラー接続では、ビデオプレイヤーは 0.5 \~ 3 MB のファイルを選択します。
* 縦向きおよび横向きモードのビデオサイズは、可能な限り含めてください。

## スキップ可能な動画広告##skippable-video-ads

パブリッシャーは、ユーザーがアプリケーションの動画広告をスキップできるかどうかをコントロール。ほとんどのスキップ可能な広告では、ユーザーが終了カードにスキップできるようになるまで一定の秒数（パブリッシャーが指定）待機する必要があります。ほとんどのスキップ可能なインベントリではユーザーが終了カードまでスキップできるため、Unity ではビデオ需要に合わせてインベントリを含めることを強くお勧めします。スキップ可能およびスキップ不可のインベントリの詳細については、パートナー マネージャにお問い合わせください。

## ビデオコントロール##video-controls

Unity のビデオコントロールオーバーレイは、ビデオの再生中にビューにフェードします。画面をタップすると、表示/非表示を切り替えることができます。オーバーレイには、画面下部にプログレスバー、プライバシーアイコン、アクション呼び出し (CTA) が含まれます。右上隅の閉じるボタンや左上隅のスキップ アイコンが含まれる場合があります。

### ビデオクリックサポート##video-click-support

VAST タグは、`<ClickThrough>`ノードに 1 つのビデオクリックスルーを含む必要があり、各`<ClickTracking>`ノードに複数のクリックトラッキング URL を含めることができます。詳細については、[VASTガイドライン](https://www.iab.com/wp-content/uploads/2016/04/VAST4.0_Updated_April_2016.pdf)の**セクション3.10**を参照してください。

以下の要件に従っていることを確認します。

* クリックスルー URL には、それぞれのプラットフォームで`https://`、`market://`、` itunes://`または`itms://`のプレフィクスを使用する必要があります。
* Unity では、長い付加 URL の代わりにサーバー側のリダイレクトを使用することを強く推奨します。
* Unity は、`tel://` プレフィックスを使用したクリックツーコール広告をサポートしていません。
* クリックラッパーには、追加のクリックトラッキングを含めることができます。

### ビデオ CTA##video-ctas

ビデオ再生中は、画面の右下に CTA (アクション呼び出し) ボタンが表示されます。ユーザーはボタンをタップしてクリックスルーイベントをトリガーし、`<ClickThrough>` URL を開く必要があります。CTA ボタンのデフォルトでは "Learn More" になっています。クリエイティブの入札反応にバンドルIDが含まれている場合、CTAボタンには「Install Now(今すぐインストール)」と表示されます。

![動画広告の「Install Now（今すぐインストール）」呼び出しボタン。](/api/media?file=/grow/media/images/install-now-cta.png)

![動画広告の「Learn More」アクション呼び出しボタン。](/api/media?file=/grow/media/images/learn-more-cta.png)

#### CTA アイコン##cta-icons

VAST 3.0 以上ではアイコンの使用がサポートされています。Unity ビデオプレイヤーは、バンドル ID を含む入札レスポンスの動画再生中に "Install Now ボタンの横に正方形のアイコンを表示します。カスタムアイコンを VAST タグにネストできます。詳細については、[VASTガイドライン](https://www.iab.com/wp-content/uploads/2016/04/VAST4.0_Updated_April_2016.pdf)の**セクション3.11**を参照してください。

アイコンは宣伝対象のアプリケーションを表します。Unity はビデオ上に他のアイコンを表示することをサポートしません。次のアイコン要件に従っていることを確認します。

* アイコンは、`.png`、`.jpg`、または `.jpeg` 拡張子を持つ`<StaticResource>`画像にする必要があります。
* アイコンは 25 x 25 ピクセルの正方形で表示されます。
* Unity はアイコン継続時間と`<IconClickThrough>`機能をサポートしていません。

```xml title="Example CTA icon code"
<Icons>
	<Icon width="25" height="25">
	<StaticResource creativeType="image/png">
		<![CDATA[ https://Unity.com/DSP/square_icon_name ]]>
	</StaticResource>
	</Icon>
</Icons>
```

すべてのコンパニオンには、以下のサイズ制限内に `height` and `width` 属性を含める必要があります。

* 正正方形の幅/高ささの最小値は 200 ピクセルです。
* 横向きの最小幅/最小高ささは480 x 320ピクセルです。
* 縦向きの最小幅/最小高ささは 320 x 480 ピクセルです。

## コンパニオン広告##companion-ads

VAST コンパニオンは、ビデオの再生が完了すると全画面の終了カードとして表示されます。推奨されるベストプラクティスは、コンパニオンを使用してクリックスルーを最大化することです。ほとんどのパブリッシャーは終了カードへのスキップを許可しているため、スキップ可能なインベントリでもユーザーが広告体験を終了する前に終了カードが表示されます。

### コンパニオン クリック サポート##companion-click-support

終了カードが表示されている間、ユーザーは画面上の任意の場所をタップして`<CompanionClickTracking>`と`<CompanionClickThrough>`イベントをトリガーできます。終了カードの上に Unity CTA は配置されません。

詳細については、[VASTガイドライン](https://www.iab.com/wp-content/uploads/2016/04/VAST4.0_Updated_April_2016.pdf)の**セクション3.13**を参照してください。

### 終了カードリソースタイプ##end-card-resource-types

| **型**              | **説明**                                                                        | **ノート**                                                                                                                                                                                                                                                        |
| ------------------ | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `<HTMLResource>`   | HTML マークアップ。                                                                  | * マークアップにカスタムの閉じるボタンを含めることはできません。
* これは [MRAID](/grow/programmatic/unity-exchange/playable-ads.md) をサポートします。
* クリエイティブマークアップには、`<CompanionClickThrough>`要素ではなく HTML または JavaScript 内の click-through 機能を含める必要があります。
* Android デバイスは、HTML 終了を他のリソーススタイプよりも優先します。 |
| `<StaticResource>` | `image/jpeg` 、 `image/jpg` 、 `image/gif` 、 `image/png` などの`<img>`タグに表示するアセット。 | - クリック URL を`<CompanionClickThrough>`要素で指定します。                                                                                                                                                                                                                 |

## サポートされている VAST 4.x マクロ##supported-vast-4.x-macros

以下のリストは、Unity がサポートする VAST 4.x マクロがトラッキング URL で提供されている場合の詳細です。

* `[ERRORCODE]`
  * [エラー コード](#error) を参照してください。
* `[OMIDPARTNER]`
  * OM SDKインテグレーションの識別子。
  * これは、`OMIDPartner` オブジェクトの `name` および `versionString` パラメータと同じです。
* `[REASON]`
  * 検証を実行しなかった理由コード。
* `[TIMESTAMP]`
  * (タイムスタンプ)
* `[IFA]`
  * デバイス固有の広告 ID スキームからのリセット可能な広告 ID。UUID 形式か、[Guidelines For Identifier](https://iabtechlab.com/standards/guidelines-identifier-advertising-over-the-top-platforms/) 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 に設定します。

## トラブルシューティング##troubleshooting

### インプレッションが低い##low-impressions

特定の動画キャンペーンやクリエイティブについて、高い成約率を示しているもののインプレッションが少ない場合は、以下のください。

| **原因**                                        | **推奨アクション**                                                                                                                             |
| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| ラップされた VAST タグは、XML を返さない`VASTAdTagURI`を示します。 | キャンペーンが稼働していることを確認します。メディア ファイルは、受信後最大 2 時間後に表示される場合があります。                                                                              |
| ビデオファイルサイズが大きすぎます                             | 20 MB 未満のメディアファイルを少なくとも 1 つ提供します。                                                                                                       |
| プラットフォームまたはモバイルブラウザーがメディアファイルを再生できません。        | メディアファイルとトラッキング URL が安全であることを確認します。URL の末尾に `.mp4` などのファイル拡張子を含める。URL ではファイル拡張子は必須ではありませんが、これにより、一部のモバイルブラウザでの MIME タイプのエラーを減らすことができます。 |

### クリックスルー URL##click-through-urls

ビデオのクリックスルーURLのクエリ文字列にフォワードスラッシュ(`/`)またはプラス記号(`+`)が含まれている場合、その記号はUTF-8でエンコードされたURLになります。これは、一部のクリックリダイレクトを妨げ、インプレッションの低下につながる可能性があります。

> **Note:**
>
> クエリ文字列は、最初の疑問符（`?`）の後の URL の部分です。

| **Character** | **UTF-8 code** |
| ------------- | -------------- |
| `/`           | `%2F`          |
| `+`           | `%2B`          |

例を次に示します。

`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 がそれらをエンコードするときに、その文字が機能(解決またはリダイレクト)していることを確認してください。

### エラーコード##error

Unity は VAST タグの`<Error>`トラッキング URL に VAST エラーを送信し、`[ERRORCODE]` マクロを以下のエラーコードのいずれかに置き換えます。これらのエラーは、広告が表示されようとしているとき、またはすでに表示されているときに発生します。

| **コード** | **説明**                                    |
| ------- | ----------------------------------------- |
| `100`   | XML 解析エラーです。                              |
| `101`   | VAST スキーマ検証エラー。                           |
| `102`   | VAST バージョンはサポートされていません。                   |
| `200`   | VAST 形式はサポートされていません。                      |
| `202`   | ビデオ継続時間が長すぎるか、`HH:MM:SS`としてフォーマットされていません。 |
| `300`   | ラッパーエラー。                                  |
| `301`   | `VastAdTagURI`がタイムアウトしました。                |
| `302`   | ラッパーの最大数（5）を超えました。                        |
| `303`   | アンラップ後に`<Ad>`が見つかりませんでした。                 |
| `401`   | サポートされているメディアファイルが見つかりません。                |
| `402`   | メディアファイルの URI がタイムアウトしました。                |
| `403`   | サポートされていないメディアファイルです。                     |
| `404`   | メディア ファイルの URI は iOS ではサポートされていません。       |
| `499`   | クリックスルー URL がありません。                       |
| `600`   | 一般的なコンパニオン広告エラー。                          |
| `601`   | サポートされていないコンパニオン広告のサイズ。                   |
| `602`   | コンパニオン広告を表示できません。                         |
| `603`   | コンパニオン広告リソースを取得できません。                     |
| `604`   | 有効なコンパニオン広告リソース URL が見つかりません。             |
| `699`   | コンパニオン広告に有効なクリックスルー URL が含まれていません。        |
| `900`   | 未定義のエラー                                   |
| `998`   | VAST XML コンテンツに無効な URL が含まれています。          |
| `999`   | 不明なエラー                                    |
