ユニークユーザー

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

入門

ザ・unique_usersアカウントレベルでの1日あたりのユニーク視聴者の推定数を顧客に提供するフィールド。データは、と呼ばれるフィールドに返されますdaily_unique_viewers。このフィールドは、アカウントまたはビデオレベルで使用できます。見る概要：Data Collection 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ユーザーの一意の識別子として。