- HTTP 요청
- 경로 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- 유입경로
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- FunnelStep
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- FunnelFilterExpression
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- FunnelFilterExpressionList
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- FunnelFieldFilter
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- FunnelEventFilter
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- FunnelParameterFilterExpression
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- FunnelParameterFilterExpressionList
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- FunnelParameterFilter
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- FunnelBreakdown
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- FunnelNextAction
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- FunnelVisualizationType
- 세그먼트
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- UserSegment
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- UserSegmentCriteria
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- UserSegmentConditionGroup
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- UserCriteriaScoping
- SegmentFilterExpression
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- SegmentFilterExpressionList
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- SegmentFilter
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- SegmentFilterScoping
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- SegmentEventFilter
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- SegmentParameterFilterExpression
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- SegmentParameterFilterExpressionList
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- SegmentParameterFilter
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- SegmentParameterFilterScoping
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- UserSegmentSequenceGroup
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- UserSequenceStep
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- UserSegmentExclusion
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- UserExclusionDuration
- SessionSegment
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- SessionSegmentCriteria
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- SessionSegmentConditionGroup
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- SessionCriteriaScoping
- SessionSegmentExclusion
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- SessionExclusionDuration
- EventSegment
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- EventSegmentCriteria
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- EventSegmentConditionGroup
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- EventCriteriaScoping
- EventSegmentExclusion
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- EventExclusionDuration
- FunnelSubReport
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- FunnelResponseMetadata
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- SamplingMetadata
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- PropertyQuota
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- QuotaStatus
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 실습
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개의 행을 반환합니다. 측정기준 값이 |
dimensionFilter |
선택사항입니다. 측정기준 필터를 사용하면 보고서에서 특정 측정기준 값만 요청할 수 있습니다. 자세한 내용은 보고서 만들기: 측정기준 필터의 예를 참고하세요. 이 필터에서는 측정항목을 사용할 수 없습니다. |
returnPropertyQuota |
선택사항입니다. 이 애널리틱스 속성의 할당량의 현재 상태를 반환할지 여부를 전환합니다. 할당량은 PropertyQuota에 반환됩니다. |
응답 본문
유입경로 보고서 응답에는 두 개의 하위 보고서가 포함됩니다. 두 개의 하위 보고서는 서로 다른 측정기준과 측정항목의 조합입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "funnelTable": { object ( |
필드 | |
---|---|
funnelTable |
유입경로 표는 유입경로 단계, 세그먼트, 세부 측정기준, 활성 사용자, 완료율, 이탈률, 이탈률이 포함된 보고서입니다. 세그먼트 측정기준은 세그먼트가 요청된 경우에만 이 응답에 표시됩니다. 세부 측정기준은 요청된 경우에만 이 응답에 표시됩니다. |
funnelVisualization |
유입경로 시각화는 유입경로 단계, 세그먼트, 날짜, 다음 액션 측정기준, 활성 사용자가 포함된 보고서입니다. 세그먼트 측정기준은 세그먼트가 요청된 경우에만 이 응답에 표시됩니다. 날짜 측정기준은 |
propertyQuota |
이 요청을 포함한 이 애널리틱스 속성의 할당량 상태입니다. |
kind |
이 메시지가 어떤 리소스인지 식별합니다. 이 |
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
유입경로
유입경로 보고서 요청에서 유입경로를 구성합니다. 유입경로는 사용자가 일련의 단계를 거칠 때 사용자를 보고합니다.
유입경로 탐색 분석을 사용하면 사용자가 작업을 완료하기 위해 실행하는 단계를 시각적으로 확인하고 단계별 작업 완료 또는 실패 여부를 신속하게 확인할 수 있습니다. 예를 들어 어떻게 하면 잠재고객이 소핑객이 되고 다시 구매자가 될까요? 어떻게 하면 일회성 구매자가 반복 구매자가 될까요? 이 정보를 활용하면 비효율적이거나 이탈이 발생한 고객 여정을 개선할 수 있습니다.
JSON 표현 |
---|
{
"isOpenFunnel": boolean,
"steps": [
{
object ( |
필드 | |
---|---|
isOpenFunnel |
개방형 유입경로에서는 사용자가 모든 단계에서 유입경로를 입력할 수 있지만 폐쇄형 유입경로에서는 사용자가 첫 번째 단계에서 유입경로에 들어가야 합니다. 선택사항입니다. 지정하지 않으면 폐쇄형 유입경로가 사용됩니다. |
steps[] |
이 유입경로의 순차적 단계입니다. |
FunnelStep
단계는 측정할 사용자 여정을 정의합니다. 단계에는 사용자가 유입경로 여정 중 해당 단계에 포함되기 위해 충족해야 하는 하나 이상의 조건이 포함됩니다.
JSON 표현 |
---|
{
"name": string,
"isDirectlyFollowedBy": boolean,
"filterExpression": {
object ( |
필드 | |
---|---|
name |
이 단계의 고유한 이름입니다. 지정하지 않으면 1을 기반으로 하여 색인이 생성된 이름 (예: '0. ', '1. ' 등). 이 이름은 |
isDirectlyFollowedBy |
true인 경우 이 단계는 이전 단계를 바로 따라야 합니다. false인 경우 이전 단계와 이 단계 사이에 이벤트가 있을 수 있습니다. 지정하지 않으면 |
filterExpression |
사용자가 유입경로 여정의 이 단계에 포함되기 위해 충족해야 하는 조건입니다. |
withinDurationFromPriorStep |
지정할 경우 이 단계는 이전 단계가 완료되는 시간 내에 완료되어야 합니다.
소수점 아래가 최대 9자리까지이고 ' |
FunnelFilterExpression
유입경로 필터의 조합을 표현합니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 expr . FunnelFilterExpression 의 한 가지 필터 유형을 지정합니다. expr 은 다음 중 하나일 수 있습니다. |
|
andGroup |
|
orGroup |
|
notExpression |
FunnelFilterExpression이 |
funnelFieldFilter |
측정기준 또는 측정항목에 대한 유입경로 필터입니다. |
funnelEventFilter |
단일 이벤트 이름의 이벤트와 일치하는 필터를 만듭니다. 매개변수 필터 표현식이 지정된 경우 단일 이벤트 이름 및 매개변수 필터 표현식 모두와 일치하는 이벤트의 하위 집합만 이 이벤트 필터와 일치합니다. |
FunnelFilterExpressionList
유입경로 필터 표현식의 목록입니다.
JSON 표현 |
---|
{
"expressions": [
{
object ( |
필드 | |
---|---|
expressions[] |
유입경로 필터 표현식의 목록입니다. |
FunnelFieldFilter
측정기준 또는 측정항목 값을 필터링하기 위한 표현식입니다.
JSON 표현 |
---|
{ "fieldName": string, // Union field |
필드 | |
---|---|
fieldName |
측정기준 이름 또는 측정항목 이름입니다. |
통합 필드 one_filter . 한 가지 유형의 필터를 지정하세요. one_filter 은 다음 중 하나여야 합니다. |
|
stringFilter |
문자열 관련 필터입니다. |
inListFilter |
목록 값의 필터입니다. |
numericFilter |
숫자 또는 날짜 값에 대한 필터입니다. |
betweenFilter |
두 값 사이의 필터입니다. |
FunnelEventFilter
단일 이벤트 이름의 이벤트와 일치하는 필터를 만듭니다. 매개변수 필터 표현식이 지정된 경우 단일 이벤트 이름 및 매개변수 필터 표현식 모두와 일치하는 이벤트의 하위 집합만 이 이벤트 필터와 일치합니다.
JSON 표현 |
---|
{
"eventName": string,
"funnelParameterFilterExpression": {
object ( |
필드 | |
---|---|
eventName |
이 필터는 이 단일 이벤트 이름의 이벤트와 일치합니다. 이벤트 이름은 필수 항목입니다. |
funnelParameterFilterExpression |
지정된 경우 이 필터는 단일 이벤트 이름 및 매개변수 필터 표현식 모두와 일치하는 이벤트와 일치합니다. 매개변수 필터 표현식 내에서는 매개변수 필터만 사용할 수 있습니다. |
FunnelParameterFilterExpression
매개변수에 대한 유입경로 필터 조합을 표현합니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 expr . FunnelParameterFilterExpression 의 한 가지 필터 유형을 지정합니다. expr 은 다음 중 하나일 수 있습니다. |
|
andGroup |
|
orGroup |
|
notExpression |
FunnelParameterFilterExpression이 |
funnelParameterFilter |
기본 유입경로 매개변수 필터입니다. |
FunnelParameterFilterExpressionList
유입경로 매개변수 필터 표현식의 목록입니다.
JSON 표현 |
---|
{
"expressions": [
{
object ( |
필드 | |
---|---|
expressions[] |
유입경로 매개변수 필터 표현식의 목록입니다. |
FunnelParameterFilter
유입경로에서 매개변수 값을 필터링하는 표현식입니다.
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 |
두 값 사이의 필터입니다. |
FunnelBreakdown
분류는 유입경로 표 하위 보고서 응답에 측정기준을 추가합니다.
JSON 표현 |
---|
{
"breakdownDimension": {
object ( |
필드 | |
---|---|
breakdownDimension |
유입경로 표 하위 보고서 응답에 추가된 측정기준 열 세부 측정기준은 각 유입경로 단계를 세분화합니다. |
limit |
응답에서 반환할 세부 측정기준의 고유 값의 최대 개수입니다. 한도가 지정되지 않은 경우 |
FunnelNextAction
다음 액션은 사용자가 한 단계를 달성한 후 동일한 사용자가 다음 단계에 도달하기 전에 측정기준의 값을 나타냅니다. 예를 들어 nextActionDimension
가 eventName
인 경우 i
번째 유입경로 단계 행의 nextActionDimension
에서 사용자를 i
번째 유입경로 단계로 유도한 이벤트 후 사용자가 i+1
번째 유입경로 단계에 도달하기 전에 첫 번째 이벤트를 반환합니다.
JSON 표현 |
---|
{
"nextActionDimension": {
object ( |
필드 | |
---|---|
nextActionDimension |
유입경로 시각화 하위 보고서 응답에 추가된 측정기준 열입니다. 다음 액션 측정기준은 사용자가
|
limit |
응답에서 반환할 세부 측정기준의 고유 값의 최대 개수입니다. 한도가 지정되지 않은 경우 |
FunnelVisualizationType
유입경로 시각화 하위 보고서 응답에 있는 측정기준을 관리합니다.
열거형 | |
---|---|
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 |
이벤트 세그먼트는 사이트 또는 앱에서 트리거된 이벤트의 하위 집합입니다. |
UserSegment
사용자 세그먼트는 내 사이트 또는 앱에 참여한 사용자의 하위 집합입니다. 예를 들어 이전에 구매한 적이 있는 사용자 장바구니에 상품을 추가했지만 구매를 완료하지 않은 사용자
JSON 표현 |
---|
{ "userInclusionCriteria": { object ( |
필드 | |
---|---|
userInclusionCriteria |
이 세그먼트에 포함될 사용자를 정의합니다. 선택사항입니다. |
exclusion |
이 세그먼트에서 제외할 사용자를 정의합니다. 선택사항입니다. |
UserSegmentCriteria
사용자의 이벤트가 기준의 조건을 충족하면 사용자는 기준에 일치하게 됩니다.
JSON 표현 |
---|
{ "andConditionGroups": [ { object ( |
필드 | |
---|---|
andConditionGroups[] |
사용자가 이러한 각 |
andSequenceGroups[] |
사용자가 이러한 각 |
UserSegmentConditionGroup
조건은 애널리틱스에서 세그먼트에 포함하거나 세그먼트에서 제외할 데이터를 지정합니다.
JSON 표현 |
---|
{ "conditionScoping": enum ( |
필드 | |
---|---|
conditionScoping |
데이터가 조건 그룹과 일치하는지 여부에 따라 데이터가 세그먼트에 포함되거나 제외됩니다. 이 범위 지정은 조건 그룹이 일치하는지 여부를 판단하기 전에 선택사항입니다. 지정하지 않으면 |
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 . SegmentFilterExpression 의 한 가지 필터 유형을 지정합니다. expr 은 다음 중 하나일 수 있습니다. |
|
andGroup |
|
orGroup |
|
notExpression |
SegmentFilterExpression이 |
segmentFilter |
기본 세그먼트 필터입니다. |
segmentEventFilter |
단일 이벤트 이름의 이벤트와 일치하는 필터를 만듭니다. 매개변수 필터 표현식이 지정된 경우 단일 이벤트 이름 및 매개변수 필터 표현식 모두와 일치하는 이벤트의 하위 집합만 이 이벤트 필터와 일치합니다. |
SegmentFilterExpressionList
세그먼트 필터 표현식의 목록입니다.
JSON 표현 |
---|
{
"expressions": [
{
object ( |
필드 | |
---|---|
expressions[] |
세그먼트 필터 표현식의 목록 |
SegmentFilter
측정기준 또는 측정항목 값을 필터링하기 위한 표현식입니다.
JSON 표현 |
---|
{ "fieldName": string, "filterScoping": { object ( |
필드 | |
---|---|
fieldName |
측정기준 이름 또는 측정항목 이름입니다. |
filterScoping |
필터 범위를 지정합니다. |
통합 필드 one_filter . Filter 의 한 가지 필터 유형을 지정합니다. one_filter 은 다음 중 하나일 수 있습니다. |
|
stringFilter |
문자열 관련 필터입니다. |
inListFilter |
목록 값의 필터입니다. |
numericFilter |
숫자 또는 날짜 값에 대한 필터입니다. |
betweenFilter |
두 값 사이의 필터입니다. |
SegmentFilterScoping
범위를 지정하여 세그먼트 필터를 평가할 때 여러 이벤트의 측정항목을 고려해야 합니다.
JSON 표현 |
---|
{ "atAnyPointInTime": boolean } |
필드 | |
---|---|
atAnyPointInTime |
이 이 기준 범위 지정이 |
SegmentEventFilter
단일 이벤트 이름의 이벤트와 일치하는 필터를 만듭니다. 매개변수 필터 표현식이 지정된 경우 단일 이벤트 이름 및 매개변수 필터 표현식 모두와 일치하는 이벤트의 하위 집합만 이 이벤트 필터와 일치합니다.
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일까지의 보고서이고
|
UserSegmentSequenceGroup
사용자가 세그먼트의 회원이 되기 위해 특정 순서로 발생해야 하는 조건을 정의합니다.
JSON 표현 |
---|
{ "sequenceScoping": enum ( |
필드 | |
---|---|
sequenceScoping |
사용자가 시퀀스와 일치하도록 범위 지정 시 모든 시퀀스 단계가 충족되어야 합니다. 예를 들어 선택사항입니다. 지정하지 않으면 |
sequenceMaximumDuration |
전체 시퀀스가 발생해야 하는 기간을 정의합니다. (예: 30분)
소수점 아래가 최대 9자리까지이고 ' |
userSequenceSteps[] |
조건 단계의 순서가 지정된 시퀀스입니다. 사용자가 |
UserSequenceStep
이 사용자가 시퀀스와 일치하도록 지정된 단계 순서대로 발생해야 하는 조건입니다.
JSON 표현 |
---|
{ "isDirectlyFollowedBy": boolean, "stepScoping": enum ( |
필드 | |
---|---|
isDirectlyFollowedBy |
true인 경우 이 단계를 충족하는 이벤트는 이벤트 발생 후 마지막 단계를 만족시키는 바로 그 다음 이벤트여야 합니다. false인 경우 이 단계는 이전 단계를 간접적으로 따릅니다. 예를 들어 이전 단계와 이 단계 사이에 이벤트가 있을 수 있습니다. 첫 번째 단계에서 |
stepScoping |
사용자가 시퀀스와 일치하도록 범위 지정 시 이 시퀀스 단계가 충족되어야 합니다. 예를 들어 선택사항입니다. 지정하지 않으면 |
segmentFilterExpression |
이벤트가 이 표현식과 일치하면 사용자가 이 시퀀스 단계와 일치하게 됩니다. 표현식은 측정기준, 측정항목 및 매개변수에 대한 기준을 나타냅니다. |
UserSegmentExclusion
이 세그먼트에서 제외할 사용자를 지정합니다.
JSON 표현 |
---|
{ "userExclusionDuration": enum ( |
필드 | |
---|---|
userExclusionDuration |
사용자가 선택사항입니다. 지정하지 않으면 |
userExclusionCriteria |
사용자가 이 조건을 충족하면 해당 사용자는 |
UserExclusionDuration
사용자가 userExclusionCriteria
와 일치하는 경우 제외가 지속될 기간에 관한 옵션을 열거합니다.
열거형 | |
---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED |
제외 기간이 지정되지 않았습니다. 지정하지 마세요. |
USER_EXCLUSION_TEMPORARY |
사용자가 userExclusionCriteria 조건을 충족하는 기간 동안 사용자를 세그먼트에서 일시적으로 제외합니다. |
USER_EXCLUSION_PERMANENT |
사용자가 userExclusionCriteria 조건을 충족하는 경우 해당 사용자를 세그먼트에서 영구적으로 제외합니다. |
SessionSegment
세션 세그먼트는 사이트 또는 앱에서 발생한 세션의 하위 집합입니다. 예: 특정 광고 캠페인에서 발생한 모든 세션
JSON 표현 |
---|
{ "sessionInclusionCriteria": { object ( |
필드 | |
---|---|
sessionInclusionCriteria |
이 세그먼트에 포함될 세션을 정의합니다. 선택사항입니다. |
exclusion |
이 세그먼트에서 제외되는 세션을 정의합니다. 선택사항입니다. |
SessionSegmentCriteria
세션의 이벤트가 기준의 조건을 충족하면 세션은 기준과 일치합니다.
JSON 표현 |
---|
{
"andConditionGroups": [
{
object ( |
필드 | |
---|---|
andConditionGroups[] |
세션이 이러한 각 |
SessionSegmentConditionGroup
조건은 애널리틱스에서 세그먼트에 포함하거나 세그먼트에서 제외할 데이터를 지정합니다.
JSON 표현 |
---|
{ "conditionScoping": enum ( |
필드 | |
---|---|
conditionScoping |
데이터가 조건 그룹과 일치하는지 여부에 따라 데이터가 세그먼트에 포함되거나 제외됩니다. 이 범위 지정은 조건 그룹이 일치하는지 여부를 판단하기 전에 선택사항입니다. 지정하지 않으면 |
segmentFilterExpression |
데이터가 이 표현식과 일치하는지 여부에 따라 데이터가 세그먼트에 포함되거나 제외됩니다. 표현식은 측정기준, 측정항목 및 매개변수에 대한 기준을 나타냅니다. |
SessionCriteriaScoping
범위 지정은 세션이 기준을 충족하는지 평가할 때 고려할 이벤트를 지정합니다.
열거형 | |
---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
기준 범위가 지정되지 않았습니다. 지정하지 마세요. |
SESSION_CRITERIA_WITHIN_SAME_EVENT |
한 이벤트 내에서 기준이 충족되면 세션은 기준과 일치합니다. |
SESSION_CRITERIA_WITHIN_SAME_SESSION |
한 세션 내에서 기준이 충족되면 세션은 기준과 일치합니다. |
SessionSegmentExclusion
이 세그먼트에서 제외할 세션을 지정합니다.
JSON 표현 |
---|
{ "sessionExclusionDuration": enum ( |
필드 | |
---|---|
sessionExclusionDuration |
세션이 선택사항입니다. 지정하지 않으면 |
sessionExclusionCriteria |
세션이 이 조건을 충족하면 해당 세션은 |
SessionExclusionDuration
세션이 sessionExclusionCriteria
와 일치하는 경우 제외가 지속될 기간에 관한 옵션을 열거합니다.
열거형 | |
---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
제외 기간이 지정되지 않았습니다. 지정하지 마세요. |
SESSION_EXCLUSION_TEMPORARY |
세션이 sessionExclusionCriteria 조건을 충족하는 기간 동안 세그먼트에서 세션을 일시적으로 제외합니다. |
SESSION_EXCLUSION_PERMANENT |
세션이 sessionExclusionCriteria 조건을 충족한 적이 있는 경우 세그먼트를 세그먼트에서 영구적으로 제외합니다. |
EventSegment
이벤트 세그먼트는 사이트 또는 앱에서 트리거된 이벤트의 하위 집합입니다. 특정 위치에서 발생한 모든 구매 이벤트를 예로 들 수 있습니다. 특정 운영체제에서 발생한 app_exception 이벤트입니다.
JSON 표현 |
---|
{ "eventInclusionCriteria": { object ( |
필드 | |
---|---|
eventInclusionCriteria |
이 세그먼트에 포함될 이벤트를 정의합니다. 선택사항입니다. |
exclusion |
이 세그먼트에서 제외할 이벤트를 정의합니다. 선택사항입니다. |
EventSegmentCriteria
이벤트가 기준의 조건을 충족하면 이벤트가 기준과 일치합니다.
JSON 표현 |
---|
{
"andConditionGroups": [
{
object ( |
필드 | |
---|---|
andConditionGroups[] |
이벤트가 이러한 각 |
EventSegmentConditionGroup
조건은 애널리틱스에서 세그먼트에 포함하거나 세그먼트에서 제외할 데이터를 지정합니다.
JSON 표현 |
---|
{ "conditionScoping": enum ( |
필드 | |
---|---|
conditionScoping |
선택사항입니다. 지정하지 않으면 |
segmentFilterExpression |
데이터가 이 표현식과 일치하는지 여부에 따라 데이터가 세그먼트에 포함되거나 제외됩니다. 표현식은 측정기준, 측정항목 및 매개변수에 대한 기준을 나타냅니다. |
EventCriteriaScoping
범위 지정은 이벤트가 기준을 충족하는지 평가할 때 고려할 이벤트를 지정합니다.
열거형 | |
---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED |
기준 범위가 지정되지 않았습니다. 지정하지 마세요. |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
하나의 이벤트 내에서 기준이 충족되면 이벤트가 기준과 일치합니다. |
EventSegmentExclusion
이 세그먼트에서 제외할 이벤트를 지정합니다.
JSON 표현 |
---|
{ "eventExclusionDuration": enum ( |
필드 | |
---|---|
eventExclusionDuration |
선택사항입니다. 지정하지 않으면 |
eventExclusionCriteria |
이벤트가 이 조건을 충족하면 해당 이벤트는 |
EventExclusionDuration
이벤트가 eventExclusionCriteria
와 일치하는 경우 제외가 지속될 기간에 관한 옵션을 열거합니다.
열거형 | |
---|---|
EVENT_EXCLUSION_DURATION_UNSPECIFIED |
제외 기간이 지정되지 않았습니다. 지정하지 마세요. |
EVENT_EXCLUSION_PERMANENT |
이벤트가 eventExclusionCriteria 조건을 충족한 적이 있는 경우 세그먼트에서 이벤트를 영구적으로 제외합니다. |
FunnelSubReport
유입경로 하위 보고서에는 측정기준 및 측정항목 데이터 값이 포함됩니다. 예를 들어 12명의 사용자가 유입경로의 두 번째 단계에 도달했습니다.
JSON 표현 |
---|
{ "dimensionHeaders": [ { object ( |
필드 | |
---|---|
dimensionHeaders[] |
측정기준 열을 설명합니다. 유입경로 보고서는 하위 보고서 응답에 항상 유입경로 단계 측정기준을 포함합니다. 요청에 따라 분류, 날짜, 다음 작업 등의 추가 측정기준이 응답에 포함될 수 있습니다. |
metricHeaders[] |
측정항목 열을 설명합니다. 유입경로 보고서의 하위 보고서 응답에 항상 활성 사용자가 포함됩니다. 유입경로 표에는 완료율, 이탈률, 이탈률과 같은 추가 측정항목이 포함됩니다. |
rows[] |
보고서의 측정기준 값 조합과 측정항목 값의 행입니다. |
metadata |
유입경로 보고서의 메타데이터입니다. |
FunnelResponseMetadata
유입경로 보고서의 응답 메타데이터에는 유입경로 보고서에 대한 추가 정보가 포함되어 있습니다.
JSON 표현 |
---|
{
"samplingMetadatas": [
{
object ( |
필드 | |
---|---|
samplingMetadatas[] |
유입경로 보고서 결과가 샘플링되는 경우 유입경로 보고서에 사용된 이벤트의 비율이 표시됩니다. 각 기간에 대해 하나의 하지만 결과가 샘플링되지 않으면 이 필드는 정의되지 않습니다. |
SamplingMetadata
유입경로 보고서 결과가 샘플링된 경우 이 메타데이터는 특정 기간 동안 유입경로 보고서에 사용된 이벤트의 비율을 설명합니다. 샘플링은 대규모 데이터 세트에서 의미 있는 정보를 찾기 위해 모든 데이터의 하위 집합을 분석하는 것입니다.
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 |
이 요청 후 남은 할당량입니다. |