Method: properties.runFunnelReport

Google 애널리틱스 이벤트 데이터의 맞춤설정된 유입경로 보고서를 반환합니다. API에서 반환되는 데이터는 요청된 측정기준 및 측정항목에 대한 열이 포함된 표입니다.

유입경로 탐색 분석을 사용하면 사용자가 작업을 완료하기 위해 실행하는 단계를 시각적으로 확인하고 단계별 작업 완료 또는 실패 여부를 신속하게 확인할 수 있습니다. 예를 들어 어떻게 하면 잠재고객이 소핑객이 되고 다시 구매자가 될까요? 어떻게 하면 일회성 구매자가 반복 구매자가 될까요? 이 정보를 활용하면 비효율적이거나 이탈이 발생한 고객 여정을 개선할 수 있습니다. 자세한 내용은 GA4 유입경로 탐색 분석을 참고하세요.

이 메서드는 알파 버전을 출시할 만큼 안정적일 때, 베타를 시작하기 전 구문 및 기능에 대한 의견을 수집하기 위해 도입됩니다. 이 API에 대한 의견을 보내려면 Google Analytics Data API 유입경로 보고서 의견을 작성하세요.

HTTP 요청

POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport

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

경로 매개변수

매개변수
property

string

선택사항입니다. 이벤트가 추적되는 Google 애널리틱스 GA4 속성 식별자입니다. 본문이 아닌 URL 경로에서 지정됩니다. 자세한 내용은 속성 ID를 찾을 수 있는 위치를 참고하세요. 일괄 요청 내에서 이 속성은 지정되지 않거나 일괄 수준 속성과 일치해야 합니다.

예: properties/1234

요청 본문

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

JSON 표현 
{
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "funnel": {
    object (Funnel)
  },
  "funnelBreakdown": {
    object (FunnelBreakdown)
  },
  "funnelNextAction": {
    object (FunnelNextAction)
  },
  "funnelVisualizationType": enum (FunnelVisualizationType),
  "segments": [
    {
      object (Segment)
    }
  ],
  "limit": string,
  "dimensionFilter": {
    object (FilterExpression)
  },
  "returnPropertyQuota": boolean
}
입력란
dateRanges[]

object (DateRange)

선택사항입니다. 읽을 데이터의 기간입니다. 여러 기간이 요청되면 각 응답 행에 0 기반 기간 색인이 포함됩니다. 두 기간이 겹치는 경우, 중복되는 날의 이벤트 데이터가 두 기간의 응답 행에 포함됩니다.
funnel

object (Funnel)

선택사항입니다. 이 요청의 유입경로의 구성입니다. 이 유입경로 구성은 필수 항목입니다.
funnelBreakdown

object (FunnelBreakdown)

선택사항입니다. 지정된 경우 이 분류를 통해 유입경로 표 하위 보고서 응답에 측정기준이 추가됩니다. 이 세부 측정기준은 각 유입경로 단계를 세부 측정기준의 고유한 값으로 확장합니다. 예를 들어 deviceCategory 측정기준을 기준으로 분류하면 mobile, tablet, desktop 및 총계에 대한 행이 생성됩니다.
funnelNextAction

object (FunnelNextAction)

선택사항입니다. 지정된 경우 다음 작업에서 유입경로 시각화 하위 보고서 응답에 측정기준을 추가합니다. 다음 액션 측정기준은 각 유입경로 단계를 다음 액션의 고유한 값으로 확장합니다. 예를 들어 eventName 측정기준의 다음 액션은 여러 이벤트 (예: session_start 및 click)와 총계에 대한 행을 만듭니다.

다음 작업은 eventName 및 대부분의 페이지 / 화면 측정기준(예: pageTitle, pagePath)만 지원합니다.
funnelVisualizationType

enum (FunnelVisualizationType)

선택사항입니다. 유입경로 시각화 유형은 유입경로 시각화 하위 보고서 응답에 있는 측정기준을 관리합니다. 지정하지 않으면 STANDARD_FUNNEL가 사용됩니다.
segments[]

object (Segment)

선택사항입니다. 세그먼트의 구성입니다. 세그먼트는 속성 데이터의 하위 집합입니다. 세그먼트가 포함된 유입경로 보고서에서는 유입경로가 각 세그먼트에서 평가됩니다.

이 요청에 지정된 각 세그먼트는 응답에 별도의 행을 생성합니다. 응답에서 각 세그먼트는 이름으로 식별됩니다.

세그먼트 매개변수는 선택사항입니다. 요청은 4개의 세그먼트로 제한됩니다.
limit

string (int64 format)

선택사항입니다. 반환할 행 수입니다. 지정하지 않으면 10,000개의 행이 반환됩니다. API는 요청하는 횟수에 관계없이 요청당 최대 250,000개의 행을 반환합니다. limit은(는) 양수여야 합니다.

측정기준 값이 limit만큼 많지 않은 경우 API가 요청된 limit보다 적은 수의 행을 반환할 수도 있습니다.
dimensionFilter

object (FilterExpression)

선택사항입니다. 측정기준 필터를 사용하면 보고서에서 특정 측정기준 값만 요청할 수 있습니다. 자세한 내용은 보고서 만들기: 측정기준 필터의 예를 참조하세요. 이 필터에 측정항목을 사용할 수 없습니다.
returnPropertyQuota

boolean

선택사항입니다. 이 애널리틱스 속성 할당량의 현재 상태를 반환할지 여부를 지정합니다. 할당량은 PropertyQuota에 반환됩니다.

응답 본문

유입경로 보고서 응답에는 두 개의 하위 보고서가 포함되어 있습니다. 두 개의 하위 보고서는 측정기준과 측정항목의 서로 다른 조합입니다.

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

JSON 표현 
{
  "funnelTable": {
    object (FunnelSubReport)
  },
  "funnelVisualization": {
    object (FunnelSubReport)
  },
  "propertyQuota": {
    object (PropertyQuota)
  },
  "kind": string
}
입력란
funnelTable

object (FunnelSubReport)

유입경로 표는 유입경로 단계, 세그먼트, 세부 측정기준, 활성 사용자, 완료율, 이탈률, 이탈률이 포함된 보고서입니다.

세그먼트 측정기준은 세그먼트가 요청된 경우에만 이 응답에 표시됩니다. 세부 측정기준은 요청된 경우에만 이 응답에 표시됩니다.
funnelVisualization

object (FunnelSubReport)

유입경로 시각화는 유입경로 단계, 세그먼트, 날짜, 다음 액션 측정기준, 활성 사용자가 포함된 보고서입니다.

세그먼트 측정기준은 세그먼트가 요청된 경우에만 이 응답에 표시됩니다. 날짜 측정기준은 TRENDED_FUNNEL 유입경로 유형을 통해 요청된 경우에만 이 응답에 표시됩니다. 다음 액션 측정기준은 요청된 경우에만 응답에 표시됩니다.
propertyQuota

object (PropertyQuota)

이 요청이 포함된 애널리틱스 속성의 할당량 상태입니다.
kind

string

이 메시지의 리소스 종류를 식별합니다. 이 kind는 항상 고정 문자열 'analyticsData#runFunnelReport'입니다. JSON에서 응답 유형을 구분하는 데 유용합니다.

승인 범위

다음 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

string

YYYY-MM-DD 형식의 쿼리의 시작일(포함)입니다. endDate 이후일 수 없습니다. NdaysAgo, yesterday 또는 today 형식도 허용되며 이 경우 속성의 보고 시간대를 기준으로 날짜가 추론됩니다.
endDate

string

YYYY-MM-DD 형식으로 된 쿼리의 종료일입니다(해당 날짜 포함). startDate 이전일 수 없습니다. NdaysAgo, yesterday 또는 today 형식도 허용되며 이 경우 속성의 보고 시간대를 기준으로 날짜가 추론됩니다.
name

string

이 기간에 이름을 지정합니다. dateRange 측정기준은 보고서 응답에서 이 이름으로 평가됩니다. 이 매개변수를 설정하면 date_range_ 또는 RESERVED_로 시작할 수 없습니다. 설정하지 않으면 요청의 0 기반 색인(date_range_0, date_range_1 등)으로 기간의 이름이 지정됩니다.

유입경로

유입경로 보고서 요청에서 유입경로를 구성합니다. 유입경로는 사용자가 일련의 단계를 통과할 때 이를 보고합니다.

