서문
계정 수준에서 고객에게 일일 예상 순 시청자 수를 제공하는unique_users필드입니다. 데이터는 호출되는 필드에daily_unique_viewers반환됩니다. 이 필드는 계정 또는 동영상 수준에서 사용할 수 있습니다. 개요 참조: 사용자 데이터가 수집되고 사용되는 방식에대한 자세한 내용은 데이터 수집 API를 참조하십시오.
샘플 호출
다음은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_viewer 값은 측정일이 지난 후 3-5일 동안 사용할 수 없습니다. API를 호출하고 NULL 응답을 받으면 데이터를 아직 사용할 수 없음을 의미합니다.
사용자 식별
비디오 클라우드 분석에서는 로 구성된 문자열을 사용자의 고유 식별자로 사용합니다. Source IP address + the User-Agent String
분석 데이터 수집기로 사용자 식별자를 보낼 수도 있습니다. 이는 식별할 수 있는 사용자가 로그인했거나 가입한 경우에 가장 적합합니다. 정보 전송 방법에 대한 정보는 다음 섹션을 참조하십시오.
뷰어 ID 보내기 - Brightcove 플레이어
먼저 시청 활동을 저장할 사용자 식별자를 설정해야 합니다.
브라이트코브 플레이어
Brightcove Player를 사용하는 경우 다음 단계를 따르십시오.
-
시청자 데이터가 브라이트코브 분석으로 자동으로 전송되더라도 사용자 식별자를 설정해야 합니다. 이 작업을 수행하려면
setUser()메서드를 사용하십시오. 예:myPlayer.bcAnalytics.client.setUser('viewer id');Brightcove Player를 호스팅하는 웹 사이트에서 인증 게이트웨이 또는 일부 ID 관리 솔루션을 사용하여 뷰어를 추적할 수 있습니다. 이 뷰어 ID를 뷰어 식별자로 사용하여 Brightcove 분석에 전달합니다.
-
플레이어에 소스를 설정하기 전에 뷰어 ID를 설정하는 것이 중요합니다. 플레이어를 초기화 한 직후에 호출해야합니다.
<video-js id="myPlayerID" data-account="1752604059001" data-player="hyQW6GByl" data-embed="default" controls="" data-video-id="6156696074001" data-playlist-id="" data-application-id="" width="640" height="360"></video-js> <script src="https://players.brightcove.net/1752604059001/hyQW6GByl_default/index.min.js"></script> <script> videojs.getPlayer('myPlayerID').ready(function() { var myPlayer = this; // Set the viewer id for Brightcove analytics myPlayer.bcAnalytics.client.setUser('viewer id'); }); </script> setUser()메서드를 사용하면 값이 해시되지 않으며 이후의 모든 비콘과 함께 일반 상태로 전송됩니다.참고
player_init이벤트에는 다음이 포함되지 않습니다.user이 경우 필드이지만 모두video_*이벤트가 포함되어야 합니다.
맞춤형 웹 플레이어
Brightcove Player를 사용하지 않는 사용자 지정 구현을 빌드하는 경우 데이터 수집 API 요청에user파라미터를 추가하십시오. 자세한 내용은개요를 참조하십시오. 데이터 수집 API v2문서.
플레이어를 호스팅하는 웹 사이트에서 인증 게이트웨이 또는 일부 ID 관리 솔루션을 사용하여 시청자를 추적 할 수 있습니다. 이 뷰어 ID를 뷰어 식별자로 사용하여 Brightcove 분석에 전달합니다.
총 고유 사용자
모든 사용자에 대한 고유 식별자를 저장하는 것은 가능하지 않기 때문에 알고리즘을 사용하여 계정의 총 사용자를 추정합니다.
즉, 정확한 시청자 수를 알고 우리의 수와 비교하면 약간의 차이가 있음을 의미합니다. 이 오류율은 순 시청자 수가 증가할수록 증가합니다.