Method: properties.runFunnelReport

string

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

예: properties/1234

{
  "startDate": string,
  "endDate": string,
  "name": string
}

string

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

string

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

string

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

{
  "isOpenFunnel": boolean,
  "steps": [
    {
      object (FunnelStep)
    }
  ]
}

boolean

개방형 유입경로에서는 사용자가 어느 단계에서나 유입경로에 진입할 수 있으며, 닫힌 유입경로에서는 사용자가 첫 번째 단계에서 유입경로에 진입해야 합니다. 선택사항입니다. 지정하지 않으면 폐쇄형 유입경로가 사용됩니다.

object (FunnelStep)

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

{
  "name": string,
  "isDirectlyFollowedBy": boolean,
  "filterExpression": {
    object (FunnelFilterExpression)
  },
  "withinDurationFromPriorStep": string
}

string

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

boolean

true인 경우 이 단계는 이전 단계를 바로 따라야 합니다. false인 경우 이전 단계와 이 단계 사이에 이벤트가 있을 수 있습니다. 지정하지 않으면 isDirectlyFollowedBy이 false로 처리됩니다.

object (FunnelFilterExpression)

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

string (Duration format)

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

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

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

{

  // 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.
}

object (FunnelFilterExpressionList)

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

object (FunnelFilterExpressionList)

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

object (FunnelFilterExpression)

FunnelFilterExpression은 notExpression의 값이 아닙니다.

object (FunnelFieldFilter)

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

object (FunnelEventFilter)

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

{
  "expressions": [
    {
      object (FunnelFilterExpression)
    }
  ]
}

object (FunnelFilterExpression)

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

{
  "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.
}

string

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

object (StringFilter)

문자열 관련 필터입니다.

object (InListFilter)

목록 내 값의 필터입니다.

object (NumericFilter)

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

object (BetweenFilter)

두 값 사이의 필터입니다.

{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}

enum (MatchType)

이 필터의 검색 유형입니다.

string

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

boolean

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

{
  "values": [
    string
  ],
  "caseSensitive": boolean
}

string

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

boolean

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

{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}

enum (Operation)

이 필터의 연산 유형입니다.

object (NumericValue)

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

{

  // 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.
}

string (int64 format)

정수 값

number

이중 값

{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}

object (NumericValue)

이 숫자로 시작합니다.

object (NumericValue)

이 번호로 끝납니다.

{
  "eventName": string,
  "funnelParameterFilterExpression": {
    object (FunnelParameterFilterExpression)
  }
}

string

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

object (FunnelParameterFilterExpression)

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

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

{

  // 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.
}

object (FunnelParameterFilterExpressionList)

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

object (FunnelParameterFilterExpressionList)

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

object (FunnelParameterFilterExpression)

FunnelParameterFilterExpression은 notExpression의 값이 아닙니다.

object (FunnelParameterFilter)

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

{
  "expressions": [
    {
      object (FunnelParameterFilterExpression)
    }
  ]
}

object (FunnelParameterFilterExpression)

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

{

  // 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.
}

string

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

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

string

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

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

상품 매개변수는 전자상거래 이벤트에서만 사용할 수 있습니다. 전자상거래 이벤트에 대한 자세한 내용은 전자상거래 측정 가이드를 참고하세요.

object (StringFilter)

문자열 관련 필터입니다.

object (InListFilter)

목록 내 값의 필터입니다.

object (NumericFilter)

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

object (BetweenFilter)

두 값 사이의 필터입니다.

{
  "breakdownDimension": {
    object (Dimension)
  },
  "limit": string
}

object (Dimension)

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

string (int64 format)

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

{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}

string

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

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

측정기준은 dimensionFilter, orderBys, dimensionExpression, pivots의 name에서 참조됩니다.

object (DimensionExpression)

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

{

  // 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.
}

object (CaseExpression)

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

object (CaseExpression)

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

object (ConcatenateExpression)

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

{
  "dimensionName": string
}

string

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

{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}

string

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

string

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

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

{
  "nextActionDimension": {
    object (Dimension)
  },
  "limit": string
}

object (Dimension)

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

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

string (int64 format)

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

{
  "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.
}

string

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

object (UserSegment)

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

object (SessionSegment)

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

