치수: 국가

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 - 플레이어가 광고 모드를 완료한 횟수
country - 해당 국가의 두 글자 코드
country_name - DMA 구역 - 미국에만 적용되며, 값은 지역 및/또는 도시 규격이 포함되지0않은 한
dma - 국가의 이름
engagement_score - 플레이어에서 재생한 동영상의 평균 참여도 점수
play_request - 비디오 재생이 요청된 총 횟수
play_rate - 동영상의 평균 재생 속도 (동영상 조회수를 노출수로 나눈 값)
player_load - 플레이어가로드 된 횟수
video_impression - 플레이어에로드 된 총 비디오 수
video_percent_viewed - 플레이어에서 비디오의 조회율 합계
video_seconds_viewed - 플레이어에서 본 동영상의 총 시간 (초)
video_view - 플레이어에서 비디오 재생이 시작된 총 횟수

필터 값

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

필터 값: ISO-3166-1 국가 코드의 쉼표로 구분된 목록 - 예: 코, 우리

치수 결합

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

요청 예제

차원 요청

    데이터 계정:데이터 및 차원=국가

필터 요청

    데이터? 계정=1752604059001&차원=도시&위치=국가=미국, 기가바이트 , 일본, 국가==미국, 기가바이트, JA&필드=국가_이름

샘플 응답

{
  "item_count": 128,
  "항목": [
    {
      "국가": "SC",
      "동영상_보기": 1
    },
    {
      "국가": "지엠",
      "동영상_보기": 1
    },
    {
      "국가": "봄 여름 시즌",
      "동영상_보기": 1
    },
    {
      "국가": "비와이",
      "동영상_보기": 1
    },
    {
      "국가": "지엠",
      "동영상_보기": 1
    },
    {
      "국가": "제이엠",
      "동영상_보기": 1
    },
    {
      "국가": "VE",
      "동영상_보기": 1
    },
    {
      "국가": "CY",
      "동영상_보기": 1
    },
    {
      "국가": "IQ",
      "동영상_보기": 1
    },
    {
      "국가": "XK",
      "동영상_보기": 1
    }
  ],
  "요약": {
    "동영상_보기": 45117
  }
}

치수: country

URL 매개 변수

사용 가능한 필드

필터 값

치수 결합

요청 예제

차원 요청

필터 요청

치수: `country`