애널리틱스 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가GET
및POST
을 모두 허용한다는 것입니다. 후자는 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에는date 과date_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수 없는 다른 지표 수를 반환할 수도 있습니다.