パートナーAPI
APIリファレンス

動画広告

📘

ベータ版機能

この機能は現在ベータ版であり、変更される可能性があります。お客様のフィードバックをいただければ、改善に役立てることができます。

広告主および小売業者は、プロモーションビデオを自社のウェブサイトやアプリに直接表示されるバナーにアップロードすることができます。これらの動画は、製品を魅力的な方法で紹介することにより、購入の決定に影響を与えます。インタラクティブビデオは、消費者がビデオから直接商品を探索し、購入できるようにします。「カートに追加」または「今すぐ購入」のオプションが用意されています。

なぜ貴社のサイトに動画広告を掲載するのですか？

オンサイト動画を利用することで、広告主様はウェブサイト上でお客様とより深く関わることができ、より魅力的なショッピング体験を創出し、お客様がサイトに滞在して選択肢を探る時間を増やすことができます。

理由説明
ブランドストーリーを促進エンゲージメントの高い動画広告は、広告主の全体的なストーリーまたは製品固有のストーリーの中で、魅力的で関連性の高い部分を紹介し、小売ブランドとより深く結び付けます。
新製品の発売広告主はビデオを使用することで、単純なディスプレイよりも深く新製品を紹介することができます。ビデオを利用することで、新製品がもたらす価値について買い物客とつながることができます。
ブランド認知新しいカテゴリや新しいメッセージで認知度を高めたい広告主は、サイトの主要な場所で動画を使って買い物客と直接コミュニケーションをとることができます。
小売ブランドとのつながりの深化ビデオは、買い物客の心の中で広告主と小売ブランドとのつながりを深めることができます。

ビデオの仕様

  • 最大ファイルサイズ：300MB
  • 使用可能なファイル形式：video/mp4、video/quicktime、video/x-msvideo
  • オプションのコーデック検証：H.264、H.265
  • 高さと幅：小売業者がピクセル単位で定義
  • 再生時間制限：なし
  • キャンペーンレビュー：動画要素を含むバナーXキャンペーンは必須です
  • タグサポート：標準VASTタグとして提供 adm （広告のレスポンス内）

動画広告を統合してください

VAST 4.0対応のビデオプレーヤーとシームレスに統合されるインタラクティブなバナーXビデオ広告を作成し、最小限の労力で展開を効率化するインタラクティブな広告形式を小売業者に提供できます。

Banner X ビデオ広告は、デジタルビデオ広告配信テンプレート（VAST）4.0標準に準拠しており、サポートされているビデオプレーヤーとのスムーズで互換性のある統合を保証します。

ビデオ広告をキャンペーンに組み込む際、広告レスポンスにはフィールド admこのフィールドには、VAST 4.0 準拠に必要な XML タグが含まれており、ビデオプレーヤーに簡単に埋め込むことができます。

統合の要件

広告リクエスト

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

広告のリクエスト方法についての詳細は、「バナーx広告の生成」をご覧ください。

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

Epsilon Retail Mediaは、バナーXレスポンスの adm オブジェクトとして、広告レスポンスでVASTタグ（ビデオ広告サーバーテンプレート）を提供します。そのため、VASTタグを解析してビデオ広告をレンダリングするには、ビデオプレーヤーが必要になる可能性があります。

📘

ビデオプレーヤーをお持ちではありませんか？

さまざまなオープンソースのビデオプレーヤーを使用することができます。Video JS や Clappr などの利用可能な有料オプションとオープンソースオプションを確認することをお勧めいたします。VAST タグを解析するには、追加のプラグインが必要になる場合があることにご注意ください。

バナーXプレビューアー

キャンペーンの作成、管理、レビュー時に広告プレビューが正しく表示されるように、バナーxプレビューアーを更新します。バナーXプレビューアーをご覧ください。

トラッキングとレポーティング

さまざまなトラッキング（インプレッション、クリック、進行状況、インタラクション）はすべてVASTタグを介して可能です。ただし、ベータ版ではインプレッションとクリックのトラッキングのみが可能です。これは標準注文レポートに加えて行われます。

🚧

将来追加予定の機能

進捗状況とインタラクションのレポーティングは今後のリリースで対応予定です。

トラッキング要素

