Method: reports.batchGet

애널리틱스 데이터를 반환합니다.

HTTP 요청

POST https://analyticsreporting.googleapis.com/v4/reports:batchGet

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "reportRequests": [
    {
      object(ReportRequest)
    }
  ],
  "useResourceQuotas": boolean
}
필드
reportRequests[]

object(ReportRequest)

요청마다 별도의 응답이 있습니다. 최대 5개의 요청이 있을 수 있습니다. 모든 요청은 dateRanges, viewId, segments, samplingLevel, cohortGroup가 동일해야 합니다.

useResourceQuotas

boolean

리소스 기반 할당량(기본값: False)을 사용 설정합니다. 이 필드가 True로 설정된 경우 보기당 (프로필) 할당량에는 요청의 컴퓨팅 비용이 적용됩니다. 비용 기반 할당량을 사용하면 샘플링 레이트가 더 높게 설정됩니다. (SMALL의 경우 1,000만 개, LARGE의 경우 1억 회) 자세한 내용은 한도 및 할당량 문서를 참고하세요.

응답 본문

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

Reporting API batchGet 호출의 보고서를 보유하는 기본 응답 클래스입니다.

JSON 표현
{
  "reports": [
    {
      object(Report)
    }
  ],
  "queryCost": number,
  "resourceQuotasRemaining": {
    object(ResourceQuotasRemaining)
  }
}
필드
reports[]

object(Report)

각 요청에 해당하는 응답입니다.

queryCost

number

쿼리를 실행하기 위해 공제된 리소스 할당량 토큰의 양입니다. 모든 응답이 포함됩니다.

resourceQuotasRemaining

object(ResourceQuotasRemaining)

속성의 잔여 리소스 할당량입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

ReportRequest

Reporting API 요청을 지정하는 기본 요청 클래스입니다.

JSON 표현
{
  "viewId": string,
  "dateRanges": [
    {
      object(DateRange)
    }
  ],
  "samplingLevel": enum(Sampling),
  "dimensions": [
    {
      object(Dimension)
    }
  ],
  "dimensionFilterClauses": [
    {
      object(DimensionFilterClause)
    }
  ],
  "metrics": [
    {
      object(Metric)
    }
  ],
  "metricFilterClauses": [
    {
      object(MetricFilterClause)
    }
  ],
  "filtersExpression": string,
  "orderBys": [
    {
      object(OrderBy)
    }
  ],
  "segments": [
    {
      object(Segment)
    }
  ],
  "pivots": [
    {
      object(Pivot)
    }
  ],
  "cohortGroup": {
    object(CohortGroup)
  },
  "pageToken": string,
  "pageSize": number,
  "includeEmptyRows": boolean,
  "hideTotals": boolean,
  "hideValueRanges": boolean
}
필드
viewId

string

데이터를 가져올 애널리틱스 보기 ID입니다. batchGet 메서드 내의 모든 ReportRequest에는 동일한 viewId가 포함되어야 합니다.

dateRanges[]

object(DateRange)

요청의 기간입니다. 요청의 기간은 최대 2개입니다. 응답에는 요청의 각 기간에 대해 각 측정기준 조합에 대한 측정항목 값 집합이 포함됩니다. 따라서 기간이 2개인 경우 원래 기간과 두 번째 기간에 대한 측정항목 값 두 개가 생깁니다. 동질 집단 또는 평생 가치 요청에는 reportRequest.dateRanges 필드를 지정하지 않아야 합니다. 기간을 제공하지 않으면 기본 기간은 (startDate: 현재 날짜 - 7일, endDate: 현재 날짜 - 1일)입니다. batchGet 메서드 내의 모든 ReportRequest에는 동일한 dateRanges 정의가 포함되어야 합니다.

samplingLevel

enum(Sampling)

원하는 보고서 샘플 크기입니다. samplingLevel 필드가 지정되지 않으면 DEFAULT 샘플링 수준이 사용됩니다. batchGet 메서드 내의 모든 ReportRequest에는 동일한 samplingLevel 정의가 포함되어야 합니다. 자세한 내용은 개발자 가이드를 참고하세요.

dimensions[]

object(Dimension)

요청된 측정기준입니다. 요청의 크기는 총 9개입니다.

dimensionFilterClauses[]

object(DimensionFilterClause)

측정기준 값을 필터링하기 위한 측정기준 필터 절입니다. AND 연산자와 논리적으로 결합됩니다. 측정기준의 집계 전에 필터링이 이루어지므로 반환된 측정항목은 관련 측정기준의 총계만 나타냅니다.

metrics[]

object(Metric)

요청된 측정항목입니다. 요청에 측정항목을 하나 이상 지정해야 합니다. 요청에는 총 10개의 측정항목이 포함될 수 있습니다.

metricFilterClauses[]

object(MetricFilterClause)

측정항목 필터 절입니다. AND 연산자와 논리적으로 결합됩니다. 측정항목 필터는 첫 번째 기간만 확인하고 비교 기간은 확인하지 않습니다. 측정항목에 대한 필터링은 측정항목이 집계된 후에 발생합니다.

filtersExpression

string

요청에 대해 반환되는 데이터를 제한하는 측정기준 또는 측정항목 필터입니다. filtersExpression을 사용하려면 필터링할 측정기준 또는 측정항목과 필터 표현식을 입력합니다. 예를 들어 다음 표현식은 Firefox로 시작하는 ga:browser 측정기준 ga:browser=~^Firefox를 선택합니다. 측정기준 및 측정항목 필터에 대한 자세한 내용은 필터 참조를 참고하세요.

orderBys[]

object(OrderBy)

출력 행의 정렬 순서입니다. 두 행을 비교하려면 차이가 발견될 때까지 다음 요소가 순서대로 적용됩니다. 출력의 모든 기간은 동일한 행 순서를 받습니다.

segments[]

object(Segment)