유입경로 탐색 분석을 사용하면 사용자가 작업을 완료하기 위해 실행하는 단계를 시각적으로 확인하고 단계별 작업 완료 또는 실패 여부를 신속하게 확인할 수 있습니다. 예를 들어 어떻게 하면 잠재고객이 소핑객이 되고 다시 구매자가 될까요? 어떻게 하면 일회성 구매자가 반복 구매자가 될까요? 이 정보를 활용하면 비효율적이거나 이탈이 발생한 고객 여정을 개선할 수 있습니다.

JSON 표현 
{
  "isOpenFunnel": boolean,
  "steps": [
    {
      object (FunnelStep)
    }
  ]
}
입력란
isOpenFunnel

boolean

개방형 유입경로에서는 사용자가 모든 단계에서 유입경로에 진입할 수 있고, 폐쇄형 유입경로에서는 사용자가 첫 번째 단계에서 유입경로에 진입해야 합니다. 선택사항입니다. 지정하지 않으면 폐쇄형 유입경로가 사용됩니다.
steps[]

object (FunnelStep)

이 유입경로의 순차적 단계입니다.

FunnelStep

단계는 측정할 사용자 여정을 정의합니다. 단계에는 사용자가 유입경로 여정의 해당 단계에 포함되기 위해 충족해야 하는 하나 이상의 조건이 포함됩니다.

JSON 표현 
{
  "name": string,
  "isDirectlyFollowedBy": boolean,
  "filterExpression": {
    object (FunnelFilterExpression)
  },
  "withinDurationFromPriorStep": string
}
입력란
name

string

이 단계의 고유한 이름입니다. 지정하지 않으면 1을 기반으로 색인이 생성된 이름 (예: '0. ', '1. ' 등)를 입력합니다. 이 이름은 funnelStepName 측정기준에서 반환하는 문자열 값을 정의합니다. 예를 들어 요청의 세 번째 유입경로 단계에서 name = Purchase를 지정하면 유입경로 보고서 응답에 3. Purchase이 생성됩니다.
isDirectlyFollowedBy

boolean

true인 경우 이 단계는 이전 단계 바로 다음에 와야 합니다. false인 경우 이전 단계와 이 단계 사이에 이벤트가 있을 수 있습니다. 지정하지 않으면 isDirectlyFollowedBy이 false로 간주됩니다.
filterExpression

object (FunnelFilterExpression)

사용자가 유입경로의 이 단계에 포함되기 위해 충족해야 하는 조건입니다.
withinDurationFromPriorStep

string (Duration format)

지정된 경우 이 단계는 이전 단계가 완료된 후 이 기간 내에 완료되어야 합니다. withinDurationFromPriorStep에는 마이크로초 단위의 엔드포인트가 포함됩니다. 예를 들어 5초 길이의 동영상도 4.9초 또는 5.0초로 완료할 수 있지만 5초 또는 1마이크로초로는 완료할 수 없습니다.

withinDurationFromPriorStep는 선택사항이며, 지정되지 않은 경우 단계는 기간으로 구분할 수 있습니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

FunnelFilterExpression

유입경로 필터의 조합을 표현합니다.

JSON 표현 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelFilterExpressionList)
  },
  "orGroup": {
    object (FunnelFilterExpressionList)
  },
  "notExpression": {
    object (FunnelFilterExpression)
  },
  "funnelFieldFilter": {
    object (FunnelFieldFilter)
  },
  "funnelEventFilter": {
    object (FunnelEventFilter)
  }
  // End of list of possible types for union field expr.
}
입력란
통합 필드 expr. FunnelFilterExpression에 대해 한 가지 유형의 필터를 지정하세요. expr은 다음 중 하나여야 합니다.
andGroup

object (FunnelFilterExpressionList)

andGroup의 FunnelFilterExpression에는 AND 관계가 있습니다.
orGroup

object (FunnelFilterExpressionList)

orGroup의 FunnelFilterExpression에는 OR 관계가 있습니다.
notExpression

object (FunnelFilterExpression)

FunnelFilterExpression이 notExpression의 값이 아닙니다.
funnelFieldFilter

object (FunnelFieldFilter)

측정기준 또는 측정항목에 대한 유입경로 필터
funnelEventFilter

object (FunnelEventFilter)

단일 이벤트 이름의 이벤트와 일치하는 필터를 만듭니다. 매개변수 필터 표현식이 지정되면 단일 이벤트 이름 및 매개변수 필터 표현식과 모두 일치하는 이벤트의 하위 집합만 이 이벤트 필터와 일치합니다.

FunnelFilterExpressionList

유입경로 필터 표현식의 목록입니다.

JSON 표현 
{
  "expressions": [
    {
      object (FunnelFilterExpression)
    }
  ]
}
입력란
expressions[]

object (FunnelFilterExpression)

유입경로 필터 표현식의 목록입니다.

FunnelFieldFilter

측정기준 또는 측정항목 값을 필터링하는 표현식입니다.

JSON 표현 
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
입력란
fieldName

string

측정기준 이름 또는 측정항목 이름입니다.
통합 필드 one_filter. 한 가지 유형의 필터를 지정하세요. one_filter은 다음 중 하나여야 합니다.
stringFilter

object (StringFilter)

문자열 관련 필터입니다.
inListFilter

object (InListFilter)

목록 값의 필터입니다.
numericFilter

object (NumericFilter)

숫자 또는 날짜 값을 위한 필터입니다.
betweenFilter

object (BetweenFilter)

두 값 사이의 필터입니다.

StringFilter

문자열 필터

JSON 표현 
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
입력란
matchType

enum (MatchType)

이 필터에 대한 검색 유형입니다.
value

string

일치에 사용되는 문자열 값입니다.
caseSensitive

boolean

true인 경우 문자열 값은 대소문자를 구분합니다.

MatchType

문자열 필터의 일치 유형

열거형
MATCH_TYPE_UNSPECIFIED 미지정
EXACT 문자열 값의 정확한 일치입니다.
BEGINS_WITH 문자열 값으로 시작합니다.
ENDS_WITH 문자열 값으로 끝납니다.
CONTAINS 문자열 값을 포함합니다.
FULL_REGEXP 문자열 값이 있는 정규 표현식과 완전히 일치합니다.
PARTIAL_REGEXP 문자열 값이 있는 정규 표현식의 부분 일치

InListFilter

결과는 문자열 값 목록에 있어야 합니다.

JSON 표현 
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
입력란
values[]

string

문자열 값 목록입니다. 비어 있으면 안 됩니다.
caseSensitive

boolean

true인 경우 문자열 값은 대소문자를 구분합니다.

NumericFilter

숫자 또는 날짜 값을 위한 필터입니다.

JSON 표현 
{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}
입력란
operation

enum (Operation)

이 필터의 작업 유형입니다.
value

object (NumericValue)

숫자 값 또는 날짜 값입니다.

작업

숫자 필터에 적용되는 연산입니다.

열거형
OPERATION_UNSPECIFIED 지정되지 않았습니다.
EQUAL 같음
LESS_THAN 미만
LESS_THAN_OR_EQUAL 작거나 같음
GREATER_THAN 초과
GREATER_THAN_OR_EQUAL 이상

NumericValue

숫자를 나타냅니다.

JSON 표현 
{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}
입력란
통합 필드 one_value. 숫자 값 one_value 중 하나는 다음 중 하나여야 합니다.
int64Value

string (int64 format)

정수 값
doubleValue

number

이중 값

BetweenFilter

결과가 두 숫자 (포함) 사이여야 합니다.

JSON 표현 
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
입력란
fromValue

object (NumericValue)

이 숫자로 시작합니다.
toValue

object (NumericValue)

이 번호로 끝납니다.

FunnelEventFilter

단일 이벤트 이름의 이벤트와 일치하는 필터를 만듭니다. 매개변수 필터 표현식이 지정되면 단일 이벤트 이름 및 매개변수 필터 표현식과 모두 일치하는 이벤트의 하위 집합만 이 이벤트 필터와 일치합니다.

JSON 표현 
{
  "eventName": string,
  "funnelParameterFilterExpression": {
    object (FunnelParameterFilterExpression)
  }
}
입력란
eventName

string

