クライアント サイド: MAPs 接続

このトピックでは、Players モジュールでMAP統合を設定する方法を学びます。

Overview

MAPs セクションでは、Brightcove プレーヤーを Marketo Munchkin または Hubspot Client-Side API にシームレスに接続できます。

これは、設定したプレーヤーを使って視聴者が動画の特定のパーセンテージに達するたびに、希望のサービスにコンタクトすることで実現します。

ワークフロー

この統合は、以下の情報をご希望のアカウントに送信します:

  • provider=brightcove
  • videoId={VIDEO_ID}
  • videoName={URL_ENCODED_VIDEO_NAME}
  • account={BC_ACCOUNT_ID}
  • player={BC_PLAYER_ID}
  • timeWatched={SECONDS_WATCHED}
  • percentile={25|50|75|95}

設定されると、プレーヤーは以下のパーセンテージで、それぞれのAPIにコールを送信します:

  • 25%
  • 50%
  • 75%
  • 95%

MAPセクションの設定

MAPsの統合を設定するには、次の手順に従います:

  1. Video Cloud にログインします。
  2. Players モジュールに移動します。

  3. プレーヤーを選択します。

  4. MAPs をクリックします。

  5. MAPの有効化をチェックします。

  6. Marketo または Hubspot のいずれかを選択し、アカウント ID を入力します。

  7. 保存をクリックします。
  8. 公開をクリックします。
  9. JSONエディタのplugins -> optionsセクションで設定を確認することができます。

特記事項

  • マイルストーンをスキップすると、スキップしたパーセンタイルごとに API が呼び出されます。 たとえば、視聴者が動画の 80% マークまでスキップした場合、その時点までのすべてのマイルストーン (25%, 50%, 75%) に対して API が呼び出されます。
  • これらの呼び出しは、視聴セッションごとに1回トリガーされます。 視聴者が以前にトリガーされたパーセンタイルに戻った場合、そのセッションでイベントが再びトリガーされることはありません。
  • 動画が完了する前にユーザーが巻き戻して動画の一部を視聴した場合、timeWatched は増加し続けます。このため、timeWatched の値が動画の再生時間よりも大きくなる可能性があります。
  • ユーザーがビデオを再生したり、リプレイをクリックしたり、リフレッシュしたりすると、新しいセッションとしてトラッキングを再開します。