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

    개요: Analytics API v1

    이 항목에서는 분석 API에 대한 개요를 얻을 수 있습니다.
     

    서문

    그만큼Analytics API Video Cloud 계정에 대한 분석 데이터를 직접 얻을 수 있습니다. 또한 비디오 클라우드 스튜디오의 분석 모듈에서 내장 분석 보고서를 볼 수 있습니다. 프로그래밍 방식으로 데이터에 액세스하면 유연성을 높일 수 있습니다.

    또한 참조 API 참조 .

    일반적인 용도

    다음은 API의 몇 가지 일반적인 사용입니다.

    • 사용자 정의 차트 및 디스플레이 만들기
    • 여러 API를 함께 사용하여 작업 - 예를 들어 이전 주에 가장 많이 조회수를CMS API기록한 동영상에 을 사용하여 비디오 데이터 가져오기
    • 비디오 분석 데이터를 다른 사이트 분석 데이터와 결합
    • 샘플 솔루션은 다음을 참조하십시오.

    기본 URL

    에 대한 기본 URL Analytics API is :

      <code class = "language-http translate ="No "> https://analytics.api.brightcove.com/v1

    헤더

    인증 필요)

    그만큼Analytics API Brightcove 사용 OAuth 서비스호출을 인증합니다.

    먼저 클라이언트 자격 증명 (a client_idclient_secret ) 을 얻어야 합니다. 이 작업은 다음을 사용하여 수행 할 수있는 일회성 작업입니다. OAuth 자격 증명 UI . 다음을 사용하여 Brightcove OAuth 서비스에서 직접 클라이언트 자격 증명을 얻을 수 있습니다. CURL , Postman , 또는Insomnia .

    클라이언트 자격 증명에 대한 분석 읽기 및 비디오 읽기 권한이 모두 필요합니다.

    <img class = "bcls-image"alt = "<span translate ="No "> Analytics API에 대한 권한자격 증명 "src ="/ assets / images / analytiics / getting-started / analytics-permissions.png "/>
    에 대한 권한Analytics API신임장

    OAuth API를 통해 직접 자격 증명을 만드는 경우 필요한 권한은 다음과 같습니다.

      [
        "video-cloud/analytics/read"
        "video-cloud/video/read"
      ]

    당신은 또한 필요합니다access_token , 이는client_idclient_secret API 요청과 함께 Authorization 헤더를 전달했습니다.

      Authorization: Bearer {access_token}

    는 5분 후에access_token만료되므로 각 요청에 대해 하나를 얻거나 토큰이 여전히 유효한지 확인해야 합니다. 보다액세스 토큰 얻기코드 샘플을 포함하여 액세스 토큰을 얻는 방법에 대한 자세한 설명은

    Accept-Encoding: gzip (optional)

    이 헤더를 전달하면 응답이 압축 된 형식으로 반환됩니다. 이렇게하면 큰 보고서의 성능이 향상 될 수 있습니다.

    캐싱

    성능상의 이유로 API 응답은 약 5 분 동안 캐시되지만 정확한 시간은 여러 요인에 따라 달라질 수 있습니다. 어떠한 것도Analytics API쿼리에서 응답 헤더에서 캐시에 대한 정보를 얻을 수 있습니다.

    캐시 제어 헤더
    캐시 제어 헤더

    그만큼Cache-Control결과가 캐시되는 최대 시간 (초)을 알려줍니다 (위의 예에서는 24 초). 그만큼Last-ModifiedExpires헤더는 현재 캐시가 생성 된 시점과 만료 시점을 알려줍니다.

    대부분의 경우 이것은 문제가되지 않지만 분석 데이터의 최신 성이 매우 중요한 경우 쿼리 실행 시간이 길수록 캐시되는 시간이 길어지고 실시간 (조정되지 않은 시간당) 데이터 만 가져 오는 보고서를 알고 있어야합니다. 조정 된 데이터를 가져 오는 동안 (실시간 데이터 만 또는 추가로) 캐시되지 않습니다. 을 찾다실시간 및 조정 된 데이터에 대한 전체 설명당신이 원한다면; 짧은 버전은Analytics API두 개의 데이터 버킷에 의존합니다.

    • 즉시 사용 가능하고 32 일 동안 저장되는 실시간 또는 시간별 미 조정 데이터
    • 영구적으로 저장되는 조정 된 데이터 실시간 데이터는 정확성을 높이기 위해 조정되고 조정 된 데이터 저장소에 24 시간마다 저장됩니다.

    결과를 조정 된 데이터 또는 실시간 데이터로 제한 할 수 있습니다. 화해매개 변수.

    캐싱을 최소화하려면 :

    • 사용reconciled=false결과를 실시간 데이터로 제한하는 매개 변수
    • 작은 사용날짜 범위 , 전체 범위가 지난 32 일 이내인지 확인합니다.

    타임 아웃

    완료되지 않은 경우 Analytics API는 8 분 후에 시간 초과를 요청합니다. 8 분 미만에 시간 초과가 표시되는 경우 원인은 일부 클라이언트 측 제한입니다.

    반품 할 수있는 최대 항목

    반환 할 수있는 최대 항목 수는 백만 개입니다. 대부분의 경우 한도에 도달 할 가능성은 적지 만 보고서를 요청하는 경우date예를 들어, 오랜 시간 동안 차원이 가능합니다. 백만 개의 항목 제한에 도달하면 반환되는 항목 수를 줄이기 위해 요청을 수정해야합니다. 일반적으로이를 수행하는 가장 간단한 방법은 데이터 범위를 줄이는 것입니다 ( fromto나중에 논의되는 매개 변수).

    동시 요청

    단일 계정은 한 번에 하나의 요청으로 제한됩니다. 여러 동시 요청이 연속적으로 실행됩니다.

    예:

    1. API 요청 "A"를 시작하십시오.
    2. 동일한 계정에 대해 API 요청 "B"를 시작합니다.
    3. 요청 "B"는 "A"가 완료 될 때까지 완료되지 않습니다.
    4. 요청 "A"가 너무 오래 걸리는 경우 "A"요청은 "요청이 보류 중입니다. 다시 시도하십시오"라는 오류를 수신합니다.
    5. 요청 "A"가 너무 오래 걸리면 요청 "B"가 동일한 오류를 수신 할 수 있습니다. A + B를 완료하는 데 걸리는 시간이 타임 아웃 값보다 크면 요청 "B"에 오류가 발생합니다.

    여러 개의 동시 요청을하는 경우 수신 된 순서대로 한 번에 하나씩 처리됩니다.

    "보류중인 오류"와 함께 반환되는 요청은 결국 완료되어 캐시에 저장됩니다. 이는 동일한 데이터에 대한 향후 요청이 거의 즉시 반환되지만 5 분 캐시가 만료되기 전에 요청이 이루어진 경우에만 반환됨을 의미합니다.

    시스템은 2-4 분을 기다린 후 동일한 요청을 다시 작성하여 보류중인 오류를 처리해야합니다.

    모범 사례

    요청 유형

    그만큼Analytics API세 가지 요청 유형 허용

    데이터 (보고서라고도 함)
    하나 이상의 보고서dimensions . 보고서 요청의 끝점은 다음과 같습니다.
      https://analytics.api.brightcove.com/v1/data?accounts={account_id(s)}&dimensions={dimensions}
    참여 보고서
    지난 32 일 이내의 기간 동안 사용할 수있는 자세한 참여 데이터입니다. 보다약혼 섹션상세 사항은.
    비디오 정보 엔드 포인트
    최소한의 지연 시간으로 제공되는 특정 분석 데이터입니다. 보다비디오 데이터 엔드 포인트자세한 내용은.

    어디에 필터날짜 범위보고서에 적용 할 수 있습니다. 보고서 요청에는 다음에 자세히 설명 된 추가 매개 변수가있을 수 있습니다. 이 문서 .

    차원 및 필드

    차원 및 필드에 대한 자세한 정보는 이제 별도의 문서에 있습니다. 차원, 필드 및 매개변수 개요

    매개변수

    매개 변수에 대한 자세한 정보는 이제 별도의 문서에 있습니다. 차원, 필드 및 매개변수 개요

    참여 보고서

    동영상의 각 100 분의 1에 대한 조회수 (또는 계정 또는 플레이어의 모든 동영상에 대한 평균)를 보여주는 자세한 참여 보고서는 지난 32 일 이내의 기간 동안 사용할 수 있습니다. (지난 32 일 이외의 기간에 대한 요청은 오류를 반환합니다.)

    계정 참여

    본 동영상 참여에 대한 평균 값을 얻으려면 엔드 포인트를 사용하십시오.

      
          https://analytics.api.brightcove.com/v1/engagement/accounts/:account_id
      

    플레이어 참여

    플레이어에서 본 모든 비디오의 평균 값을 얻으려면 다음과 같은 엔드 포인트를 사용하십시오.

      
          https://analytics.api.brightcove.com/v1/engagement/accounts/:account_id/players/:player_id
      

    비디오 참여

    특정 비디오에 대한 참여 데이터를 얻으려면 엔드 포인트를 사용하십시오.

      
          https://analytics.api.brightcove.com/v1/engagement/accounts/:account_id/videos/:video_id
      

    라이브 분석

    그만큼Analytics API시계열 또는 이벤트별로 Brightcove Live 스트림에 대한 분석을 검색하기위한 두 개의 엔드 포인트를 제공합니다. 참조Analytics API Reference자세한 내용은.