Brightcove Player 用 Tealium プラグイン

概要

Tealium プラグインを使用すると、Tealium iQ タグマネージャーを Brightcove Player と統合できます。これにより、Tealium Universal Data Hub を使用して Brightcove Player のイベントをトラッキングできます。

タグマネージャーを使用すると、コードを使用せずにタグの追加や公開が可能になります。クライアントサイドのソリューションであるため、複数のマーケティングテクノロジーにわたってデータを収集できます。これにより、さまざまな収集ポイントからユーザーやプレーヤーのデータを取得でき、マーケターの業務効率が向上します。

Tealium iQ は特定のプラットフォーム向けに設計されていないため、任意の製品と組み合わせて使用できます。Tealium iQ にはタグマーケットプレイスが用意されており、多くの用途に対応したタグテンプレートを見つけることができます。

Tealium Tag Manager プラグインは、Brightcove Player バージョン 6.36.5 以降でサポートされています。

タグ管理の用語

以下は、Tealium iQ を使用する際によく登場する用語です。

用語	説明
Event	イベントは、レポートツールにデータを送信するためのデータポイントです。動画の読み込みや再生に関連します。
Profile	タグ管理システムのアカウントには、複数のコンテナ（プロファイル）を持つことができ、それぞれに独自のタグや変数を設定できます。各プロファイルには通常、開発、ステージング、本番用の複数の環境が用意されます。
Rule	ルールは、タグコードをページに追加するタイミングを指定します。ユーザー定義の条件です。
Tag	タグは、ユーザーの操作データを収集するために Web ページに配置されるコードスニペットです。タグ管理システムを使用すると、タグ ID とイベントタイプを指定するだけで、簡単にタグをサイトに追加できます。
Tag marketplace	タグマーケットプレイスのテンプレートは、タグを展開するためのコードスニペットを提供します。これにより必要なコード知識は減りますが、実装を成功させるためには JavaScript や HTML の基本的な知識が必要です。
Tracker	トラッカーは、データを収集・保存し、そのデータを Tealium iQ タグマネージャーに送信するオブジェクトです。
Universal Data Object (UDO) utag_data object	`utag_data` という JavaScript 変数で、Web ページのコード内に存在するデータの集合を保持します。この JavaScript オブジェクトは、Web サイトからタグマネージャーのコンテナに情報を渡すために使用されます。この情報を基に、変数の設定やタグ設定内でのイベントの発火を行うことができます。

はじめに

Tealium iQ Tag Management のドキュメントを確認し、アカウントのセットアップを行ってください。セットアップには、以下の作業が含まれます。

タグ設定の定義
ビーコンを発火させるトリガーの定義
イベントおよびカスタムディメンション用の変数の作成

Brightcove プラグインの使用

他の Brightcove Player プラグインと同様に、Tealium プラグインはプレーヤーに読み込む必要があります。

Studio を使用する方法

以下の手順では、Video Cloud Studio を使用してプラグインを読み込む方法を説明します。

PLAYERS モジュールを開き、新しいプレーヤーを作成するか、プラグインを追加したい既存のプレーヤーを選択します。
プレーヤーのリンクを選択して、プレーヤーのプロパティを開きます。
左側のナビゲーションメニューで プラグイン を選択します。
次に プラグインの追加 ボタンを選択し、Brightcove プラグイン を選択します。

Add a Plugin ボタン
Brightcove プラグイン のドロップダウンを展開し、Tealium を選択します。

Tealium プラグイン
これで、トラッキングしたいディメンションを使用して分析プラットフォーム（例：Google Analytics）を設定する準備が整いました。利用可能なディメンションについては、本ドキュメントのイベントおよび属性セクションを参照してください。

オプション(JSON) テキストボックスに、トラッキングしたいイベントおよび属性を入力します。各フィールドの説明は以下のとおりです。

paramsToTrack - トラッキングしたい属性の一覧
eventsToTrack - トラッキングしたいイベントの一覧
account - Tealium のアカウント名
profile - Tealium のプロファイル名
env - Tealium の環境名

以下は入力例です。

    {
      "paramsToTrack": {
        "video_playhead": "video_playhead",
        "video_platform": "video_platform",
        "video_length": "video_length",
        "video_name": "video_name",
        "video_id": "video_id",
        "video_milestone": "video_milestone"
      },
      "eventsToTrack": {
        "video_load": "video_load",
        "video_play": "video_play",
        "video_complete": "video_complete",
        "video_watch": "video_watch",
        "video_pause": "video_pause",
        "ad_start": "ad_start",
        "ad_end": "ad_end"
      },
      "env": "your environment",
      "profile": "your profile",
      "account": "your account"
    }