이 필터는 이 단일 이벤트 이름의 이벤트와 일치합니다. 이벤트 이름은 필수 항목입니다.
funnelParameterFilterExpression

object (FunnelParameterFilterExpression)

지정된 경우 이 필터는 단일 이벤트 이름 및 매개변수 필터 표현식과 모두 일치하는 이벤트와 일치합니다.

매개변수 필터 표현식 내에서는 매개변수 필터만 사용할 수 있습니다.

FunnelParameterFilterExpression

매개변수에 대한 유입경로 필터의 조합을 표현합니다.

JSON 표현 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "orGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "notExpression": {
    object (FunnelParameterFilterExpression)
  },
  "funnelParameterFilter": {
    object (FunnelParameterFilter)
  }
  // End of list of possible types for union field expr.
}
입력란
통합 필드 expr. FunnelParameterFilterExpression에 대해 한 가지 유형의 필터를 지정하세요. expr은 다음 중 하나여야 합니다.
andGroup

object (FunnelParameterFilterExpressionList)

andGroup의 FunnelParameterFilterExpression에는 AND 관계가 있습니다.
orGroup

object (FunnelParameterFilterExpressionList)

orGroup의 FunnelParameterFilterExpression에는 OR 관계가 있습니다.
notExpression

object (FunnelParameterFilterExpression)

FunnelParameterFilterExpression이 notExpression의 값이 아닙니다.
funnelParameterFilter

object (FunnelParameterFilter)

기본 유입경로 매개변수 필터입니다.

FunnelParameterFilterExpressionList

유입경로 매개변수 필터 표현식의 목록입니다.

JSON 표현 
{
  "expressions": [
    {
      object (FunnelParameterFilterExpression)
    }
  ]
}
입력란
expressions[]

object (FunnelParameterFilterExpression)

유입경로 매개변수 필터 표현식의 목록입니다.

FunnelParameterFilter

유입경로에서 매개변수 값을 필터링하는 표현식입니다.

JSON 표현 
{

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
입력란
통합 필드 one_parameter. 필터링되는 필드입니다. one_parameter은 다음 중 하나여야 합니다.
eventParameterName

string

이 필터는 지정된 이벤트 매개변수에 대해 평가됩니다. 이벤트 매개변수는 이벤트의 매개변수로 기록됩니다. 이벤트 매개변수에는 'firebase_screen' 및 'currency'와 같은 필드가 포함됩니다.

이벤트 매개변수는 세그먼트 및 유입경로에서만 사용할 수 있으며 EventFilter의 하위 필터에서만 사용할 수 있습니다. EventFilter의 하위 필터에서는 이벤트 또는 항목 매개변수를 사용해야 합니다.
itemParameterName

string

이 필터는 지정된 항목 매개변수에 대해 평가됩니다. 항목 매개변수는 항목 배열에 매개변수로 기록됩니다. 상품 매개변수에는 'item_name' 및 'item_category'와 같은 필드가 포함됩니다.

항목 매개변수는 세그먼트 및 유입경로에서만 사용할 수 있으며 EventFilter의 하위 필터에서만 사용할 수 있습니다. EventFilter의 하위 필터에서는 이벤트 또는 항목 매개변수를 사용해야 합니다.

항목 매개변수는 전자상거래 이벤트에서만 사용할 수 있습니다. 전자상거래 이벤트에 대한 자세한 내용은 전자상거래 측정 가이드를 참고하세요.
통합 필드 one_filter. 한 가지 유형의 필터를 지정하세요. one_filter은 다음 중 하나여야 합니다.
stringFilter

object (StringFilter)

문자열 관련 필터입니다.
inListFilter

object (InListFilter)

목록 값의 필터입니다.
numericFilter

object (NumericFilter)

숫자 또는 날짜 값을 위한 필터입니다.
betweenFilter

object (BetweenFilter)

두 값 사이의 필터입니다.

FunnelBreakdown

분류를 사용하면 유입경로 표 하위 보고서 응답에 측정기준이 추가됩니다.

JSON 표현 
{
  "breakdownDimension": {
    object (Dimension)
  },
  "limit": string
}
입력란
breakdownDimension

object (Dimension)

유입경로 표 하위 보고서 응답에 추가된 측정기준 열입니다. 세부 측정기준은 각 유입경로 단계를 세분화합니다. funnelBreakdown가 지정된 경우 유효한 breakdownDimension가 필요합니다.
limit

string (int64 format)

응답에서 반환할 세부 측정기준의 고유값의 최대 개수입니다. 한도가 지정되지 않으면 limit 5이 사용됩니다. 한도는 0을 초과해야 하며 15를 초과할 수 없습니다.

측정기준

측정기준은 데이터의 속성입니다. 예를 들어 도시 측정기준은 이벤트가 발생한 도시를 나타냅니다. 보고서 응답의 측정기준 값은 문자열입니다. 예를 들어 도시는 '파리' 또는 '뉴욕'일 수 있습니다.

JSON 표현 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
입력란
name

string

측정기준의 이름입니다. runReport 및 batchRunReports와 같은 핵심 보고 메서드에서 지원하는 측정기준 이름 목록은 API 측정기준을 참고하세요. runRealtimeReport 메서드에서 지원되는 측정기준 이름 목록은 실시간 측정기준을 참조하세요. runFunnelReport 메서드에서 지원하는 측정기준 이름 목록은 유입경로 측정기준을 참고하세요.

dimensionExpression가 지정되면 name는 허용되는 문자 집합에 원하는 어떤 문자열이든 가능합니다. 예를 들어 dimensionExpression가 country와 city를 연결하는 경우 해당 측정기준을 countryAndCity이라고 할 수 있습니다. 선택한 측정기준 이름은 정규 표현식 ^[a-zA-Z0-9_]$과 일치해야 합니다.

크기는 dimensionFilter, orderBys, dimensionExpression, pivots의 name에서 참조됩니다.
dimensionExpression

object (DimensionExpression)

하나의 측정기준은 여러 측정기준을 사용한 표현식의 결과일 수 있습니다. 예를 들어 측정기준 '국가, 도시': concatenate(국가, ", ", 도시)입니다.

DimensionExpression

여러 측정기준의 수식의 결과인 측정기준을 표현하는 데 사용됩니다. 사용 예: 1)lowerCase(dimension) 2) concatenate(dimension1, sym, dimension2).

JSON 표현 
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
입력란
통합 필드 one_expression. DimensionExpression에 대해 한 가지 유형의 측정기준 표현식을 지정하세요. one_expression은 다음 중 하나여야 합니다.
lowerCase

object (CaseExpression)

측정기준 값을 소문자로 변환하는 데 사용됩니다.
upperCase

object (CaseExpression)

측정기준 값을 대문자로 변환하는 데 사용됩니다.
concatenate

object (ConcatenateExpression)

측정기준 값을 단일 측정기준으로 결합하는 데 사용됩니다. 예를 들어 측정기준 '국가, 도시': concatenate(국가, ", ", 도시)입니다.

CaseExpression

측정기준 값을 단일 케이스로 변환하는 데 사용됩니다.

JSON 표현 
{
  "dimensionName": string
}
입력란
dimensionName

string

측정기준의 이름입니다. 이름은 요청의 측정기준 필드에 있는 이름을 다시 참조해야 합니다.

ConcatenateExpression

측정기준 값을 단일 측정기준으로 결합하는 데 사용됩니다.

JSON 표현 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
입력란
dimensionNames[]

string

측정기준의 이름입니다. 이름은 요청의 측정기준 필드에 있는 이름을 다시 참조해야 합니다.
delimiter

string

측정기준 이름 사이에 있는 구분 기호입니다.

구분자는 '|' 또는 ''와 같은 단일 문자인 경우가 많지만 긴 문자열일 수도 있습니다. 측정기준 값에 구분자가 포함된 경우 구분 없이 둘 다 표시됩니다. 예를 들어 측정기준 1 값이 'US,FR', 측정기준 2 값이 'JP', 구분 기호 = ','이면 응답에 'US,FR, JP'가 포함됩니다.

FunnelNextAction

다음 액션은 사용자가 한 단계를 완료한 후 동일한 사용자가 다음 단계에 도달하기 전에 측정기준의 값을 나타냅니다. 예를 들어 nextActionDimension가 eventName이면 i번째 유입경로 단계 행의 nextActionDimension은 사용자가 i번째 유입경로 단계에 요건을 충족한 이벤트 후, 사용자가 i+1번째 유입경로 단계에 도달하기 전의 첫 번째 이벤트를 반환합니다.

