テーマ
はじめに
Michao プレイヤーは、Web 向けのリワード広告・アウトストリーム広告のプレイヤーです。VAST 形式の入札を渡すと再生します。入札の提供元は問わず、Prebid.js などクライアントサイドで取得した入札をそのまま渡せます。プレイヤー自身が RTB を呼ぶことはありません。
- リワード広告: 「広告を見て特典を受け取る」モーダル。視聴完了でリワードを付与します。
- アウトストリーム広告: フィード内で表示領域に入ると再生、外れると停止するインフィード動画です。
配信元に依存しません
Michao を SSP・ビッダーとして利用する必要はありません。VAST 形式の入札であれば、どの配信元のものでも再生できます。
ベータ
Michao プレイヤーは現在ベータです。window.alm（manager.js）を使う従来のリワード広告も引き続き利用できますが、新規導入にはこちらを推奨します。
前提条件
- 広告枠の入札を取得していること。提供元は問わず、Prebid.js などクライアントサイドで取得した入札をそのまま渡せます。
- 動画（video / VAST）: そのまま再生します（リワード・アウトストリーム）。
- バナー（display）: リワードで利用できます。クリエイティブの描画は呼び出し側で行います（バナーのリワード）。
具体的な配線は Prebid.js 連携 を参照してください。
対応規格
| 規格 | 対応 |
|---|---|
| VAST | 4.2（2.0 / 3.0 / 4.x に後方互換） |
| VAST Wrapper / Waterfall | あり |
| Ad Pod | あり（複数広告の順次再生） |
| VPAID | 2.0 |
| SIMID | 1.2 |
| Google IMA | あり（mode: "ima"） |
| OMID (Open Measurement) | あり（任意） |
VAST は 4.2 に対応し、後方互換により 2.0 / 3.0 / 4.x のタグもそのまま再生します。
読み込み方法
次の 2 通りから選べます。どちらもビルド環境は不要で、CSS はバンドルに内包されているため追加の読み込みもいりません。
スクリプトタグ（グローバル window.michao）
<script> を 1 行置くと、window.michao から各関数を呼べます。
html
<script src="https://cdn.michao-ssp.com/player/v1/reward.js"></script>
<script>
window.michao.createRewardPlayer({
/* … */
});
</script>URL から ESM インポート
URL から直接 import します。
html
<script type="module">
import { createRewardPlayer } from "https://cdn.michao-ssp.com/player/v1/reward.mjs";
// …
</script>