object (EventSegment)

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

{
  "userInclusionCriteria": {
    object (UserSegmentCriteria)
  },
  "exclusion": {
    object (UserSegmentExclusion)
  }
}

object (UserSegmentCriteria)

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

object (UserSegmentExclusion)

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

{
  "andConditionGroups": [
    {
      object (UserSegmentConditionGroup)
    }
  ],
  "andSequenceGroups": [
    {
      object (UserSegmentSequenceGroup)
    }
  ]
}

object (UserSegmentConditionGroup)

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

object (UserSegmentSequenceGroup)

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

{
  "conditionScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}

enum (UserCriteriaScoping)

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

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

object (SegmentFilterExpression)

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

{

  // 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.
}

object (SegmentFilterExpressionList)

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

object (SegmentFilterExpressionList)

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

object (SegmentFilterExpression)

SegmentFilterExpression은 notExpression의 NOT입니다.

object (SegmentFilter)

프리미티브 세그먼트 필터.

object (SegmentEventFilter)

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

{
  "expressions": [
    {
      object (SegmentFilterExpression)
    }
  ]
}

object (SegmentFilterExpression)

세그먼트 필터 표현식 목록

{
  "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.
}

string

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

object (SegmentFilterScoping)

필터의 범위를 지정합니다.

object (StringFilter)

문자열 관련 필터입니다.

object (InListFilter)

목록 내 값의 필터입니다.

object (NumericFilter)

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

object (BetweenFilter)

두 값 사이의 필터입니다.

{
  "atAnyPointInTime": boolean
}

boolean

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

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

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

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

{
  "eventName": string,
  "segmentParameterFilterExpression": {
    object (SegmentParameterFilterExpression)
  }
}

string

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

object (SegmentParameterFilterExpression)

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

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

{

  // 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.
}

object (SegmentParameterFilterExpressionList)

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

object (SegmentParameterFilterExpressionList)

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

object (SegmentParameterFilterExpression)

SegmentParameterFilterExpression이 notExpression의 값이 아닙니다.

object (SegmentParameterFilter)

프리미티브 세그먼트 매개변수 필터입니다.

{
  "expressions": [
    {
      object (SegmentParameterFilterExpression)
    }
  ]
}

object (SegmentParameterFilterExpression)

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

{
  "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.
}

object (SegmentParameterFilterScoping)

필터의 범위를 지정합니다.

string

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

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

string

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

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

상품 매개변수는 전자상거래 이벤트에서만 사용할 수 있습니다. 전자상거래 이벤트에 대한 자세한 내용은 전자상거래 측정 가이드를 참고하세요.

object (StringFilter)

문자열 관련 필터입니다.

object (InListFilter)

목록 내 값의 필터입니다.

object (NumericFilter)

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

object (BetweenFilter)

두 값 사이의 필터입니다.

{
  "inAnyNDayPeriod": string
}

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월 2일, 2021년 11월 1일~2021년 11월 3일, 2021년 11월 1일~2021년 11월 1일입니다.

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

{
  "sequenceScoping": enum (UserCriteriaScoping),
  "sequenceMaximumDuration": string,
  "userSequenceSteps": [
    {
      object (UserSequenceStep)
    }
  ]
}

enum (UserCriteriaScoping)

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

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

string (Duration format)

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

sequenceMaximumDuration는 선택사항이며 지정하지 않으면 임의의 기간 내에 시퀀스가 완료될 수 있습니다.

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

object (UserSequenceStep)

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

{
  "isDirectlyFollowedBy": boolean,
  "stepScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}

boolean

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

enum (UserCriteriaScoping)

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

선택사항입니다. 지정하지 않으면 stepScoping은 sequenceScoping와 동일한 UserCriteriaScoping을 사용합니다.

object (SegmentFilterExpression)

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

{
  "userExclusionDuration": enum (UserExclusionDuration),
  "userExclusionCriteria": {
    object (UserSegmentCriteria)
  }
}

enum (UserExclusionDuration)

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

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

object (UserSegmentCriteria)

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

{
  "sessionInclusionCriteria": {
    object (SessionSegmentCriteria)
  },
  "exclusion": {
    object (SessionSegmentExclusion)
  }
}

object (SessionSegmentCriteria)

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

object (SessionSegmentExclusion)

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

{
  "andConditionGroups": [
    {
      object (SessionSegmentConditionGroup)
    }
  ]
}

object (SessionSegmentConditionGroup)

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

{
  "conditionScoping": enum (SessionCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}

enum (SessionCriteriaScoping)

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

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

object (SegmentFilterExpression)

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

{
  "sessionExclusionDuration": enum (SessionExclusionDuration),
  "sessionExclusionCriteria": {
    object (SessionSegmentCriteria)
  }
}

enum (SessionExclusionDuration)

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

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

object (SessionSegmentCriteria)

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

{
  "eventInclusionCriteria": {
    object (EventSegmentCriteria)
  },
  "exclusion": {
    object (EventSegmentExclusion)
  }
}

object (EventSegmentCriteria)

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

object (EventSegmentExclusion)

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

{
  "andConditionGroups": [
    {
      object (EventSegmentConditionGroup)
    }
  ]
}

object (EventSegmentConditionGroup)

이벤트가 각 andConditionGroups과 일치하면 이벤트가 이 기준과 일치합니다.

{
  "conditionScoping": enum (EventCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}

enum (EventCriteriaScoping)

conditionScoping는 항상 EVENT_CRITERIA_WITHIN_SAME_EVENT이어야 합니다.

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

object (SegmentFilterExpression)

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

{
  "eventExclusionDuration": enum (EventExclusionDuration),
  "eventExclusionCriteria": {
    object (EventSegmentCriteria)
  }
}

enum (EventExclusionDuration)

eventExclusionDuration는 항상 PERMANENTLY_EXCLUDE이어야 합니다.

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

object (EventSegmentCriteria)

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

{

  // 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.
}

object (FilterExpressionList)

andGroup의 FilterExpressions는 AND 관계를 갖습니다.

object (FilterExpressionList)

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

object (FilterExpression)

FilterExpression은 notExpression의 NOT입니다.

object (Filter)

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

{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}

object (FilterExpression)

필터 표현식 목록입니다.

{
  "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.
}

string

측정기준 이름 또는 측정항목 이름입니다. 측정기준 또는 측정항목에 정의된 이름이어야 합니다.

object (StringFilter)

문자열 관련 필터입니다.

object (InListFilter)

목록 내 값의 필터입니다.

object (NumericFilter)

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

object (BetweenFilter)

두 값 사이의 필터입니다.

{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "metadata": {
    object (FunnelResponseMetadata)
  }
}

object (DimensionHeader)

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

object (MetricHeader)

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

object (Row)

보고서에 있는 측정기준 값 조합 및 측정항목 값의 행

object (FunnelResponseMetadata)

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

{
  "name": string
}

string

측정기준의 이름입니다.

{
  "name": string,
  "type": enum (MetricType)
}

string

측정항목의 이름입니다.

enum (MetricType)

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

{
  "dimensionValues": [
    {
      object (DimensionValue)
    }
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}

object (DimensionValue)

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

object (MetricValue)

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

{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}

string

치수 유형이 문자열인 경우 문자열로 표시되는 값입니다.

{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}

string

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

{
  "samplingMetadatas": [
    {
      object (SamplingMetadata)
    }
  ]
}

object (SamplingMetadata)

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

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

{
  "samplesReadCount": string,
  "samplingSpaceSize": string
}

string (int64 format)

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

string (int64 format)

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

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

{
  "tokensPerDay": {
    object (QuotaStatus)
  },
  "tokensPerHour": {
    object (QuotaStatus)
  },
  "concurrentRequests": {
    object (QuotaStatus)
  },
  "serverErrorsPerProjectPerHour": {
    object (QuotaStatus)
  },
  "potentiallyThresholdedRequestsPerHour": {
    object (QuotaStatus)
  },
  "tokensPerProjectPerHour": {
    object (QuotaStatus)
  }
}

object (QuotaStatus)

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

object (QuotaStatus)

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

object (QuotaStatus)

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

object (QuotaStatus)

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

object (QuotaStatus)

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

object (QuotaStatus)

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

{
  "consumed": integer,
  "remaining": integer
}

integer

이 요청에서 소비한 할당량입니다.

integer

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