プレイヤーイベントのご利用方法

プレーヤーイベントはビデオグプレイヤーをお客様ページにiframeで埋め込む場合に、埋め込み先のお客様ページ（以後「埋込ページ」とする）で、分析に役立つ各種イベントを取得できる機能です。

◯目次

• 注意事項
• 通知データ
• 取得できるプレイヤーイベント
• サンプル

◯注意事項

プレーヤーイベントはWebMessagingというブラウザの機能により、iframeに操作の通知を行うことで動作します。この仕組みに対応していないブラウザではご利用になれません。

◯通知データ

イベントハンドラに渡されるMessageEventオブジェクトのdata属性には以下のような文字列が渡されます。

signature=videog_player_event&name=timeupdate&value={再生秒数}&hash={ハッシュ}&mymedia_num={動画番号}

• 署名(signature) : "videog_player_event"
  ※全プレイヤーイベント共通
• イベント名(name) : "timeupdate"
• データ(value) : 再生秒数
• 動画ハッシュ(hash) : 動画固有のハッシュ
• 動画番号(mymedia_num) : 管理画面上での動画番号

※IE9以下対応のため、通知データはURLにおけるクエリーストリングと同様の文字列で渡しております。
※パラメーターの順番は順不同です。

◯取得できるプレイヤーイベント

・プレイヤー関連

1. 再生秒数
2. 再生開始
3. シーク
4. 一時停止
5. 再生完了

・動画広告関連

1. 広告再生開始
2. 広告一時停止
3. 広告スキップ
4. 広告再生完了

◯サンプル

・ 再生秒数

• イベント名：timeupdate
• データ：動画の再生秒数
  ※精度はブラウザとFlash Playerの仕様により異なります。
• データ形式：数値
• コーディング例：

・ 再生開始

• イベント名：play
• データ：なし
• データ形式：なし
• コーディング例：

・ シーク

• イベント名：seek
• データ：なし
• データ形式：なし
• コーディング例：

・一時停止

• イベント名：pause
• データ：なし
• データ形式：なし
• コーディング例：

・ 再生完了

• イベント名：complete
• データ：なし
• データ形式：なし
• コーディング例：

・ 広告再生開始

• イベント名：adplay
• データ：なし
• データ形式：なし
• コーディング例：

・ 広告一時停止

• イベント名：adpause
• データ：なし
• データ形式：なし
• コーディング例：

・ 広告スキップ

• イベント名：adskipped
• データ：なし
• データ形式：なし
• コーディング例：

・ 広告再生完了

• イベント名：adcomplete
• データ：なし
• データ形式：なし
• コーディング例：