- HTTP 요청
- 경로 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- 기간
- 유입경로
- 유입경로 단계
- FunnelFilterExpression
- FunnelFilterExpressionList
- FunnelFieldFilter
- 문자열 필터
- MatchType
- InListFilter
- NumericFilter
- 작업
- NumericValue
- BetweenFilter
- 유입경로 이벤트 필터
- FunnelParameterFilterExpression
- FunnelParameterFilterExpressionList
- FunnelParameterFilter
- 유입경로 분석
- 측정기준
- DimensionExpression
- CaseExpression
- ConcatenateExpression
- FunnelNextAction
- 유입경로 시각화 유형
- 세그먼트
- 사용자 세그먼트
- UserSegmentCriteria
- UserSegmentConditionGroup
- 사용자 기준 범위 지정
- SegmentFilterExpression
- SegmentFilterExpressionList
- SegmentFilter
- SegmentFilterScoping
- SegmentEventFilter
- SegmentParameterFilterExpression
- SegmentParameterFilterExpressionList
- SegmentParameterFilter
- SegmentParameterFilterScoping
- UserSegmentSequenceGroup
- UserSequenceStep
- UserSegmentExclusion
- 사용자 제외 기간
- SessionSegment
- SessionSegmentCriteria
- SessionSegmentConditionGroup
- 세션 기준 범위 지정
- SessionSegmentExclusion
- SessionExclusionDuration을
- 이벤트 세그먼트
- EventSegmentCriteria
- EventSegmentConditionGroup
- EventCriteriaScoping
- EventSegmentExclusion
- EventExclusionDuration을
- FilterExpression
- FilterExpressionList
- 필터
- 유입경로 하위 보고서
- DimensionHeader
- MetricHeader
- 측정항목 유형
- 행
- DimensionValue
- MetricValue
- FunnelResponseMetadata
- SamplingMetadata
- PropertyQuota
- QuotaStatus
- 실습
Google 애널리틱스 이벤트 데이터의 맞춤 유입경로 보고서를 반환합니다. API에서 반환되는 데이터는 요청된 측정기준 및 측정항목의 열이 있는 표입니다.
유입경로 탐색 분석을 사용하면 사용자가 작업을 완료하기 위해 실행하는 단계를 시각적으로 확인하고 단계별 작업 완료 또는 실패 여부를 신속하게 확인할 수 있습니다. 예를 들어 어떻게 하면 잠재고객이 소핑객이 되고 다시 구매자가 될까요? 어떻게 하면 일회성 구매자가 반복 구매자가 될까요? 이 정보를 활용하면 비효율적이거나 이탈이 발생한 고객 여정을 개선할 수 있습니다. 자세한 내용은 GA4 유입경로 탐색 분석을 참고하세요.
이 메서드는 알파 버전을 출시할 만큼 안정적일 때, 베타를 시작하기 전 구문 및 기능에 대한 의견을 수집하기 위해 도입됩니다. 이 API에 대한 의견을 보내려면 Google 애널리틱스 Data API 유입경로 보고서 의견을 작성하세요.
HTTP 요청
POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
property |
이벤트가 추적되는 Google 애널리틱스 GA4 속성 식별자입니다. 본문이 아닌 URL 경로에 지정됩니다. 자세한 내용은 속성 ID를 찾을 수 있는 위치를 참고하세요. 일괄 요청 내에서 이 속성은 지정되지 않거나 일괄 수준 속성과 일관되어야 합니다. 예: properties/1234 |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "dateRanges": [ { object ( |
필드 | |
---|---|
dateRanges[] |
읽을 데이터의 기간입니다. 여러 기간이 요청되면 각 응답 행에 0 기반 기간 색인이 포함됩니다. 두 기간이 겹치는 경우 겹치는 날짜의 이벤트 데이터가 두 기간의 응답 행에 포함됩니다. |
funnel |
이 요청의 유입경로 구성입니다. 이 유입경로 구성은 필수 항목입니다. |
funnelBreakdown |
지정된 경우 이 분류는 유입경로 표 하위 보고서 응답에 측정기준을 추가합니다. 이 분석 측정기준은 각 유입경로 단계를 세부 측정기준의 고유한 값으로 확장합니다. 예를 들어 |
funnelNextAction |
지정된 경우 다음 액션은 유입경로 시각화 하위 보고서 응답에 측정기준을 추가합니다. 이 다음 액션 측정기준은 각 유입경로 단계를 다음 액션의 고유한 값으로 확장합니다. 예를 들어 다음 작업은 |
funnelVisualizationType |
유입경로 시각화 유형은 유입경로 시각화 하위 보고서 응답에 표시되는 측정기준을 제어합니다. 지정하지 않으면 |
segments[] |
세그먼트의 구성입니다. 세그먼트는 속성 데이터의 하위 집합입니다. 세그먼트가 포함된 유입경로 보고서에서 유입경로는 각 세그먼트에서 평가됩니다. 이 요청에 지정된 각 세그먼트는 응답에서 별도의 행을 생성하며, 응답에서 각 세그먼트는 이름으로 식별됩니다. 세그먼트 매개변수는 선택사항입니다. 요청은 최대 4개까지 세그먼트로 제한됩니다. |
limit |
반환할 행의 개수입니다. 지정하지 않으면 10,000개의 행이 반환됩니다. API는 요청 수와 관계없이 요청당 최대 250,000개의 행을 반환합니다. API는 측정기준 값이 |
dimensionFilter |
측정기준 필터를 사용하면 보고서에서 특정 측정기준 값만 요청할 수 있습니다. 자세한 내용은 보고서 만들기: 측정기준 필터를 참고하세요. 이 필터에는 측정항목을 사용할 수 없습니다. |
returnPropertyQuota |
이 애널리틱스 속성 할당량의 현재 상태를 반환할지 여부를 전환합니다. 할당량은 PropertyQuota에 반환됩니다. |
응답 본문
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
유입경로 보고서 응답에는 2개의 하위 보고서가 포함됩니다. 두 개의 하위 보고서는 측정기준 및 측정항목의 조합입니다.
JSON 표현 |
---|
{ "funnelTable": { object ( |
필드 | |
---|---|
funnelTable |
유입경로 표는 유입경로 단계, 세그먼트, 세부 측정기준, 활성 사용자, 완료율, 이탈률 및 이탈률이 포함된 보고서입니다. 세그먼트가 요청된 경우에만 이 응답에 세그먼트 측정기준이 표시됩니다. 세부 측정기준은 요청된 경우에만 이 응답에 표시됩니다. |
funnelVisualization |
유입경로 시각화는 유입경로 단계, 세그먼트, 날짜, 다음 액션 측정기준, 활성 사용자가 포함된 보고서입니다. 세그먼트가 요청된 경우에만 이 응답에 세그먼트 측정기준이 표시됩니다. 날짜 측정기준은 |
propertyQuota |
이 요청을 포함한 이 애널리틱스 속성의 할당량 상태입니다. |
kind |
이 메시지의 리소스 유형을 식별합니다. 이 |
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
DateRange
연속된 날짜(startDate, startDate + 1, ..., endDate)입니다. 요청은 최대 4개의 기간으로 허용됩니다.
JSON 표현 |
---|
{ "startDate": string, "endDate": string, "name": string } |
필드 | |
---|---|
startDate |
|
endDate |
|
name |
이 기간에 이름을 할당합니다. 측정기준( |
유입경로
유입경로 보고서 요청에서 유입경로를 구성합니다. 유입경로는 사용자가 여러 단계를 거치는 과정을 보고합니다.
유입경로 탐색 분석을 사용하면 사용자가 작업을 완료하기 위해 실행하는 단계를 시각적으로 확인하고 단계별 작업 완료 또는 실패 여부를 신속하게 확인할 수 있습니다. 예를 들어 어떻게 하면 잠재고객이 소핑객이 되고 다시 구매자가 될까요? 어떻게 하면 일회성 구매자가 반복 구매자가 될까요? 이 정보를 활용하면 비효율적이거나 이탈이 발생한 고객 여정을 개선할 수 있습니다.
JSON 표현 |
---|
{
"isOpenFunnel": boolean,
"steps": [
{
object ( |
필드 | |
---|---|
isOpenFunnel |
개방형 유입경로에서는 사용자가 어느 단계에서나 유입경로에 진입할 수 있으며, 폐쇄형 유입경로에서는 사용자가 첫 번째 단계에서 유입경로에 진입해야 합니다. 선택사항입니다. 지정하지 않으면 닫힌 유입경로가 사용됩니다. |
steps[] |
이 유입경로의 순차적 단계 |
유입경로 단계
단계는 측정할 사용자 여정을 정의합니다. 단계에는 사용자가 유입경로 여정의 해당 단계에 포함되기 위해 충족해야 하는 조건이 하나 이상 포함되어 있습니다.
JSON 표현 |
---|
{
"name": string,
"isDirectlyFollowedBy": boolean,
"filterExpression": {
object ( |
필드 | |
---|---|
name |
이 단계의 고유한 이름입니다. 지정하지 않으면 색인이 1부터 색인이 생성된 이름 (예: '0. ", "1. ' 등). 이 이름은 |
isDirectlyFollowedBy |
true인 경우 이 단계는 이전 단계를 직접 따라야 합니다. false인 경우 이전 단계와 이 단계 사이에 이벤트가 있을 수 있습니다. 지정하지 않으면 |
filterExpression |
사용자가 유입경로 여정의 이 단계에 포함되기 위해 충족해야 하는 조건입니다. |
withinDurationFromPriorStep |
지정된 경우 이 단계는 이전 단계를 완료한 기간 내에 완료되어야 합니다.
초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 ' |
유입경로 필터 표현식
유입경로 필터 조합을 표현합니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 expr 는 FunnelFilterExpression 에 대해 한 가지 유형의 필터를 지정합니다. expr 은 다음 중 하나여야 합니다. |
|
andGroup |
|
orGroup |
|
notExpression |
FunnelFilterExpression이 |
funnelFieldFilter |
측정기준 또는 측정항목에 대한 유입경로 필터 |
funnelEventFilter |
단일 이벤트 이름의 이벤트와 일치하는 필터를 만듭니다. 매개변수 필터 표현식이 지정된 경우 단일 이벤트 이름 및 매개변수 필터 표현식과 모두 일치하는 이벤트의 하위 집합만 이 이벤트 필터와 일치합니다. |
유입경로 필터 표현식 목록
유입경로 필터 표현식 목록입니다.
JSON 표현 |
---|
{
"expressions": [
{
object ( |
필드 | |
---|---|
expressions[] |
유입경로 필터 표현식 목록입니다. |
유입경로 필드 필터
측정기준 또는 측정항목 값을 필터링하는 표현식입니다.
JSON 표현 |
---|
{ "fieldName": string, // Union field |
필드 | |
---|---|
fieldName |
측정기준 이름 또는 측정항목 이름입니다. |
통합 필드 one_filter 는 필터 유형을 지정합니다. one_filter 은 다음 중 하나여야 합니다. |
|
stringFilter |
문자열 관련 필터입니다. |
inListFilter |
목록 값의 필터입니다. |
numericFilter |
숫자 또는 날짜 값에 대한 필터. |
betweenFilter |
두 값 사이의 필터입니다. |
문자열 필터
문자열을 위한 필터
JSON 표현 |
---|
{
"matchType": enum ( |
필드 | |
---|---|
matchType |
이 필터의 검색 유형입니다. |
value |
일치에 사용되는 문자열 값입니다. |
caseSensitive |
true인 경우 문자열 값은 대소문자를 구분합니다. |
MatchType
문자열 필터의 일치 유형
열거형 | |
---|---|
MATCH_TYPE_UNSPECIFIED |
미지정 |
EXACT |
문자열 값과 정확하게 일치합니다. |
BEGINS_WITH |
문자열 값으로 시작합니다. |
ENDS_WITH |
문자열 값으로 끝납니다. |
CONTAINS |
문자열 값을 포함합니다. |
FULL_REGEXP |
문자열 값이 있는 정규 표현식과 완전히 일치합니다. |
PARTIAL_REGEXP |
문자열 값이 있는 정규 표현식과 부분적으로 일치합니다. |
목록 내 필터
결과는 문자열 값 목록에 있어야 합니다.
JSON 표현 |
---|
{ "values": [ string ], "caseSensitive": boolean } |
필드 | |
---|---|
values[] |
문자열 값의 목록입니다. 비워 둘 수 없습니다. |
caseSensitive |
true인 경우 문자열 값은 대소문자를 구분합니다. |
숫자 필터
숫자 또는 날짜 값에 대한 필터입니다.
JSON 표현 |
---|
{ "operation": enum ( |
필드 | |
---|---|
operation |
이 필터의 작업 유형입니다. |
value |
숫자 값 또는 날짜 값입니다. |
작업
숫자 필터에 적용된 연산입니다.
열거형 | |
---|---|
OPERATION_UNSPECIFIED |
지정되지 않았습니다. |
EQUAL |
같음 |
LESS_THAN |
미만 |
LESS_THAN_OR_EQUAL |
작거나 같음 |
GREATER_THAN |
초과 |
GREATER_THAN_OR_EQUAL |
크거나 같음 |
NumericValue
숫자를 나타내기 위해
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 one_value 는 숫자 값 one_value 중 하나는 다음 중 하나여야 합니다. |
|
int64Value |
정수 값 |
doubleValue |
이중 값 |
필터 간
결과가 두 숫자 (포함) 사이여야 합니다.
JSON 표현 |
---|
{ "fromValue": { object ( |
필드 | |
---|---|
fromValue |
이 숫자로 시작합니다. |
toValue |
이 숫자로 끝납니다. |
유입경로 이벤트 필터
단일 이벤트 이름의 이벤트와 일치하는 필터를 만듭니다. 매개변수 필터 표현식이 지정된 경우 단일 이벤트 이름 및 매개변수 필터 표현식과 모두 일치하는 이벤트의 하위 집합만 이 이벤트 필터와 일치합니다.
JSON 표현 |
---|
{
"eventName": string,
"funnelParameterFilterExpression": {
object ( |
필드 | |
---|---|
eventName |
이 필터는 단일 이벤트 이름의 이벤트와 일치합니다. 이벤트 이름은 필수 항목입니다. |
funnelParameterFilterExpression |
지정된 경우 이 필터는 단일 이벤트 이름 및 매개변수 필터 표현식과 모두 일치하는 이벤트를 일치시킵니다. 매개변수 필터 표현식에는 매개변수 필터만 사용할 수 있습니다. |
FunnelParameterFilterExpression 클래스의 생성자
매개변수에서 유입경로 필터 조합을 표현합니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 expr 는 FunnelParameterFilterExpression 에 대해 한 가지 유형의 필터를 지정합니다. expr 은 다음 중 하나여야 합니다. |
|
andGroup |
|
orGroup |
|
notExpression |
FunnelParameterFilterExpression이 |
funnelParameterFilter |
기본 유입경로 매개변수 필터입니다. |
FunnelParameterFilterExpressionList
유입경로 매개변수 필터 표현식의 목록입니다.
JSON 표현 |
---|
{
"expressions": [
{
object ( |
필드 | |
---|---|
expressions[] |
유입경로 매개변수 필터 표현식의 목록입니다. |
유입경로 매개변수 필터
유입경로의 매개변수 값을 필터링하는 표현식입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 one_parameter 는 필터링되는 필드입니다. one_parameter 은 다음 중 하나여야 합니다. |
|
eventParameterName |
이 필터는 지정된 이벤트 매개변수에서 평가됩니다. 이벤트 매개변수는 이벤트의 매개변수로 기록됩니다. 이벤트 매개변수에는 'firebase_screen' 및 'currency'와 같은 필드가 포함됩니다. 이벤트 매개변수는 세그먼트와 유입경로에서만 사용할 수 있으며 EventFilter의 하위 필터에서만 사용할 수 있습니다. EventFilter의 하위 필터에서 이벤트 또는 항목 매개변수를 사용해야 합니다. |
itemParameterName |
이 필터는 지정된 항목 매개변수에서 평가됩니다. 항목 매개변수는 항목 배열에 매개변수로 로깅됩니다. 상품 매개변수에는 'item_name' 및 'item_category'와 같은 필드가 포함됩니다. 항목 매개변수는 세그먼트와 유입경로에서만 사용할 수 있으며 EventFilter의 하위 필터에서만 사용할 수 있습니다. EventFilter의 하위 필터에서 이벤트 또는 항목 매개변수를 사용해야 합니다. 상품 매개변수는 전자상거래 이벤트에서만 사용할 수 있습니다. 전자상거래 이벤트에 대한 자세한 내용은 전자상거래 측정 가이드를 참고하세요. |
통합 필드 one_filter 는 필터 유형을 지정합니다. one_filter 은 다음 중 하나여야 합니다. |
|
stringFilter |
문자열 관련 필터입니다. |
inListFilter |
목록 값의 필터입니다. |
numericFilter |
숫자 또는 날짜 값에 대한 필터. |
betweenFilter |
두 값 사이의 필터입니다. |
유입경로 분류
분류를 사용하면 유입경로 표의 하위 보고서 응답에 측정기준이 추가됩니다.
JSON 표현 |
---|
{
"breakdownDimension": {
object ( |
필드 | |
---|---|
breakdownDimension |
유입경로 표 하위 보고서 응답에 추가된 측정기준 열입니다. 세부 측정기준은 각 유입경로 단계를 분석합니다. |
limit |
응답에서 반환할 세부 측정기준의 고유한 값의 최대 개수입니다. 한도가 지정되지 않은 경우 |
측정기준
측정기준은 데이터의 속성입니다. 예를 들어 도시 측정기준은 이벤트가 시작된 도시를 나타냅니다. 보고서 응답의 측정기준 값은 문자열입니다. 예를 들어 도시는 '파리' 또는 '뉴욕'일 수 있습니다.
JSON 표현 |
---|
{
"name": string,
"dimensionExpression": {
object ( |
필드 | |
---|---|
name |
측정기준의 이름입니다. 측정기준 이름 목록은 API 측정기준을 참고하세요.
|
dimensionExpression |
하나의 측정기준이 여러 차원 표현식의 결과일 수 있습니다. 예를 들어 'country, city' 측정기준은 concatenate(country, ", ", city)입니다. |
DimensionExpression
여러 차원으로 이루어진 식의 결과인 차원을 표현하는 데 사용됩니다. 사용법 예: 1) lowerCase(dimension) 2) concatenate(dimension1, Symbol, dimension2)
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 one_expression 는 DimensionExpression 에 하나의 측정기준 표현식 유형을 지정합니다. one_expression 은 다음 중 하나여야 합니다. |
|
lowerCase |
측정기준 값을 소문자로 변환하는 데 사용됩니다. |
upperCase |
측정기준 값을 대문자로 변환하는 데 사용됩니다. |
concatenate |
측정기준 값을 단일 측정기준으로 결합하는 데 사용됩니다. 예를 들어 'country, city' 측정기준은 concatenate(country, ", ", city)입니다. |
CaseExpression
측정기준 값을 단일 케이스로 변환하는 데 사용됩니다.
JSON 표현 |
---|
{ "dimensionName": string } |
필드 | |
---|---|
dimensionName |
측정기준의 이름입니다. 이름은 요청의 측정기준 필드에서 이름을 다시 참조해야 합니다. |
ConcatenateExpression
측정기준 값을 단일 측정기준으로 결합하는 데 사용됩니다.
JSON 표현 |
---|
{ "dimensionNames": [ string ], "delimiter": string } |
필드 | |
---|---|
dimensionNames[] |
측정기준의 이름입니다. 이름은 요청의 측정기준 필드에 있는 이름을 다시 참조해야 합니다. |
delimiter |
측정기준 이름 사이에 있는 구분 기호입니다. 구분 기호는 주로 '|' 또는 '' 같은 단일 문자이지만 더 긴 문자열일 수도 있습니다. 측정기준 값에 구분 기호가 포함되어 있으면 두 값 모두 구분 없이 표시됩니다. 예를 들어 측정기준 1 값 = 'US,FR', 측정기준 2 값 = 'JP', 구분 기호 = ','이면 응답에 'US,FR,JP'가 포함됩니다. |
유입경로 다음 액션
다음 액션은 사용자가 단계를 달성한 후 동일한 사용자가 다음 단계를 달성하기 전에 측정기준의 값을 명시합니다. 예를 들어 nextActionDimension
가 eventName
이면 i
번째 유입경로 단계 행의 nextActionDimension
는 사용자가 i
번째 유입경로 단계로 진입한 이벤트가 발생하고 사용자가 i+1
번째 유입경로 단계를 완료하기 전에 첫 번째 이벤트를 반환합니다.
JSON 표현 |
---|
{
"nextActionDimension": {
object ( |
필드 | |
---|---|
nextActionDimension |
유입경로 시각화 하위 보고서 응답에 추가된 측정기준 열입니다. 다음 액션 측정기준은 사용자가
|
limit |
응답에서 반환할 세부 측정기준의 고유한 값의 최대 개수입니다. 한도가 지정되지 않은 경우 |
유입경로 시각화 유형
유입경로 시각화 하위 보고서 응답에 있는 측정기준을 설정합니다.
열거형 | |
---|---|
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED |
알 수 없는 유형. |
STANDARD_FUNNEL |
표준 (계단식) 유입경로 응답의 유입경로 시각화 하위 보고서에 날짜가 포함되지 않습니다. |
TRENDED_FUNNEL |
추세 (선 차트) 유입경로 응답의 유입경로 시각화 하위 보고서에는 날짜 측정기준이 포함됩니다. |
세그먼트
세그먼트는 애널리틱스 데이터의 하위 집합입니다. 예를 들어 사용자의 전체 집합 중에서 특정 국가 또는 도시의 사용자에 해당하는 세그먼트를 만들 수 있으며, 특정 제품 라인을 구매한 사용자 또는 사이트의 특정 부분을 방문하거나 앱에서 특정 이벤트를 트리거한 사용자로 세그먼트를 만들 수도 있습니다.
자세한 내용은 GA4 세그먼트 작성 도구를 참고하세요.
JSON 표현 |
---|
{ "name": string, // Union field |
필드 | |
---|---|
name |
이 세그먼트의 이름입니다. 지정하지 않으면 세그먼트의 이름이 'Segment'로 지정됩니다. 이 이름은 |
통합 필드 one_segment_scope 는 세그먼트는 하나의 범위에 지정됩니다. one_segment_scope 은 다음 중 하나여야 합니다. |
|
userSegment |
사용자 세그먼트는 사이트 또는 앱과 상호작용한 사용자의 하위 집합입니다. |
sessionSegment |
세션 세그먼트는 사이트 또는 앱에서 발생한 세션의 하위 집합입니다. |
eventSegment |
이벤트 세그먼트는 사이트 또는 앱에서 트리거된 이벤트의 하위 집합입니다. |
사용자 세그먼트
사용자 세그먼트는 사이트 또는 앱과 상호작용한 사용자의 하위 집합입니다. 예: 이전에 구매한 사용자, 장바구니에 제품을 추가했지만 구매를 완료하지 않은 사용자.
JSON 표현 |
---|
{ "userInclusionCriteria": { object ( |
필드 | |
---|---|
userInclusionCriteria |
이 세그먼트에 포함되는 사용자를 정의합니다. 선택사항입니다. |
exclusion |
이 세그먼트에서 제외할 사용자를 정의합니다. 선택사항입니다. |
사용자 세그먼트 기준
사용자의 이벤트가 기준의 조건을 충족하는 경우 사용자는 기준과 일치합니다.
JSON 표현 |
---|
{ "andConditionGroups": [ { object ( |
필드 | |
---|---|
andConditionGroups[] |
사용자가 |
andSequenceGroups[] |
사용자가 |
사용자 세그먼트 조건 그룹
조건은 애널리틱스에서 세그먼트에 포함하거나 세그먼트에서 제외할 데이터를 지정합니다.
JSON 표현 |
---|
{ "conditionScoping": enum ( |
필드 | |
---|---|
conditionScoping |
데이터가 조건 그룹과 일치하는지에 따라 세그먼트에 포함되거나 제외됩니다. 이 범위 지정은 조건 그룹이 일치 여부를 판단하기 전에 선택사항입니다. 지정하지 않으면 |
segmentFilterExpression |
데이터가 이 표현식과 일치하는지에 따라 세그먼트에 포함되거나 제외됩니다. 표현식은 측정기준, 측정항목 또는 매개변수에 대한 기준을 나타냅니다. |
사용자 기준 범위 지정
범위 지정은 사용자가 기준을 충족하는지 평가할 때 고려할 이벤트를 지정합니다.
열거형 | |
---|---|
USER_CRITERIA_SCOPING_UNSPECIFIED |
지정되지 않은 기준 범위 지정하지 마세요. |
USER_CRITERIA_WITHIN_SAME_EVENT |
한 이벤트 내에서 기준이 충족되면 사용자는 기준과 일치합니다. |
USER_CRITERIA_WITHIN_SAME_SESSION |
하나의 세션 내에서 기준이 충족되면 사용자는 기준과 일치합니다. |
USER_CRITERIA_ACROSS_ALL_SESSIONS |
사용자의 이벤트가 기준을 충족하면 사용자는 기준과 일치합니다. |
SegmentFilterExpression
세그먼트 필터의 조합을 표시합니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 expr 는 SegmentFilterExpression 에 대해 한 가지 유형의 필터를 지정합니다. expr 은 다음 중 하나여야 합니다. |
|
andGroup |
|
orGroup |
|
notExpression |
SegmentFilterExpression이 |
segmentFilter |
기본 세그먼트 필터입니다. |
segmentEventFilter |
단일 이벤트 이름의 이벤트와 일치하는 필터를 만듭니다. 매개변수 필터 표현식이 지정된 경우 단일 이벤트 이름 및 매개변수 필터 표현식과 모두 일치하는 이벤트의 하위 집합만 이 이벤트 필터와 일치합니다. |
SegmentFilterExpressionList
세그먼트 필터 표현식의 목록입니다.
JSON 표현 |
---|
{
"expressions": [
{
object ( |
필드 | |
---|---|
expressions[] |
세그먼트 필터 표현식 목록 |
세그먼트 필터
측정기준 또는 측정항목 값을 필터링하는 표현식입니다.
JSON 표현 |
---|
{ "fieldName": string, "filterScoping": { object ( |
필드 | |
---|---|
fieldName |
측정기준 이름 또는 측정항목 이름입니다. |
filterScoping |
필터의 범위를 지정합니다. |
통합 필드 one_filter 는 Filter 에 대해 한 가지 유형의 필터를 지정합니다. one_filter 은 다음 중 하나여야 합니다. |
|
stringFilter |
문자열 관련 필터입니다. |
inListFilter |
목록 값의 필터입니다. |
numericFilter |
숫자 또는 날짜 값에 대한 필터. |
betweenFilter |
두 값 사이의 필터입니다. |
세그먼트 필터 범위 지정
범위 지정은 세그먼트 필터를 평가할 때 여러 이벤트의 측정기준 및 측정항목을 고려하는 방법을 지정합니다.
JSON 표현 |
---|
{ "atAnyPointInTime": boolean } |
필드 | |
---|---|
atAnyPointInTime |
이 이 기준 범위 지정이 |
세그먼트 이벤트 필터
단일 이벤트 이름의 이벤트와 일치하는 필터를 만듭니다. 매개변수 필터 표현식이 지정된 경우 단일 이벤트 이름 및 매개변수 필터 표현식과 모두 일치하는 이벤트의 하위 집합만 이 이벤트 필터와 일치합니다.
JSON 표현 |
---|
{
"eventName": string,
"segmentParameterFilterExpression": {
object ( |
필드 | |
---|---|
eventName |
이 필터는 단일 이벤트 이름의 이벤트와 일치합니다. 이벤트 이름은 필수 항목입니다. |
segmentParameterFilterExpression |
지정된 경우 이 필터는 단일 이벤트 이름 및 매개변수 필터 표현식과 모두 일치하는 이벤트를 일치시킵니다. 매개변수 필터 표현식에는 매개변수 필터만 사용할 수 있습니다. |
SegmentParameterFilterExpression
매개변수에 세그먼트 필터의 조합을 표시합니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 expr 는 SegmentParameterFilterExpression 에 대해 한 가지 유형의 필터를 지정합니다. expr 은 다음 중 하나여야 합니다. |
|
andGroup |
|
orGroup |
|
notExpression |
SegmentParameterFilterExpression이 |
segmentParameterFilter |
기본 세그먼트 매개변수 필터입니다. |
SegmentParameterFilterExpressionList
세그먼트 매개변수 필터 표현식의 목록입니다.
JSON 표현 |
---|
{
"expressions": [
{
object ( |
필드 | |
---|---|
expressions[] |
세그먼트 매개변수 필터 표현식의 목록입니다. |
SegmentParameterFilter
세그먼트의 매개변수 값을 필터링하는 표현식입니다.
JSON 표현 |
---|
{ "filterScoping": { object ( |
필드 | |
---|---|
filterScoping |
필터의 범위를 지정합니다. |
통합 필드 one_parameter 는 필터링되는 필드입니다. one_parameter 은 다음 중 하나여야 합니다. |
|
eventParameterName |
이 필터는 지정된 이벤트 매개변수에서 평가됩니다. 이벤트 매개변수는 이벤트의 매개변수로 기록됩니다. 이벤트 매개변수에는 'firebase_screen' 및 'currency'와 같은 필드가 포함됩니다. 이벤트 매개변수는 세그먼트와 유입경로에서만 사용할 수 있으며 EventFilter의 하위 필터에서만 사용할 수 있습니다. EventFilter의 하위 필터에서 이벤트 또는 항목 매개변수를 사용해야 합니다. |
itemParameterName |
이 필터는 지정된 항목 매개변수에서 평가됩니다. 항목 매개변수는 항목 배열에 매개변수로 로깅됩니다. 상품 매개변수에는 'item_name' 및 'item_category'와 같은 필드가 포함됩니다. 항목 매개변수는 세그먼트와 유입경로에서만 사용할 수 있으며 EventFilter의 하위 필터에서만 사용할 수 있습니다. EventFilter의 하위 필터에서 이벤트 또는 항목 매개변수를 사용해야 합니다. 상품 매개변수는 전자상거래 이벤트에서만 사용할 수 있습니다. 전자상거래 이벤트에 대한 자세한 내용은 전자상거래 측정 가이드를 참고하세요. |
통합 필드 one_filter 는 필터 유형을 지정합니다. one_filter 은 다음 중 하나여야 합니다. |
|
stringFilter |
문자열 관련 필터입니다. |
inListFilter |
목록 값의 필터입니다. |
numericFilter |
숫자 또는 날짜 값에 대한 필터. |
betweenFilter |
두 값 사이의 필터입니다. |
SegmentParameterFilterScoping
범위 지정은 세그먼트 매개변수 필터를 평가할 때 여러 이벤트를 고려해야 하는 방법을 지정합니다.
JSON 표현 |
---|
{ "inAnyNDayPeriod": string } |
필드 | |
---|---|
inAnyNDayPeriod |
필터를 적용하기 전에 지정된 기간 동안 매개변수를 누적합니다. 기준 범위 범위가 예를 들어 기간이 시작되기 전까지 N일 동안 기간을 연장하지 않습니다. 예를 들어 2021년 11월 1일~2021년 11월 10일 보고서이고
|
사용자 세그먼트 시퀀스 그룹
사용자가 세그먼트의 회원이 되려면 특정 순서로 발생해야 하는 조건을 정의합니다.
JSON 표현 |
---|
{ "sequenceScoping": enum ( |
필드 | |
---|---|
sequenceScoping |
사용자가 시퀀스와 일치하도록 범위 지정에서 모든 시퀀스 단계가 충족되어야 합니다. 예를 들어 선택사항입니다. 지정하지 않으면 |
sequenceMaximumDuration |
전체 시퀀스가 발생해야 하는 기간을 정의합니다(예: 30분).
초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 ' |
userSequenceSteps[] |
순서가 지정된 조건 단계의 순서입니다. 사용자가 |
사용자 시퀀스 단계
이 사용자가 시퀀스와 일치하도록 지정된 단계 순서에서 발생해야 하는 조건입니다.
JSON 표현 |
---|
{ "isDirectlyFollowedBy": boolean, "stepScoping": enum ( |
필드 | |
---|---|
isDirectlyFollowedBy |
참인 경우 이 단계를 충족하는 이벤트는 마지막 단계를 포괄하는 이벤트 직후의 다음 이벤트여야 합니다. false인 경우 이 단계는 이전 단계를 간접적으로 따릅니다. 예를 들어 이전 단계와 이 단계 사이에 이벤트가 있을 수 있습니다. 첫 번째 단계에서 |
stepScoping |
사용자가 시퀀스와 일치하도록 범위 지정에서 이 시퀀스 단계를 충족해야 합니다. 예를 들어 선택사항입니다. 지정하지 않으면 |
segmentFilterExpression |
이벤트가 이 표현식과 일치하는 경우 사용자는 이 시퀀스 단계와 일치합니다. 표현식은 측정기준, 측정항목 또는 매개변수에 대한 기준을 나타냅니다. |
사용자 세그먼트 제외
이 세그먼트에서 제외할 사용자를 지정합니다.
JSON 표현 |
---|
{ "userExclusionDuration": enum ( |
필드 | |
---|---|
userExclusionDuration |
사용자가 선택사항입니다. 지정하지 않으면 |
userExclusionCriteria |
이 조건을 충족하는 사용자는 |
사용자 제외 기간
사용자가 userExclusionCriteria
와 일치하는 경우 제외 기간이 지속되는 옵션을 열거합니다.
열거형 | |
---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED |
제외 기간이 지정되지 않았습니다. 지정하지 마세요. |
USER_EXCLUSION_TEMPORARY |
사용자가 userExclusionCriteria 조건을 충족하는 기간 동안 사용자를 세그먼트에서 일시적으로 제외합니다. |
USER_EXCLUSION_PERMANENT |
사용자가 userExclusionCriteria 조건을 충족한 경우 사용자를 세그먼트에서 영구적으로 제외합니다. |
세션 세그먼트
세션 세그먼트는 사이트 또는 앱에서 발생한 세션의 하위 집합입니다. 예: 특정 광고 캠페인에서 발생한 모든 세션
JSON 표현 |
---|
{ "sessionInclusionCriteria": { object ( |
필드 | |
---|---|
sessionInclusionCriteria |
이 세그먼트에 포함되는 세션을 정의합니다. 선택사항입니다. |
exclusion |
이 세그먼트에서 제외할 세션을 정의합니다. 선택사항입니다. |
세션 세그먼트 기준
세션의 이벤트가 기준의 조건을 충족하면 세션이 기준과 일치합니다.
JSON 표현 |
---|
{
"andConditionGroups": [
{
object ( |
필드 | |
---|---|
andConditionGroups[] |
세션이 각 |
세션 세그먼트 조건 그룹
조건은 애널리틱스에서 세그먼트에 포함하거나 세그먼트에서 제외할 데이터를 지정합니다.
JSON 표현 |
---|
{ "conditionScoping": enum ( |
필드 | |
---|---|
conditionScoping |
데이터가 조건 그룹과 일치하는지에 따라 세그먼트에 포함되거나 제외됩니다. 이 범위 지정은 조건 그룹이 일치 여부를 판단하기 전에 선택사항입니다. 지정하지 않으면 |
segmentFilterExpression |
데이터가 이 표현식과 일치하는지에 따라 세그먼트에 포함되거나 제외됩니다. 표현식은 측정기준, 측정항목 또는 매개변수에 대한 기준을 나타냅니다. |
세션 기준 범위 지정
범위 지정은 세션이 기준을 충족하는지 평가할 때 고려되는 이벤트를 지정합니다.
열거형 | |
---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
지정되지 않은 기준 범위 지정하지 마세요. |
SESSION_CRITERIA_WITHIN_SAME_EVENT |
한 이벤트에서 기준을 충족하면 세션이 기준과 일치합니다. |
SESSION_CRITERIA_WITHIN_SAME_SESSION |
기준이 한 세션 내에 충족되면 세션이 기준과 일치합니다. |
세션 세그먼트 제외
이 세그먼트에서 제외할 세션을 지정합니다.
JSON 표현 |
---|
{ "sessionExclusionDuration": enum ( |
필드 | |
---|---|
sessionExclusionDuration |
세션이 선택사항입니다. 지정하지 않으면 |
sessionExclusionCriteria |
세션이 이 조건을 충족하면 |
세션 제외 시간
세션이 sessionExclusionCriteria
와 일치하는 경우 제외가 지속되는 시간을 열거합니다.
열거형 | |
---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
제외 기간이 지정되지 않았습니다. 지정하지 마세요. |
SESSION_EXCLUSION_TEMPORARY |
세션이 sessionExclusionCriteria 조건을 충족하는 기간에 세그먼트에서 세션을 일시적으로 제외합니다. |
SESSION_EXCLUSION_PERMANENT |
세션이 sessionExclusionCriteria 조건을 충족하는 경우 해당 세그먼트를 세그먼트에서 영구적으로 제외합니다. |
이벤트 세그먼트
이벤트 세그먼트는 사이트 또는 앱에서 트리거된 이벤트의 하위 집합입니다. 예: 특정 위치에서 발생한 모든 구매 이벤트, 특정 운영체제에서 발생한 app_exception 이벤트.
JSON 표현 |
---|
{ "eventInclusionCriteria": { object ( |
필드 | |
---|---|
eventInclusionCriteria |
이 세그먼트에 포함될 이벤트를 정의합니다. 선택사항입니다. |
exclusion |
이 세그먼트에서 제외할 이벤트를 정의합니다. 선택사항입니다. |
이벤트 세그먼트 기준
이벤트가 기준을 충족하는 경우 기준과 일치합니다.
JSON 표현 |
---|
{
"andConditionGroups": [
{
object ( |
필드 | |
---|---|
andConditionGroups[] |
이벤트가 이 |
이벤트 세그먼트 조건 그룹
조건은 애널리틱스에서 세그먼트에 포함하거나 세그먼트에서 제외할 데이터를 지정합니다.
JSON 표현 |
---|
{ "conditionScoping": enum ( |
필드 | |
---|---|
conditionScoping |
선택사항입니다. 지정하지 않으면 |
segmentFilterExpression |
데이터가 이 표현식과 일치하는지에 따라 세그먼트에 포함되거나 제외됩니다. 표현식은 측정기준, 측정항목 또는 매개변수에 대한 기준을 나타냅니다. |
이벤트 기준 범위 지정
범위 지정은 이벤트가 기준을 충족하는지 평가할 때 고려할 이벤트를 지정합니다.
열거형 | |
---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED |
지정되지 않은 기준 범위 지정하지 마세요. |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
기준이 한 이벤트에서 충족되면 이벤트가 기준과 일치합니다. |
이벤트 세그먼트 제외
이 세그먼트에서 제외할 이벤트를 지정합니다.
JSON 표현 |
---|
{ "eventExclusionDuration": enum ( |
필드 | |
---|---|
eventExclusionDuration |
선택사항입니다. 지정하지 않으면 |
eventExclusionCriteria |
이벤트가 이 조건을 충족하면 |
이벤트 제외 기간
이벤트가 eventExclusionCriteria
와 일치하는 경우 제외가 지속되는 기간을 열거합니다.
열거형 | |
---|---|
EVENT_EXCLUSION_DURATION_UNSPECIFIED |
제외 기간이 지정되지 않았습니다. 지정하지 마세요. |
EVENT_EXCLUSION_PERMANENT |
이벤트가 eventExclusionCriteria 조건을 충족한 경우 세그먼트에서 이벤트를 영구적으로 제외합니다. |
FilterExpression
측정기준 또는 측정항목 필터를 표현하기 위해 동일한 FilterExpression의 필드는 모든 측정기준 또는 모든 측정항목이어야 합니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 expr 는 FilterExpression 에 대해 한 가지 유형의 필터 표현식을 지정합니다. expr 은 다음 중 하나여야 합니다. |
|
andGroup |
andGroup의 FilterExpressions에는 AND 관계가 있습니다. |
orGroup |
orGroup의 FilterExpressions에는 OR 관계가 있습니다. |
notExpression |
FilterExpression이 notExpression이 아닙니다. |
filter |
기본 필터입니다. 동일한 FilterExpression에서 모든 필터의 필드 이름은 모든 측정기준 또는 모든 측정항목이어야 합니다. |
FilterExpressionList
필터 표현식 목록입니다.
JSON 표현 |
---|
{
"expressions": [
{
object ( |
필드 | |
---|---|
expressions[] |
필터 표현식 목록입니다. |
필터
측정기준 또는 측정항목 값을 필터링하는 표현식입니다.
JSON 표현 |
---|
{ "fieldName": string, // Union field |
필드 | |
---|---|
fieldName |
측정기준 이름 또는 측정항목 이름입니다. 측정기준 또는 측정항목에 정의된 이름이어야 합니다. |
통합 필드 one_filter 는 Filter 에 대해 한 가지 유형의 필터를 지정합니다. one_filter 은 다음 중 하나여야 합니다. |
|
stringFilter |
문자열 관련 필터입니다. |
inListFilter |
목록 값의 필터입니다. |
numericFilter |
숫자 또는 날짜 값에 대한 필터. |
betweenFilter |
두 값 사이의 필터입니다. |
유입경로 하위 보고서
유입경로 하위 보고서에는 측정기준 및 측정항목 데이터 값이 포함되어 있습니다. 예를 들어 12명의 사용자가 유입경로의 두 번째 단계에 도달했다면
JSON 표현 |
---|
{ "dimensionHeaders": [ { object ( |
필드 | |
---|---|
dimensionHeaders[] |
측정기준 열을 설명합니다. 유입경로 보고서는 하위 보고서 응답에 항상 유입경로 단계 측정기준을 포함합니다. 요청에 따라 분류, 날짜, 다음 작업과 같은 추가 측정기준이 응답에 표시될 수 있습니다. |
metricHeaders[] |
측정항목 열을 설명합니다. 유입경로 보고서에는 항상 하위 보고서 응답에 활성 사용자가 포함됩니다. 유입경로 테이블에는 완료율, 이탈률, 이탈률과 같은 추가 측정항목이 포함됩니다. |
rows[] |
보고서의 측정기준 값 조합과 측정항목 값의 행입니다. |
metadata |
유입경로 보고서의 메타데이터입니다. |
DimensionHeader
보고서의 측정기준 열을 설명합니다. 보고서에서 요청된 측정기준은 행 및 DimensionHeaders 내에 열 항목을 생성합니다. 하지만 필터 또는 표현식 내에서만 사용되는 측정기준은 보고서에서 열을 생성하지 않으며, 그에 따라 이러한 측정기준은 헤더를 생성하지 않습니다.
JSON 표현 |
---|
{ "name": string } |
필드 | |
---|---|
name |
측정기준의 이름입니다. |
MetricHeader
보고서의 측정항목 열을 설명합니다. 보고서에 요청된 측정항목은 행과 MetricHeader 내에 열 항목을 생성합니다. 하지만 필터 또는 표현식 내에서만 사용되는 측정항목은 보고서에서 열을 생성하지 않으며, 그에 따라 이러한 측정항목은 헤더를 생성하지 않습니다.
JSON 표현 |
---|
{
"name": string,
"type": enum ( |
필드 | |
---|---|
name |
측정항목의 이름입니다. |
type |
측정항목의 데이터 유형입니다. |
MetricType
측정항목의 값 유형입니다.
열거형 | |
---|---|
METRIC_TYPE_UNSPECIFIED |
알 수 없는 유형. |
TYPE_INTEGER |
정수 유형입니다. |
TYPE_FLOAT |
부동 소수점 유형입니다. |
TYPE_SECONDS |
지속 시간(초), 특수 부동 소수점 유형입니다. |
TYPE_MILLISECONDS |
지속 시간(밀리초)으로, 특별한 부동 소수점 유형입니다. |
TYPE_MINUTES |
분 단위의 길이. 특수 부동 소수점 유형입니다. |
TYPE_HOURS |
시간 단위이며, 특수 부동 소수점 유형입니다. |
TYPE_STANDARD |
표준 유형의 맞춤 측정항목, 특수 부동 소수점 유형입니다. |
TYPE_CURRENCY |
일정 금액, 특수한 부동 소수점 유형 |
TYPE_FEET |
피트 단위의 길이로, 특수 부동 소수점 유형입니다. |
TYPE_MILES |
마일 단위의 길이로, 특수 부동 소수점 유형입니다. |
TYPE_METERS |
미터 단위의 길이로, 특수 부동 소수점 유형입니다. |
TYPE_KILOMETERS |
킬로미터 단위의 길이로, 특수 부동 소수점 유형입니다. |
Row
각 행의 데이터를 보고합니다. 예를 들어 RunReportRequest에 다음이 포함된 경우
"dimensions": [
{
"name": "eventName"
},
{
"name": "countryId"
}
],
"metrics": [
{
"name": "eventCount"
}
]
'in_app_purchase'가 eventName, 'JP', countryId, eventCount가 1개인 행은 다음과 같습니다.
"dimensionValues": [
{
"value": "in_app_purchase"
},
{
"value": "JP"
}
],
"metricValues": [
{
"value": "15"
}
]
JSON 표현 |
---|
{ "dimensionValues": [ { object ( |
필드 | |
---|---|
dimensionValues[] |
요청된 측정기준 값의 목록입니다. 피봇 보고서에서 측정기준 값은 피봇에 포함된 측정기준에 대해서만 나열됩니다. |
metricValues[] |
요청된 공개 측정항목 값의 목록입니다. |
DimensionValue
측정기준의 값입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 one_value 는 측정기준 값 one_value 의 한 종류는 다음 중 하나여야 합니다. |
|
value |
측정기준 유형이 문자열인 경우 문자열 값입니다. |
MetricValue
측정항목의 값입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 one_value 는 측정항목 값 one_value 중 하나는 다음 중 하나여야 합니다. |
|
value |
측정값입니다. 유형은 MetricHeader를 참조하세요. |
유입경로 응답 메타데이터
유입경로 보고서의 응답 메타데이터에는 유입경로 보고서에 대한 추가 정보가 들어 있습니다.
JSON 표현 |
---|
{
"samplingMetadatas": [
{
object ( |
필드 | |
---|---|
samplingMetadatas[] |
유입경로 보고서 결과가 샘플링된 경우 이 유입경로 보고서에서 사용된 이벤트의 비율을 확인할 수 있습니다. 각 기간별로 하나의 하지만 결과가 샘플링되지 않으면 이 필드가 정의되지 않습니다. |
샘플링 메타데이터
유입경로 보고서 결과가 샘플링된 경우 이 메타데이터는 해당 유입경로 보고서에서 일정 기간 동안 사용된 이벤트 비율을 보여줍니다. 샘플링은 더 큰 데이터 세트에서 의미 있는 정보를 찾기 위해 모든 데이터의 하위 집합을 분석하는 방법입니다.
JSON 표현 |
---|
{ "samplesReadCount": string, "samplingSpaceSize": string } |
필드 | |
---|---|
samplesReadCount |
특정 기간 동안 샘플링된 보고서에서 읽은 총 이벤트 수입니다. 이 유입경로 보고서에서 분석된 이 속성 데이터의 하위 집합 크기입니다. |
samplingSpaceSize |
이 유입경로 보고서에서 특정 기간 동안 분석되었을 수 있는 이벤트의 총 이벤트 수입니다. 샘플링을 통해 대규모 데이터 세트에 관한 유의미한 정보를 알 수 있으며, 이는 대규모 데이터 세트의 크기입니다. 이 유입경로 보고서에서 사용된 가용 데이터의 백분율을 계산하려면 |
PropertyQuota
이 애널리틱스 속성에 대한 모든 할당량의 현재 상태입니다. 속성의 할당량이 소진되면 해당 속성에 대한 모든 요청이 리소스 소진 오류를 반환합니다.
JSON 표현 |
---|
{ "tokensPerDay": { object ( |
필드 | |
---|---|
tokensPerDay |
표준 애널리틱스 속성에서는 하루에 최대 200,000개의 토큰을 사용할 수 있으며, 애널리틱스 360 속성에서는 하루에 2,000,000개의 토큰을 사용할 수 있습니다. 대부분의 요청에서는 10개 미만의 토큰을 사용합니다. |
tokensPerHour |
표준 애널리틱스 속성은 시간당 최대 40,000개의 토큰을 사용할 수 있고, 애널리틱스 360 속성은 시간당 400,000개의 토큰을 사용할 수 있습니다. API 요청은 단일 토큰을 소비하며 이 개수는 시간별, 일일, 프로젝트별 시간당 할당량에서 모두 차감됩니다. |
concurrentRequests |
표준 애널리틱스 속성은 최대 10개의 동시 요청을 전송할 수 있고, 애널리틱스 360 속성은 최대 50개의 동시 요청을 사용할 수 있습니다. |
serverErrorsPerProjectPerHour |
표준 애널리틱스 속성 및 클라우드 프로젝트 쌍에는 시간당 최대 10개의 서버 오류가 발생할 수 있고, 애널리틱스 360 속성과 클라우드 프로젝트 쌍에는 시간당 최대 50개의 서버 오류가 있을 수 있습니다. |
potentiallyThresholdedRequestsPerHour |
애널리틱스 속성은 시간당 임계값을 초과할 수 있는 측정기준을 포함하여 최대 120개의 요청을 보낼 수 있습니다. 일괄 요청의 경우 요청에 잠재적으로 임계값이 포함된 측정기준이 포함된 경우 각 보고서 요청은 이 할당량으로 개별적으로 계산됩니다. |
tokensPerProjectPerHour |
애널리틱스 속성은 프로젝트당 시간당 최대 35% 의 토큰을 사용할 수 있습니다. 표준 애널리틱스 속성에는 프로젝트별로 시간당 최대 14,000개의 토큰을 사용할 수 있으며, 애널리틱스 360 속성에는 프로젝트별로 시간당 140,000개의 토큰을 사용할 수 있습니다. API 요청은 단일 토큰을 소비하며 이 개수는 시간별, 일일, 프로젝트별 시간당 할당량에서 모두 차감됩니다. |
QuotaStatus
특정 할당량 그룹의 현재 상태입니다.
JSON 표현 |
---|
{ "consumed": integer, "remaining": integer } |
필드 | |
---|---|
consumed |
이 요청에서 사용된 할당량입니다. |
remaining |
이 요청 후 할당량이 남았습니다. |