> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/ja/generating-ads/banner-x-responsive/video-ads-banner-x.md).

# Banner X動画広告

広告主とリテールパートナーはプロモーション動画をバナーにアップロードでき、Webサイトやアプリに直接表示されます。これらの動画は、魅力的形で商品を紹介することで購買決定に影響を与えます。インタラクティブ動画では、消費者が動画から直接商品を調べたり購入したりでき、**カートに追加**や**今すぐ購入**などのオプション機能が提供されます。

<figure><img src="/files/B3L2hvC0NuVQZDkXekE7" alt="" width="450"><figcaption></figcaption></figure>

## サイトに動画広告を導入する理由

オンサイト動画により、広告主はWebサイト上で買い物客とより深いエンゲージメントを構築できます。これにより、より魅力的な買い物体験が創出され、買い物客がサイトにとどまって商品を検討する時間を増やすことができます。

| 理由                | 説明                                                                            |
| ----------------- | ----------------------------------------------------------------------------- |
| ブランドストーリーの訴求      | エンゲージメントの高い動画広告は、広告主の全体的または特定商品のストーリーの魅力的で適切な部分を紹介し、リテールブランドと買い物客をより深く結びつけます。 |
| 新商品の発売            | 広告主は動画を活用して、通常のディスプレイ広告よりも深く新商品を紹介できます。動画により、新商品がもたらす価値を買い物客にアピールできます。        |
| ブランド認知度           | 新しいカテゴリーや新しいメッセージで認知度を高めたい広告主は、サイト内の主要な場所で動画を使用し、買い物客に直接アプローチできます。            |
| リテールブランドとの結びつきの強化 | 動画は、買い物客のマインドにおいて広告主とリテールブランドの結びつきを深めることができます。                                |

## 動画の仕様

* 最大ファイルサイズ\*\*: 300MB
* **対応ファイル形式**: Video/mp4, video/quicktime, video/x-msvideo
* **オプションのコーデック検証**: H.264, H.265
* **高さと幅**: リテールパートナーがピクセル単位で定義
* 再生時間制限\*\*: なし
* **キャンペーン審査**: 動画要素を含むバナー X キャンペーンで必須
* **タグサポート**: 次として配信される標準VASTタグ `adm` 広告レスポンス内

## 動画広告の統合

