サポート サポートへのお問い合わせ | システムステータス システムステータス
ページコンテンツ

    ユニークユーザー

    このトピックでは、を介して一意のユーザーに関するデータを取得する方法について学習します。Analytics APIユニークユーザーの計算方法。

    はじめに

    ザ・unique_usersアカウントレベルでの1日あたりのユニーク視聴者の推定数を顧客に提供するフィールド。データは、と呼ばれるフィールドに返されますdaily_unique_viewers。このフィールドは、アカウントレベルでのみ使用できます。見る概要:データ収集APIユーザーデータの収集方法と使用方法の詳細については、

    一意のユーザーデータは次の場合にのみ返されることに注意してください和解データ。

    サンプルコール

    これは、を使用した1日のユーザーレポートのサンプル呼び出しです。day寸法:

        https://analytics.api.brightcove.com/v1/data?accounts=789967572001&dimensions=date&from=2014-07-09&to=2014-07-22&limit=10&format=json&fields=daily_unique_viewers,date,video_view

    サンプル出力:

        {
          "item_count": 14,
          "items": [
            {
              "daily_unique_viewers": 73,
              "date": "2014-07-09",
              "video_view": 454
            },
            {
              "daily_unique_viewers": 203,
              "date": "2014-07-10",
              "video_view": 287
            },
            {
              "daily_unique_viewers": 150,
              "date": "2014-07-15",
              "video_view": 257
            },
            {
              "daily_unique_viewers": 170,
              "date": "2014-07-12",
              "video_view": 195
            },
            {
              "daily_unique_viewers": 120,
              "date": "2014-07-14",
              "video_view": 166
            },
            {
              "daily_unique_viewers": 118,
              "date": "2014-07-11",
              "video_view": 155
            },
            {
              "daily_unique_viewers": 95,
              "date": "2014-07-16",
              "video_view": 150
            },
            {
              "daily_unique_viewers": 89,
              "date": "2014-07-17",
              "video_view": 136
            },
            {
              "daily_unique_viewers": 57,
              "date": "2014-07-18",
              "video_view": 132
            },
            {
              "daily_unique_viewers": 99,
              "date": "2014-07-13",
              "video_view": 108
            }
          ],
          "summary": {
            "video_view": 2334
          },
          "account": "789967572001"
        }

    その結果セットに基づいて、このエントリ...

        {
          "daily_unique_viewers": 73,
          "date": "2014-07-09",
          "video_view": 454
        },

    ...このアカウントには、2014年7月9日に73人の推定ユニークユーザーから454回の閲覧があったことを意味します。

    複数日にわたるスパンは平均的です

    次のように、複数日にわたるリクエストを行う場合:

        https://analytics.api.brightcove.com/v1/data?accounts=789967572001&dimensions=account&from=2014-07-09&to=2014-07-22&limit=10&format=json&fields=daily_unique_viewers,video_view

    応答には、その期間のdaily_unique_viewersの平均値が含まれます。

        {
          "item_count": 1,
          "items": [
            {
              "account": "789967572001",
              "daily_unique_viewers": 99,
              "video_view": 2334
            }
          ],
          "summary": {
            "video_view": 2334
          },
          "account": "789967572001"
        }

    データの可用性

    一意性の見積もりはバッチ処理システムで行われます。つまり、このdaily_unique_viewers値はリアルタイムでは利用できません。daily_unique_viewersの値は、測定日が経過してから3〜5日間は利用できません。APIを呼び出してNULL応答を受け取った場合、それはデータがまだ利用できないことを意味します。

    ユーザーの特定

    Video Cloud Analyticsは、Source IP address + the User-Agent Stringユーザーの一意の識別子として。

    ユニークユーザーの総数

    すべてのユーザーの一意の識別子を保存することは不可能であるため、アルゴリズムを使用してアカウントの合計ユーザーを推定します。

    つまり、視聴者の正確な数を知っていて、それを私たちの数と比較すると、わずかな差異が見られます。このエラー率は、ユニーク視聴者の数が増えるにつれて増加します。