요청에 대해 반환된 데이터를 분류합니다. 세그먼트 정의는 세그먼트 요청의 하위 집합을 살펴보는 데 도움이 됩니다. 한 요청에 최대 4개의 세그먼트가 포함될 수 있습니다. batchGet 메서드 내의 모든 ReportRequest에는 동일한 segments 정의가 포함되어야 합니다. 세그먼트가 포함된 요청에는 ga:segment 측정기준이 있어야 합니다.

pivots[]

object(Pivot)

피봇 정의입니다. 요청은 최대 2개의 피봇을 포함할 수 있습니다.

cohortGroup

object(CohortGroup)

이 요청과 연결된 동질 집단 그룹 요청에 동질 집단 그룹이 있으면 ga:cohort 측정기준이 있어야 합니다. batchGet 메서드 내의 모든 ReportRequest에는 동일한 cohortGroup 정의가 포함되어야 합니다.

pageToken

string

결과의 다음 페이지를 가져오는 연속 토큰입니다. 이것을 요청에 추가하면 pageToken 다음 행이 반환됩니다. pageToken은 reports.batchGet 요청에 대한 응답으로 nextPageToken 매개변수에서 반환된 값이어야 합니다.

pageSize

number

페이지 크기는 페이징용이며 반환되는 최대 행 수를 지정합니다. 페이지 크기는 >= 0이어야 합니다. 쿼리는 기본값인 1,000행을 반환합니다. Analytics Core Reporting API는 요청하는 수와 상관없이 요청당 최대 100,000개의 행을 반환합니다. 또한 측정기준 세그먼트가 예상보다 적으면 요청된 행보다 적은 행이 반환될 수도 있습니다. 예를 들어 ga:country에 사용할 수 있는 값은 300개 미만이므로 국가별로만 분류하면 pageSize을 더 높은 값으로 설정해도 300개가 넘는 행을 가져올 수 없습니다.

includeEmptyRows

boolean

false로 설정된 경우 검색된 모든 측정항목이 0인 경우 응답에 행이 포함되지 않습니다. 기본값은 false이며, 이러한 행이 제외됩니다.

hideTotals

boolean

True로 설정되면 모든 기간에 대해 일치하는 모든 행의 모든 측정항목의 총계가 숨겨집니다. 기본값은 false이며 총계를 반환합니다.

hideValueRanges

boolean

True로 설정되면 일치하는 모든 행에서 최소 및 최대 값이 숨겨집니다. 기본값은 false이며 값 범위가 반환됩니다.

샘플링

샘플링 수준의 값입니다.

열거형
SAMPLING_UNSPECIFIED samplingLevel 필드가 지정되지 않으면 DEFAULT 샘플링 수준이 사용됩니다.
DEFAULT 속도와 정확도가 균형을 이루는 샘플 크기가 포함된 응답을 반환합니다.
SMALL 더 작은 샘플링 크기로 빠른 응답을 반환합니다.
LARGE 큰 샘플링 크기를 사용하여 더 정확한 응답을 반환합니다. 이로 인해 응답 속도가 느려질 수 있습니다.

측정기준

측정기준은 데이터의 속성입니다. 예를 들어 ga:city 측정기준은 세션이 발생한 도시(예: '파리' 또는 '뉴욕')를 나타냅니다.

JSON 표현
{
  "name": string,
  "histogramBuckets": [
    string
  ]
}
필드
name

string

가져올 측정기준의 이름입니다(예: ga:browser).

histogramBuckets[]

string (int64 format)

비어 있지 않은 경우 측정기준 값을 문자열 다음에 int64로 배치합니다. 적분값의 문자열 표현이 아닌 측정기준 값은 0으로 변환됩니다. 버킷 값은 오름차순이어야 합니다. 각 버킷은 아래쪽에서 닫히고 상단에서는 열립니다. '첫 번째' 버킷에는 첫 번째 경계보다 작은 모든 값이 포함되어 있고, '마지막' 버킷에는 무한대까지의 모든 값이 포함되어 있습니다. 버킷에 속하는 측정기준 값은 새 측정기준 값으로 변환됩니다. 예를 들어, '0, 1, 3, 4, 7'의 목록이 제공되면 다음 버킷을 반환합니다.

  • 버킷 #1: values < 0, 측정기준 값 <0<quot;
  • 버킷 #2: [0,1), 측정기준 값 "0"
  • 버킷 #3: [1,3]의 값, 측정기준 값 &1~2"
  • 버킷 #4: [3,4]의 값, 측정기준 값 "3"
  • 버킷 #5: [4,7), 측정기준 값 "4-6"
  • 버킷 #6: 값 >= 7, 측정기준 값 "7+"

참고: 측정기준에 히스토그램 변형을 적용하고 해당 측정기준을 정렬에 사용하는 경우 해당 목적에는 정렬 유형 HISTOGRAM_BUCKET를 사용하는 것이 좋습니다. 그렇지 않으면 측정기준 값이 사전 (사전순)에 따라 정렬됩니다. 예를 들어 오름차순 사전 순서는 다음과 같습니다.

50~1000, 121~1000, 50~120

오름차순 HISTOGRAM_BUCKET 순서는 다음과 같습니다.

50-120, 121-1000, 1001+1001,

클라이언트는 히스토그램 변형된 측정기준에 대해 "orderType": "HISTOGRAM_BUCKET"를 명시적으로 요청해야 합니다.

측정기준 필터 절

측정기준 필터의 그룹입니다. 필터 값을 논리적으로 조합하는 방법을 지정하려면 연산자 값을 설정합니다.

JSON 표현
{
  "operator": enum(FilterLogicalOperator),
  "filters": [
    {
      object(DimensionFilter)
    }
  ]
}
필드
operator

enum(FilterLogicalOperator)

여러 측정기준 필터를 결합하는 연산자입니다. 지정하지 않으면 OR로 처리됩니다.

filters[]

object(DimensionFilter)

반복되는 필터 집합입니다. 지정된 연산자를 기반으로 논리적으로 결합됩니다.

FilterLogicalOperator

필터를 논리적으로 조합하는 방법입니다.

열거형
OPERATOR_UNSPECIFIED 연산자가 지정되지 않았습니다. OR로 처리됩니다.
OR 논리적 OR 연산자입니다.
AND 논리적 AND 연산자입니다.

