このトピックでは、Google アナリティクス プラグインの使用方法と、Studioを使用した実装方法、およびカスタムコーディングによる実装方法について学びます。
概要
Brightcove Google アナリティクス プラグインは、Google アナリティクス にデータを送信する機能を提供します。このプラグインは、Google アナリティクス 4 をサポートしていることに注意してください。このドキュメントには、5 つの主要なコンテンツ セクションが含まれています:
ワークフロー
Google アナリティクス プラグインは、まず eventsToTrack オプションと trackerID をチェックします。両方が存在する場合、GAを初期化し、analytics-beacons または/および analytics_request イベントをリッスンし、すべてのプレーヤーイベントで、イベントが追跡するイベントのリストに存在するかどうかをチェックします。存在する場合、プラグインはイベントに関連付けられたカスタム ディメンション（paramsToTrackにも存在する）を取得します。GAプラグインで扱われるイベントと、それに関連するカスタム ディメンションは以下の通りです：
player_load - 一般的なカスタム ディメンションvideo_engagement - 一般的なカスタム ディメンション + video_duration + video_range+seconds_viewedvideo_impression - 一般的なカスタム ディメンションplay_request - 一般的なカスタム ディメンションad_start/ad_mode_begin - 一般的なカスタム ディメンションad_end/ ad_mode_complete - 一般的なカスタム ディメンションerror - 一般的なカスタム ディメンションvideo_view - 一般的なカスタム ディメンション video_complete - 一般的なカスタム ディメンションカスタム ディメンションは次を含みます - video_account, video_player, video_session, video_platform_version, video_tags.
コードによる実装
プラグインを実装するには、プレーヤーはプラグインコードの場所、スタイルシートの場所（必要な場合）、プラグイン名、プラグイン設定オプションを知る必要があります。Google アナリティクスのプラグインの場合:
以下では、プレーヤーのページ内埋め込み(Videoタグ)実装を使用して、Google アナリティクス プラグインをプレーヤーの単一のインスタンスに関連付る例になります。
- 1行目:
video-js タグに id 属性と値を付与し、何らかの値（この例では myPlayerID）を指定します。
- 9行目:
script タグを使用して、プラグインのJavaScriptをHTMLページの body に含めます。
- 13行目: プレーヤーへの参照を作成します。
- 14-35行目: プラグインを初期化し、カスタムオプションを渡します。
<video-js id="myPlayerID"
data-account="1752604059001"
data-player="decfdaf5-0a6e-43f6-82d3-39d125c413c4"
data-embed="default"
data-video-id="4077874637001"
controls=""></video-js>
<script src="https://players.brightcove.net/1752604059001/decfdaf5-0a6e-43f6-82d3-39d125c413c4_default/index.min.js"></script>
<script type="text/javascript" src="https://players.brightcove.net/videojs-bc-ga/2/videojs-bc-ga.min.js"></script>
<script type="text/javascript">
videojs.getPlayer('myPlayerID').ready(function() {
var myPlayer = this;
myPlayer.bcGa({
"paramsToTrackGA4": [
"account",
"platform_version",
"player",
"range",
"seconds_viewed",
"session",
"tags",
"video_duration"
],
"eventsToTrack": {
"ad_end": "Ad Ended",
"ad_start": "Ad Started",
"error": "Player Errors",
"play_request": "Play Request",
"player_load": "Player Load",
"video_engagement": "Video Engagement",
"video_impression": "Video Impression",
"video_view": "Video View"
},
"trackerGA4": "GA-123456-1"
})
});
</script>
