video치수. 그만큼video dimension은 비디오로 분석을 제공합니다. 참고 : "비디오"를 포함하려는 경우. 필드 (예 : video.name ) 응답에서 클라이언트 자격 증명에 CMS가 포함되어야합니다. 비디오 읽기 권한. 또한 반품은 할 수 없지만video.custom_fields , 당신은 돌아갈 수 있습니다video.custom_fields.{field_name} .URL 매개 변수
분석 API 보고서는 다음 URL 매개 변수를 지원합니다.
| 매개 변수 | 설명 | 필수 | 값 | 기본값 |
|---|---|---|---|---|
account |
보고하려는 계정 | 예 | 쉼표로 구분된 목록으로 하나 이상의 계정 ID | 없음 |
dimensions |
보고할 차원입니다. | 예 | 쉼표로 구분된 목록으로 된 하나 이상의 차원(일부 조합은 유효하지 않음 - 여기에서 대화형 도구를 사용하여 조합이 유효한지 확인) | 없음 |
where |
보고서에 대한 필터를 지정하는 데 사용됩니다. | 아니요 | {dimension}=={value} - 세미콜론으로 구분된 목록으로 하나 이상. 값은 해당 측정기준의 기본 측정항목에 대한 하나 이상의 값입니다. 예: video==video_idcountry=country-code , 또는viewer=viewer_id (마지막 경우 viewer_id의 형식은 일종의 viewer_id를 직접 캡처하여 전송하는지 또는 분석 시스템에서 생성한 값에 따라 달라집니다). |
없음 |
limit |
반품할 항목 수 | 아니요 | 양의 정수 | 10 |
offset |
건너뛸 항목 수 | 아니요 | 양의 정수 | 0 |
sort |
항목을 정렬할 필드 | 아니요 | 요청에 의해 반환되는 모든 필드 | 비디오 보기 |
fields |
반환할 필드 | 아니요 | 보고 중인 차원에 따라 다릅니다. | 비디오,video_view |
format |
결과를 반환할 형식 | 아니요 | json(기본값) | csv | xlxs | json |
reconciled |
포함된 경우 결과를 기록 또는 실시간 데이터로 제한합니다. 분석 데이터는 여러 소스에서 파생됩니다. 일부는 플레이어에서 전송되지만 다른 데이터는 CDN과 Video Cloud 시스템에서 수집됩니다. 가능한 한 빨리 분석을 제공하기 위해 “실시간” 데이터를 사용할 수 있는 즉시 전달하기 시작한 다음 나중에 모든 소스의 데이터가 수집 및 처리될 때 분석을 조정합니다. 완전히 처리된 데이터를 조정됨이라고 합니다. | 아니요 | 참 | 거짓 | 진정한 |
from |
요청에 대한 날짜 범위의 시작 | 아니요 |
다음 중 하나:
참여 끝점 또는 reconciled=false인 경우 지난 32일 이내의 날짜만 허용됩니다. |
-30일 |
to |
요청에 대한 날짜 범위의 종료 | 아니요 |
다음 중 하나:
참여 끝점 또는 reconciled=false인 경우 지난 32일 이내의 날짜만 허용됩니다. |
지금 |
사용 가능한 필드
차원에 대해 다음 필드를 반환할 수 있습니다.
ad_mode_begin- 플레이어가 광고 모드로 들어간 횟수ad_mode_complete- 플레이어가 광고 모드를 완료한 횟수bytes_delivered- 플레이어 및 관련 미디어에 대해 클라이언트 시스템에 전달된 총 바이트engagement_score- 비디오의 참여 점수play_request- 비디오 재생이 요청된 총 횟수play_rate- 동영상의 평균 재생 속도 (동영상 조회수를 노출수로 나눈 값)video-동영상 IDvideo_duration-동영상 길이 (보고 된 경우)video_engagement_1- 비디오의 1% 포인트에서 조회수video_engagement_100- 동영상 지속 시간의 100% 시점의 총 조회수video_engagement_25- 동영상 지속 시간의 25% 지점에서 총 조회수video_engagement_50- 동영상 지속 시간의 50% 시점의 총 조회수video_engagement_75-동영상 재생 시간의 75 % 지점에서 총 조회수 <video_impression-동영상이 플레이어에로드 된 총 횟수video_name-기간 내 가장 최근 노출 당시의 동영상 이름video_percent_viewed-모든 동영상 조회수에 대해 본 동영상 비율의 합계입니다. 예를 들어 해당 기간에 두 번의 조회수가 있고 한보기에서 조회 한 비율이 78 %이고 다른보기에서 59 % 인 경우video_percent_viewed반환은137 .video_seconds_viewed-각 비디오보기에 대해 본 총 시간video_view-동영상 재생이 시작된 횟수video.reference_id-동영상의 참조 IDvideo.name-동영상의 현재 이름video.description-동영상의 현재 설명video.complete-영상 처리 완료 여부video.created_at-동영상이 생성 된 날짜 / 시간video.duration-동영상의 현재 길이video.economics-동영상의 광고 사용 여부video.long_description-동영상의 자세한 설명video.state-동영상이 현재ACTIVE또는INACTIVEvideo.tags-동영상의 태그video.updated_at-동영상이 마지막으로 수정 된 날짜 / 시간video.custom_fields.{field_name}-이름이 지정된 비디오의 사용자 정의 필드 값{field_name}video_download_request-오프라인 재생이 가능한 비디오에 대한 다운로드 요청 수video_download_complete-오프라인 재생이 활성화 된 비디오가 완전히 다운로드 된 횟수video_download_cancellation-오프라인 재생이 활성화 된 동영상 다운로드가 취소 된 횟수 (다운로드가 완료되기 전에 페이지가 닫힌 횟수 포함)video_download_error-오류로 인해 오프라인 재생이 활성화 된 비디오 다운로드 실패 횟수
필터 값
필터로 사용되는 차원을 사용하면 결과 범위를 좁힐 수 있습니다.
필터 값 : 쉼표로 구분 된 목록 또는 video.q == {video field} : {value}로 동영상 ID
치수 결합
이 차원과 결합할 수 있는 차원과 조합에 사용할 수 있는 필드를 보려면차원 및 필드를참조하십시오.
요청 예제
차원 요청
https : //analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=video
필터 요청
https : //analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=video&where=video==4093643993001,1754276206001
샘플 응답
{
"item_count": 123,
"항목": [
{
"동영상": "2180741085001",
"동영상_보기": 1
},
{
"동영상": "4446941108001",
"동영상_보기": 1
},
{
"동영상": "2535301903001",
"동영상_보기": 1
},
{
"동영상": "5323136098001",
"동영상_보기": 1
},
{
"동영상": "1732474228567874935",
"동영상_보기": 1
},
{
"동영상": "1723783757463121178",
"동영상_보기": 1
},
{
"동영상": "4454620114001",
"동영상_보기": 1
},
{
"동영상": "5271819050001",
"동영상_보기": 1
},
{
"동영상": "2026627035001",
"동영상_보기": 1
},
{
"동영상": "4446941103001",
"동영상_보기": 2
}
],
"요약": {
"동영상_보기": 45136
}
}