측정기준 필터

측정기준 필터는 측정기준에 필터링 옵션을 지정합니다.

JSON 표현
{
  "dimensionName": string,
  "not": boolean,
  "operator": enum(Operator),
  "expressions": [
    string
  ],
  "caseSensitive": boolean
}
필드
dimensionName

string

필터링할 측정기준입니다. 측정기준 필터는 측정기준을 포함해야 합니다.

not

boolean

논리적 NOT 연산자입니다. 이 불리언을 true로 설정하면 일치하는 측정기준 값이 보고서에서 제외됩니다. 기본값은 false입니다.

operator

enum(Operator)

측정기준을 표현식과 일치시키는 방법 기본값은 REGEXP입니다.

expressions[]

string

일치시킬 문자열 또는 정규 표현식입니다. IN_LIST가 아닌 한 목록의 첫 번째 값만 비교에 사용됩니다. IN_LIST 연산자인 경우 전체 목록이 IN_LIST 연산자 설명에 설명된 것처럼 측정기준을 필터링하는 데 사용됩니다.

caseSensitive

boolean

대소문자를 구분해야 하나요? 기본값은 false입니다.

연산자

다양한 검색 유형이 지원됩니다.

열거형
OPERATOR_UNSPECIFIED 검색 유형을 지정하지 않으면 REGEXP으로 처리됩니다.
REGEXP 일치 표현식은 정규 표현식으로 처리됩니다. 모든 검색 유형은 정규 표현식으로 처리되지 않습니다.
BEGINS_WITH 제공된 일치 표현식으로 시작하는 값과 일치합니다.
ENDS_WITH 제공된 일치 표현식으로 끝나는 값과 일치합니다.
PARTIAL 하위 문자열 일치
EXACT 값은 일치 표현식과 완전히 일치해야 합니다.
NUMERIC_EQUAL

정수 비교 필터입니다. 이러한 경우 대소문자 구분이 무시되고 표현식이 정수를 나타내는 문자열로 간주됩니다. 실패 조건:

  • 표현식이 유효한 int64가 아닌 경우 클라이언트에 오류가 발생합니다.
  • 유효한 int64 값이 아닌 입력 측정기준은 필터와 일치하지 않습니다.
NUMERIC_GREATER_THAN 측정기준이 일치 표현식보다 큰지 확인합니다. 제한사항은 NUMERIC_EQUALS 설명을 참고하세요.
NUMERIC_LESS_THAN 측정기준이 일치 표현식보다 작은지 확인합니다. 제한사항은 NUMERIC_EQUALS 설명을 참고하세요.
IN_LIST

이 옵션은 표현식이 선택한 값 목록에서 모든 값을 취할 수 있는 측정기준 필터를 지정하는 데 사용됩니다. 이렇게 하면 모든 단일 응답 행에 OR이 적용되는 일치검색 측정기준 필터를 여러 개 평가하지 않아도 됩니다. 예를 들면 다음과 같습니다.

expressions: ["A", "B", "C"]

측정기준의 값이 A, B 또는 C인 응답 행은 이 DimensionFilter와 일치합니다.

측정항목

측정항목은 정량적 측정값입니다. 예를 들어 ga:users 측정항목은 요청된 기간의 총 사용자 수를 나타냅니다.

JSON 표현
{
  "expression": string,
  "alias": string,
  "formattingType": enum(MetricType)
}
필드
expression

string

요청의 측정항목 표현식입니다. 표현식은 하나 이상의 측정항목 및 숫자로 구성됩니다. 허용되는 연산자로는 더하기 (+), 빼기 (-), 부정 (단항 -), 나눗셈 (/), 곱하기 (*), 괄호, 양의 카디널 숫자 (0~9)가 포함되며 소수점 이하 1024자까지만 허용됩니다. ga:totalRefunds/ga:users 예: 대부분의 경우 측정항목 표현식은 ga:users 같은 단일 측정항목 이름입니다. 혼합 MetricType(예: CURRENCY + PERCENTAGE) 측정항목을 사용하면 예기치 않은 결과가 발생합니다.

alias

string

측정항목 표현식의 별칭은 표현식의 대체 이름입니다. 별칭은 필터링 및 정렬에 사용할 수 있습니다. 이 필드는 선택사항이며, 표현식이 단일 측정항목이 아니라 필터링 및 정렬에 사용할 수 없는 복잡한 표현식인 경우에 유용합니다. 별칭은 응답 열 헤더에도 사용됩니다.

formattingType

enum(MetricType)

측정항목 표현식의 형식을 지정합니다(예: INTEGER).

MetricType

측정항목의 유형입니다.

열거형
METRIC_TYPE_UNSPECIFIED 측정항목 유형이 지정되지 않았습니다.
INTEGER 정수 측정항목입니다.
FLOAT 부동 측정항목입니다.
CURRENCY 통화 측정항목입니다.
PERCENT 백분율 측정항목
TIME HH:MM:SS 형식의 시간 측정항목입니다.

측정항목 필터 절

측정항목 필터 그룹을 나타냅니다. 필터 값을 논리적으로 조합하는 방법을 지정하려면 연산자 값을 설정합니다.

JSON 표현
{
  "operator": enum(FilterLogicalOperator),
  "filters": [
    {
      object(MetricFilter)
    }
  ]
}
필드
operator

enum(FilterLogicalOperator)

여러 측정항목 필터를 결합하는 연산자입니다. 지정하지 않으면 OR로 처리됩니다.

filters[]

object(MetricFilter)

반복되는 필터 집합입니다. 지정된 연산자를 기반으로 논리적으로 결합됩니다.

측정항목 필터

MetricFilter는 측정항목에 필터를 지정합니다.

JSON 표현
{
  "metricName": string,
  "not": boolean,
  "operator": enum(Operator),
  "comparisonValue": string
}
필드
metricName

string

