자주 묻는 질문: 분석 API

다음은 분석 API에 대한 몇 가지 자주 묻는 질문입니다. Video Cloud Studio Analytics 모듈에 대한 몇 가지 일반적인 질문에 대한 답변은 다음을 참조하십시오. 자주하는 질문: 분석 모듈 .

기간

특정 날짜에 대한 데이터는 어떻게 얻습니까?
fromto값을 모두 해당 날짜로 설정합니다. 예를 들면 다음과 같습니다from=2013-05-12&to=2013-05-12 . 또한 다른 차원과 결합할 수 있는date차원을기준으로 쿼리할 수 있습니다.
Analytics 모듈에서 동일한 날짜 범위에 대해 동일한 데이터를Analytics API제공해야 하나요?
예. 하지만 비교적 최근의 데이터를 비교하고 Studio 및 API에서 다른 시간에 데이터를 얻는 경우 다를 수 있습니다.
  1. 데이터는 3 일 미만입니다. 3일 미만의 분석 데이터는 잠정적이며 언제든지 변경될 수 있습니다.
  2. 같은 기간의 데이터는 32 일 미만이었을 때, 그리고 32 일이 지난 후에 다시 살펴 봅니다. 32일이 지나면 데이터가 별도의 “기록” 저장소로 이동되고, 이 시점에서 일부 데이터, 특히 상세한 참여 데이터가 폐기됩니다. 즉, 덜 세분화된 데이터에 대한 계산이 이루어지기 때문에 참여 점수와 같은 계산된 필드가 약간씩 변경될 수 있습니다.

데이터 세분성

최근 Analytics 데이터의 세분성은 무엇입니까?
가장 최근 32일 (현재 날짜 포함) 의 경우 값을 시간별 버킷에 저장하므로 시간 단위로Analytics API보고됩니다. 그러나 현재 시간이 여전히 채워져 있으므로 현재 시간에 해당하는 데이터를 요청할 때 API가 한 시간보다 더 세분화 된 것처럼 보일 수 있습니다.

예:

  1. 3시간 전의 9시 15분과 9시 20분 데이터를 요청하면 동일한 시간 버킷에 속하면 동일한 값을 얻을 수 있습니다. 하지만 모든 분석 데이터는 잠정적이며 조정될 때까지 변경될 수 있으므로 서로 다를 수 있습니다.
  2. 10 분 전의 데이터를 요청한 다음 5 분 동안 기다렸다가 다시 요청하면 해당 버킷이 여전히 업데이트 중이므로 동일한 버킷에 있더라도 다른 값을 얻을 수 있습니다.
분석 데이터의 새로 고침 간격은 무엇입니까?
/data 엔드포인트는 현재 쿼리 사이에 5분 동안 캐시되므로 지난 1시간 동안 트래픽이 발생한 동영상 목록의 경우 5분 간격이 작업에 소요되는 지연 시간이 가장 짧습니다.
과거 Analytics 데이터의 세분성은 무엇입니까?
지난 32일보다 이전 날짜의 경우 전체 날짜 값이Analytics API보고됩니다. 즉, 요청하신 경우from=1368334306919&to=1378446336919 (2013년 5월 12일 일요일 04:51:46 GMT부터 2013년 9월 6일 금요일 05:45:36 그리니치 표준시) 요청하셨을 때와 동일한 결과를 받으실 수 있습니다. from=2013-05-12&to=2013-09-06

항목 및 필드

하나 이상의 동영상에 대해 일정 기간 동안 스트림이 시작된 횟수를 확인하는 가장 좋은 방법은 무엇인가요?
video_view메트릭을 보세요. 이 수치는 항상 스트리밍 시작 횟수와 같습니다. 이 측정 항목은 모든 보고서에서 볼 수 있으며 요약에는 쿼리 된 기간의 모든 동영상에 대한 스트림 시작이 표시됩니다. 계정의 모든 동영상에 대한 스트림 시작을 보려면 다음 요청을 실행하면됩니다.
    https://analytics.api.brightcove.com/v1/data?accounts={account_ids}&dimensions=video&limit=all&offset=0&fields=all
보고서에 있는 모든 아이템을 반품하려면 어떻게 해야 하나요 ?
설정limit에 대한 매개변수보고서동일all .
기본적으로 항목에 대해fields반환되는 데이터는 무엇입니까?
기본적으로video_view및 요청된 차원에 해당하는 필드(예: destination_domain ) 반환됩니다. 추가 필드를 가져오려면 선택한 필드를fields=field_name1,field_name2반환하도록 설정합니다.
필드 값이 이면 무엇을 의미합니까null ?
데이터 필드의null값은 요청된 데이터가 처리되지 않았음을 나타냅니다. 가장 가능성이 높은 이유는 다음과 같습니다.
  • 요청하신 데이터는 최신 데이터이며 아직 처리되지 않았습니다.
  • 요청한 데이터가 너무 오래되어 아직 현재 분석 시스템으로 가져 오지 않았습니다.
내 동영상 중 하나의 이름을 변경했는데 Analytics 데이터에 이전 이름이 표시되는 이유는 무엇입니까?
새 분석 이벤트에 대해 새 이름이 기록되지만 기록 데이터에서 이름을 변경하지 않습니다. 반환 된 비디오 이름은 시청 당시의 이름이됩니다.
참여도 값에 항상 정수가 표시되지 않는 이유는 무엇입니까?
결속 번호가 소수점으로 반환될 수 있습니다. 그 이유는 참여가 정규화되어 있기 때문입니다. 즉, “video_percent_video_engagement _sum (video_engagement _25/video_engagement _sum)" 의 비율이므로 쿼리에 대해 선택한 시간 범위에 따라 정확하게 나누지 않는 경우 부동 소수점 숫자가 표시 될 수 있습니다.
플레이어별로 결과를 필터링하려면 어떻게합니까?

보고

플레이어가 사용하는 대역폭을 볼 때 왜 0GB가 표시됩니까?
과거에 Brightcove는 플레이어별로 대역폭을보고 했으므로 플레이어별로 세부 정보를 나누고 자하는 고객의 경우 이러한 메트릭을 대역폭 비용 할당 수단으로 사용할 수있었습니다. 그러나 더 매니페스트 기반 전달 (현재 HLS 및 미래의 DASH)로 이동함에 따라 분할 된 비디오의 특성으로 인해 플레이어 별 추적 대역폭이 부정확해질 것입니다. 따라서 사용률 보고서에서 플레이어 차원 별 대역폭을 더 이상 사용하지 않습니다. 따라서 앞으로는 실적 보고서에서 플레이어가 본 시간 (초)을 사용하여 플레이어별로 비용을 할당하는 것이 좋습니다.

여러 가지 잡다한

분석 보고서에서 직원 조회수를 제외할 수 있습니까?
이를 쉽게 수행 할 수있는 방법은 없으며 트래픽이 많은 비디오의 경우 직원 조회수는 분석 결과에 미치는 영향은 무시할 정도로 적습니다. 그러나 이렇게 하는 것이 중요하다고 생각되는 트래픽이 낮은 비디오의 경우 가장 간단한 해결책은 프로덕션 플레이어를 복제하고 직원이 복사본에 대한 비디오를 테스트/보도록 하는 것입니다. 그런 다음 필터를 사용하여 애널리틱스 모듈의 사용자 지정 보고서 기능 또는 Analytics API를 사용하여 프로덕션 플레이어에 대해서만 보고서를 생성할 수 있습니다.