保存ボタンを選択します。これで、プレーヤーのプラグイン一覧に Tealium プラグインが追加されます。

Save ボタン
プレーヤーを公開するには、公開と埋め込み > 変更の公開 を選択します。
ダイアログを閉じるには、閉じる を選択します。
MEDIA に戻り、Tealium 用に更新したプレーヤーを使用して動画またはプレイリストを公開します。

プレーヤーが読み込まれ、ユーザーがプレーヤーを操作すると、指定したイベントおよびパラメーターがトラッキングされます。

JSON エディタを使用した実装

プレーヤー 7.28.0 以降では、JSON エディタを使用して以下の手順でプラグインを追加することもできます。

Players モジュールで設定したいプレーヤーに移動し、JSON エディタのリンクをクリックします。 "plugins" 配列を編集して Tealium プラグインを追加します。

      
        "plugins": [
        {
          "name": "bcTealium",
          "is_packaged": true,
          "options": {
            ...
          }
        }
      ]

イベントおよび属性

以下のイベントおよび属性を Tealium iQ に送信できます。

イベント

これらのイベントはプレーヤーから送信されます。すべてのイベントには共通の属性が送信されます。一部のイベントでは、追加の属性が送信される場合があります。

イベント	タイプ	説明
`video_load`	標準	プレーヤーで動画メタデータの読み込みが完了したとき。
`video_play`	標準	ユーザー操作または自動再生によって再生が開始されたとき。送信される追加属性: `video_playhead`
`video_watch ^[1]`	カスタム	レンディション選択、ビットレート測定、バッファリング情報などの追加情報が含まれます。送信される追加属性: `video_playhead` `video_milestone`
`video_pause`	標準	ユーザーが動画の再生を一時停止したとき。送信される追加属性: `video_playhead`
`ad_start`	カスタム	広告の再生が開始されたとき。
`ad_end`	カスタム	広告の再生が終了したとき。
`video_complete`	標準	動画の再生が終了したときに発火します。

注意事項

以下の注意事項は、上記の表に関するものです。

^[1] video_watch イベントは、以下のマイルストーンで送信されます。

25% マイルストーン – 動画全体の再生時間の 25%〜50% の範囲が視聴されたとき
50% マイルストーン – 動画全体の再生時間の 50%〜75% の範囲が視聴されたとき
75% マイルストーン – 動画全体の再生時間の 75%〜95% の範囲が視聴されたとき
100% マイルストーン – 動画全体の再生時間の 100% が視聴されたとき

動画の視聴率（video_watch）は、以下のように計算されます（Google や Adobe Analytics の video_engagement イベントと同様です）。

動画の視聴率 = ユーザーが実際に視聴した時間 / 動画の総再生時間

たとえば、20 秒の動画の場合、以下のいずれのケースでも 25% のマイルストーンが達成されます。

ユーザーが 0〜5 秒まで視聴した場合
ユーザーが 0〜1 秒まで視聴し、その後 11 秒目にスキップして 15 秒まで視聴した場合

いずれの場合も、ユーザーは合計 5 秒間視聴しているため、マイルストーンは 25% としてレポートされます。

共通属性

これらの属性は、すべてのイベントで共通して使用されます。

名前	タイプ	説明
`video_id`	文字列	イベントの発生元となった Brightcove 動画 ID
`video_length`	数値	動画属性で指定された動画の長さ
`video_name`	文字列	動画属性で指定された動画名
`video_platform`	文字列	動画が再生されているプラットフォーム

イベント固有の属性

これらの属性は、特定のイベントに関連付けられています。

名前	タイプ	説明
`video_playhead`	数値	イベントが発生した時点での動画内の再生位置。以下のイベントで送信されます。 `video_play` `video_pause` `video_watch`
`video_milestone`	数値	イベント発生時点での動画の視聴完了率（パーセンテージ）。以下のイベントで送信されます。 `video_watch`

Tealium でのデータ表示

プレーヤーの操作により、プラグインが分析データを Tealium Universal Data Hub に送信します。イベントおよび属性を確認するには、以下の手順を実行してください。

https://my.tealiumiq.com にアクセスします。
認証情報を使用して Universal Data Hub にログインします。
左側のナビゲーションで EventStream を展開します。
左側のナビゲーションで Live Events を選択します。

Live events
リアルタイムのイベントデータを表示するダッシュボードが表示されます。

Dashboard
イベントを選択すると、そのイベントに関連付けられた属性を確認できます。

変更履歴

v2.0.2 までの過去のリリースノートおよび変更履歴については、Tealium プラグインリリースを参照してください。

v2.0.2 以降に行われた主な変更については、Brightcove Player リリースノートに掲載されます。