필터링할 측정항목입니다. metricFilter에는 측정항목 이름이 포함되어야 합니다. 측정항목 이름은 이전에 측정항목으로 정의된 별칭이거나 측정항목 표현식일 수도 있습니다.

not

boolean

논리적 NOT 연산자입니다. 이 불리언을 true로 설정하면 일치하는 측정항목 값이 보고서에서 제외됩니다. 기본값은 false입니다.

operator

enum(Operator)

EQUAL, LESS_THAN, GREATER_THAN 측정항목이 비교값이며 기본값은 EQUAL입니다. 연산자가 IS_MISSING이면 측정항목이 누락되었는지 확인하고 비교 값을 무시합니다.

comparisonValue

string

비교할 값입니다.

연산자

다양한 비교 유형 옵션

열거형
OPERATOR_UNSPECIFIED 연산자를 지정하지 않으면 EQUAL로 처리됩니다.
EQUAL 측정항목의 값이 비교 값과 정확하게 일치해야 합니다.
LESS_THAN 측정항목 값이 비교 값보다 작아야 합니다.
GREATER_THAN 측정항목 값이 비교 값보다 커야 합니다.
IS_MISSING 측정항목이 누락되었는지 확인합니다. 비교 가치는 고려하지 않습니다.

OrderBy

정렬 옵션을 지정합니다.

JSON 표현
{
  "fieldName": string,
  "orderType": enum(OrderType),
  "sortOrder": enum(SortOrder)
}
필드
fieldName

string

정렬 기준으로 사용되는 필드입니다. 기본 정렬 순서는 오름차순입니다. 예: ga:browser 정렬의 경우에는 한 개의 필드만 지정할 수 있습니다. 예를 들어 ga:browser, ga:city은 유효하지 않습니다.

orderType

enum(OrderType)

주문 유형입니다. 기본 orderType은 VALUE입니다.

sortOrder

enum(SortOrder)

필드의 정렬 순서입니다.

OrderType

OrderType은 정렬 순서가 결정되는 방식을 제어합니다.

열거형
ORDER_TYPE_UNSPECIFIED 지정되지 않은 주문 유형은 값을 기준으로 정렬로 처리됩니다.
VALUE 정렬 순서는 선택한 열의 값을 기준으로 하며 첫 번째 기간만 확인합니다.
DELTA 정렬 순서는 처음 2개의 기간 동안 선택한 열의 값 차이를 기준으로 합니다. 정확히 2개의 기간이 있는 경우에만 사용 가능합니다.
SMART 정렬 순서는 선택한 열의 가중치를 기준으로 합니다. 열에 n/d 형식이 있으면 이 비율의 가중치 값은 (n + totals.n)/(d + totals.d)이며, 비율을 나타내는 측정항목에서만 사용할 수 있습니다.
HISTOGRAM_BUCKET 히스토그램 순서 유형은 비어 있지 않은 히스토그램 버킷이 있는 측정기준 열에만 적용됩니다.
DIMENSION_AS_INTEGER 치수가 고정된 길이 숫자이면 일반적인 정렬만 사용해도 됩니다. 크기가 가변 길이의 숫자인 경우 DIMENSION_AS_INTEGER를 사용할 수 있습니다.

SortOrder

정렬의 순서입니다.

열거형
SORT_ORDER_UNSPECIFIED 정렬 순서를 지정하지 않으면 기본값은 오름차순입니다.
ASCENDING 오름차순 정렬 필드는 오름차순으로 정렬됩니다.
DESCENDING 내림차순 정렬입니다. 필드가 내림차순으로 정렬됩니다.

세그먼트

세그먼트 정의(보고서가 분류되어야 하는 경우) 세그먼트는 애널리틱스 데이터의 하위 집합입니다. 예를 들어 사용자의 전체 집합 중에서 특정 국가 또는 도시의 사용자에 해당하는 세그먼트를 만들 수 있으며,

JSON 표현
{

  // Union field dynamicOrById can be only one of the following:
  "dynamicSegment": {
    object(DynamicSegment)
  },
  "segmentId": string
  // End of list of possible types for union field dynamicOrById.
}
필드
통합 필드 dynamicOrById는 세그먼트는 DynamicSegment를 사용하거나 동적으로 제공된 세그먼트 또는 맞춤 세그먼트의 ID를 사용하여 동적으로 정의할 수 있습니다. dynamicOrById은 다음 중 하나여야 합니다.
dynamicSegment

object(DynamicSegment)

요청의 동적 세그먼트 정의입니다.

segmentId

string

기본 제공 세그먼트 또는 맞춤 세그먼트의 세그먼트 ID입니다(예: gaid::-3).

동적 세그먼트

요청 내에서 세그먼트를 정의하는 동적 세그먼트 정의입니다. 세그먼트는 사용자, 세션 또는 둘 다를 선택할 수 있습니다.

JSON 표현
{
  "name": string,
  "userSegment": {
    object(SegmentDefinition)
  },
  "sessionSegment": {
    object(SegmentDefinition)
  }
}
필드
name

string

동적 세그먼트의 이름입니다.

userSegment

object(SegmentDefinition)

사용자 세그먼트를 선택하여 세그먼트에 포함할 사용자를 선택합니다.

sessionSegment

object(SegmentDefinition)

세션 세그먼트를 선택하여 세그먼트에 포함할 세션 세그먼트

세그먼트 정의

SegmentDefinition은 세그먼트를 논리적 AND 작업과 결합하는 SegmentFilter의 집합으로 정의합니다.

JSON 표현
{
  "segmentFilters": [
    {
      object(SegmentFilter)
    }
  ]
}
필드
segmentFilters[]

object(SegmentFilter)

세그먼트는 논리적 AND 작업과 결합되는 세그먼트 필터로 정의됩니다.

세그먼트 필터

SegmentFilter는 세그먼트를 단순 세그먼트 또는 시퀀스 세그먼트로 정의합니다. 간단한 세그먼트 조건에는 세션 또는 사용자를 선택하는 측정기준 및 측정항목 조건이 포함됩니다. 시퀀스 세그먼트 조건을 사용하여 순차 조건에 따라 사용자 또는 세션을 선택할 수 있습니다.

