技術情報

メディアイベントをトラッキングする際のレート制限

 

Matomo は、1 つの(仮想)ページビューでトラッキングできるメディアイベントの最大数を制限しています。これらの制限は、メディアプレーヤーが誤って大量のイベントをトリガーしてしまうバグが発生した場合など、1回の再生で何百ものイベントが送信され、データが歪んだり、サーバー負荷が高くなったりするのを防ぐために設けられています。私たちは、データの品質とサーバーの負荷を保護しながら、実際にこれらの制限に直面した人を見たことがない、高い制限を選択しました。

注:これらのイベントは、実際のメディアレポートには適用されません。これは、”Behaviour -> Events “レポートや訪問ログに表示される “play”、”pause”、”resume”、”seek”、”finish “イベントのみに影響します。

限界

  • 我々は、単一のページビューの間にユニークなビデオまたはオーディオのURLごとに、これらのイベントの最大量を追跡します:
    再生:50、一時停止:25、再開:25、終了:50、シーク:50
  • 私たちは、1つのページビューの間にインタラクションされたすべてのビデオまたはオーディオにわたって、これらのイベントの最大量を追跡します:
    再生:50、一時停止:100、再開:100、終了:50、シーク:100

注:メディアリソースの継続時間が15分を超える場合、各ユニークなオーディオまたはビデオURLに対して許可されるメディアアクションの一時停止再開の最大イベント数は、上記の定義にある25ではなく、50になります。

trackPageViewトラッカーメソッドが呼び出されるたびに、これらの制限はリセットされ、単一ページアプリやプログレッシブウェブアプリが制限されないようにします。

メディアイベントのレート制限を無効にする

以下のJavaScriptトラッキングコードをウェブサイトに追加することで、メディアイベントのレート制限を無効にすることができます:

window._paq = window._paq || [];
window.paq.push(['MediaAnalytics::disableRateLimit']);

レート制限を無効にしている場合は、以下のJavaScriptトラッキングコードをウェブサイトに追加することで、後で再び有効にすることができます:

window._paq = window._paq || [];
window.paq.push(['MediaAnalytics::enableRateLimit']);

レート制限の仕組みの例

シナリオ1:あるウェブサイトをトラッキングしていて、「My Media Resource」というページに1つのビデオ/オーディオリソースがあるとします。ユーザーが25の一時停止イベントを開始した場合、25すべての一時停止イベントがトラッキングされます。

シナリオ2:ウェブサイトをトラッキングしていて、”My Media Resource “というページに1つのビデオ/オーディオリソースがあるとします。ユーザーが30の一時停止イベントを開始した場合、各トラッカーで各メディアリソースに対して最大25の一時停止イベントを許可しているため、最初の25イベントのみがトラッキングされます。

シナリオ3:あるウェブサイトをトラッキングしていて、あるページに「My Media Resource 1」、「My Media Resource 2」、「My Media Resource 3」、「My Media Resource 4」、「My Media Resource 5」という5つのビデオ/オーディオリソースがあるとします。ユーザが最初に “My Media Resource 1″、”My Media Resource 2″、”My Media Resource 3 “に対してそれぞれ25回、”My Media Resource 4 “と “My Media Resource 5 “に対してそれぞれ15回の一時停止イベントを開始したとします。Matomoは “My Media Resource 1″、”My Media Resource 2″、”My Media Resource 3″、および “My Media Resource 4 “の各25イベントと15イベントを追跡し、”My Media Resource 5 “の最初の10イベントのみを追跡します。”My Media Resource 5 “の合計ポーズイベントが許容限界より少ないにもかかわらず、各トラッカーで追跡できるポーズイベントの最大数が100であるため、10イベントのみを追跡していることがわかります。

シナリオ4:ウェブサイトをトラッキングしていて、”My Media Resource “と呼ばれるページ上に1つのビデオ/オーディオリソースがあるとします。ユーザが30の一時停止イベントを開始し、後でページを更新し、更新後にさらに20の一時停止イベントを開始した場合、Matomoは最初の25の一時停止イベントを追跡し、メディアリソースの制限に達したため5つの一時停止イベントをスキップします。

単一サイトで複数のトラッカーを使用する

複数のトラッカーを設定することで、同じデータを複数の Matomo サイトにトラッキングすることがあります。上記の制限はトラッカーごとに適用されます。つまり、各トラッカーは1つのページビュー中に例えば100のシークイベントを送信することができます。

注:Media Analyticsのバージョン4.1.0以上では、レート制限がデフォルトで有効になっています。