치수: date

이 항목에서는Analytics API날짜 차원에 대해 학습합니다. 날짜 측정기준은 하루 동안의 분석을 반환합니다. 사용자는from및to매개변수를yyyy-mm-dd형식으로 지정할 수 있습니다. 이를 통해 사용자는 분석 시스템을 쿼리하여from및to날짜 범위 내의 일별 보고서를 생성할 수 있습니다. 사용자가 지정한 날짜 범위는 계정의 현재 시간대로 해석됩니다. 요청에 대한 날짜 범위는 포함, 배타적 즉from=2013-09-24&to=2013-09-27 , 사용자가 요청을하면 응답은 2013-09-24 00:00:00 에 2013-09-27 00:00 의 결과를 포함합니다.

URL 매개 변수

분석 API 보고서는 다음 URL 매개 변수를 지원합니다.

URL 매개변수
매개 변수 설명 필수 값 기본값
account 보고하려는 계정 예 쉼표로 구분된 목록으로 하나 이상의 계정 ID 없음
dimensions 보고할 차원입니다. 예 쉼표로 구분된 목록으로 된 하나 이상의 차원(일부 조합은 유효하지 않음 - 여기에서 대화형 도구를 사용하여 조합이 유효한지 확인) 없음
where 보고서에 대한 필터를 지정하는 데 사용됩니다. 아니요 {dimension}=={value} - 세미콜론으로 구분된 목록으로 하나 이상. 값은 해당 측정기준의 기본 측정항목에 대한 하나 이상의 값입니다. 예: video==video_idcountry=country-code , 또는viewer=viewer_id (마지막 경우 viewer_id의 형식은 일종의 viewer_id를 직접 캡처하여 전송하는지 또는 분석 시스템에서 생성한 값에 따라 달라집니다). 없음
limit 반품할 항목 수 아니요 양의 정수 10
offset 건너뛸 항목 수 아니요 양의 정수 0
sort 항목을 정렬할 필드 아니요 요청에 의해 반환되는 모든 필드 비디오 보기
fields 반환할 필드 아니요 보고 중인 차원에 따라 다릅니다. 비디오,video_view
format 결과를 반환할 형식 아니요 json(기본값) | csv | xlxs json
reconciled 포함된 경우 결과를 기록 또는 실시간 데이터로 제한합니다. 분석 데이터는 여러 소스에서 파생됩니다. 일부는 플레이어에서 전송되지만 다른 데이터는 CDN과 Video Cloud 시스템에서 수집됩니다. 가능한 한 빨리 분석을 제공하기 위해 “실시간” 데이터를 사용할 수 있는 즉시 전달하기 시작한 다음 나중에 모든 소스의 데이터가 수집 및 처리될 때 분석을 조정합니다. 완전히 처리된 데이터를 조정됨이라고 합니다. 아니요 참 | 거짓 진정한
from 요청에 대한 날짜 범위의 시작 아니요 다음 중 하나:
  • ISO 8601 날짜(YYYY-MM-DD)
  • 밀리초 단위의 에포크 시간(예: 1659641316719 [= 2022년 8월 4일 목요일 오후 7:28:36.719 GMT]). Epoch 시간 변환기를 참조하십시오.
  • 문자열: from=alltime
  • +/- 일 (d), 주 (w) 또는 월 (m) 단위의 기준 날짜 - 예: from=-6m&to=%2B2w (6개월 전부터 2주 후까지의 기간 -- + 기호는 다음과 같이 URI로 인코딩되어야%2B함)

참여 끝점 또는 reconciled=false인 경우 지난 32일 이내의 날짜만 허용됩니다.

 -30일
to 요청에 대한 날짜 범위의 종료 아니요 다음 중 하나:
  • ISO 8601 날짜(YYYY-MM-DD)
  • 밀리초 단위의 에포크 시간(예: 1659641316719 [= 2022년 8월 4일 목요일 오후 7:28:36.719 GMT]). Epoch 시간 변환기를 참조하십시오.
  • 문자열: to=now
  • +/- 일 (d), 주 (w) 또는 월 (m) 단위의 기준 날짜 - 예: from=-6m&to=%2B2w (6개월 전부터 2주 후까지의 기간 -- + 기호는 다음과 같이 URI로 인코딩되어야%2B함)

참여 끝점 또는 reconciled=false인 경우 지난 32일 이내의 날짜만 허용됩니다.

 지금

사용 가능한 필드

차원에 대해 다음 필드를 반환할 수 있습니다.

  • ad_mode_begin - 플레이어가 광고 모드로 들어간 횟수
  • ad_mode_complete - 플레이어가 광고 모드를 완료한 횟수
  • active_media - 계정의 활성 동영상 수
  • bytes_delivered - 플레이어 및 관련 미디어에 대해 클라이언트 시스템에 전달된 총 바이트
  • daily_unique_viewers - 평균 일일 고유 사용자
  • date - 날짜 - ISO 8601 날짜 (연년-월) 형식
  • drm_bytes_packaged - 패키지 된 DRM 바이트 수
  • engagement_score - 동영상의 평균 참여도 점수
  • licenses_served - 제공되는 DRM 라이선스 수
  • live_seconds_streamed - 전송된 총 라이브 스트리밍 시간 (초)
  • play_request - 비디오 재생이 요청된 총 횟수
  • play_rate - 동영상의 평균 재생률 (동영상 조회수를 노출수로 나눈 값)
  • player_load - 플레이어 로드의 총 수
  • video_engagement_1 - 동영상 지속 시간의 1% 포인트에서 총 조회수
  • video_engagement_100 - 동영상 지속 시간의 100% 시점의 총 조회수
  • video_engagement_25 - 동영상 지속 시간의 25% 지점에서 총 조회수
  • video_engagement_50 - 동영상 지속 시간의 50% 시점의 총 조회수
  • video_engagement_75 - 동영상 지속 시간의 75% 지점에서 총 조회수
  • video_impression - 비디오가 플레이어에 로드된 총 횟수
  • video_percent_viewed - 모든 비디오 조회수에 대한 총 시청 비율 (평균이 아닌 합계)
  • video_seconds_viewed - 모든 동영상에 대해 본 총 시간 (초)
  • video_view - 비디오 재생이 시작된 총 횟수

필터 값

필터로 사용되는 차원을 사용하면 결과 범위를 좁힐 수 있습니다.

필터 값: 날짜 차원은 필터로 사용되지 않습니다.

치수 결합

이 차원과 결합할 수 있는 차원과 조합에 사용할 수 있는 필드를 보려면차원 및 필드를참조하십시오.

요청 예제

차원 요청

    데이터 계정:데이터 (데이터) =1752604059001&차원 데이터

필터 요청

    해당 없음
샘플 응답 
{
  "item_count": 31,
  "항목": [
    {
      "날짜": "2022-04-30",
      "동영상_보기": 160
    },
    {
      "날짜": "2022-05-07",
      "동영상_보기": 220
    },
    {
      "날짜": "2022-05-21",
      "동영상_보기": 226
    },
    {
      "날짜": "2022-05-08",
      "동영상_보기": 236
    },
    {
      "날짜": "2022-05-28",
      "동영상_보기": 261
    },
    {
      "날짜": "2022-05-29",
      "동영상_보기": 280
    },
    {
      "날짜": "2022-05-01",
      "동영상_보기": 307
    },
    {
      "날짜": "2022-05-03",
      "동영상_보기": 431
    },
    {
      "날짜": "2022-05-02",
      "동영상_보기": 512
    },
    {
      "날짜": "2022-05-30",
      "동영상_보기": 518
    }
  ],
  "요약": {
    "동영상_보기": 45117
  }
}