JSON 표현
{
  "not": boolean,

  // Union field simpleOrSequence can be only one of the following:
  "simpleSegment": {
    object(SimpleSegment)
  },
  "sequenceSegment": {
    object(SequenceSegment)
  }
  // End of list of possible types for union field simpleOrSequence.
}
필드
not

boolean

참인 경우 단순 세그먼트 또는 시퀀스 세그먼트 보완과 일치합니다. 예를 들어 '뉴욕'에서 발생하지 않은 모든 방문을 일치시키기 위해 다음과 같이 세그먼트를 정의할 수 있습니다.

  "sessionSegment": {
    "segmentFilters": [{
      "simpleSegment" :{
        "orFiltersForSegment": [{
          "segmentFilterClauses":[{
            "dimensionFilter": {
              "dimensionName": "ga:city",
              "expressions": ["New York"]
            }
          }]
        }]
      },
      "not": "True"
    }]
  },

통합 필드 simpleOrSequence는 단순 세그먼트인가요, 시퀀스 세그먼트 정의인가요? simpleOrSequence은 다음 중 하나여야 합니다.
simpleSegment

object(SimpleSegment)

단순 세그먼트 조건은 결합될 수 있는 하나 이상의 측정기준/측정항목 조건으로 구성됩니다.

sequenceSegment

object(SequenceSegment)

시퀀스 조건은 하나 이상의 단계로 구성되며, 각 단계는 하나 이상의 측정기준/측정항목 조건으로 정의됩니다. 여러 단계를 특수 시퀀스 연산자와 결합할 수 있습니다.

단순 세그먼트

단순 세그먼트 조건은 결합될 수 있는 하나 이상의 측정기준/측정항목 조건으로 구성됩니다.

JSON 표현
{
  "orFiltersForSegment": [
    {
      object(OrFiltersForSegment)
    }
  ]
}
필드
orFiltersForSegment[]

object(OrFiltersForSegment)

논리적 AND 연산자와 결합된 세그먼트 필터 그룹의 목록입니다.

OR필터용 세그먼트

OR 그룹의 세그먼트 필터 목록이 논리 OR 연산자로 결합됩니다.

JSON 표현
{
  "segmentFilterClauses": [
    {
      object(SegmentFilterClause)
    }
  ]
}
필드
segmentFilterClauses[]

object(SegmentFilterClause)

OR 연산자와 결합할 세그먼트 필터 목록입니다.

세그먼트 필터 절

세그먼트 정의에 사용할 필터 절은 측정항목 또는 측정기준 필터를 사용할 수 있습니다.

JSON 표현
{
  "not": boolean,

  // Union field dimensionOrMetricFilter can be only one of the following:
  "dimensionFilter": {
    object(SegmentDimensionFilter)
  },
  "metricFilter": {
    object(SegmentMetricFilter)
  }
  // End of list of possible types for union field dimensionOrMetricFilter.
}
필드
not

boolean

필터의 보수(!)와 일치합니다.

통합 필드 dimensionOrMetricFilter는 측정기준 또는 측정항목 필터 dimensionOrMetricFilter은 다음 중 하나여야 합니다.
dimensionFilter

object(SegmentDimensionFilter)

세그먼트 정의에 대한 측정기준 필터입니다.

metricFilter

object(SegmentMetricFilter)

세그먼트 정의에 대한 측정항목 필터입니다.

세그먼트 측정기준 필터

측정기준 필터는 측정기준에 필터링 옵션을 지정합니다.

JSON 표현
{
  "dimensionName": string,
  "operator": enum(Operator),
  "caseSensitive": boolean,
  "expressions": [
    string
  ],
  "minComparisonValue": string,
  "maxComparisonValue": string
}
필드
dimensionName

string

필터를 적용할 측정기준의 이름입니다.

operator

enum(Operator)

측정기준을 표현식과 일치시키는 데 사용할 연산자입니다.

caseSensitive

boolean

일치는 대소문자를 구분하며 IN_LIST 연산자에서는 무시됩니다.

expressions[]

string

표현식 목록, 모든 연산자에 첫 번째 요소만 사용됨

minComparisonValue

string

BETWEEN 검색 유형에 대한 최소 비교 값입니다.

maxComparisonValue

string

BETWEEN 검색 유형의 최대 비교 값입니다.

연산자

다양한 검색 유형이 지원됩니다.

열거형
OPERATOR_UNSPECIFIED 검색 유형을 지정하지 않으면 REGEXP로 처리됩니다.
REGEXP 일치 표현식은 정규 표현식으로 처리됩니다. 다른 모든 검색 유형은 정규 표현식으로 처리되지 않습니다.
BEGINS_WITH 제공된 일치 표현식으로 시작하는 값과 일치합니다.
ENDS_WITH 제공된 일치 표현식으로 끝나는 값과 일치합니다.
PARTIAL 하위 문자열 일치
EXACT 값은 일치 표현식과 완전히 일치해야 합니다.
IN_LIST

이 옵션은 표현식이 선택한 값 목록에서 모든 값을 취할 수 있는 측정기준 필터를 지정하는 데 사용됩니다. 이렇게 하면 모든 단일 응답 행에 OR이 적용되는 일치검색 측정기준 필터를 여러 개 평가하지 않아도 됩니다. 예를 들면 다음과 같습니다.

expressions: ["A", "B", "C"]

측정기준의 값이 A, B 또는 C인 응답 행은 이 DimensionFilter와 일치합니다.

NUMERIC_LESS_THAN

정수 비교 필터입니다. 이러한 경우 대소문자 구분이 무시되고 표현식이 정수를 나타내는 문자열로 간주됩니다. 실패 조건:

  • 표현식이 유효한 int64가 아닌 경우 클라이언트는 오류를 예상합니다.
  • 유효한 int64 값이 아닌 입력 측정기준은 필터와 일치하지 않습니다.

측정기준이 일치 표현식보다 작은지 확인합니다.

