지원 고객 지원 문의 | 시스템 상태 시스템 상태
페이지 내용

    치수: video

    이 항목에서는Analytics APIvideo치수. 그만큼video dimension은 비디오로 분석을 제공합니다. 참고 : "비디오"를 포함하려는 경우. 필드 (예 : video.name ) 응답에서 클라이언트 자격 증명에 CMS가 포함되어야합니다. 비디오 읽기 권한. 또한 반품은 할 수 없지만video.custom_fields , 당신은 돌아갈 수 있습니다video.custom_fields.{field_name} .

    URL 매개 변수

    분석 API 보고서는 다음 URL 매개 변수를 지원합니다.

    URL 매개변수
    매개 변수 설명 필수 값 기본값
    account 보고하려는 계정 예 쉼표로 구분된 목록으로 하나 이상의 계정 ID 없음
    dimensions 보고할 차원입니다. 예 하나 이상의 차원을 쉼표로 구분된 목록으로 표시 (일부 조합은 유효하지 않음) 없음
    where 보고서에 대한 필터를 지정하는 데 사용됩니다. 아니요 {차원} == {value} - 하나 이상의 세미콜론으로 구분된 목록 없음
    limit 반품할 항목 수 아니요 양의 정수 10
    offset 건너뛸 항목 수 아니요 양의 정수 0
    sort 항목을 정렬할 필드 아니요 요청에 대한 유효한 필드 비디오 보기
    fields 반환할 필드 아니요 보고 중인 차원에 따라 다릅니다. 비디오 보기
    format 결과를 반환할 형식 아니요 json | CSV | xlxs json
    reconciled 포함된 경우 결과를 기록 또는 실시간 데이터로 제한합니다. 아니요 참 | 거짓 진정한
    from 요청에 대한 날짜 범위의 시작 아니요 ISO 8601 날짜 (YYY-MM-DD), 시간 (밀리초), 문자열 항상 또는 상대 날짜 (-1m). 계약 끝점이나 조정=false인 경우 지난 32일 내의 날짜만 허용됩니다. 현재 30일 전
    to 요청에 대한 날짜 범위의 종료 아니요 ISO 8601 날짜 (YYY-MM-DD), 시간 (밀리초), 문자열 지금 또는 상대 데이터 (+7d). 계약 끝점에 대해서는 지난 32일 내의 날짜만 허용되거나 조정=false인 경우 허용됩니다. 지금

    사용 가능한 필드

    차원에 대해 다음 필드를 반환할 수 있습니다.

    • ad_mode_begin - 플레이어가 광고 모드로 들어간 횟수
    • ad_mode_complete - 플레이어가 광고 모드를 완료한 횟수
    • bytes_delivered - 플레이어 및 관련 미디어에 대해 클라이언트 시스템에 전달된 총 바이트
    • engagement_score - 비디오의 참여 점수
    • play_request - 비디오 재생이 요청된 총 횟수
    • play_rate - 동영상의 평균 재생 속도 (동영상 조회수를 노출수로 나눈 값)
    • video -동영상 ID
    • video_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 -동영상의 참조 ID
    • video.name -동영상의 현재 이름
    • video.description -동영상의 현재 설명
    • video.complete -영상 처리 완료 여부
    • video.created_at -동영상이 생성 된 날짜 / 시간
    • video.duration -동영상의 현재 길이
    • video.economics -동영상의 광고 사용 여부
    • video.long_description -동영상의 자세한 설명
    • video.state -동영상이 현재ACTIVE또는INACTIVE
    • video.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

    대응

        요청을 테스트할 때 응답이 여기에 나타납니다.