VAST マクロ展開ツール
トラッキング URL の IAB VAST 4.x マクロを展開し、発火されるリクエストをブラウザ内でプレビューします。貼り付けたタグはデバイス上に留まります。
VAST マクロ展開ツールは、すべてブラウザ内で動作します。貼り付けたトラッキング URL、同意文字列、デバイス識別子はデバイス上で解析され、ArrayKit にアップロードされることも、どの広告サーバーに送られることもありません。
VAST マクロ展開ツール について
VAST マクロ展開ツールは、動画広告トラッキング URL 内のプレースホルダートークンを、実際に発火されるリクエストへと変換するので、プレーヤーが何を送信するのかを正確に確認できます。IAB VAST 4.x マクロ — [CACHEBUSTING]、[TIMESTAMP]、[GDPR]、[GDPRCONSENT]、[US_PRIVACY]、[IFA]、[PAGEURL] など — を含む impression、quartile、error のピクセルを貼り付けると、ツールがサンプル値やあなたの上書き値を代入し、ランダムなキャッシュバスターと ISO タイムスタンプをその場で生成します。検索可能なリファレンスがすべてのマクロとそのカテゴリを説明します。広告オペレーションの URL は同意文字列やデバイス識別子を頻繁に含むため、すべてがデバイス上で動作します: 貼り付けたタグはブラウザ内で解析され、サーバーに送られることはありません。
機能
- 貼り付けた impression、トラッキング、error の URL 内のすべての IAB VAST 4.x マクロを展開
- 発火時にランダムな [CACHEBUSTING] 番号と ISO 8601 の [TIMESTAMP] を自動生成
- 編集可能な行で、検出された任意のマクロを独自の値で上書き可能
- Regenerate ボタンで動的なキャッシュバスターを再抽選しタイムスタンプを更新
- VAST マクロでない角括弧トークンを指摘し、そのまま残す
- [IFA]、[GDPRCONSENT]、[GPP]、[ADCOUNT] などのマクロを検索できるリファレンス
- 展開後の URL 全体、または任意の単一マクロトークンをワンクリックでコピー
- すべてブラウザ内で動作 — 貼り付けたタグや同意文字列はデバイス上に留まります
VAST マクロ展開ツール の使い方
- Expand URL タブを選択したままにする
- VAST マクロを含むトラッキングまたは impression の URL を貼り付ける
- 検出された任意のマクロ値を編集するか、Regenerate を押して新しいキャッシュバスターとタイムスタンプを取得する
- 展開後の URL をコピーするか、Macro Reference に切り替えてトークンを調べる
例
入力
https://ad.example.com/i?cb=[CACHEBUSTING]&ts=[TIMESTAMP]&gdpr=[GDPR]
出力
https://ad.example.com/i?cb=12345678&ts=2025-03-04T05:06:07.000Z&gdpr=1
[CACHEBUSTING] はランダムな整数に、[TIMESTAMP] は ISO 時刻に、[GDPR] はそのサンプル値になります。
よくあるエラーとトラブルシューティング
- 発火された URL にまだ [SOMETHING] が変わらずに表示されている。 — そのトークンは認識された VAST 4.x マクロではないため、そのまま残されています。マクロは [CACHEBUSTING] のように大文字です — スペルと大文字小文字を確認するか、自分で値を入力してください。
- 展開されたリンクを開くと同意文字列やページ URL が壊れて見える。 — プレーヤーは発火前に [GDPRCONSENT] や [PAGEURL] などの値を URL エンコードします。このプレビューはそれらを文字通り代入するので、エンドポイントが期待する場合は自分でパーセントエンコードしてください。
- キャッシュバスターがどのプレビューでも同じになる。 — プレビューは URL ごとに 1 つの値をシードします。Regenerate をクリックして新しいランダムな [CACHEBUSTING] を抽選し [TIMESTAMP] を更新してください。
- 広告サーバーが私の [IFA] 値を無視する。 — [IFA] は [IFATYPE] とペアにし、limit-ad-tracking が許可する場合にのみ送るべきです。マクロが埋められる前に、デバイスが実際に識別子を渡したか確認してください。
よくある質問
- VAST マクロとは何ですか?
- VAST マクロは、動画広告トラッキング URL 内の [CACHEBUSTING] や [GDPRCONSENT] のような角括弧で囲まれた大文字トークンです。動画プレーヤーや広告サーバーが、ピクセルが発火する瞬間にそれを実際の値に置き換えます。
- 展開ツールはどのマクロを自動生成しますか?
- [CACHEBUSTING] と [TIMESTAMP] は動的です: ツールがランダムな 8 桁のキャッシュバスターと ISO 8601 UTC タイムスタンプを構築します。それ以外のマクロは、上書き可能な同梱サンプル値を使います。
- このツールは広告タグをフェッチしたり、実際にトラッキング URL を発火したりしますか?
- いいえ。ネットワークリクエストを一切行いません。URL を貼り付けると、マクロの置換がブラウザ内でローカルに行われるので、何もフェッチ、発火、サーバーへの記録はされません。
- なぜ出力でトークンが展開されずに残るのですか?
- 正規の大文字 VAST 4.x マクロのみが置換されます。それ以外 — タイプミス、小文字トークン、カスタムプレースホルダー — は未知として報告され、変更されずにそのまま渡されます。
- 代入する値を URL エンコードしますか?
- 生のトークンを読めるように、値は文字通り代入します。実際のプレーヤーは [PAGEURL] や同意文字列などのフィールドをパーセントエンコードするので、エンドポイントが必要とする場合は自分でエンコードしてください。
- マクロはどの VAST バージョンに基づいていますか?
- リファレンスは IAB VAST 4.x のマクロセットに準拠しており、近年のバージョンで導入された [GDPR]、[GDPRCONSENT]、[US_PRIVACY]、[GPP]、[GPPSID] などのプライバシーマクロを含みます。
関連ツール
すべての ArrayKit ツール