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

    치수: 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

    대응

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