NUMERIC_GREATER_THAN 측정기준이 일치 표현식보다 큰지 확인합니다.
NUMERIC_BETWEEN 측정기준이 일치 표현식의 최솟값과 최댓값 사이의 숫자인지, 경계가 제외되었는지 확인합니다.

세그먼트 측정항목 필터

세그먼트 필터 절에서 사용할 측정항목 필터입니다.

JSON 표현
{
  "scope": enum(Scope),
  "metricName": string,
  "operator": enum(Operator),
  "comparisonValue": string,
  "maxComparisonValue": string
}
필드
scope

enum(Scope)

측정항목의 범위는 측정항목이 정의된 수준을 정의합니다. 지정된 측정항목 범위는 데이터 모델에 정의된 기본 범위와 같거나 그보다 커야 합니다. 기본 범위는 세그먼트가 사용자 또는 세션을 선택하는지를 통해 정의됩니다.

metricName

string

필터링할 측정항목입니다. metricFilter에는 측정항목 이름이 포함되어야 합니다.

operator

enum(Operator)

측정항목을 비교하기 위해 수행할 작업입니다. 기본값은 EQUAL입니다.

comparisonValue

string

비교할 값입니다. 연산자가 BETWEEN이면 이 값은 최소 비교 값으로 처리됩니다.

maxComparisonValue

string

최대 비교 값은 BETWEEN 연산자에만 사용됩니다.

범위

측정항목의 범위는 측정항목이 정의된 수준을 정의합니다(PRODUCT, HIT, SESSION 또는 USER). 측정항목 값은 기본 범위보다 큰 범위에서 보고될 수도 있습니다. 예: ga:pageviewsga:transactions는 해당 세션에서 발생하는 각 조회 또는 해당 사용자에 대해서 추가하여 SESSIONUSER 수준에서 보고할 수 있습니다.

열거형
UNSPECIFIED_SCOPE 범위가 지정되지 않은 경우 세그먼트가 사용자 또는 세션을 선택하려고 하는지에 따라 USER 또는 SESSION 조건 범위가 기본값으로 지정됩니다.
PRODUCT 제품 범위
HIT 조회 범위
SESSION 세션 범위입니다.
USER 사용자 범위

연산자

다양한 비교 유형 옵션

열거형
UNSPECIFIED_OPERATOR 지정되지 않은 연산자는 LESS_THAN 연산자로 간주됩니다.
LESS_THAN 측정항목 값이 비교 값보다 작은지 확인합니다.
GREATER_THAN 측정항목 값이 비교 값보다 큰지 확인합니다.
EQUAL 같음 연산자
BETWEEN 연산자 간에는 최솟값과 최댓값이 모두 배타적입니다. LTGT를 사용하여 비교합니다.

시퀀스 세그먼트

시퀀스 조건은 하나 이상의 단계로 구성되며, 각 단계는 하나 이상의 측정기준/측정항목 조건으로 정의됩니다. 여러 단계를 특수 시퀀스 연산자와 결합할 수 있습니다.

JSON 표현
{
  "segmentSequenceSteps": [
    {
      object(SegmentSequenceStep)
    }
  ],
  "firstStepShouldMatchFirstHit": boolean
}
필드
segmentSequenceSteps[]

object(SegmentSequenceStep)

시퀀스의 단계 목록입니다.

firstStepShouldMatchFirstHit

boolean

설정된 경우 첫 번째 단계 조건은 방문자의 첫 번째 조회와 일치해야 합니다 (기간).

세그먼트 시퀀스 단계

세그먼트 시퀀스 정의입니다.

JSON 표현
{
  "orFiltersForSegment": [
    {
      object(OrFiltersForSegment)
    }
  ],
  "matchType": enum(MatchType)
}
필드
orFiltersForSegment[]

object(OrFiltersForSegment)

시퀀스는 AND 연산자와 결합된 OR 그룹화된 필터 목록으로 지정됩니다.

matchType

enum(MatchType)

단계의 바로 앞 또는 다음 단계 이전 단계일 수 있습니다.

MatchType

시퀀스의 검색 유형입니다.

열거형
UNSPECIFIED_MATCH_TYPE 지정되지 않은 검색 유형은 선행으로 처리됩니다.
PRECEDES 연산자는 이전 단계가 다음 단계보다 이전임을 나타냅니다.
IMMEDIATELY_PRECEDES 연산자는 이전 단계가 다음 단계 바로 앞에 있음을 나타냅니다.

피봇

피봇은 요청의 피봇 섹션을 설명합니다. 피봇을 사용하면 두 번째 측정기준에서 데이터를 피봇하여 특정 보고서의 표에 있는 정보를 재정렬할 수 있습니다.

JSON 표현
{
  "dimensions": [
    {
      object(Dimension)
    }
  ],
  "dimensionFilterClauses": [
    {
      object(DimensionFilterClause)
    }
  ],
  "metrics": [
    {
      object(Metric)
    }
  ],
  "startGroup": number,
  "maxGroupCount": number
}
필드
dimensions[]

object(Dimension)

피봇 열로 표시할 측정기준 목록입니다. 한 피봇에는 최대 4개의 측정기준을 포함할 수 있습니다. 피봇 측정기준은 요청에서 허용되는 총 측정기준 수에 관한 제한사항의 일부입니다.

dimensionFilterClauses[]

object(DimensionFilterClause)

DimensionFilterClauses는 논리적으로 AND 연산자와 결합됩니다. 모든 DimensionFilterClauses에 포함된 데이터만 이 피벗 영역의 값에 기여합니다. 측정기준 필터를 사용하여 피벗 영역에 표시되는 열을 제한할 수 있습니다. 예를 들어 피벗 영역에 요청된 측정기준으로 ga:browser이 있고 ga:browser를 'IE' 또는 'Firefox'로 제한하도록 키 필터를 지정하면 이 두 브라우저만 열로 표시됩니다.

metrics[]

object(Metric)

피봇 측정항목입니다. 피봇 측정항목은 요청에서 허용되는 총 측정항목 수에 관한 제한사항의 일부입니다.

startGroup

number