ビデオ広告配信テンプレート（VAST）をトラッキング目的で使用します。VASTタグには、いくつかのトラッキングメカニズムが含まれています。

  • インプレッショントラッキング
  • クリックトラッキング
  • 進捗状況のトラッキング（開始、第1四分位、中間点、第3四分位、完了）
    • 第1四分位（25%視聴）：初期エンゲージメントの早期指標
    • 中間点（50％視聴）：コンテンツの途中で視聴者の関心が持続していることを示します
    • 第3四分位数（75％視聴）：コンテンツに対する視聴者の強い関心を示します
    • 完了（100%視聴）：視聴者が動画全体を視聴したことを確認し、最大のエンゲージメントを示します
  • インタラクショントラッキング（ミュート、ミュート解除、一時停止、再開、全画面表示）
    • ミュート：ユーザーはビデオの音声をミュートしました
    • ミュート解除：ユーザーはビデオの音声のミュートを解除しました
    • 一時停止：ユーザーはビデオ再生を一時停止しました
    • 再開：ユーザーは一時停止後にビデオ再生を再開しました

ビデオ広告のレスポンスの例

以下は、VAST関連情報を含む動画広告のレスポンスがどのように表示されるかの一例です。

{

  "ads": [

    {

      "contentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",

      "slotId": "Top_Banner",

      "banners": [

        {

          "citrusAdId": "shotgun_8SvgA7OvvuwtZkkOKR0vr8AXMvQKFgoURmluZ2VybGltZTI2LWZkeHZxMjcSABoMCO30r70GEKPplJQCIgIIAQ==",

          "citrusCampaignName": "Ads:74-330-96832622ed499dafb3da8de8b76340a2",

          "citrusContentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",

          "citrusSlotId": "Top_Banner",

          "citrusExpiry": "2025-02-12T01:33:33.579155107Z",

          "headingText": "recusandae 3205",

          "bannerText": "placeat 2825",

          "bannerTextColour": "ffffff",

          "ctaFlag": true,

          "ctaText": "CTA text",

          "ctaTextAccessibility": "call to action accessibility text",

          "ctaLink": http://citrusad.com ,

          "backgroundColour": "000000",

          "backgroundImage": https://dev3.flavedo.io./citrus/8de07ed9-60b4-4611-8bd5-3f1f0c0b6be4,

          "secondaryBackgroundImage": https://dev3.flavedo.io./citrus/b7a70785-1366-42c6-8134-c7fe47a30c34,

          "secondaryBackgroundImagePosition": "rightaligned",

          "heroImage": https://dev3.flavedo.io./citrus/26798ca9-1022-422d-9100-1a3687c88372,

          "heroImageAltText": "hero image alt text",

          "secondaryHeroImage": https://dev3.flavedo.io./citrus/c4ee18b4-bf51-44d7-9eb6-eeb1dc4c422f,

          "secondaryHeroImageAltText": "secondary hero image alt text",

          "secondaryHeroMode": "landscape",

          "tags": {},

          "additionalFields": [

            {

              "id": "text-1",

              "value": "sed 5731"

            }

          ],

          "gtins": [

            "Fingerlime26-fdxvq27",

            "Oranges5-qgxeb6",

            "Cherries9-adkoj11",

            "Incaberries20-ppscn21",

            "Banana14-simfk15"

          ],

          "sellerId": "seller_id_772_659",

          "position": 1,

          "metadata": {

            "advertiserInfo": {

             "advertiser": "Bob's advertising agency",

             "onBehalfOf": "Brand company inc"

            }

          },
          "adm": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<VAST version=\"4.0\">\n    <Ad id=\"1\">\n        <InLine>\n            <AdSystem>CitrusAd</AdSystem>\n            <Impression><![CDATA[https://integration.BASE-URL.citrusad.com/v1/resource/first-i/shotgun_2DbJUbTdlM3HFvLuF75YoA2FgpwKBQoDMTIzEgAaCwjHsuG_BhD7sqZzIgIIAQ==]]></Impression>\n            <ViewableImpression>\n                <Viewable><![CDATA[https://integration.BASE-URL.citrusad.com/v1/resource/first-i/shotgun_2DbJUbTdlM3HFvLuF75YoA2FgpwKBQoDMTIzEgAaCwjHsuG_BhD7sqZzIgIIAQ==]]></Viewable>\n                <NotViewable></NotViewable>\n                <ViewUndetermined></ViewUndetermined>\n            </ViewableImpression>\n            <AdTitle>VAST-4.0-Short-Intro.mp4</AdTitle>\n            <Creatives>\n                <Creative>\n                    <UniversalAdId idRegistry=\"http://citrusad.com \" idValue=\"VAST-4.0-Short-Intro.mp4\">VAST-4.0-Short-Intro.mp4</UniversalAdId>\n                    <Linear>\n                        <Duration></Duration>\n                        <MediaFiles>\n                            <MediaFile delivery=\"progressive\" type=\"video/mp4\" width=\"0\" height=\"0\" bitrate=\"0\" codec=\"\"><![CDATA[https://cdn.flavedo.io./citrus/VAST-4.0-Short-Intro.mp4]]></MediaFile>\n                            <Mezzanine><![CDATA[https://cdn.flavedo.io./citrus/VAST-4.0-Short-Intro.mp4]]></Mezzanine>\n                        </MediaFiles>\n                        <VideoClicks>\n                            <ClickTracking><![CDATA[https://integration.BASE-URL.citrusad.com/v1/resource/second-c/shotgun_2DbJUbTdlM3HFvLuF75YoA2FgpwKBQoDMTIzEgAaCwjHsuG_BhD7sqZzIgIIAQ==]]></ClickTracking>\n                            <ClickThrough><![CDATA[a/a-national/everything/browse]]></ClickThrough>\n                        </VideoClicks>\n                    </Linear>\n                </Creative>\n            </Creatives>\n        </InLine>\n    </Ad>\n</VAST>"      

       }

      ]

    }

  ]

}