JSON 표현 
{
  "nextActionDimension": {
    object (Dimension)
  },
  "limit": string
}
입력란
nextActionDimension

object (Dimension)

유입경로 시각화 하위 보고서 응답에 추가된 측정기준 열입니다. 다음 액션 측정기준은 사용자가 i번째 유입경로 단계에 도달한 후 이 측정기준의 다음 측정기준 값을 반환합니다.

nextActionDimension에서는 현재 eventName 및 대부분의 페이지 / 화면 측정기준(예: pageTitle, pagePath)만 지원합니다. nextActionDimension은(는) 측정기준 표현식이 될 수 없습니다.
limit

string (int64 format)

응답에서 반환할 세부 측정기준의 고유값의 최대 개수입니다. 한도가 지정되지 않으면 limit 5이 사용됩니다. 한도는 0을 초과해야 하며 5를 초과할 수 없습니다.

FunnelVisualizationType

유입경로 시각화 하위 보고서 응답에 있는 측정기준을 관리합니다.

열거형
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED 알 수 없는 유형.
STANDARD_FUNNEL 표준 (계단식) 유입경로 응답의 유입경로 시각화 하위 보고서에는 날짜가 포함되지 않습니다.
TRENDED_FUNNEL 선 차트형 유입경로 응답의 유입경로 시각화 하위 보고서에는 날짜 측정기준이 포함됩니다.

세그먼트

세그먼트는 애널리틱스 데이터의 하위 집합입니다. 예를 들어 사용자의 전체 집합 중에서 특정 국가 또는 도시의 사용자에 해당하는 세그먼트를 만들 수 있으며, 특정 제품 라인을 구매한 사용자 또는 사이트의 특정 부분을 방문하거나 앱에서 특정 이벤트를 트리거한 사용자로 세그먼트를 만들 수도 있습니다.

자세한 내용은 GA4 세그먼트 작성 도구를 참고하세요.

JSON 표현 
{
  "name": string,

  // Union field one_segment_scope can be only one of the following:
  "userSegment": {
    object (UserSegment)
  },
  "sessionSegment": {
    object (SessionSegment)
  },
  "eventSegment": {
    object (EventSegment)
  }
  // End of list of possible types for union field one_segment_scope.
}
입력란
name

string

이 세그먼트의 이름입니다. 지정하지 않으면 세그먼트의 이름이 '세그먼트'로 지정됩니다. 이 이름은 segment 측정기준에서 반환하는 문자열 값을 정의합니다. segment 측정기준에서는 요청에 있는 세그먼트의 1부터 시작하는 색인 번호별로 세그먼트 이름을 접두사로 사용합니다 (예: '1. 분류 기준', '2. 세그먼트' 등).
통합 필드 one_segment_scope. 세그먼트는 하나의 범위에서 지정됩니다. one_segment_scope은 다음 중 하나여야 합니다.
userSegment

object (UserSegment)

사용자 세그먼트는 사이트 또는 앱에 참여한 사용자의 하위 집합입니다.
sessionSegment

object (SessionSegment)

세션 세그먼트는 사이트 또는 앱에서 발생한 세션의 하위 집합입니다.
eventSegment

object (EventSegment)

이벤트 세그먼트는 사이트 또는 앱에서 트리거된 이벤트의 하위 집합입니다.

UserSegment

사용자 세그먼트는 사이트 또는 앱에 참여한 사용자의 하위 집합입니다. 예: 이전에 구매한 사용자, 장바구니에 상품을 추가했지만 구매를 완료하지 않은 사용자를 예로 들 수 있습니다.

JSON 표현 
{
  "userInclusionCriteria": {
    object (UserSegmentCriteria)
  },
  "exclusion": {
    object (UserSegmentExclusion)
  }
}
입력란
userInclusionCriteria

object (UserSegmentCriteria)

이 세그먼트에 포함되는 사용자를 정의합니다. 선택사항입니다.
exclusion

object (UserSegmentExclusion)

이 세그먼트에서 제외되는 사용자를 정의합니다. 선택사항입니다.

UserSegmentCriteria

사용자의 이벤트가 기준의 조건을 충족하면 사용자는 기준과 일치합니다.

JSON 표현 
{
  "andConditionGroups": [
    {
      object (UserSegmentConditionGroup)
    }
  ],
  "andSequenceGroups": [
    {
      object (UserSegmentSequenceGroup)
    }
  ]
}
입력란
andConditionGroups[]

object (UserSegmentConditionGroup)

사용자가 각 andConditionGroups 및 각 andSequenceGroups와 일치하면 이 기준에 부합하는 사용자입니다. andSequenceGroups가 지정된 경우 andConditionGroups가 비어 있을 수 있습니다.
andSequenceGroups[]

object (UserSegmentSequenceGroup)

사용자가 각 andSequenceGroups 및 각 andConditionGroups와 일치하면 이 기준에 부합하는 사용자입니다. andConditionGroups가 지정된 경우 andSequenceGroups가 비어 있을 수 있습니다.

UserSegmentConditionGroup

조건은 애널리틱스에서 세그먼트에 포함하거나 세그먼트에서 제외할 데이터를 지정합니다.

JSON 표현 
{
  "conditionScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
입력란
conditionScoping

enum (UserCriteriaScoping)

데이터는 조건 그룹과의 일치 여부에 따라 세그먼트에 포함되거나 제외됩니다. 이 범위 지정은 조건 그룹의 일치 여부를 판단하기 전에 segmentFilterExpression이 평가되는 이벤트 수를 정의합니다. 예를 들어 conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION인 경우 세션의 모든 이벤트에서 표현식이 평가된 후 이 사용자에 대해 조건 그룹이 일치하는지 여부를 결정합니다. 예를 들어 conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT인 경우 단일 이벤트에서 표현식이 평가된 후 이 사용자에 대해 조건 그룹이 일치하는지 여부를 결정합니다.

선택사항입니다. 지정하지 않으면 conditionScoping = ACROSS_ALL_SESSIONS이 사용됩니다.
segmentFilterExpression

object (SegmentFilterExpression)

데이터는 이 표현식과 일치하는지에 따라 세그먼트에 포함되거나 제외됩니다. 표현식은 측정기준, 측정항목 또는 매개변수에 대한 기준을 표현합니다.

UserCriteriaScoping

범위 지정은 사용자가 기준을 충족하는지 평가할 때 고려할 이벤트를 지정합니다.

열거형
USER_CRITERIA_SCOPING_UNSPECIFIED 지정되지 않은 기준 범위 지정. 지정하지 않습니다.
USER_CRITERIA_WITHIN_SAME_EVENT 한 이벤트 내에서 기준이 충족되면 사용자가 기준과 일치합니다.
USER_CRITERIA_WITHIN_SAME_SESSION 한 세션 내에서 기준이 충족되면 사용자가 기준과 일치합니다.
USER_CRITERIA_ACROSS_ALL_SESSIONS 사용자의 이벤트가 기준을 충족하면 사용자는 기준과 일치합니다.

SegmentFilterExpression

세그먼트 필터의 조합을 표현합니다.

JSON 표현 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentFilterExpressionList)
  },
  "orGroup": {
    object (SegmentFilterExpressionList)
  },
  "notExpression": {
    object (SegmentFilterExpression)
  },
  "segmentFilter": {
    object (SegmentFilter)
  },
  "segmentEventFilter": {
    object (SegmentEventFilter)
  }
  // End of list of possible types for union field expr.
}
입력란
통합 필드 expr. SegmentFilterExpression에 대해 한 가지 유형의 필터를 지정하세요. expr은 다음 중 하나여야 합니다.
andGroup

object (SegmentFilterExpressionList)

andGroup의 SegmentFilterExpression에는 AND 관계가 있습니다.
orGroup

object (SegmentFilterExpressionList)

orGroup의 SegmentFilterExpression에는 OR 관계가 있습니다.
notExpression

object (SegmentFilterExpression)

SegmentFilterExpression이 notExpression의 값이 아닙니다.
segmentFilter

object (SegmentFilter)

기본 세그먼트 필터입니다.
segmentEventFilter