k 측정항목이 요청된 경우 응답에 보고서에 k열의 여러 데이터 종속 항목이 포함됩니다. 예를 들어 ga:browser 측정기준을 피봇팅한 경우 'Firefox'의 경우 k개의 열을, 'IT'의 경우 k개의 열을, 'Chrome'의 경우 k개의 열을 얻었습니다. 열 그룹의 순서는 첫 번째 열의 k 총계의 내림차순으로 결정됩니다. 첫 번째 피봇 측정기준의 사전순, 두 번째 피봇 측정기준의 사전순으로 정렬됩니다. 예를 들어 Firefox, IE, Chrome의 첫 번째 값의 합계가 각각 8, 2, 8인 경우 열의 순서는 Chrome, Firefox, IE가 됩니다.

다음과 같은 경우 응답에 포함할 k열 그룹을 선택할 수 있습니다.

maxGroupCount

number

반환할 최대 그룹 수를 지정합니다. 기본값은 10, 최댓값은 1,000입니다.

동질 집단 그룹

동질 집단 그룹을 정의합니다. 예를 들면 다음과 같습니다.

"cohortGroup": {
  "cohorts": [{
    "name": "cohort 1",
    "type": "FIRST_VISIT_DATE",
    "dateRange": { "startDate": "2015-08-01", "endDate": "2015-08-01" }
  },{
    "name": "cohort 2"
     "type": "FIRST_VISIT_DATE"
     "dateRange": { "startDate": "2015-07-01", "endDate": "2015-07-01" }
  }]
}
JSON 표현
{
  "cohorts": [
    {
      object(Cohort)
    }
  ],
  "lifetimeValue": boolean
}
필드
cohorts[]

object(Cohort)

동질 집단의 정의입니다.

lifetimeValue

boolean

평생 가치 (LTV)를 사용 설정합니다. LTV는 다양한 채널을 통해 획득한 사용자의 평생 가치를 측정합니다. 동질 집단 분석평생 가치를 참고하세요. 평생 가치의 값이 거짓인 경우:

  • 측정항목 값은 웹 인터페이스 동질 집단 보고서의 값과 유사합니다.
  • 동질 집단 정의 기간은 달력 주와 월로 맞춰야 합니다. 예를 들어 ga:cohortNthWeek을 요청할 때 동질 집단 정의에서 startDate는 일요일이어야 하고 endDate는 다음 토요일이어야 합니다. ga:cohortNthMonth의 경우 startDate는 그 달의 첫 번째 날이고 endDate는 매월 마지막 날이어야 합니다.

lifecycleValue가 true인 경우:

  • 측정항목 값은 웹 인터페이스 LifeTime 가치 보고서의 값과 일치합니다.
  • 평생 가치 보고서는 사용자를 획득한 후 90일 동안 사용자 가치 (수익)와 참여도 (앱 조회수, 목표 달성, 세션수, 세션 시간)가 어떻게 증가했는지 보여줍니다.
  • 측정항목은 시간 경과에 따라 사용자별 누적 평균으로 계산됩니다.
  • 동질 집단 정의 기간은 캘린더 주와 월 경계에 맞게 정렬할 필요가 없습니다.
  • viewId앱 보기 ID여야 합니다.

동질 집단

동질 집단을 정의합니다. 동질 집단이란 공통된 특징을 가진 사용자 그룹을 말합니다. 예를 들어 획득 날짜가 동일한 사용자는 모두 같은 동질 집단에 속합니다.

JSON 표현
{
  "name": string,
  "type": enum(Type),
  "dateRange": {
    object(DateRange)
  }
}
필드
name

string

동질 집단의 고유한 이름입니다. 정의되지 않은 경우 동질 집단_[1234...] 값을 사용하여 이름이 자동 생성됩니다.

type

enum(Type)

동질 집단의 유형입니다. 현재 지원되는 유일한 유형은 FIRST_VISIT_DATE입니다. 이 필드를 지정하지 않으면 동질 집단이 FIRST_VISIT_DATE 유형 동질 집단으로 간주됩니다.

dateRange

object(DateRange)

FIRST_VISIT_DATE 동질 집단에 사용되며 동질 집단에서 첫 방문 날짜가 DateRange에 정의된 시작일과 종료일 사이에 있는 사용자를 선택합니다. 동질 집단 요청에 맞춰 기간을 조정해야 합니다. 요청에 ga:cohortNthDay이 포함된 경우 정확히 1일이어야 하고, ga:cohortNthWeek인 경우 주 경계에 맞게 정렬되어야 합니다 (일요일부터 토요일까지). ga:cohortNthMonth의 경우 기간을 월 (예: 첫 번째 날부터 마지막 날까지)에 정렬해야 합니다. LTV 요청에는 이러한 제한이 없습니다. reportsRequest.dateRanges 필드에 기간을 제공할 필요가 없습니다.

유형

동질 집단 유형입니다.

열거형
UNSPECIFIED_COHORT_TYPE 지정하지 않으면 FIRST_VISIT_DATE로 처리됩니다.
FIRST_VISIT_DATE 첫 방문 날짜를 기준으로 선택된 사용자 집단

신고

요청에 해당하는 데이터 응답입니다.

JSON 표현
{
  "columnHeader": {
    object(ColumnHeader)
  },
  "data": {
    object(ReportData)
  },
  "nextPageToken": string
}
필드
columnHeader

object(ColumnHeader)

열 헤더입니다.

data

object(ReportData)

응답 데이터

nextPageToken

string

목록의 다음 결과 페이지를 검색하는 페이지 토큰입니다.

열 헤더

열 헤더

JSON 표현
{
  "dimensions": [
    string
  ],
  "metricHeader": {
    object(MetricHeader)
  }
}
필드
dimensions[]

string

응답의 측정기준 이름입니다.

metricHeader

object(MetricHeader)

응답의 측정항목에 대한 측정항목 헤더입니다.

MetricHeader

측정항목의 헤더입니다.