完全なVASTタグの例

📘

これには、現在提供していないフィールドが含まれています。

トラッキングは今後のアップデートで追加予定です。

次の例は、クリエイティブの定義、クリックスルー用のURL、トラッキングイベントを詳述したオンラインビデオ広告の設定を示しています。

<VAST version="4.0" xmlns="http://www.iab.com/VAST">

  <Ad id="inArticle_123" sequence="1">

    <InLine>

      <AdSystem version="1.0">InArticleAdServer</AdSystem>

      <AdTitle>In-Article Video Ad</AdTitle>

      <Description>Video ad that plays within article content</Description>

      <Impression><![CDATA[http://example.com/track/impression]]></Impression>

      <Creatives>

        <Creative>

          <Linear>

            <Duration>00:00:15</Duration>

            <MediaFiles>

              <MediaFile delivery="progressive" type="video/mp4" width="640" height="360">

                <![CDATA[https://example.com/video/ad.mp4]]>

              </MediaFile>

            </MediaFiles>

            <VideoClicks>

              <ClickThrough>https://advertiser.com/landing</ClickThrough>

            </VideoClicks>

            <TrackingEvents>

              <Tracking event="start">http://example.com/tracking/start</Tracking>

              <Tracking event="firstQuartile">http://example.com/tracking/firstQuartile</Tracking>

              <Tracking event="midpoint">http://example.com/tracking/midpoint</Tracking>

              <Tracking event="thirdQuartile">http://example.com/tracking/thirdQuartile</Tracking>

              <Tracking event="complete">http://example.com/tracking/complete</Tracking>

              <Tracking event="progress" offset="00:00:10">http://example.com/tracking/progress-10</Tracking>

              <Tracking event="creativeView">http://example.com/tracking/creativeView</Tracking>

              <Tracking event="mute">http://example.com/tracking/mute</Tracking>

              <Tracking event="unmute">http://example.com/tracking/unmute</Tracking>

              <Tracking event="pause">http://example.com/tracking/pause</Tracking>

              <Tracking event="resume">http://example.com/tracking/resume</Tracking>

              <Tracking event="fullscreen">http://example.com/tracking/fullscreen</Tracking>

              <Tracking event="exitFullscreen">http://example.com/tracking/exitFullscreen</Tracking>

          </TrackingEvents>

          </Linear>

        </Creative>

      </Creatives>

    </InLine>

  </Ad>

</VAST>