マクロをクリックするとその詳細に移動します
広告リクエスト マクロ
| マクロ |
|---|
[APIFRAMEWORKS] |
sdk_apis パラメータです。
| マクロ |
|---|
[APPBUNDLE] |
an パラメータです。
| マクロ |
|---|
%%ASSET_KEY%% |
ライブ ストリーム イベントコードに展開されます。
| マクロ |
|---|
[BREAKPOSITION] |
VAST 4.1 マクロです。次の値を返します。
1: プレロールの場合2: ミッドロールの場合
3: ポストロールの場合
4: スタンドアロンの場合
0: 上記以外 / その他の場合
| マクロ |
|---|
%%BREAK_DURATION%% |
[BREAKMAXDURATION] |
現在の広告ブレークの長さ（秒）です。
[BREAKMAXDURATION] は %%BREAK_DURATION%% が許可されていないアド マネージャーのリダイレクトでのみ使用します。
| マクロ |
|---|
[CACHEBUSTING] |
乱数です。
| マクロ |
|---|
[CLIENTUA] |
使用されたプレーヤーと VAST クライアントの ID です。
| マクロ |
|---|
%%CMS_ID%% |
現在再生中のアド マネージャー コンテンツ ソース ID（「CMS ID」）に展開されます。この値は MRSS フィードには表示されませんが、アド マネージャー管理画面に表示されます。
| マクロ |
|---|
%%DAI_PRE%% |
デフォルト値は 0 です。広告リクエストが「早期ブレーク」や「プリフェッチ」などのノンブロッキングまたはリクエスト調整で行われた場合は、1 に設定します。これにより、広告リクエストの処理により多くの時間を使用できることが広告サーバーに示されます。
ライブ / リニア トラフィックにのみ適用可能です。
| マクロ |
|---|
[DOMAIN] |
VAST 4.1 マクロです。ストリーム作成の参照元 URL のドメインです。
| マクロ |
|---|
%%FW_CAID%% |
VOD のみの場合 - MRSS フィードからの FreeWheel カスタム アセット ID
| マクロ |
|---|
%%GDPR%% |
gdpr パラメータです。
| マクロ |
|---|
[GDPRCONSENT] |
gdpr_consent パラメータです。
| マクロ |
|---|
[GOOGLE_INSTREAM_VIDEO_NONCE] |
givn パラメータです。
| マクロ |
|---|
[IFA] |
rdid パラメータから取得したリセット可能な広告 ID です。広告 ID は、プライバシー フラグ（tfcd や is_lat など）で許可されている場合にのみ、メインの広告リクエストに渡されます。
| マクロ |
|---|
[IFATYPE] |
DAI idtype パラメータです。IFA タイプは、プライバシー フラグ（tfcd や is_lat など）で許可されている場合にのみ、メインの広告リクエストに渡されます。
| マクロ |
|---|
[LIMITADTRACKING] |
ltd パラメータです。
| マクロ |
|---|
[MEDIAMIME] |
VAST 4.1 マクロ: サポートされているメディア MIME タイプのカンマ区切りのリストです。
| マクロ |
|---|
%%NPA%% |
1 の値に展開し、パーソナライズされていない広告のリクエストとしてタグを設定します。
このマクロは、GDPR が適用される広告リクエストのダイナミック広告挿入の広告タグでのみ使用されます。その他の GDPR のマクロをご確認ください。
| マクロ |
|---|
[OMIDPARTNER] |
VAST 4.1 マクロ: omid_p パラメータです。
| マクロ |
|---|
[PAGEURL] |
VAST 4.1 マクロ: ストリーム作成の参照元 URL です。
| マクロ |
|---|
[REGULATIONS] |
VAST 4.1 マクロ: パラメータに基づいて適用される規制のカンマ区切りリストです。tfcd=1 が存在する場合は「coppa」、gdpr=1 が存在する場合は「gdpr」が追加されます。
| マクロ |
|---|
[SERVERSIDE] |
1 です。| マクロ |
|---|
%%SPLICE_INSERT_EVENT_ID%% |
%%SPLICE_INSERT_UPID%% |
%%TIME_SIGNAL_EVENT_ID%% |
%%TIME_SIGNAL_UPID%% |
%%TIME_SIGNAL_UPID_RAW%% |
%%AFMM_CBC%% |
SCTE-35 信号に展開されます。
| マクロ |
|---|
%%STREAM_ID%% |
現在再生中のコンテンツ ソースのセッション ストリーム ID に展開されます。
| マクロ |
|---|
%%TFCD%% |
tfcd パラメータの値に展開されます。
| マクロ |
|---|
%%TFUA%% |
tfua パラメータです。
| マクロ |
|---|
[TIMESTAMP] |
VAST 4.0 マクロ - ISO 8601 に準拠した形式の現在のタイムスタンプです。
| マクロ |
|---|
[TRANSACTIONID] |
VAST 4.1 マクロ - 送信元から広告リクエストのチェーンを関連付けるために使用される識別子です。
| マクロ |
|---|
%%US_PRIVACY%% |
us_privacy パラメータの値に展開されます。
| マクロ |
|---|
%%USER_AGENT%% |
[DEVICEUA] |
エンドユーザーに広告をレンダリングするデバイスのユーザー エージェントです。
[DEVICEUA] マクロのみが期待どおりの機能を持ちます。| マクロ |
|---|
%%USER_IP%% |
[DEVICEIP] |
[IP_ADDRESS] |
ユーザーの IP アドレスに展開されます。
[IP_ADDRESS] は、%%USER_IP%% が許可されていないアド マネージャーのリダイレクトでのみ使用します。
| マクロ |
|---|
%%VIDEO_DURATION%% |
VOD のみ - MRSS フィードから取得した動画の再生時間（ミリ秒）です。
| マクロ |
|---|
%%VIDEO_DURATION_SEC%% |
動画の再生時間（秒）に展開されます。
| マクロ |
|---|
%%VIDEO_ID%% |
VOD のみ - MRSS フィードから取得した CMS コンテンツ ID です。
| マクロ |
|---|
%%VIDEO_TITLE%% |
VOD のみ - MRSS フィードから取得した動画のタイトルです。
VAST トラッキング マクロ
[CACHEBUSTING] マクロと [ERRORCODE] マクロはいずれも VAST 4.0 仕様（英語）に準拠しています（「2.3.7 Macros」セクションを参照）。
| マクロ |
|---|
[CACHEBUSTING] |
8 桁の乱数に展開されます。
| マクロ |
|---|
[ERRORCODE] |
VAST エラーコードに展開されます。
URL エンコードされた文字列のマクロ
URL エンコードが必要な広告タグのセクションでマクロを使用する必要がある場合は、マクロの置換が正しく機能するように、マクロ自体を URL エンコードしないでください。
適切な例
http://www.some-adtag.com?encoded_param=[GOOGLE_INSTREAM_VIDEO_NONCE]%3D5
不適切な例
http://www.some-adtag.com?encoded_param=%5BGOOGLE_INSTREAM_VIDEO_NONCE%5D%3D5