JSON 표현
{
  "metricHeaderEntries": [
    {
      object(MetricHeaderEntry)
    }
  ],
  "pivotHeaders": [
    {
      object(PivotHeader)
    }
  ]
}
필드
metricHeaderEntries[]

object(MetricHeaderEntry)

응답의 측정항목에 대한 헤더입니다.

pivotHeaders[]

object(PivotHeader)

응답의 피봇 헤더입니다.

측정항목 헤더 항목

측정항목의 헤더입니다.

JSON 표현
{
  "name": string,
  "type": enum(MetricType)
}
필드
name

string

헤더의 이름입니다.

type

enum(MetricType)

측정항목의 유형입니다(예: INTEGER).

PivotHeader

요청에 정의된 각 피봇 섹션의 헤더입니다.

JSON 표현
{
  "pivotHeaderEntries": [
    {
      object(PivotHeaderEntry)
    }
  ],
  "totalPivotGroupsCount": number
}
필드
pivotHeaderEntries[]

object(PivotHeaderEntry)

단일 피봇 섹션 헤더입니다.

totalPivotGroupsCount

number

이 피봇의 총 그룹 수입니다.

PivotHeaderEntry

응답의 피봇 섹션에 요청된 측정항목에 해당하는 각 측정항목 열의 헤더입니다.

JSON 표현
{
  "dimensionNames": [
    string
  ],
  "dimensionValues": [
    string
  ],
  "metric": {
    object(MetricHeaderEntry)
  }
}
필드
dimensionNames[]

string

피봇 응답의 측정기준 이름입니다.

dimensionValues[]

string

피봇의 측정기준 값입니다.

metric

object(MetricHeaderEntry)

피벗 측정항목의 측정항목 헤더입니다.

보고서 데이터

보고서의 데이터 부분입니다.

JSON 표현
{
  "rows": [
    {
      object(ReportRow)
    }
  ],
  "totals": [
    {
      object(DateRangeValues)
    }
  ],
  "rowCount": number,
  "minimums": [
    {
      object(DateRangeValues)
    }
  ],
  "maximums": [
    {
      object(DateRangeValues)
    }
  ],
  "samplesReadCounts": [
    string
  ],
  "samplingSpaceSizes": [
    string
  ],
  "isDataGolden": boolean,
  "dataLastRefreshed": string
}
필드
rows[]

object(ReportRow)

모든 측정기준 조합에 대한 하나의 ReportRow가 있습니다.

totals[]

object(DateRangeValues)

요청된 각 기간에 대해 쿼리와 일치하는 모든 행 집합에서 요청된 모든 값 형식의 합계가 집계됩니다. 값 형식의 합계는 먼저 값 형식에 언급된 측정항목의 합계를 구한 후 값 형식을 스칼라 표현식으로 평가하여 계산합니다. 예: 3 / (ga:sessions + 2)의 경우 'totals'는 3 / ((sum of all relevant ga:sessions) + 2)를 계산합니다. 총계는 페이지로 나누기 전에 계산됩니다.

rowCount

number

이 쿼리와 일치하는 총 행 수입니다.

minimums[]

object(DateRangeValues)

일치하는 모든 행에 표시된 최솟값 및 최댓값입니다. 요청의 hideValueRanges가 false이거나 rowCount가 0이면 둘 다 비어 있습니다.

maximums[]

object(DateRangeValues)

일치하는 모든 행에 표시된 최솟값 및 최댓값입니다. 요청의 hideValueRanges가 false이거나 rowCount가 0이면 둘 다 비어 있습니다.

samplesReadCounts[]

string (int64 format)

결과가 샘플링되면 기간당 한 항목씩 읽은 총 샘플 수가 반환됩니다. 결과가 샘플링되지 않으면 이 필드가 정의되지 않습니다. 자세한 내용은 개발자 가이드를 참고하세요.

samplingSpaceSizes[]

string (int64 format)

결과가 샘플링되면 기간당 항목 한 개가 반환되어 총 샘플 수가 반환됩니다. 결과가 샘플링되지 않으면 이 필드가 정의되지 않습니다. 자세한 내용은 개발자 가이드를 참고하세요.

isDataGolden

boolean

이 요청에 대한 응답이 골든인지 여부를 나타냅니다. 나중에 동일한 요청을 해도 새로운 요청이 생성되지 않는 경우 데이터는 황금색이 됩니다.

dataLastRefreshed

string (Timestamp format)

보고서의 데이터가 마지막으로 새로고침된 시간입니다. 이 타임스탬프 이전에 발생한 모든 조회가 보고서 계산에 포함됩니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프로 정밀도는 나노초 수준입니다. 예: "2014-10-02T15:01:23.045123456Z"

보고서 행

보고서의 행입니다.

JSON 표현
{
  "dimensions": [
    string
  ],
  "metrics": [
    {
      object(DateRangeValues)
    }
  ]
}
필드
dimensions[]

string

요청된 측정기준의 목록입니다.

metrics[]

object(DateRangeValues)

요청된 각 기간의 측정항목 목록입니다.

기간 값

단일 기간 / 측정기준 조합의 측정항목 목록을 반환하는 데 사용됩니다.

JSON 표현
{
  "values": [
    string
  ],
  "pivotValueRegions": [
    {
      object(PivotValueRegion)
    }
  ]
}
필드
values[]

string

각 값은 요청의 각 측정항목에 해당합니다.

pivotValueRegions[]

object(PivotValueRegion)

각 피봇 영역의 값입니다.

피봇 값 리전

피봇 리전의 측정항목 값입니다.

JSON 표현
{
  "values": [
    string
  ]
}
필드
values[]

string

각 피봇 지역의 측정항목의 값입니다.

나머지 리소스 할당량

요청이 완료된 후 속성에 남아 있는 리소스 할당량 토큰입니다.

JSON 표현
{
  "dailyQuotaTokensRemaining": number,
  "hourlyQuotaTokensRemaining": number
}
필드
dailyQuotaTokensRemaining

number

남은 일일 리소스 할당량이 있습니다.

hourlyQuotaTokensRemaining

number

시간당 리소스 할당량 토큰이 남았습니다.

사용해 보기