VASTタグ
XMLの例
<?xml version="1.0" encoding="UTF-8"?>
<VAST version="3.0">
<Ad id="1111111">
<InLine>
<AdSystem>Exoclick</AdSystem>
<AdTitle/>
<Impression id="exotr">
<![CDATA[https://syndication.myadserver.com/vregister.php?a=vimp&tracking_event=impression&idzone=22222&data=abcd]]></Impression>
<Error>
<![CDATA[https://syndication.myadserver.com/vregister.php?a=vview&errorcode=[ERRORCODE]&idzone=22222]]></Error>
<Creatives>
<Creative sequence="1" id="12345">
<Linear skipoffset="00:00:05">
<Duration>00:00:20.54</Duration>
<TrackingEvents>
<Tracking id="prog_1" event="progress" offset="00:00:10.000">
<![CDATA[https://syndication.myadserver.com/vregister.php?a=vview&tracking_event=progress&progress=00:00:10.000&idzone=22222&data=abcd]]></Tracking>
</TrackingEvents>
<VideoClicks>
<ClickThrough>
<![CDATA[https://syndication.myadserver.com/click.php?data=abcd]]></ClickThrough>
</VideoClicks>
<MediaFiles>
<MediaFile delivery="progressive" type="video/mp4">
<![CDATA[https://static.myadserver.com/library/12345/myvideo.mp4]]></MediaFile>
</MediaFiles>
<Icons>
<Icon>
<IconClicks>
<IconClickThrough>exoclick.com</IconClickThrough>
</IconClicks>
</Icon>
</Icons>
</Linear>
</Creative>
</Creatives>
<Extensions>
<Extension>
<TitleCTA>
<MobileText>View More</MobileText>
<PCText>View More</PCText>
<DisplayUrl><![CDATA[]]></DisplayUrl>
<Tracking><![CDATA[https://syndication.myadserver.com/click.php?data=abcd]]></Tracking>
</TitleCTA>
</Extension>
<Extension>
<DSA>
<Behalf>Exoclick SL</Behalf>
<Paid>Exoclick SL</Paid>
<WhyThisAd>The time of day. Your general location (e.g. country or region). Websites or apps you may have visited.</WhyThisAd>
<ClickThrough>
<![CDATA[ https://a.magsrv.com/about-this-ad.html?data=eyJhZHZlcnRpc2VyX25hbWUiOiJFeG9jbGljayBTTCJ9 ]]>
</ClickThrough>
</DSA>
</Extension>
</Extensions>
</InLine>
</Ad>
</VAST>
プロパティ
| オプション | 説明 |
|---|---|
<?xml version="1.0" encoding="UTF-8"?> | バージョンとエンコーディングを定義したXMLプロログ。 |
| 広告 | 単一の広告を表す広告のルート要素。この要素には、動画プレーヤが広告クリエイティブを表示および追跡するために必要なすべての情報が含まれます。 **広告の「id」属性は、入札キャンペーン ID を表します。 |
| インライン | 広告の再生とトラッキングに必要なすべてのファイルとURIを含む要素。 |
| 広告システム | 広告を配信するシステムの説明的な名前を含む要素で、すべての広告配信者が提供しなければならない。 |
| 広告タイトル | **提供されていない。 |
| 印象 | 広告のインプレッショントラッキングURIを含む要素。インプレッションの id 属性はインプレッションの広告サーバー ID を表します。 |
| エラー | 広告再生でエラーが発生した場合に、プレーヤが広告サーバーに通知するために使用する URI を含む要素。URI に [ERRORCODE] マクロが含まれている場合、動画プレーヤはそのマクロにエラー コードを入力する必要があります。 |
| クリエイティブ | 広告のクリエイティブファイルを提供するために使用される、1つ以上の <Creative> 要素のコンテナ要素。InLine 広告の場合、<Creatives> 要素は広告の実行とトラッキングに必要なすべてのファイルをネストします。 |
| クリエイティブ | 各要素はネストされた要素を含み、Linear または NonLinear 広告用のネストされたサブ要素を使用して、配信される広告のタイプを記述します。Exoclick は1つのVASTレスポンスにつき、<Creative> 要素を1つだけ提供します。クリエイティブの sequence 属性はシーケンスを表すので、1つのクリエイティブの値に対して "sequence" は 1 になります。Exoclick Creative id 属性はクリエイティブIDを表します。 |
| リニア | ストリーミングコンテンツ内でリニアに再生される動画フォーマットの広告を設定する。つまり、ストリーミングコンテンツの前、休憩中、またはストリーミングコンテンツの後を意味する。<MediaFiles> リニアクリエイティブには、最低限 <Duration> 要素が含まれ、広告の実行に必要な動画ファイルを提供する。また、Exoclick は TrackingEvents、VideoClicks、Icons(オプション)も提供する。直線の skipoffset 属性は、スキップ制御がエンドユーザーに利用可能になるタイミングを特定する。 |
| 期間 | 広告のLinearコンポーネントの意図された再生時間を示す要素。時間値はHH:MM:SSの形式で指定する。 |
| メディアファイル | 各要素には、リニアクリエイティブのダウンロードまたはストリーミングされるメディアファイルへの CDATA ラッピング URI が含まれます。リニアクリエイティブは通常動画ファイルですが、静止画像を使用することもできます。Exoclickは単一の MediaFile のみをサポートしており、クロスデバイスや異なるビットレートのMediaFileはサポートしていない。 |
| メディアファイル | 要素には、提供されるメディアファイルへの URI が含まれる。MediaFile delivery 属性 - プログレッシブダウンロードプロトコル(HTTPなど)の場合は progressive 、ストリーミングプロトコルの場合は streaming となります。MediaFile type 属性 - ファイルコンテナの MIME タイプ。 |
| ビデオクリック | 広告が表示されている間に、ユーザーがビデオ・プレーヤーのフレーム内で直接クリックした場合に、ビデオ・プレーヤーが何をすべきかを指定するために使われる要素です。<VideoClicks>要素が提供されるとき、その子要素であるURIを持つ <ClickThrough>要素(Wrapperの場合は <ClickTracking>要素)を1つ含みます。 |
| クリックスルー | 広告視聴者が広告をクリックしたときに広告主のサイトにリダイレクトするクリックURIです。clickthroughはInLine` フォーマットでのみ使用可能で、リニア広告ユニットがクリックスルーを処理できない場合に使用します。 |
| イベント追跡 | トラッキング情報を広告サーバーに送り返すための要素。<TrackingEvents> 要素は一つ以上の <Tracking> 要素を含むことができる。<Tracking>要素にevent属性を指定することで、広告サーバーはトラッキングしたいイベントのトラッキングURIを個別に指定することができます。トラッキング "event "属性 - Exoclickは impression, progress, complete のために用意されているが、ほとんどの場合 progress だけが返される。トラッキング offset 属性 - リニアクリエイティブの進捗が指定された値と一致した場合、含まれるURIがトリガーされる。オフセットがパーセンテージ値に設定されているときに期間がわからない場合、進捗イベントは無視されることがあります。 |
| アイコン | リニア広告にアイコンを掲載する際に使用します。Exoclickではアイコンの下に1つだけアイコンが表示されます。RTBリクエストでimp.ext.icons_support = 0と設定することで無効にできます。 |
| アイコン | <IconClicks>要素を含む要素。 |
アイコンクリック | 新しいウィンドウで情報ページをロードし、ユーザーが広告をクリックしたタイミングを追跡するために使用される要素。 |
アイコンクリックスルー | 要素には、情報ページへの URI が含まれます。ユーザーがアイコンをクリックすると、動画プレーヤはこのページを新しいウィンドウで読み込む必要があります。 |
拡張機能 | アドサーバーによって定義されたカスタムエクステンションに使用される要素。<Extension>要素を含まなければならない。 |
エクステンション | 各カスタム機能のエレメント使用 |
| タイトルCTA | CTAをサポートするためのカスタム要素で、以下の要素があります:<MobileText>, <PCText>, <DisplayUrl>, <Tracking>. |
| モバイルテキスト/PCText`。 | 要素には、「もっと見る」や「今すぐ購読する」などのCTAテキストが含まれます。 |
DisplayUrl | オプションのフレンドリードメイン。 |
| トラッキング | クリックトラッキングURI。Exoclickでは、RTBリクエストでimp.ext.video_cta = 0を送信するように設定することで無効にすることができます。 |
| DSA`。 | DSAをサポートするためのカスタム要素で、以下の要素を持つ:<Behalf>, <Paid>, <WhyThisAd>, <ClickThrough>.デジタルサービス法](/ja/docs/general/dsa)の免責事項。 |
| ハーフ」と「ペイド | この広告に費用を支払った広告主名 |
| なぜこの広告なのか? | 収集された特定のユーザー情報 |
| クリックスルー | DSA](/ja/docs/general/dsa)に関連するその他の情報 |