object (SegmentEventFilter)

단일 이벤트 이름의 이벤트와 일치하는 필터를 만듭니다. 매개변수 필터 표현식이 지정되면 단일 이벤트 이름 및 매개변수 필터 표현식과 모두 일치하는 이벤트의 하위 집합만 이 이벤트 필터와 일치합니다.

SegmentFilterExpressionList

세그먼트 필터 표현식의 목록입니다.

JSON 표현 
{
  "expressions": [
    {
      object (SegmentFilterExpression)
    }
  ]
}
입력란
expressions[]

object (SegmentFilterExpression)

세그먼트 필터 표현식의 목록

SegmentFilter

측정기준 또는 측정항목 값을 필터링하는 표현식입니다.

JSON 표현 
{
  "fieldName": string,
  "filterScoping": {
    object (SegmentFilterScoping)
  },

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
입력란
fieldName

string

측정기준 이름 또는 측정항목 이름입니다.
filterScoping

object (SegmentFilterScoping)

필터의 범위를 지정합니다.
통합 필드 one_filter. Filter에 대해 한 가지 유형의 필터를 지정하세요. one_filter은 다음 중 하나여야 합니다.
stringFilter

object (StringFilter)

문자열 관련 필터입니다.
inListFilter

object (InListFilter)

목록 값의 필터입니다.
numericFilter

object (NumericFilter)

숫자 또는 날짜 값을 위한 필터입니다.
betweenFilter

object (BetweenFilter)

두 값 사이의 필터입니다.

SegmentFilterScoping

범위를 통해 세그먼트 필터를 평가할 때 여러 이벤트의 측정기준 및 측정항목을 어떻게 고려해야 하는지 지정할 수 있습니다.

JSON 표현 
{
  "atAnyPointInTime": boolean
}
입력란
atAnyPointInTime

boolean

atAnyPointInTime가 true인 경우 이 필터는 요청 기간의 모든 이벤트에 대해 true로 평가될 경우 모든 이벤트에 대해 true로 평가됩니다.

이 atAnyPointInTime 매개변수는 보고서 이벤트의 기간을 연장하지 않습니다. atAnyPointInTime가 true인 경우 이 필터를 평가할 때 보고서 기간 내의 이벤트만 고려됩니다.

이 atAnyPointInTime는 기준 범위 지정이 ACROSS_ALL_SESSIONS이고 시퀀스로 지정할 수 없는 경우에만 지정할 수 있습니다.

기준 범위가 ACROSS_ALL_SESSIONS인 경우 지정되지 않으면 atAnyPointInTime = false가 사용됩니다.

SegmentEventFilter

단일 이벤트 이름의 이벤트와 일치하는 필터를 만듭니다. 매개변수 필터 표현식이 지정되면 단일 이벤트 이름 및 매개변수 필터 표현식과 모두 일치하는 이벤트의 하위 집합만 이 이벤트 필터와 일치합니다.

JSON 표현 
{
  "eventName": string,
  "segmentParameterFilterExpression": {
    object (SegmentParameterFilterExpression)
  }
}
입력란
eventName

string

이 필터는 이 단일 이벤트 이름의 이벤트와 일치합니다. 이벤트 이름은 필수 항목입니다.
segmentParameterFilterExpression

object (SegmentParameterFilterExpression)

지정된 경우 이 필터는 단일 이벤트 이름 및 매개변수 필터 표현식과 모두 일치하는 이벤트와 일치합니다.

매개변수 필터 표현식 내에서는 매개변수 필터만 사용할 수 있습니다.

SegmentParameterFilterExpression

매개변수에 대한 세그먼트 필터 조합을 표현합니다.

JSON 표현 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "orGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "notExpression": {
    object (SegmentParameterFilterExpression)
  },
  "segmentParameterFilter": {
    object (SegmentParameterFilter)
  }
  // End of list of possible types for union field expr.
}
입력란
통합 필드 expr. SegmentParameterFilterExpression에 대해 한 가지 유형의 필터를 지정하세요. expr은 다음 중 하나여야 합니다.
andGroup

object (SegmentParameterFilterExpressionList)

andGroup의 SegmentParameterFilterExpression에는 AND 관계가 있습니다.
orGroup

object (SegmentParameterFilterExpressionList)

orGroup의 SegmentParameterFilterExpression에는 OR 관계가 있습니다.
notExpression

object (SegmentParameterFilterExpression)

SegmentParameterFilterExpression이 notExpression의 값이 아닙니다.
segmentParameterFilter

object (SegmentParameterFilter)

기본 세그먼트 매개변수 필터입니다.

SegmentParameterFilterExpressionList

세그먼트 매개변수 필터 표현식의 목록입니다.

JSON 표현 
{
  "expressions": [
    {
      object (SegmentParameterFilterExpression)
    }
  ]
}
입력란
expressions[]

object (SegmentParameterFilterExpression)

세그먼트 매개변수 필터 표현식의 목록입니다.

SegmentParameterFilter

세그먼트에서 매개변수 값을 필터링하는 표현식입니다.

