- HTTP 요청
- 요청 본문
- 응답 본문
- 승인 범위
- ReportRequest
- 샘플링
- 측정기준
- DimensionFilterClause
- FilterLogicalOperator
- 측정기준 필터
- 연산자
- 측정항목
- 측정항목 유형
- MetricFilterClause
- MetricFilter
- 연산자
- OrderBy
- 주문 유형
- 정렬 순서
- 세그먼트
- 동적 세그먼트
- SegmentDefinition
- 세그먼트 필터
- SimpleSegment
- OrFiltersForSegment
- SegmentFilterClause
- SegmentDimensionFilter
- 연산자
- SegmentMetricFilter
- 범위
- 연산자
- SequenceSegment
- SegmentSequenceStep
- MatchType
- 피봇
- 동질 집단
- 사용자 집단
- 유형
- 보고서
- ColumnHeader
- MetricHeader
- MetricHeaderEntry
- PivotHeader
- PivotHeaderEntry
- 보고서 데이터
- ReportRow
- DateRangeValues
- PivotValueRegion
- ResourceQuotaRemaining
- 실습
애널리틱스 데이터를 반환합니다.
HTTP 요청
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
URL은 gRPC 트랜스코딩 구문을 사용합니다.
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 | |
---|---|
{
"reportRequests": [
{
object( |
필드 | |
---|---|
reportRequests[] |
요청마다 별도의 응답이 있습니다. 최대 5개의 요청이 있을 수 있습니다. 모든 요청은 |
useResourceQuotas |
리소스 기반 할당량(기본값: |
응답 본문
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
Reporting API batchGet
호출의 보고서를 보유하는 기본 응답 클래스입니다.
JSON 표현 | |
---|---|
{ "reports": [ { object( |
필드 | |
---|---|
reports[] |
각 요청에 해당하는 응답입니다. |
queryCost |
쿼리를 실행하기 위해 공제된 리소스 할당량 토큰의 양입니다. 모든 응답이 포함됩니다. |
resourceQuotasRemaining |
속성의 잔여 리소스 할당량입니다. |
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
ReportRequest
Reporting API 요청을 지정하는 기본 요청 클래스입니다.
JSON 표현 | |
---|---|
{ "viewId": string, "dateRanges": [ { object( |
필드 | |
---|---|
viewId |
데이터를 가져올 애널리틱스 보기 ID입니다. |
dateRanges[] |
요청의 기간입니다. 요청의 기간은 최대 2개입니다. 응답에는 요청의 각 기간에 대해 각 측정기준 조합에 대한 측정항목 값 집합이 포함됩니다. 따라서 기간이 2개인 경우 원래 기간과 두 번째 기간에 대한 측정항목 값 두 개가 생깁니다. 동질 집단 또는 평생 가치 요청에는 |
samplingLevel |
원하는 보고서 샘플 크기입니다. |
dimensions[] |
요청된 측정기준입니다. 요청의 크기는 총 9개입니다. |
dimensionFilterClauses[] |
측정기준 값을 필터링하기 위한 측정기준 필터 절입니다. |
metrics[] |
요청된 측정항목입니다. 요청에 측정항목을 하나 이상 지정해야 합니다. 요청에는 총 10개의 측정항목이 포함될 수 있습니다. |
metricFilterClauses[] |
측정항목 필터 절입니다. |
filtersExpression |
요청에 대해 반환되는 데이터를 제한하는 측정기준 또는 측정항목 필터입니다. |
orderBys[] |
출력 행의 정렬 순서입니다. 두 행을 비교하려면 차이가 발견될 때까지 다음 요소가 순서대로 적용됩니다. 출력의 모든 기간은 동일한 행 순서를 받습니다. |
segments[] |
요청에 대해 반환된 데이터를 분류합니다. 세그먼트 정의는 세그먼트 요청의 하위 집합을 살펴보는 데 도움이 됩니다. 한 요청에 최대 4개의 세그먼트가 포함될 수 있습니다. |
pivots[] |
피봇 정의입니다. 요청은 최대 2개의 피봇을 포함할 수 있습니다. |
cohortGroup |
이 요청과 연결된 동질 집단 그룹 요청에 동질 집단 그룹이 있으면 |
pageToken |
결과의 다음 페이지를 가져오는 연속 토큰입니다. 이것을 요청에 추가하면 pageToken 다음 행이 반환됩니다. pageToken은 reports.batchGet 요청에 대한 응답으로 nextPageToken 매개변수에서 반환된 값이어야 합니다. |
pageSize |
페이지 크기는 페이징용이며 반환되는 최대 행 수를 지정합니다. 페이지 크기는 >= 0이어야 합니다. 쿼리는 기본값인 1,000행을 반환합니다. Analytics Core Reporting API는 요청하는 수와 상관없이 요청당 최대 100,000개의 행을 반환합니다. 또한 측정기준 세그먼트가 예상보다 적으면 요청된 행보다 적은 행이 반환될 수도 있습니다. 예를 들어 |
includeEmptyRows |
false로 설정된 경우 검색된 모든 측정항목이 0인 경우 응답에 행이 포함되지 않습니다. 기본값은 false이며, 이러한 행이 제외됩니다. |
hideTotals |
True로 설정되면 모든 기간에 대해 일치하는 모든 행의 모든 측정항목의 총계가 숨겨집니다. 기본값은 false이며 총계를 반환합니다. |
hideValueRanges |
True로 설정되면 일치하는 모든 행에서 최소 및 최대 값이 숨겨집니다. 기본값은 false이며 값 범위가 반환됩니다. |
샘플링
샘플링 수준의 값입니다.
열거형 | |
---|---|
SAMPLING_UNSPECIFIED |
samplingLevel 필드가 지정되지 않으면 DEFAULT 샘플링 수준이 사용됩니다. |
DEFAULT |
속도와 정확도가 균형을 이루는 샘플 크기가 포함된 응답을 반환합니다. |
SMALL |
더 작은 샘플링 크기로 빠른 응답을 반환합니다. |
LARGE |
큰 샘플링 크기를 사용하여 더 정확한 응답을 반환합니다. 이로 인해 응답 속도가 느려질 수 있습니다. |
측정기준
측정기준은 데이터의 속성입니다. 예를 들어 ga:city
측정기준은 세션이 발생한 도시(예: '파리' 또는 '뉴욕')를 나타냅니다.
JSON 표현 | |
---|---|
{ "name": string, "histogramBuckets": [ string ] } |
필드 | |
---|---|
name |
가져올 측정기준의 이름입니다(예: |
histogramBuckets[] |
비어 있지 않은 경우 측정기준 값을 문자열 다음에 int64로 배치합니다. 적분값의 문자열 표현이 아닌 측정기준 값은 0으로 변환됩니다. 버킷 값은 오름차순이어야 합니다. 각 버킷은 아래쪽에서 닫히고 상단에서는 열립니다. '첫 번째' 버킷에는 첫 번째 경계보다 작은 모든 값이 포함되어 있고, '마지막' 버킷에는 무한대까지의 모든 값이 포함되어 있습니다. 버킷에 속하는 측정기준 값은 새 측정기준 값으로 변환됩니다. 예를 들어, '0, 1, 3, 4, 7'의 목록이 제공되면 다음 버킷을 반환합니다.
참고: 측정기준에 히스토그램 변형을 적용하고 해당 측정기준을 정렬에 사용하는 경우 해당 목적에는 정렬 유형 50~1000, 121~1000, 50~120 오름차순 50-120, 121-1000, 1001+1001, 클라이언트는 히스토그램 변형된 측정기준에 대해 |
측정기준 필터 절
측정기준 필터의 그룹입니다. 필터 값을 논리적으로 조합하는 방법을 지정하려면 연산자 값을 설정합니다.
JSON 표현 | |
---|---|
{ "operator": enum( |
필드 | |
---|---|
operator |
여러 측정기준 필터를 결합하는 연산자입니다. 지정하지 않으면 |
filters[] |
반복되는 필터 집합입니다. 지정된 연산자를 기반으로 논리적으로 결합됩니다. |
FilterLogicalOperator
필터를 논리적으로 조합하는 방법입니다.
열거형 | |
---|---|
OPERATOR_UNSPECIFIED |
연산자가 지정되지 않았습니다. OR 로 처리됩니다. |
OR |
논리적 OR 연산자입니다. |
AND |
논리적 AND 연산자입니다. |
측정기준 필터
측정기준 필터는 측정기준에 필터링 옵션을 지정합니다.
JSON 표현 | |
---|---|
{
"dimensionName": string,
"not": boolean,
"operator": enum( |
필드 | |
---|---|
dimensionName |
필터링할 측정기준입니다. 측정기준 필터는 측정기준을 포함해야 합니다. |
not |
논리적 |
operator |
측정기준을 표현식과 일치시키는 방법 기본값은 REGEXP입니다. |
expressions[] |
일치시킬 문자열 또는 정규 표현식입니다. |
caseSensitive |
대소문자를 구분해야 하나요? 기본값은 false입니다. |
연산자
다양한 검색 유형이 지원됩니다.
열거형 | |
---|---|
OPERATOR_UNSPECIFIED |
검색 유형을 지정하지 않으면 REGEXP 으로 처리됩니다. |
REGEXP |
일치 표현식은 정규 표현식으로 처리됩니다. 모든 검색 유형은 정규 표현식으로 처리되지 않습니다. |
BEGINS_WITH |
제공된 일치 표현식으로 시작하는 값과 일치합니다. |
ENDS_WITH |
제공된 일치 표현식으로 끝나는 값과 일치합니다. |
PARTIAL |
하위 문자열 일치 |
EXACT |
값은 일치 표현식과 완전히 일치해야 합니다. |
NUMERIC_EQUAL |
정수 비교 필터입니다. 이러한 경우 대소문자 구분이 무시되고 표현식이 정수를 나타내는 문자열로 간주됩니다. 실패 조건:
|
NUMERIC_GREATER_THAN |
측정기준이 일치 표현식보다 큰지 확인합니다. 제한사항은 NUMERIC_EQUALS 설명을 참고하세요. |
NUMERIC_LESS_THAN |
측정기준이 일치 표현식보다 작은지 확인합니다. 제한사항은 NUMERIC_EQUALS 설명을 참고하세요. |
IN_LIST |
이 옵션은 표현식이 선택한 값 목록에서 모든 값을 취할 수 있는 측정기준 필터를 지정하는 데 사용됩니다. 이렇게 하면 모든 단일 응답 행에 OR이 적용되는 일치검색 측정기준 필터를 여러 개 평가하지 않아도 됩니다. 예를 들면 다음과 같습니다.
측정기준의 값이 A, B 또는 C인 응답 행은 이 DimensionFilter와 일치합니다. |
측정항목
측정항목은 정량적 측정값입니다. 예를 들어 ga:users
측정항목은 요청된 기간의 총 사용자 수를 나타냅니다.
JSON 표현 | |
---|---|
{
"expression": string,
"alias": string,
"formattingType": enum( |
필드 | |
---|---|
expression |
요청의 측정항목 표현식입니다. 표현식은 하나 이상의 측정항목 및 숫자로 구성됩니다. 허용되는 연산자로는 더하기 (+), 빼기 (-), 부정 (단항 -), 나눗셈 (/), 곱하기 (*), 괄호, 양의 카디널 숫자 (0~9)가 포함되며 소수점 이하 1024자까지만 허용됩니다. |
alias |
측정항목 표현식의 별칭은 표현식의 대체 이름입니다. 별칭은 필터링 및 정렬에 사용할 수 있습니다. 이 필드는 선택사항이며, 표현식이 단일 측정항목이 아니라 필터링 및 정렬에 사용할 수 없는 복잡한 표현식인 경우에 유용합니다. 별칭은 응답 열 헤더에도 사용됩니다. |
formattingType |
측정항목 표현식의 형식을 지정합니다(예: |
MetricType
측정항목의 유형입니다.
열거형 | |
---|---|
METRIC_TYPE_UNSPECIFIED |
측정항목 유형이 지정되지 않았습니다. |
INTEGER |
정수 측정항목입니다. |
FLOAT |
부동 측정항목입니다. |
CURRENCY |
통화 측정항목입니다. |
PERCENT |
백분율 측정항목 |
TIME |
HH:MM:SS 형식의 시간 측정항목입니다. |
측정항목 필터 절
측정항목 필터 그룹을 나타냅니다. 필터 값을 논리적으로 조합하는 방법을 지정하려면 연산자 값을 설정합니다.
JSON 표현 | |
---|---|
{ "operator": enum( |
필드 | |
---|---|
operator |
여러 측정항목 필터를 결합하는 연산자입니다. 지정하지 않으면 |
filters[] |
반복되는 필터 집합입니다. 지정된 연산자를 기반으로 논리적으로 결합됩니다. |
측정항목 필터
MetricFilter는 측정항목에 필터를 지정합니다.
JSON 표현 | |
---|---|
{
"metricName": string,
"not": boolean,
"operator": enum( |
필드 | |
---|---|
metricName |
필터링할 측정항목입니다. metricFilter에는 측정항목 이름이 포함되어야 합니다. 측정항목 이름은 이전에 측정항목으로 정의된 별칭이거나 측정항목 표현식일 수도 있습니다. |
not |
논리적 |
operator |
|
comparisonValue |
비교할 값입니다. |
연산자
다양한 비교 유형 옵션
열거형 | |
---|---|
OPERATOR_UNSPECIFIED |
연산자를 지정하지 않으면 EQUAL 로 처리됩니다. |
EQUAL |
측정항목의 값이 비교 값과 정확하게 일치해야 합니다. |
LESS_THAN |
측정항목 값이 비교 값보다 작아야 합니다. |
GREATER_THAN |
측정항목 값이 비교 값보다 커야 합니다. |
IS_MISSING |
측정항목이 누락되었는지 확인합니다. 비교 가치는 고려하지 않습니다. |
OrderBy
정렬 옵션을 지정합니다.
JSON 표현 | |
---|---|
{ "fieldName": string, "orderType": enum( |
필드 | |
---|---|
fieldName |
정렬 기준으로 사용되는 필드입니다. 기본 정렬 순서는 오름차순입니다. 예: |
orderType |
주문 유형입니다. 기본 orderType은 |
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 는 세그먼트는 DynamicSegment를 사용하거나 동적으로 제공된 세그먼트 또는 맞춤 세그먼트의 ID를 사용하여 동적으로 정의할 수 있습니다. dynamicOrById 은 다음 중 하나여야 합니다. |
||
dynamicSegment |
요청의 동적 세그먼트 정의입니다. |
|
segmentId |
기본 제공 세그먼트 또는 맞춤 세그먼트의 세그먼트 ID입니다(예: |
동적 세그먼트
요청 내에서 세그먼트를 정의하는 동적 세그먼트 정의입니다. 세그먼트는 사용자, 세션 또는 둘 다를 선택할 수 있습니다.
JSON 표현 | |
---|---|
{ "name": string, "userSegment": { object( |
필드 | |
---|---|
name |
동적 세그먼트의 이름입니다. |
userSegment |
사용자 세그먼트를 선택하여 세그먼트에 포함할 사용자를 선택합니다. |
sessionSegment |
세션 세그먼트를 선택하여 세그먼트에 포함할 세션 세그먼트 |
세그먼트 정의
SegmentDefinition은 세그먼트를 논리적 AND
작업과 결합하는 SegmentFilter의 집합으로 정의합니다.
JSON 표현 | |
---|---|
{
"segmentFilters": [
{
object( |
필드 | |
---|---|
segmentFilters[] |
세그먼트는 논리적 |
세그먼트 필터
SegmentFilter는 세그먼트를 단순 세그먼트 또는 시퀀스 세그먼트로 정의합니다. 간단한 세그먼트 조건에는 세션 또는 사용자를 선택하는 측정기준 및 측정항목 조건이 포함됩니다. 시퀀스 세그먼트 조건을 사용하여 순차 조건에 따라 사용자 또는 세션을 선택할 수 있습니다.
JSON 표현 | |
---|---|
{ "not": boolean, // Union field |
필드 | ||
---|---|---|
not |
참인 경우 단순 세그먼트 또는 시퀀스 세그먼트 보완과 일치합니다. 예를 들어 '뉴욕'에서 발생하지 않은 모든 방문을 일치시키기 위해 다음과 같이 세그먼트를 정의할 수 있습니다.
|
|
통합 필드 simpleOrSequence 는 단순 세그먼트인가요, 시퀀스 세그먼트 정의인가요? simpleOrSequence 은 다음 중 하나여야 합니다. |
||
simpleSegment |
단순 세그먼트 조건은 결합될 수 있는 하나 이상의 측정기준/측정항목 조건으로 구성됩니다. |
|
sequenceSegment |
시퀀스 조건은 하나 이상의 단계로 구성되며, 각 단계는 하나 이상의 측정기준/측정항목 조건으로 정의됩니다. 여러 단계를 특수 시퀀스 연산자와 결합할 수 있습니다. |
단순 세그먼트
단순 세그먼트 조건은 결합될 수 있는 하나 이상의 측정기준/측정항목 조건으로 구성됩니다.
JSON 표현 | |
---|---|
{
"orFiltersForSegment": [
{
object( |
필드 | |
---|---|
orFiltersForSegment[] |
논리적 |
OR필터용 세그먼트
OR
그룹의 세그먼트 필터 목록이 논리 OR 연산자로 결합됩니다.
JSON 표현 | |
---|---|
{
"segmentFilterClauses": [
{
object( |
필드 | |
---|---|
segmentFilterClauses[] |
|
세그먼트 필터 절
세그먼트 정의에 사용할 필터 절은 측정항목 또는 측정기준 필터를 사용할 수 있습니다.
JSON 표현 | |
---|---|
{ "not": boolean, // Union field |
필드 | ||
---|---|---|
not |
필터의 보수( |
|
통합 필드 dimensionOrMetricFilter 는 측정기준 또는 측정항목 필터 dimensionOrMetricFilter 은 다음 중 하나여야 합니다. |
||
dimensionFilter |
세그먼트 정의에 대한 측정기준 필터입니다. |
|
metricFilter |
세그먼트 정의에 대한 측정항목 필터입니다. |
세그먼트 측정기준 필터
측정기준 필터는 측정기준에 필터링 옵션을 지정합니다.
JSON 표현 | |
---|---|
{
"dimensionName": string,
"operator": enum( |
필드 | |
---|---|
dimensionName |
필터를 적용할 측정기준의 이름입니다. |
operator |
측정기준을 표현식과 일치시키는 데 사용할 연산자입니다. |
caseSensitive |
일치는 대소문자를 구분하며 |
expressions[] |
표현식 목록, 모든 연산자에 첫 번째 요소만 사용됨 |
minComparisonValue |
|
maxComparisonValue |
|
연산자
다양한 검색 유형이 지원됩니다.
열거형 | |
---|---|
OPERATOR_UNSPECIFIED |
검색 유형을 지정하지 않으면 REGEXP로 처리됩니다. |
REGEXP |
일치 표현식은 정규 표현식으로 처리됩니다. 다른 모든 검색 유형은 정규 표현식으로 처리되지 않습니다. |
BEGINS_WITH |
제공된 일치 표현식으로 시작하는 값과 일치합니다. |
ENDS_WITH |
제공된 일치 표현식으로 끝나는 값과 일치합니다. |
PARTIAL |
하위 문자열 일치 |
EXACT |
값은 일치 표현식과 완전히 일치해야 합니다. |
IN_LIST |
이 옵션은 표현식이 선택한 값 목록에서 모든 값을 취할 수 있는 측정기준 필터를 지정하는 데 사용됩니다. 이렇게 하면 모든 단일 응답 행에 OR이 적용되는 일치검색 측정기준 필터를 여러 개 평가하지 않아도 됩니다. 예를 들면 다음과 같습니다.
측정기준의 값이 A, B 또는 C인 응답 행은 이 DimensionFilter와 일치합니다. |
NUMERIC_LESS_THAN |
정수 비교 필터입니다. 이러한 경우 대소문자 구분이 무시되고 표현식이 정수를 나타내는 문자열로 간주됩니다. 실패 조건:
측정기준이 일치 표현식보다 작은지 확인합니다. |
NUMERIC_GREATER_THAN |
측정기준이 일치 표현식보다 큰지 확인합니다. |
NUMERIC_BETWEEN |
측정기준이 일치 표현식의 최솟값과 최댓값 사이의 숫자인지, 경계가 제외되었는지 확인합니다. |
세그먼트 측정항목 필터
세그먼트 필터 절에서 사용할 측정항목 필터입니다.
JSON 표현 | |
---|---|
{ "scope": enum( |
필드 | |
---|---|
scope |
측정항목의 범위는 측정항목이 정의된 수준을 정의합니다. 지정된 측정항목 범위는 데이터 모델에 정의된 기본 범위와 같거나 그보다 커야 합니다. 기본 범위는 세그먼트가 사용자 또는 세션을 선택하는지를 통해 정의됩니다. |
metricName |
필터링할 측정항목입니다. |
operator |
측정항목을 비교하기 위해 수행할 작업입니다. 기본값은 |
comparisonValue |
비교할 값입니다. 연산자가 |
maxComparisonValue |
최대 비교 값은 |
범위
측정항목의 범위는 측정항목이 정의된 수준을 정의합니다(PRODUCT
, HIT
, SESSION
또는 USER
). 측정항목 값은 기본 범위보다 큰 범위에서 보고될 수도 있습니다. 예: ga:pageviews
및 ga:transactions
는 해당 세션에서 발생하는 각 조회 또는 해당 사용자에 대해서 추가하여 SESSION
및 USER
수준에서 보고할 수 있습니다.
열거형 | |
---|---|
UNSPECIFIED_SCOPE |
범위가 지정되지 않은 경우 세그먼트가 사용자 또는 세션을 선택하려고 하는지에 따라 USER 또는 SESSION 조건 범위가 기본값으로 지정됩니다. |
PRODUCT |
제품 범위 |
HIT |
조회 범위 |
SESSION |
세션 범위입니다. |
USER |
사용자 범위 |
연산자
다양한 비교 유형 옵션
열거형 | |
---|---|
UNSPECIFIED_OPERATOR |
지정되지 않은 연산자는 LESS_THAN 연산자로 간주됩니다. |
LESS_THAN |
측정항목 값이 비교 값보다 작은지 확인합니다. |
GREATER_THAN |
측정항목 값이 비교 값보다 큰지 확인합니다. |
EQUAL |
같음 연산자 |
BETWEEN |
연산자 간에는 최솟값과 최댓값이 모두 배타적입니다. LT 및 GT 를 사용하여 비교합니다. |
시퀀스 세그먼트
시퀀스 조건은 하나 이상의 단계로 구성되며, 각 단계는 하나 이상의 측정기준/측정항목 조건으로 정의됩니다. 여러 단계를 특수 시퀀스 연산자와 결합할 수 있습니다.
JSON 표현 | |
---|---|
{
"segmentSequenceSteps": [
{
object( |
필드 | |
---|---|
segmentSequenceSteps[] |
시퀀스의 단계 목록입니다. |
firstStepShouldMatchFirstHit |
설정된 경우 첫 번째 단계 조건은 방문자의 첫 번째 조회와 일치해야 합니다 (기간). |
세그먼트 시퀀스 단계
세그먼트 시퀀스 정의입니다.
JSON 표현 | |
---|---|
{ "orFiltersForSegment": [ { object( |
필드 | |
---|---|
orFiltersForSegment[] |
시퀀스는 |
matchType |
단계의 바로 앞 또는 다음 단계 이전 단계일 수 있습니다. |
MatchType
시퀀스의 검색 유형입니다.
열거형 | |
---|---|
UNSPECIFIED_MATCH_TYPE |
지정되지 않은 검색 유형은 선행으로 처리됩니다. |
PRECEDES |
연산자는 이전 단계가 다음 단계보다 이전임을 나타냅니다. |
IMMEDIATELY_PRECEDES |
연산자는 이전 단계가 다음 단계 바로 앞에 있음을 나타냅니다. |
피봇
피봇은 요청의 피봇 섹션을 설명합니다. 피봇을 사용하면 두 번째 측정기준에서 데이터를 피봇하여 특정 보고서의 표에 있는 정보를 재정렬할 수 있습니다.
JSON 표현 | |
---|---|
{ "dimensions": [ { object( |
필드 | |
---|---|
dimensions[] |
피봇 열로 표시할 측정기준 목록입니다. 한 피봇에는 최대 4개의 측정기준을 포함할 수 있습니다. 피봇 측정기준은 요청에서 허용되는 총 측정기준 수에 관한 제한사항의 일부입니다. |
dimensionFilterClauses[] |
DimensionFilterClauses는 논리적으로 |
metrics[] |
피봇 측정항목입니다. 피봇 측정항목은 요청에서 허용되는 총 측정항목 수에 관한 제한사항의 일부입니다. |
startGroup |
k 측정항목이 요청된 경우 응답에 보고서에 k열의 여러 데이터 종속 항목이 포함됩니다. 예를 들어 다음과 같은 경우 응답에 포함할 k열 그룹을 선택할 수 있습니다. |
maxGroupCount |
반환할 최대 그룹 수를 지정합니다. 기본값은 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( |
필드 | |
---|---|
cohorts[] |
동질 집단의 정의입니다. |
lifetimeValue |
평생 가치 (LTV)를 사용 설정합니다. LTV는 다양한 채널을 통해 획득한 사용자의 평생 가치를 측정합니다. 동질 집단 분석 및 평생 가치를 참고하세요. 평생 가치의 값이 거짓인 경우:
lifecycleValue가 true인 경우:
|
동질 집단
동질 집단을 정의합니다. 동질 집단이란 공통된 특징을 가진 사용자 그룹을 말합니다. 예를 들어 획득 날짜가 동일한 사용자는 모두 같은 동질 집단에 속합니다.
JSON 표현 | |
---|---|
{ "name": string, "type": enum( |
필드 | |
---|---|
name |
동질 집단의 고유한 이름입니다. 정의되지 않은 경우 동질 집단_[1234...] 값을 사용하여 이름이 자동 생성됩니다. |
type |
동질 집단의 유형입니다. 현재 지원되는 유일한 유형은 |
dateRange |
|
유형
동질 집단 유형입니다.
열거형 | |
---|---|
UNSPECIFIED_COHORT_TYPE |
지정하지 않으면 FIRST_VISIT_DATE 로 처리됩니다. |
FIRST_VISIT_DATE |
첫 방문 날짜를 기준으로 선택된 사용자 집단 |
신고
요청에 해당하는 데이터 응답입니다.
JSON 표현 | |
---|---|
{ "columnHeader": { object( |
필드 | |
---|---|
columnHeader |
열 헤더입니다. |
data |
응답 데이터 |
nextPageToken |
목록의 다음 결과 페이지를 검색하는 페이지 토큰입니다. |
열 헤더
열 헤더
JSON 표현 | |
---|---|
{
"dimensions": [
string
],
"metricHeader": {
object( |
필드 | |
---|---|
dimensions[] |
응답의 측정기준 이름입니다. |
metricHeader |
응답의 측정항목에 대한 측정항목 헤더입니다. |
MetricHeader
측정항목의 헤더입니다.
JSON 표현 | |
---|---|
{ "metricHeaderEntries": [ { object( |
필드 | |
---|---|
metricHeaderEntries[] |
응답의 측정항목에 대한 헤더입니다. |
pivotHeaders[] |
응답의 피봇 헤더입니다. |
측정항목 헤더 항목
측정항목의 헤더입니다.
JSON 표현 | |
---|---|
{
"name": string,
"type": enum( |
필드 | |
---|---|
name |
헤더의 이름입니다. |
type |
측정항목의 유형입니다(예: |
PivotHeader
요청에 정의된 각 피봇 섹션의 헤더입니다.
JSON 표현 | |
---|---|
{
"pivotHeaderEntries": [
{
object( |
필드 | |
---|---|
pivotHeaderEntries[] |
단일 피봇 섹션 헤더입니다. |
totalPivotGroupsCount |
이 피봇의 총 그룹 수입니다. |
PivotHeaderEntry
응답의 피봇 섹션에 요청된 측정항목에 해당하는 각 측정항목 열의 헤더입니다.
JSON 표현 | |
---|---|
{
"dimensionNames": [
string
],
"dimensionValues": [
string
],
"metric": {
object( |
필드 | |
---|---|
dimensionNames[] |
피봇 응답의 측정기준 이름입니다. |
dimensionValues[] |
피봇의 측정기준 값입니다. |
metric |
피벗 측정항목의 측정항목 헤더입니다. |
보고서 데이터
보고서의 데이터 부분입니다.
JSON 표현 | |
---|---|
{ "rows": [ { object( |
필드 | |
---|---|
rows[] |
모든 측정기준 조합에 대한 하나의 ReportRow가 있습니다. |
totals[] |
요청된 각 기간에 대해 쿼리와 일치하는 모든 행 집합에서 요청된 모든 값 형식의 합계가 집계됩니다. 값 형식의 합계는 먼저 값 형식에 언급된 측정항목의 합계를 구한 후 값 형식을 스칼라 표현식으로 평가하여 계산합니다. 예: |
rowCount |
이 쿼리와 일치하는 총 행 수입니다. |
minimums[] |
일치하는 모든 행에 표시된 최솟값 및 최댓값입니다. 요청의 |
maximums[] |
일치하는 모든 행에 표시된 최솟값 및 최댓값입니다. 요청의 |
samplesReadCounts[] |
결과가 샘플링되면 기간당 한 항목씩 읽은 총 샘플 수가 반환됩니다. 결과가 샘플링되지 않으면 이 필드가 정의되지 않습니다. 자세한 내용은 개발자 가이드를 참고하세요. |
samplingSpaceSizes[] |
결과가 샘플링되면 기간당 항목 한 개가 반환되어 총 샘플 수가 반환됩니다. 결과가 샘플링되지 않으면 이 필드가 정의되지 않습니다. 자세한 내용은 개발자 가이드를 참고하세요. |
isDataGolden |
이 요청에 대한 응답이 골든인지 여부를 나타냅니다. 나중에 동일한 요청을 해도 새로운 요청이 생성되지 않는 경우 데이터는 황금색이 됩니다. |
dataLastRefreshed |
보고서의 데이터가 마지막으로 새로고침된 시간입니다. 이 타임스탬프 이전에 발생한 모든 조회가 보고서 계산에 포함됩니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프로 정밀도는 나노초 수준입니다. 예: |
보고서 행
보고서의 행입니다.
JSON 표현 | |
---|---|
{
"dimensions": [
string
],
"metrics": [
{
object( |
필드 | |
---|---|
dimensions[] |
요청된 측정기준의 목록입니다. |
metrics[] |
요청된 각 기간의 측정항목 목록입니다. |
기간 값
단일 기간 / 측정기준 조합의 측정항목 목록을 반환하는 데 사용됩니다.
JSON 표현 | |
---|---|
{
"values": [
string
],
"pivotValueRegions": [
{
object( |
필드 | |
---|---|
values[] |
각 값은 요청의 각 측정항목에 해당합니다. |
pivotValueRegions[] |
각 피봇 영역의 값입니다. |
피봇 값 리전
피봇 리전의 측정항목 값입니다.
JSON 표현 | |
---|---|
{ "values": [ string ] } |
필드 | |
---|---|
values[] |
각 피봇 지역의 측정항목의 값입니다. |
나머지 리소스 할당량
요청이 완료된 후 속성에 남아 있는 리소스 할당량 토큰입니다.
JSON 표현 | |
---|---|
{ "dailyQuotaTokensRemaining": number, "hourlyQuotaTokensRemaining": number } |
필드 | |
---|---|
dailyQuotaTokensRemaining |
남은 일일 리소스 할당량이 있습니다. |
hourlyQuotaTokensRemaining |
시간당 리소스 할당량 토큰이 남았습니다. |