シームレスに統合できるインタラクティブなバナー X 動画広告を作成できます [VAST 4.0](https://iabtechlab.com/wp-content/uploads/2016/05/VAST4.0_Updated_April_2016.pdf) 互換性のあるビデオプレイヤーにより、リテールパートナーに最小限の工数で導入を効率化するインタラクティブな広告フォーマットを提供します。

Banner X 動画広告はDigital Video Ad Serving Template (VAST) 4.0標準に準拠しており、サポートされているビデオプレイヤーとのスムーズで互換性のある統合を保証します。

キャンペーンに動画広告を組み込む際、広告レスポンスにはという名前のフィールドが含まれます `adm`。このフィールドにはVAST 4.0準拠に必要なXMLタグが含まれており、ビデオプレイヤーへの埋め込みが容易になります。

### 統合要件

#### 広告リクエスト

当社の Banner X エンドポイントに広告リクエストを送信する必要があります。動画およびその他のバナーコンテンツは、動画とバナーコンテンツが設定されているキャンペーンに対してのみ配信されます。が提供された広告を受信する前に、動画アセットが設定されているキャンペーンが存在することを確認する必要があります `adm` オブジェクトが提供されます。

広告のリクエスト方法についての詳細は、以下を参照してください [バナーX広告を生成する](/retail-media-interface/integration/ja/integration/bannerx.md)

#### ビデオプレイヤー（広告のレンダリング）

Epsilon Retail Media バナー X レスポンスの `adm` オブジェクトとして、広告レスポンス内でVASTタグ（Video Ad Server Template）を配信します。そのため、VASTタグをパースして動画広告をレンダリングするには、ビデオプレイヤーが必要になる可能性が高くなります。

{% hint style="info" %}
**ビデオプレイヤーをお持ちでない場合** さまざまなオープンソースのビデオプレイヤーをご利用いただけます。Video JSやClapprなど、利用可能な有料オプションおよびオープンソースオプションを確認することをお勧めします。なお、VASTタグをパースするには追加のプラグインが必要になる場合があります。
{% endhint %}

#### Banner X プレビュー機能

キャンペーンの作成、管理、審査を行う際に広告プレビューが正確に表示されるよう、バナー X プレビュー機能を更新してください。以下を参照してください [バナー X プレビューワー](/retail-media-interface/integration/ja/generating-ads/banner-x-responsive/integrating-your-banner-x-previewer.md).

#### トラッキングとレポート

さまざまなトラッキング（インプレッション、クリック、進行状況、インタラクション）がすべて可能です。ガイドを参照してください [バナーX動画インタラクションレポート](/retail-media-interface/integration/ja/data-api/api-overview/ad-interaction-events-reporting/integrate-banner-x-video-interaction-reporting.md)

### トラッキング要素

トラッキング目的で [Video Ad Serving Template (動画広告配信テンプレート)](https://iabtechlab.com/standards/vast/) (VAST)を使用します。VASTタグには複数のトラッキングメカニズムが含まれています:

* インプレショントラッキング
* クリッキングトラッキング
* 進行状況トラッキング（start、firstQuartile、midpoint、thirdQuartile、complete）
  * **第1四分位数（25%再生）**: 初期エンゲージメントの初期指標
  * **中間点（50%再生）**: コンテンツの半ばまで視聴者が興味を維持していることを示す
  * **第3四分位数（75%再生）**: コンテンツに対する高い視聴意欲を示す
  * **完了（100%再生）**: ユーザーが動画を最後まで視聴したことを確認し、最大エンゲージメントを示す
* インタラクションのトラッキング（mute、unmute、pause、resume、fullscreen）
  * **消音（Mute）**: ユーザーが動画の音声を出力しないようにした
  * **消音解除（Unmute）**: ユーザーが動画の音声をオンにした
  * **一時停止（Pause）**: ユーザーが動画再生を一時停止した
  * **再開（Resume）**: 一時停止後にユーザーが動画再生を再開した

{% hint style="info" %}
**インタラクションのトラッキングに関する統合ガイドを見る** ガイドを参照してください [バナーX動画インタラクションレポート](/retail-media-interface/integration/ja/data-api/api-overview/ad-interaction-events-reporting/integrate-banner-x-video-interaction-reporting.md)
{% endhint %}

### 動画広告の広告レスポンス例

VAST関連情報を含む動画広告レスポンスの表示形式のスニペットです:

```
{
  "ads": [
    {
      "contentStandardId": "00000000-0000-0000-0000-000000000001",
      "slotId": "Double_Tile",
      "banners": [
        {
          "citrusAdId": "example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789",
          "citrusCampaignName": "Example-Campaign-Name",
          "citrusContentStandardId": "00000000-0000-0000-0000-000000000001",
          "citrusSlotId": "Double_Tile",
          "citrusExpiry": "2026-12-31T00:00:00.000000000Z",
          "headingText": "Example heading text",
          "bannerText": "Example banner text",
          "bannerTextColour": "000000",
          "tags": {},
          "gtins": [
            "00000000000000"
          ],
          "sellerId": "",
          "position": 1,
          "metadata": {},
          "adm": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<VAST version=\"4.0\">
    <Ad id=\"1\">
        <InLine>
            <AdSystem>CitrusAd</AdSystem>
            <Impression><![CDATA[https://example.com/v1/resource/first-i/example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789]]></Impression>
            <ViewableImpression>
                <Viewable><![CDATA[https://example.com/v1/resource/first-i/example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789]]></Viewable>
                <NotViewable></NotViewable>
                <ViewUndetermined></ViewUndetermined>
            </ViewableImpression>
            <AdTitle>example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789</AdTitle>
            <Creatives>
                <Creative>
                    <UniversalAdId
                        idRegistry=\"citrusad.com\"
                        idValue=\"00000000-0000-0000-0000-000000000002\">
                        00000000-0000-0000-0000-000000000002
                    </UniversalAdId>
                    <Linear>
                        <Duration></Duration>
                        <MediaFiles>
                            <ClosedCaptionFiles>
                                <ClosedCaptionFile type=\"text/vtt\" language=\"en\">
                                    <![CDATA[https://example.com/media/example-transcript.vtt]]>
                                </ClosedCaptionFile>
                            </ClosedCaptionFiles>
                            <Mezzanine>
                                <![CDATA[https://example.com/media/example-video-1.mp4]]>
                            </Mezzanine>
                            <MediaFile
                                delivery=\"progressive\"
                                type=\"video/mp4\"
                                width=\"160\"
                                height=\"128\"
                                bitrate=\"3552\"
                                codec=\"h264\">
                                <![CDATA[https://example.com/media/example-video-1.mp4]]>
                            </MediaFile>
                        </MediaFiles>
                        <VideoClicks>
                            <ClickTracking>
                                <![CDATA[https://example.com/v1/resource/second-c/example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789]]>
                            </ClickTracking>
                            <ClickThrough></ClickThrough>
                        </VideoClicks>
                    </Linear>
                </Creative>

                <Creative>
                    <UniversalAdId
                        idRegistry=\"citrusad.com\"
                        idValue=\"00000000-0000-0000-0000-000000000003\">
                        00000000-0000-0000-0000-000000000003
                    </UniversalAdId>
                    <Linear>
                        <Duration></Duration>
                        <MediaFiles>
                            <Mezzanine>
                                <![CDATA[https://example.com/media/example-video-2.mp4]]>
                            </Mezzanine>
                            <MediaFile
                                delivery=\"progressive\"
                                type=\"video/mp4\"
                                width=\"1920\"
                                height=\"1080\"
                                bitrate=\"832398\"
                                codec=\"h264\">
                                <![CDATA[https://example.com/media/example-video-2.mp4]]>
                            </MediaFile>
                        </MediaFiles>
                        <VideoClicks>
                            <ClickTracking>
                                <![CDATA[https://example.com/v1/resource/second-c/example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789]]>
                            </ClickTracking>
                            <ClickThrough></ClickThrough>
                        </VideoClicks>
                    </Linear>
                </Creative>
            </Creatives>
        </InLine>
    </Ad>
</VAST>",
          "videoTranscriptFiles": [
            {
              "videoFileId": "00000000-0000-0000-0000-000000000002",
              "format": "txt",
              "url": "https://example.com/media/example-transcript.txt",
              "language": "en"
            }
          ]
        }
      ]
    }
  ]
}
```

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.citrusad.com/retail-media-interface/integration/ja/generating-ads/banner-x-responsive/video-ads-banner-x.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.