JSON 표현 
{
  "filterScoping": {
    object (SegmentParameterFilterScoping)
  },

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
입력란
filterScoping

object (SegmentParameterFilterScoping)

필터의 범위를 지정합니다.
통합 필드 one_parameter. 필터링되는 필드입니다. one_parameter은 다음 중 하나여야 합니다.
eventParameterName

string

이 필터는 지정된 이벤트 매개변수에 대해 평가됩니다. 이벤트 매개변수는 이벤트의 매개변수로 기록됩니다. 이벤트 매개변수에는 'firebase_screen' 및 'currency'와 같은 필드가 포함됩니다.

이벤트 매개변수는 세그먼트 및 유입경로에서만 사용할 수 있으며 EventFilter의 하위 필터에서만 사용할 수 있습니다. EventFilter의 하위 필터에서는 이벤트 또는 항목 매개변수를 사용해야 합니다.
itemParameterName

string

이 필터는 지정된 항목 매개변수에 대해 평가됩니다. 항목 매개변수는 항목 배열에 매개변수로 기록됩니다. 상품 매개변수에는 'item_name' 및 'item_category'와 같은 필드가 포함됩니다.

항목 매개변수는 세그먼트 및 유입경로에서만 사용할 수 있으며 EventFilter의 하위 필터에서만 사용할 수 있습니다. EventFilter의 하위 필터에서는 이벤트 또는 항목 매개변수를 사용해야 합니다.

항목 매개변수는 전자상거래 이벤트에서만 사용할 수 있습니다. 전자상거래 이벤트에 대한 자세한 내용은 전자상거래 측정 가이드를 참고하세요.
통합 필드 one_filter. 한 가지 유형의 필터를 지정하세요. one_filter은 다음 중 하나여야 합니다.
stringFilter

object (StringFilter)

문자열 관련 필터입니다.
inListFilter

object (InListFilter)

목록 값의 필터입니다.
numericFilter

object (NumericFilter)

숫자 또는 날짜 값을 위한 필터입니다.
betweenFilter

object (BetweenFilter)

두 값 사이의 필터입니다.

SegmentParameterFilterScoping

범위는 세그먼트 매개변수 필터를 평가할 때 여러 이벤트를 고려해야 하는 방식을 지정합니다.

JSON 표현 
{
  "inAnyNDayPeriod": string
}
입력란
inAnyNDayPeriod

string (int64 format)

필터를 적용하기 전에 지정된 기간(일) 동안 매개변수를 누적합니다. 기준 범위가 ACROSS_ALL_SESSIONS 또는 WITHIN_SAME_SESSION인 경우에만 지원됩니다. 매개변수가 event_count인 경우에만 지원됩니다.

예를 들어 inAnyNDayPeriod이 3, eventName이 'purchase', 이벤트 매개변수가 'event_count', 필터 기준이 5보다 큰 경우 이 필터는 보고서 기간 중 연속 3일마다 구매 이벤트의 이벤트 수를 누적합니다. 사용자는 3일 중 연속 5회를 초과하는 구매 이벤트 수가 이 세그먼트에 포함되는 경우 이 필터의 기준을 통과합니다. 예를 들어 2021년 11월 1일부터 2021년 11월 3일까지, 2021년 11월 2일부터 2021년 11월 4일까지, 2021년 11월 3일부터 2021년 11월 5일까지의 기간이 고려됩니다.

기간의 시작에 근접한 N일의 기간을 확보하기 위해 기간이 연장되지 않았습니다. 예를 들어 2021년 11월 1일부터 2021년 11월 10일까지의 보고서이고 inAnyNDayPeriod = 3인 경우 보고서 기간을 벗어나는 이벤트 데이터를 읽을 수 없으므로 처음 2일의 기간이 효과적으로 짧아집니다. 예를 들어 처음 4개의 기간은 사실상 2021년 11월 1일부터 2021년 11월 1일까지, 2021년 11월 1일부터 2021년 11월 1일부터 2021년 11월 2일까지, 2021년 11월 1일부터 2021년 11월 3일까지, 2021년 11월 1일부터 2021년 11월 1일부터 2021년 11월 1일부터 2021년 11월 1일까지가 됩니다.

inAnyNDayPeriod는 선택사항입니다. 지정하지 않으면 segmentParameterFilter이 각 이벤트에 개별적으로 적용됩니다.

UserSegmentSequenceGroup

사용자가 세그먼트의 회원이 되기 위해 특정 순서로 발생해야 하는 조건을 정의합니다.

JSON 표현 
{
  "sequenceScoping": enum (UserCriteriaScoping),
  "sequenceMaximumDuration": string,
  "userSequenceSteps": [
    {
      object (UserSequenceStep)
    }
  ]
}
입력란
sequenceScoping

enum (UserCriteriaScoping)

사용자가 시퀀스와 일치하려면 범위 지정에서 모든 시퀀스 단계가 충족되어야 합니다. 예를 들어 sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION인 경우 사용자가 시퀀스와 일치하려면 모든 시퀀스 단계가 한 세션 내에 완료되어야 합니다. sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT는 지원되지 않습니다.

선택사항입니다. 지정하지 않으면 conditionScoping = ACROSS_ALL_SESSIONS이 사용됩니다.
sequenceMaximumDuration

string (Duration format)

전체 시퀀스가 발생해야 하는 기간을 정의합니다(예: 30분). sequenceMaximumDuration에는 마이크로초 단위의 엔드포인트가 포함됩니다. 예를 들어 최대 길이가 5초인 시퀀스는 4.9초 또는 5.0초로 완료할 수 있지만 5초 및 1마이크로초에는 완료할 수 없습니다.

sequenceMaximumDuration은 선택사항이며, 지정되지 않은 경우 시퀀스는 원하는 시간 내에 완료될 수 있습니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
userSequenceSteps[]

object (UserSequenceStep)

조건 단계의 순서가 지정된 순서입니다. 사용자가 UserSegmentSequenceGroup과 일치시키려면 사용자의 이벤트가 각 단계를 완료해야 합니다.

UserSequenceStep

이 사용자가 시퀀스와 일치시키기 위해 지정된 단계 순서대로 발생해야 하는 조건입니다.

JSON 표현 
{
  "isDirectlyFollowedBy": boolean,
  "stepScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
입력란
isDirectlyFollowedBy

boolean

true인 경우 이 단계를 충족하는 이벤트는 마지막 단계를 충족하는 이벤트 이후의 바로 다음 이벤트여야 합니다. false인 경우 이 단계는 이전 단계를 간접적으로 따릅니다. 예를 들어 이전 단계와 이 단계 사이에 이벤트가 있을 수 있습니다. 첫 번째 단계에서 isDirectlyFollowedBy은 false여야 합니다.
stepScoping

enum (UserCriteriaScoping)

사용자가 시퀀스와 일치시키려면 범위 지정에서 이 시퀀스 단계가 충족되어야 합니다. 예를 들어 sequenceScoping = WITHIN_SAME_SESSION인 경우 이 시퀀스 단계가 한 세션 내에 완료되어야 사용자가 시퀀스와 일치하게 됩니다. stepScoping = ACROSS_ALL_SESSIONS는 sequenceScoping = ACROSS_ALL_SESSIONS인 경우에만 허용됩니다.

선택사항입니다. 지정하지 않으면 stepScoping에서 sequenceScoping와 동일한 UserCriteriaScoping를 사용합니다.
segmentFilterExpression

object (SegmentFilterExpression)

사용자의 이벤트가 이 표현식과 일치하는 경우 사용자는 이 시퀀스 단계와 일치합니다. 표현식은 측정기준, 측정항목 또는 매개변수에 대한 기준을 표현합니다.

UserSegmentExclusion

이 세그먼트에서 제외할 사용자를 지정합니다.

JSON 표현 
{
  "userExclusionDuration": enum (UserExclusionDuration),
  "userExclusionCriteria": {
    object (UserSegmentCriteria)
  }
}
입력란
userExclusionDuration

enum (UserExclusionDuration)

사용자가 userExclusionCriteria와 일치하는 경우 제외가 지속되는 시간을 지정합니다.

선택사항입니다. 지정하지 않으면 USER_EXCLUSION_TEMPORARY의 userExclusionDuration가 사용됩니다.
userExclusionCriteria

object (UserSegmentCriteria)

이 조건을 충족하는 사용자는 userExclusionDuration 세그먼트의 멤버십에서 제외됩니다.

UserExclusionDuration

사용자가 userExclusionCriteria와 일치하는 경우 제외가 지속되는 시간에 대한 옵션을 열거합니다.

열거형
USER_EXCLUSION_DURATION_UNSPECIFIED 제외 기간이 지정되지 않았습니다. 지정하지 않습니다.
USER_EXCLUSION_TEMPORARY 사용자가 userExclusionCriteria 조건을 충족하는 기간 동안 사용자를 세그먼트에서 일시적으로 제외합니다.
USER_EXCLUSION_PERMANENT 사용자가 userExclusionCriteria 조건을 충족하면 세그먼트에서 사용자를 영구적으로 제외합니다.

SessionSegment

세션 세그먼트는 사이트 또는 앱에서 발생한 세션의 하위 집합입니다. 예: 특정 광고 캠페인에서 발생한 모든 세션

JSON 표현 
{
  "sessionInclusionCriteria": {
    object (SessionSegmentCriteria)
  },
  "exclusion": {
    object (SessionSegmentExclusion)
  }
}
입력란
sessionInclusionCriteria

object (SessionSegmentCriteria)

이 세그먼트에 포함되는 세션을 정의합니다. 선택사항입니다.
exclusion

object (SessionSegmentExclusion)

이 세그먼트에서 제외할 세션을 정의합니다. 선택사항입니다.

SessionSegmentCriteria

세션의 이벤트가 기준의 조건을 충족하면 세션이 기준과 일치합니다.

JSON 표현 
{
  "andConditionGroups": [
    {
      object (SessionSegmentConditionGroup)
    }
  ]
}
입력란
andConditionGroups[]

object (SessionSegmentConditionGroup)

세션이 이러한 각 andConditionGroups와 일치하면 세션이 이 기준과 일치합니다.

SessionSegmentConditionGroup

조건은 애널리틱스에서 세그먼트에 포함하거나 세그먼트에서 제외할 데이터를 지정합니다.

JSON 표현 
{
  "conditionScoping": enum (SessionCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
입력란
conditionScoping

enum (SessionCriteriaScoping)

데이터는 조건 그룹과의 일치 여부에 따라 세그먼트에 포함되거나 제외됩니다. 이 범위 지정은 조건 그룹의 일치 여부를 판단하기 전에 segmentFilterExpression이 평가되는 이벤트 수를 정의합니다. 예를 들어 conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION인 경우 한 세션의 모든 이벤트에서 표현식이 평가된 후 이 세션에서 조건 그룹이 일치하는지 여부를 결정됩니다. 예를 들어 conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT인 경우 단일 이벤트에서 표현식이 평가된 후 이 세션에서 조건 그룹이 일치하는지 여부를 결정됩니다.

선택사항입니다. 지정하지 않으면 WITHIN_SAME_SESSION의 conditionScoping가 사용됩니다.
segmentFilterExpression

object (SegmentFilterExpression)

데이터는 이 표현식과 일치하는지에 따라 세그먼트에 포함되거나 제외됩니다. 표현식은 측정기준, 측정항목 또는 매개변수에 대한 기준을 표현합니다.

SessionCriteriaScoping

범위 지정은 세션이 기준을 충족하는지 평가할 때 고려할 이벤트를 지정합니다.

열거형
SESSION_CRITERIA_SCOPING_UNSPECIFIED 지정되지 않은 기준 범위 지정. 지정하지 않습니다.
SESSION_CRITERIA_WITHIN_SAME_EVENT 하나의 이벤트 내에서 기준이 충족되면 세션이 기준과 일치합니다.
SESSION_CRITERIA_WITHIN_SAME_SESSION 한 세션 내에서 기준이 충족되면 세션이 기준과 일치합니다.

SessionSegmentExclusion

이 세그먼트에서 제외할 세션을 지정합니다.

JSON 표현 
{
  "sessionExclusionDuration": enum (SessionExclusionDuration),
  "sessionExclusionCriteria": {
    object (SessionSegmentCriteria)
  }
}
입력란
sessionExclusionDuration

enum (SessionExclusionDuration)

세션이 sessionExclusionCriteria와 일치하는 경우 제외가 지속되는 시간을 지정합니다.

선택사항입니다. 지정하지 않으면 SESSION_EXCLUSION_TEMPORARY의 sessionExclusionDuration가 사용됩니다.
sessionExclusionCriteria

object (SessionSegmentCriteria)

세션이 이 조건을 충족하면 세션이 sessionExclusionDuration 세그먼트의 멤버십에서 제외됩니다.

SessionExclusionDuration

세션이 sessionExclusionCriteria와 일치하는 경우 제외가 지속되는 시간에 대한 옵션을 열거합니다.

열거형
SESSION_EXCLUSION_DURATION_UNSPECIFIED 제외 기간이 지정되지 않았습니다. 지정하지 않습니다.
SESSION_EXCLUSION_TEMPORARY 세션이 sessionExclusionCriteria 조건을 충족하는 기간 동안 세션을 세그먼트에서 일시적으로 제외합니다.
SESSION_EXCLUSION_PERMANENT 세션이 sessionExclusionCriteria 조건을 충족하면 세그먼트에서 세션을 영구적으로 제외합니다.

EventSegment

이벤트 세그먼트는 사이트 또는 앱에서 트리거된 이벤트의 하위 집합입니다. 예: 특정 위치에서 발생한 모든 구매 이벤트, 특정 운영체제에서 발생한 app_exception 이벤트.

JSON 표현 
{
  "eventInclusionCriteria": {
    object (EventSegmentCriteria)
  },
  "exclusion": {
    object (EventSegmentExclusion)
  }
}
입력란
eventInclusionCriteria

object (EventSegmentCriteria)

이 세그먼트에 포함되는 이벤트를 정의합니다. 선택사항입니다.
exclusion

object (EventSegmentExclusion)

이 세그먼트에서 제외할 이벤트를 정의합니다. 선택사항입니다.

EventSegmentCriteria

이벤트가 기준의 조건을 충족하면 기준과 일치합니다.

JSON 표현 
{
  "andConditionGroups": [
    {
      object (EventSegmentConditionGroup)
    }
  ]
}
입력란
andConditionGroups[]

object (EventSegmentConditionGroup)

이벤트가 이러한 각 andConditionGroups와 일치하는 경우 이벤트가 이 기준과 일치합니다.

EventSegmentConditionGroup

조건은 애널리틱스에서 세그먼트에 포함하거나 세그먼트에서 제외할 데이터를 지정합니다.

JSON 표현 
{
  "conditionScoping": enum (EventCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
입력란
conditionScoping

enum (EventCriteriaScoping)

conditionScoping는 항상 EVENT_CRITERIA_WITHIN_SAME_EVENT여야 합니다.

선택사항입니다. 지정하지 않으면 EVENT_CRITERIA_WITHIN_SAME_EVENT의 conditionScoping가 사용됩니다.
segmentFilterExpression

object (SegmentFilterExpression)

데이터는 이 표현식과 일치하는지에 따라 세그먼트에 포함되거나 제외됩니다. 표현식은 측정기준, 측정항목 또는 매개변수에 대한 기준을 표현합니다.

EventCriteriaScoping

범위 지정은 이벤트가 기준을 충족하는지 평가할 때 고려할 이벤트를 지정합니다.

열거형
EVENT_CRITERIA_SCOPING_UNSPECIFIED 지정되지 않은 기준 범위 지정. 지정하지 않습니다.
EVENT_CRITERIA_WITHIN_SAME_EVENT 한 이벤트 내에서 기준이 충족되면 이벤트가 기준과 일치합니다.

EventSegmentExclusion

이 세그먼트에서 제외할 이벤트를 지정합니다.

JSON 표현 
{
  "eventExclusionDuration": enum (EventExclusionDuration),
  "eventExclusionCriteria": {
    object (EventSegmentCriteria)
  }
}
입력란
eventExclusionDuration

enum (EventExclusionDuration)

eventExclusionDuration는 항상 PERMANENTLY_EXCLUDE여야 합니다.

선택사항입니다. 지정하지 않으면 EVENT_EXCLUSION_PERMANENT의 eventExclusionDuration가 사용됩니다.
eventExclusionCriteria

object (EventSegmentCriteria)

이벤트가 이 조건을 충족하면 eventExclusionDuration 세그먼트의 멤버십에서 해당 이벤트가 제외됩니다.

EventExclusionDuration

이벤트가 eventExclusionCriteria와 일치하는 경우 제외가 유지되는 기간에 대한 옵션을 열거합니다.

열거형
EVENT_EXCLUSION_DURATION_UNSPECIFIED 제외 기간이 지정되지 않았습니다. 지정하지 않습니다.
EVENT_EXCLUSION_PERMANENT 이벤트가 eventExclusionCriteria 조건을 충족하는 경우 이벤트를 세그먼트에서 영구적으로 제외합니다.

FilterExpression

측정기준 또는 측정항목 필터를 표현하기 위해 동일한 FilterExpression의 필드는 모든 측정기준 또는 모든 측정항목이어야 합니다.

JSON 표현 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of list of possible types for union field expr.
}
입력란
통합 필드 expr. FilterExpression에 대해 한 가지 유형의 필터 표현식을 지정합니다. expr은 다음 중 하나여야 합니다.
andGroup

object (FilterExpressionList)

andGroup의 FilterExpressions에는 AND 관계가 있습니다.
orGroup

object (FilterExpressionList)

orGroup의 FilterExpressions에는 OR 관계가 있습니다.
notExpression

object (FilterExpression)

FilterExpression은 notExpression이 아닙니다.
filter

object (Filter)

기본 필터 동일한 FilterExpression에서는 필터의 모든 필드 이름이 모든 측정기준 또는 측정항목이어야 합니다.

FilterExpressionList

필터 표현식의 목록입니다.

JSON 표현 
{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}
입력란
expressions[]

object (FilterExpression)

필터 표현식의 목록입니다.

필터

측정기준 또는 측정항목 값을 필터링하는 표현식입니다.

JSON 표현 
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
입력란
fieldName

string

측정기준 이름 또는 측정항목 이름입니다. 측정기준 또는 측정항목에 정의된 이름이어야 합니다.
통합 필드 one_filter. Filter에 대해 한 가지 유형의 필터를 지정하세요. one_filter은 다음 중 하나여야 합니다.
stringFilter

object (StringFilter)

문자열 관련 필터입니다.
inListFilter

object (InListFilter)

목록 값의 필터입니다.
numericFilter

object (NumericFilter)

숫자 또는 날짜 값을 위한 필터입니다.
betweenFilter

object (BetweenFilter)

두 값 사이의 필터입니다.

FunnelSubReport

유입경로 하위 보고서에는 측정기준 및 측정항목 데이터 값이 포함됩니다. 예를 들어 12명의 사용자가 유입경로의 두 번째 단계에 도달했다면

JSON 표현 
{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "metadata": {
    object (FunnelResponseMetadata)
  }
}
입력란
dimensionHeaders[]

object (DimensionHeader)

측정기준 열을 설명합니다. 유입경로 보고서는 하위 보고서 응답에 항상 유입경로 단계 측정기준을 포함합니다. 요청 시 분류, 날짜, 다음 조치와 같은 추가 측정기준이 응답에 표시될 수 있습니다.
metricHeaders[]

object (MetricHeader)

측정항목 열을 설명합니다. 유입경로 보고서에는 항상 하위 보고서 응답에 활성 사용자가 포함됩니다. 유입경로 표에는 완료율, 이탈률, 이탈률과 같은 추가 측정항목이 포함됩니다.
rows[]

object (Row)

보고서의 측정기준 값 조합과 측정항목 값의 행입니다.
metadata

object (FunnelResponseMetadata)

유입경로 보고서의 메타데이터입니다.

DimensionHeader

보고서의 측정기준 열을 설명합니다. 보고서에서 요청된 측정기준은 행과 DimensionHeaders 내에 열 항목을 생성합니다. 하지만 필터 또는 표현식 내에서만 사용되는 측정기준은 보고서에서 열을 생성하지 않습니다. 따라서 이러한 측정기준은 헤더를 생성하지 않습니다.

JSON 표현 
{
  "name": string
}
입력란
name

string

측정기준의 이름입니다.

MetricHeader

보고서의 측정항목 열을 설명합니다. 보고서에 요청된 표시 측정항목은 행과 MetricHeaders 내에 열 항목을 생성합니다. 하지만 필터 또는 표현식 내에서만 사용되는 측정항목은 보고서에 열을 생성하지 않습니다. 따라서 이러한 측정항목은 헤더를 생성하지 않습니다.

JSON 표현 
{
  "name": string,
  "type": enum (MetricType)
}
입력란
name

string

측정항목의 이름입니다.
type

enum (MetricType)

측정항목의 데이터 유형입니다.

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 킬로미터 단위의 길이, 특수 부동 소수점 유형.

행

각 행의 데이터를 보고합니다. 다음은 RunReportRequest에 포함된 예입니다.

"dimensions": [
  {
    "name": "eventName"
  },
  {
    "name": "countryId"
  }
],
"metrics": [
  {
    "name": "eventCount"
  }
]

여기서 eventName은 'in_app_purchase'이고, countryId는 'JP', eventCount는 15입니다.

"dimensionValues": [
  {
    "value": "in_app_purchase"
  },
  {
    "value": "JP"
  }
],
"metricValues": [
  {
    "value": "15"
  }
]
JSON 표현 
{
  "dimensionValues": [
    {
      object (DimensionValue)
    }
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
입력란
dimensionValues[]

object (DimensionValue)

요청된 측정기준 값의 목록입니다. PivotReport에서 dimensionValues는 피벗에 포함된 측정기준에 대해서만 나열됩니다.
metricValues[]

object (MetricValue)

요청된 표시 측정항목 값의 목록입니다.

DimensionValue

측정기준의 값입니다.

JSON 표현 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
입력란
통합 필드 one_value. 한 종류의 측정기준 값 one_value은 다음 중 하나여야 합니다.
value

string

크기 유형이 문자열인 경우 문자열 값

MetricValue

측정항목의 값입니다.

JSON 표현 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
입력란
통합 필드 one_value. 측정항목 값 one_value 중 하나는 다음 중 하나여야 합니다.
value

string

측정값입니다. 유형은 MetricHeader를 참조하세요.

FunnelResponseMetadata

유입경로 보고서의 응답 메타데이터에는 유입경로 보고서에 대한 추가 정보가 포함되어 있습니다.

JSON 표현 
{
  "samplingMetadatas": [
    {
      object (SamplingMetadata)
    }
  ]
}
입력란
samplingMetadatas[]

object (SamplingMetadata)

유입경로 보고서 결과가 샘플링된 경우 이 유입경로 보고서에서 사용된 이벤트의 비율을 나타냅니다. 각 기간에 하나의 samplingMetadatas가 채워집니다. 각 samplingMetadatas은 요청에 기간이 지정된 순서대로의 기간에 해당합니다.

하지만 결과가 샘플링되지 않으면 이 필드가 정의되지 않습니다.

SamplingMetadata

유입경로 보고서 결과가 샘플링된 경우 이 메타데이터는 특정 기간에 이 유입경로 보고서에서 사용된 이벤트의 비율을 나타냅니다. 샘플링은 대규모 데이터 세트에서 의미 있는 정보를 찾기 위해 모든 데이터의 하위 집합을 분석하는 방법입니다.

JSON 표현 
{
  "samplesReadCount": string,
  "samplingSpaceSize": string
}
입력란
samplesReadCount

string (int64 format)

이 샘플링 보고서에서 특정 기간에 읽은 총 이벤트 수입니다. 이 유입경로 보고서에서 분석된 이 속성의 데이터 하위 집합의 크기입니다.
samplingSpaceSize

string (int64 format)

특정 기간 동안 이 유입경로 보고서에서 분석될 수 있었던 이 속성의 데이터에 있는 총 이벤트 수입니다. 샘플링을 통해 대규모 데이터 세트에서 의미 있는 정보를 파악할 수 있으며, 이것이 더 큰 데이터 세트의 크기입니다.

이 유입경로 보고서에 사용된 사용 가능한 데이터의 비율을 계산하려면 samplesReadCount/samplingSpaceSize를 계산하세요.

PropertyQuota

이 애널리틱스 속성에 대한 모든 할당량의 현재 상태입니다. 속성의 할당량이 소진되면 해당 속성에 대한 모든 요청에서 리소스 소진 오류가 반환됩니다.

JSON 표현 
{
  "tokensPerDay": {
    object (QuotaStatus)
  },
  "tokensPerHour": {
    object (QuotaStatus)
  },
  "concurrentRequests": {
    object (QuotaStatus)
  },
  "serverErrorsPerProjectPerHour": {
    object (QuotaStatus)
  },
  "potentiallyThresholdedRequestsPerHour": {
    object (QuotaStatus)
  },
  "tokensPerProjectPerHour": {
    object (QuotaStatus)
  }
}
입력란
tokensPerDay

object (QuotaStatus)

표준 애널리틱스 속성은 하루에 최대 200,000개의 토큰을 사용할 수 있고, 애널리틱스 360 속성은 하루에 2,000,000개의 토큰을 사용할 수 있습니다. 대부분의 요청에서는 10개 미만의 토큰을 사용합니다.
tokensPerHour

object (QuotaStatus)

표준 애널리틱스 속성은 시간당 최대 40,000개의 토큰을 사용할 수 있고, 애널리틱스 360 속성은 시간당 400,000개의 토큰을 사용할 수 있습니다. API 요청은 단일 토큰 수를 사용하며 이 숫자는 모든 시간별, 일별 및 프로젝트별 시간별 할당량에서 차감됩니다.
concurrentRequests

object (QuotaStatus)

표준 애널리틱스 속성은 최대 10개의 동시 요청을 전송할 수 있으며, 애널리틱스 360 속성은 최대 50개의 동시 요청을 사용할 수 있습니다.
serverErrorsPerProjectPerHour

object (QuotaStatus)

표준 애널리틱스 속성과 클라우드 프로젝트 쌍에는 시간당 최대 10개의 서버 오류가 있을 수 있으며, 애널리틱스 360 속성과 클라우드 프로젝트 쌍의 경우 시간당 최대 50개의 서버 오류가 발생할 수 있습니다.
potentiallyThresholdedRequestsPerHour

object (QuotaStatus)

애널리틱스 속성은 기준점이 적용될 수 있는 측정기준과 함께 시간당 최대 120개의 요청을 전송할 수 있습니다. 일괄 요청에서 각 보고서 요청은 요청에 기준점을 설정할 수 있는 측정기준이 포함된 경우 이 할당량에 따라 개별적으로 계산됩니다.
tokensPerProjectPerHour

object (QuotaStatus)

애널리틱스 속성은 프로젝트별로 시간당 최대 35% 의 토큰을 사용할 수 있습니다. 표준 애널리틱스 속성에서는 시간당 프로젝트당 최대 14,000개의 토큰을 사용할 수 있으며, 애널리틱스 360 속성은 프로젝트별로 시간당 140,000개의 토큰을 사용할 수 있습니다. API 요청은 단일 토큰 수를 사용하며 이 숫자는 모든 시간별, 일별 및 프로젝트별 시간별 할당량에서 차감됩니다.

QuotaStatus

특정 할당량 그룹의 현재 상태입니다.

JSON 표현 
{
  "consumed": integer,
  "remaining": integer
}
입력란
consumed

integer

이 요청에서 사용한 할당량입니다.
remaining

integer

이 요청 후 남은 할당량입니다.