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

    애널리틱스 REST API에서 브라이트코브 분석 API로 마이그레이션

    이 항목에서는 Ooyala 분석 REST API에서 비디오 클라우드 분석 API로 이동하는 방법에 대한 지침을 제공합니다.

    서문

    비디오Analytics API클라우드는 오오야라 분석 REST API와 매우 유사합니다.

    또한 Video Cloud Studio의 분석 모듈에는 강력한사용자 지정 보고서 작성기가포함되어 있으므로 대부분의 경우 API를 전혀 사용하지 않아도 됩니다.

    아래 섹션은 두 API의 다양한 측면에 해당합니다.

    인증

    브라이트코브 API 요청의 인증은 Ooyala REST API의 인증과 약간 다르게 처리됩니다. 자세한 내용은브라이트코브 API 요청에 대한 인증을참조하십시오.

    보고서

    Ooyala 애널리틱스 REST API의 단일/reports엔드포인트는 브라이트코브Analytics API/data엔드포인트와 매우 밀접하게 일치합니다. 가장 큰 차이점은 Ooyala API가GETPOST을 모두 허용한다는 것입니다. 후자는 URL 매개 변수가 아닌 요청 본문에 일부 데이터를 전달하는 데 사용되어 더 긴 데이터 문자열을 허용합니다.

    매개변수

    요청에 대한 매개 변수는 두 API와 유사합니다. 차이점이 어디에 있는지 보여주기 위해 아래 표에 자세히 설명되어 있습니다.

    매개변수
    오야라 매개 변수 브라이트코브 파라미터 문서
    없음 accounts - 여러 계정의 모든 보고서에 대한 매개 변수로 포함 차원, 필드 및 매개변수 개요
    report_type 없음 (단, 브라이트코브 API는 참여 및 실시간 분석 보고서를 위한 몇 가지 추가 엔드포인트를 제공합니다. 개요: 애널리틱스
    start_date from두 매개 변수는 비슷하며 둘YYYY-MM-DD다 형식의 값을 허용합니다. 브라이트코브 매개 변수는 밀리 초 단위의 에포크 날짜와-3d 차원, 필드 및 매개변수 개요
    end_date to두 매개 변수는 비슷하며 둘YYYY-MM-DD다 형식의 값을 허용합니다. 브라이트코브 매개 변수는 밀리 초 단위의 에포크 날짜와-3d 차원, 필드 및 매개변수 개요
    metrics fields - 두 매개 변수는 본질적으로 동일합니다. Brighcove API는 Live Analytics 요청에도 사용합니다metrics . 사용 가능한지표에대한 정보는 지표를 참조하십시오. 차원, 필드 및 매개변수 개요
    dimensions dimensions - 두 매개 변수는 본질적으로 동일합니다. Brighcove API는 Live Analytics 요청에도 사용합니다metrics . 사용 가능한차원에대한 자세한 내용은 차원을 참조하십시오. 차원, 필드 및 매개변수 개요
    filters where - 이름 외에도 두 매개 변수는 본질적으로 동일합니다. 자세한 내용은 아래필터를참조하십시오. 차원, 필드 및 매개변수 개요
    time_segment 없음-Brightcove API에는datedate_hour유사한 시간 세분화를 제공하는 측정 기준과 동영상의 각 100 번째 부분에 대한 조회수를 제공하는 이전 32 일 내의 기간에 대한 참여 엔드 포인트 차원, 필드 및 매개변수 개요
    sort sort Ooyala API가 여러 메트릭에 대한 정렬을 허용한다는 점을 제외하고는 매개 변수가 동일합니다. 차원, 필드 및 매개변수 개요
    limit limit - Ooyala API 매개 변수의 1000 제한을 제외하고는 매개 변수가 동일합니다. 차원, 필드 및 매개변수 개요
    page offset - 매개 변수는 다른 값을 취하지만 데이터 세트의 페이징과 유사하게 작동합니다. 차원, 필드 및 매개변수 개요
    없음 reconciled - 분석 데이터가 서로 다른 일정에 따라 서로 다른 소스에서 제공되기 때문에 브라이트코브 API는 최신 분석 데이터를 업데이트되는 동안 “조정되지 않은” 버킷에 넣고 “기록” 버킷으로 전송합니다. 매개 변수를 사용하면이 버킷 사이 차원, 필드 및 매개변수 개요
    없음 bucket_limit - 라이브 애널리틱스 요청에만 적용됩니다. 와bucket_duration함께이 함수는 Ooyala API time_segment매개 변수 와 다소 비슷한 방식으로 차원, 필드 및 매개변수 개요
    없음 bucket_duration 차원, 필드 및 매개변수 개요

    해상도 및 비트레이트

    Ooyala 및 브라이트코브 애널리틱스 API는 모두 데이터를 “차원”이라는 버킷으로 그룹화합니다. 이와 비슷한 방식으로 사용되지만 API에는 여러 차원을 결합할 수 있는 방법에 대한 규칙이 다소 다르며 브라이트코브는 더 광범위한 차원 집합을 가지고 있습니다. 브라이트코브 API에 대한 자세한 내용은지원되는 차원 조합을참조하십시오. 아래 표는 자세한 비교를 제공합니다.

    해상도 및 비트레이트
    오야라 디멘션 브라이트코브 차원 문서
    asset video - 브라이트코브video차원은 VOD 자산만 다룹니다. live_stream 비디오 치수
    country country - 치수가 본질적으로 동일합니다. 국가 차원
    region region - 브라이트코브 차원에 미국 주가 포함된다는 점을 제외하면 차원이 본질적으로 동일합니다. 영역 차원
    dma 없음 해당 없음
    state region - 브라이트코브 API는region차원에 미국 주를 포함합니다. 영역 차원
    device_type device_type - 치수가 본질적으로 동일합니다. 장치 유형 차원
    domain destination_domain 대상 도메인 차원
    url device_os - 본질적으로 동일한 장치 OS 차원
    os destination_domain - 정확히 동일하지는 않지만 가장 가까운 동등한 것 대상 도메인 차원
    pcode account 계정 차원
    player_id player 플레이어 치수
    없음 browser_type 브라우저 유형 차원
    없음 date 날짜 차원
    없음 date_hour 날짜 시간 차원
    없음 device_manufacturer 장치 제조업체 치수
    없음 referrer_domain 참조자 도메인 차원
    없음 search_terms 검색어 차원
    없음 social_platform 소셜 플랫폼 차원
    없음 source_type 소스 유형 차원

    필터

    필터는 다음과 같은 측면에서 지정된 두 API에서 거의 동일하게 작동합니다.

          
            // Ooyala
            filter={dimension1}=={value1};{dimension2}=={value2}
          
            // Brightcove
            where={dimension1}=={value1};{dimension2}=={value2}
          

    메트릭

    보고서에 반환되는metrics (브라이트코브 API의 경우: fields ) 는 브라이트코브 애널리틱스 API에 요청된 차원에 따라 다릅니다. 차원 및 필드에 내장된 도구를 사용할 수 있습니다.을 클릭하여 특정 차원 또는 차원 조합에 대해 반환할 수 있는 필드를 확인합니다.

    Ooyala API는 지정된 지표가 없는 경우 모든 지표를 반환하지만 브라이트코브 API는 요청에 를 포함하지 않는 한 차원 (조합) 에 따라 달라지는 작은 기본 지표 집합만 반환합니다. fields

    브라이트코브 필드에는 다음을 제외한 모든 Ooyala 지표에 해당하는 항목이 포함되어 있습니다.

    • uniq_plays_requested
    • uniq_displays
    • uniq_video_starts

    브라이트코브는 Ooyala 분석에서 사용할Analytics API수 없는 다른 지표 수를 반환할 수도 있습니다.