Core Reporting API - 세그먼트

이 문서에서는 Core Reporting API에서 세그먼트를 사용하기 위한 구문과 고려사항을 설명합니다.

소개

Core Reporting API의 세분화 기능을 사용할 때 다음 두 가지 방법으로 Core Reporting API에서 세그먼트를 요청할 수 있습니다.

  1. ID별 세그먼트: 기본 제공 또는 맞춤 세그먼트의 숫자 ID를 사용하여 쿼리합니다.
  2. 동적 세그먼트: 요청 시 세그먼트를 동적으로 지정합니다.

ID별 분류 기준

기본 제공 또는 맞춤 세그먼트의 ID를 사용하여 Core Reporting API에서 세그먼트를 요청할 수 있습니다. 사용자가 사용할 수 있는 모든 세그먼트는 Google Analytics Management API에서 세그먼트 컬렉션list 메서드를 사용하여 가져올 수 있습니다. 각 세그먼트의 ID는 세그먼트 리소스id 속성에서 사용할 수 있습니다.

API 요청에서 세그먼트 ID를 사용하는 방법에 대한 자세한 내용은 Core Reporting API 참조를 확인하세요.

동적 세그먼트

API를 요청할 때 동적으로 세그먼트를 만들고 사용할 수도 있습니다. 일반적으로 동적 세그먼트를 만들 때 다음 사항을 고려해야 합니다.

  1. 사용자 선택 및 세션 선택
  2. 조건과 시퀀스 비교
  3. 측정항목 범위 사용

동적 세그먼트를 만들 때 고려해야 할 각 사항은 아래에 개략적으로 설명되어 있습니다. 동적 세그먼트의 전체 구문을 검토하려면 동적 세그먼트 구문 참조를 확인하세요.

세그먼트에 허용되는 측정기준 및 측정항목입니다.
세그먼트에서 일부 측정기준과 측정항목을 사용할 수 있는 것은 아닙니다. 세그먼트에서 허용되는 측정기준과 측정항목을 검토하려면 측정기준 및 측정항목 탐색기로 이동하세요.

1. 사용자 및 세션 선택

사용자 또는 세션 (또는 둘 다) 중 무엇을 선택할지 지정합니다.

  • users::를 사용하여 사용자를 선택합니다.
  • sessions::를 사용하여 세션을 선택합니다.
  • users::sessions::의 조건이 모두 지정된 경우:
    1. 사용자 조건이 먼저 적용되어 일치하는 사용자의 세션을 출력합니다.
    2. 세션 조건은 1번의 세션에만 적용됩니다.

예를 들면 다음과 같습니다.

  • 하나 이상의 세션에서 Chrome 브라우저를 사용한 사용자를 선택합니다.
    • users::condition::ga:browser==Chrome
  • Chrome 브라우저를 사용한 세션을 선택합니다.
    • sessions::condition::ga:browser==Chrome
  • 런던 시에서 Chrome 브라우저를 사용한 세션이 1개 이상 발생한 사용자의 세션을 선택합니다.
    • users::condition::ga:browser==Chrome;sessions::condition::ga:city==London

사용자 및 세션 선택에 대한 자세한 내용은 구문 참조의 conditionScope 섹션을 참조하세요.

2. 조건과 시퀀스의 비교

사용자 또는 세션을 분류할지 여부를 결정했으면 하나 이상의 조건 및/또는 시퀀스를 지정합니다.

조건

조건은 condition:: 접두사를 사용합니다. 예를 들면 다음과 같습니다.

  • 런던에서 Chrome 브라우저를 사용하여 방문한 적이 있는 사용자를 선택합니다.
    • users::condition::ga:city==London;ga:browser==Chrome

시퀀스

시퀀스 조건은 하나 이상의 단계로 구성되며, 각 단계는 하나 이상의 측정기준/측정항목 조건으로 정의됩니다.

sequence:: 프리픽스와 이후 (;–>>) 또는 바로 다음 단계 (;–>) 연산자를 사용하여 시퀀스 기반 조건을 지정합니다. 예를 들면 다음과 같습니다.

  • 데스크톱을 먼저 사용한 다음 휴대기기를 사용한 사용자를 선택하세요. 사용자를 분류하고 있으므로 사용자의 모든 세션을 검색하고 사용자가 한 세션에서 데스크톱을 사용한 다음 후속 세션 중 하나에서 휴대기기를 사용했는지 확인합니다.
    • users::sequence::ga:deviceCategory==desktop;->>ga:deviceCategory==mobile
  • 각 단계에 여러 조건을 사용할 수도 있습니다.
    • users::sequence::ga:deviceCategory==desktop;ga:operatingSystem==Windows->>ga:deviceCategory==mobile;ga:operatingSystem==Android
  • AND (즉, ‘;’) 연산자입니다.
    • users::condition::ga:totalEvents>10;sequence::ga:deviceCategory==desktop->>ga:deviceCategory==mobile

단순 조건 및 시퀀스 기반 조건에 대한 자세한 내용은 구문 참조의 conditionType 섹션을 참조하세요. 추가 예시는 세그먼트 기능 참조 조건 시퀀스 섹션을 참조하세요.

3. 측정항목 범위 사용

측정항목의 범위는 측정항목이 정의되는 수준(HIT, SESSION, USER)을 정의합니다. 예를 들어 ga:pageviewsga:transactions는 조회에서 발생하므로 HIT 수준 측정항목인 반면, ga:sessionDurationga:bounces는 세션당 단일 값이 있으므로 세션 수준 측정항목입니다. 개념적으로 USER는 가장 높은 수준 범위이고 HIT는 최저 수준 범위입니다.

측정항목 값은 기본 범위보다 큰 범위에서 보고될 수도 있습니다. 예: ga:pageviewsga:transactions는 해당 세션에서 발생하는 각 조회나 사용자에 대해 더하기만 하면 SESSION 및 사용자 수준에서 보고될 수 있습니다.

각 측정항목 조건의 범위를 지정하여 조건이 적용되는 수준을 결정할 수 있습니다. 측정항목 범위는 perUser::, perSession:: 또는 perHit:: 프리픽스를 사용하여 지정됩니다.

예를 들면 다음과 같습니다.

  • 웹사이트에서 10달러 이상 지출한 사용자 (예: 사용자의 평생 가치가 10달러 이상임).
    users::condition::perUser::ga:transactionRevenue>=10
    
  • 세션당 10달러 이상을 지출한 사용자를 선택합니다.
    users::condition::perSession::ga:transactionRevenue>=10
    

범위 제한

Core Reporting API는 지정된 쿼리가 유효한지 확인하기 위해 측정항목 범위의 유효성 검사를 수행합니다. 범위 유효성 검사 규칙은 다음과 같습니다.

  1. 지정된 측정항목 범위는 항상 상위 조건 범위 (users:: 또는 sessions:: 프리픽스로 표시됨) 이하여야 합니다.
  2. 지정된 측정항목 범위는 데이터 모델에 정의된 기본 범위와 같거나 그보다 커야 합니다. 측정항목 및 기본 범위의 전체 목록은 측정항목: 기본 범위 참조를 확인하세요.

예를 들어 다음은 유효한 측정항목 범위입니다.

  • 조건과 측정항목 범위가 모두 동일합니다 (즉, 사용자 수준).
    • users::condition::perUser::ga:transactionRevenue>10
  • 조건 범위가 측정항목 범위보다 큽니다 (예: USER > SESSION).
    • users::condition::perSession::ga:transactionRevenue>10
  • ga:totalEvents는 HIT 수준 측정항목이므로 조건에서 사용할 수 있는 범위는 perHit::, perSession:: 또는 perUser::입니다 (모두 HIT 수준 범위보다 크거나 같기 때문).
    • users::condition::perHit::ga:totalEvents>5
    • users::condition::perSession::ga:totalEvents>5

예를 들어 다음은 잘못된 측정항목 범위입니다.

  • 다음 세그먼트는 상위 조건 범위가 측정항목 범위 (즉, 세션 < 사용자)
    • sessions::condition::perUser::ga:transactionRevenue>10
  • SESSION 수준 측정항목에 HIT 수준 범위 및 SESSION 수준 미만의 HIT 수준 사용
    • users::condition::perHit::ga:sessionDuration>60

기본 범위

측정항목 조건의 범위가 명시적으로 지정되지 않으면 조건 범위가 기본값으로 설정됩니다. 예를 들어 다음 세그먼트는 모든 측정항목 조건에 사용자 수준 범위를 사용합니다. users::condition::ga:transactionRevenue>=10;ga:sessionDuration>60

동적 세그먼트 구문 참조

기본 구문

세그먼트를 정의하는 문법은 segment=<segmentCondition>+ 형식입니다. 즉, 세그먼트는 하나 이상의 segmentCondition 문으로 구성됩니다.

<segmentCondition>은 다음과 같이 정의됩니다. <conditionScope><conditionType><dimensionOrMetricConditions>

여기서
conditionScope는 조건의 최상위 범위를 지정합니다.
conditionType는 조건 유형을 지정합니다.
dimensionOrMetricConditions는 측정기준/측정항목 조건 또는 시퀀스 단계를 지정합니다.

conditionScope

조건의 최상위 범위를 지정합니다. 사용할 수 있는 값은 다음과 같습니다.

  • 사용자 선택을 위한 users::
  • sessions::: 세션 선택

conditionScope의 제약조건 및 고려사항:

  • 여러 'users' 및 'sessions' 조건이 단일 세그먼트에 지정된 경우 AND 연산자로 결합해야 합니다.
  • 사용자와 세션을 모두 선택하는 조건은 AND 연산자로도 결합해야 합니다. 사용자 및 세션 조건을 모두 지정하면 일치하는 사용자를 찾기 위해 모든 사용자 조건이 먼저 적용된 다음 일치하는 사용자에게 속한 세션의 모든 세션 조건이 적용됩니다.
  • 사용자 수준 조건을 사용하는 경우 기간은 90일 이하여야 합니다.
  • 또한 조건 범위는 그 아래 모든 측정항목 조건의 기본 범위 수준을 결정합니다. 범위 수준에 대한 자세한 내용은 측정항목: 기본 범위 참조를 확인하세요.

conditionType

조건 유형을 지정합니다. 사용할 수 있는 값은 다음과 같습니다.

  • 간단한 (즉, 비시퀀스 기반) 조건을 지정하는 condition::
  • 시퀀스 기반 조건을 지정하기 위한 sequence::

conditionType의 제약조건 및 고려사항:

  • 여러 '단순 조건'과 '시퀀스'가 지정된 경우 항상 AND 연산자로 결합되어야 합니다.
  • 시퀀스 기반 조건에 허용되는 단계는 세그먼트당 최대 10개입니다.

단순 조건

단순 조건은 결합할 수 있는 하나 이상의 측정기준/측정항목 조건으로 구성됩니다.

간단한 조건에 유효한 조건 연산자는 다음과 같습니다.

간단한 조건의 구문은 다음과 같습니다.

condition::<dimensionOrMetricConditions>

간단한 조건의 예는 다음과 같습니다.

  • users::condition::ga:transactionRevenue>10;ga:sessionDuration>60
  • 최상위 부정 연산자를 지정하여 측정기준/측정항목 조건이 여러 개 있을 수 있는 지정된 간단한 조건의 보완을 찾을 수 있습니다. 예: users::condition::!ga:transactionRevenue>10;ga:sessionDuration>60

조건 제외

제외 조건은 정의된 조건을 충족하지 않는 세그먼트를 만드는 데 사용됩니다.

구문은 NOT Operator(! 문자)를 사용하여 조건을 무효화하고 해당 조건과 일치하는 세션을 제외합니다.

종료 페이지가 루트 페이지 경로와 정확하게 일치하는 세션을 제외합니다.
sessions::condition::!ga:exitPagePath==/

여러 조건

모든 사용자 수준 조건을 단일 users:: 프리픽스로 그룹화하거나 각 조건에 별도의 users:: 프리픽스를 사용할 수 있습니다. 세션 수준 조건의 경우에도 마찬가지입니다.

예를 들어 다음 세그먼트는 동일합니다. 두 경우 모두 condition1condition1는 선택된 사용자를 위해 AND됩니다.
users::<condition1>;<condition2>
users::<condition1>users::<condition2>

시퀀스 조건

시퀀스 조건은 하나 이상의 단계로 구성되며, 각 단계는 하나 이상의 측정기준/측정항목 조건으로 정의됩니다. 여러 단계를 특수 시퀀스 연산자와 결합할 수 있습니다.

시퀀스 조건에 유효한 시퀀스 연산자는 다음과 같습니다.

  • –>> 연산자는 이전 단계가 다음 단계 임을 나타냅니다.
  • –> 연산자는 이전 단계가 다음 단계 직전에 있음을 나타냅니다.

시퀀스 조건의 구문은 다음과 같습니다.

sequence:: NOT? FIRST_HIT_MATCHES_FIRST_STEP? (AND (PRECEDES|IMMEDIATELY_PRECEDES) <step>)*

위치:

NOT!로 표시됩니다.
FIRST_HIT_MATCHES_FIRST_STEP^로 표시됩니다.
PRECEDES;–>>로 표시됩니다.
IMMEDIATELY_PRECEDES;–>로 표시됩니다.
step<dimensionOrMetricConditions>로 표시됩니다.

시퀀스 조건의 예:

  • users::sequence::ga:deviceCategory==desktop;->ga:deviceCategory==tablet
  • 최상위 부정 연산자를 지정하여 여러 단계 또는 측정기준/측정항목 조건이 포함된 특정 시퀀스의 보완을 찾을 수도 있습니다. 예: users::sequence::!ga:deviceCategory==desktop;->ga:deviceCategory==tablet
  • ^ 연산자를 사용하면 첫 번째 단계가 지정된 기간 내 첫 번째 세션의 첫 번째 조회와 일치함을 지정할 수 있습니다. 예: users::sequence::^ga:deviceCategory==desktop;->ga:deviceCategory==tablet

세션 날짜 조건

세그먼트는 dateOfSession 구문을 활용하는 분석 유형을 지원합니다. 사이 <> 연산자와 함께 사용하면 특정 기간 내에 세션을 시작한 사용자 그룹으로 세그먼트를 제한할 수 있습니다. dateOfSession의 최대 기간은 31일입니다. 사용에 대한 자세한 내용은 아래의 세션 날짜 예를 참조하세요.

측정기준 및 측정항목 조건

조건 결합

하나 이상의 측정기준 조건을 AND(예: ';') 및 OR (즉, ',') 연산자의 우선순위가 더 높은 OR 연산자가 포함된 연산자입니다.

구문은 필터를 결합하는 데 사용되는 것과 동일합니다. 자세한 내용은 Core Reporting API 참조의 필터 결합을 참고하세요.

연산자

아래 표에는 세그먼트에서 사용할 수 있는 모든 연산자와 이 연산자가 측정기준 및 측정항목에 지원되는지 여부가 설명되어 있습니다.

연산자 설명 측정기준 조건에서 지원 여부 측정항목 조건에서 지원 여부
== 같거나 일치검색
예: ga:city==London

예: ga:adCost==10
!= 같지 않거나 정확히 일치하지 않습니다.
예: ga:city!=London

예: ga:adCost!=10
< 보다 작음 예 (숫자 값에만 해당)
예: ga:hour<12

예: ga:adCost<10
<= 작거나 같음 예 (숫자 값에만 해당)
예: ga:hour<=12

예: ga:adCost<=10
> 보다 큼 예 (숫자 값에만 해당)
예: ga:hour>12

예: ga:adCost>10
>= 크거나 같음 예 (숫자 값에만 해당)
예: ga:hour>=12

예: ga:adCost>=10
<> 사이 (값이 주어진 범위 사이에 있음)1 예 (숫자 값에만 해당)
예: ga:hour<>1_12

예: ga:adCost<>10_20
[] 목록에 있음 (값이 나열된 값 중 하나임)2
예: ga:browser[]Chrome|Firefox|Opera
아니요
=@ 하위 문자열을 포함합니다.
예: ga:keyword=@shoes
아니요
!@ 하위 문자열은 포함하지 않습니다.
예: ga:keyword!@shoes
아니요
=~ 정규 표현식 일치 항목을 포함합니다.
예: ga:keyword=~shoes
아니요
!~ 정규 표현식 일치 항목을 포함하지 않습니다.
예: ga:keyword!~shoes
아니요

1연산자 <>
특정 범위 내의 값을 쿼리할 수 있습니다. 범위 값은 포함이며 숫자 값이 있는 측정항목과 측정기준 (예: ga:hour). 범위의 최솟값과 최댓값은 밑줄로 구분해야 합니다.

구문:
{dimensionOrMetricName}<>{minValue}_{maxValue}

예:
12~23시에 발생한 세션을 선택합니다.
sessions::condition::ga:hour<>12_23

2목록 연산자 []
지정된 목록의 값을 쿼리할 수 있습니다. 측정기준에만 사용할 수 있습니다. 값 목록은 '|' 문자를 사용하여 구분해야 합니다. 값에 '|'가 있으면 이스케이프 처리해야 합니다.

구문:
{dimensionName}[]{value1}|{value2}|...

제약조건:
목록 내 측정기준 조건당 최대 10개의 값이 허용됩니다 (예: ga:city[]city1|city2|...|city10).

예:
Chrome, Firefox 또는 Opera 브라우저에서 발생한 세션을 선택합니다.
sessions::condition::ga:browser[]Chrome|Firefox|Opera

특수문자 이스케이프

특수문자 ',' 및 ';'은 값 표현식 내에서 발생하는 경우 이스케이프 처리해야 합니다. 예: ga:keyword==nike\,shoes

측정기준 및 측정항목 조건에 대한 자세한 내용은 Core Reporting API 참조를 참고하세요.

제약조건

측정기준 및 측정항목 조건과 관련된 제약 조건은 다음과 같습니다.

  • 세그먼트당 최대 10개의 측정기준 또는 측정항목 조건
  • 측정기준 조건의 최대 표현식 길이는 1,024자입니다.

기존 동적 세그먼트 이전

dynamic:: 접두사를 사용하는 기존 동적 세그먼트는 현재 구문에서 측정기준 및 측정항목 조건이 있는 세션 수준 세그먼트와 동일합니다. 기존 동적 세그먼트를 사용하는 경우 dynamic:: 접두사를 sessions::condition:: 접두사로 대체하여 새 구문으로 이전해야 합니다. 예를 들어 아래의 두 세그먼트는 동일합니다.

dynamic::ga:browser==Chrome
이(가) 다음과 같음:
sessions::condition::ga:browser==Chrome

세그먼트 예

1. 인구통계: 남성 언어는 영어(미국)로 게임에 관심이 있으며 미주 출신입니다.

사용자 기반 세그먼트가 먼저 적용됩니다. 따라서 사용자 기반 조건은 게임에 관심이 있는 남성 사용자를 반환합니다. 그런 다음 미주에서 진행되었으며 언어가 EN-US인 세션을 가져오기 위해 이러한 사용자의 세션에 세션 기반 조건이 적용됩니다.

users::condition::ga:userGender==Male;users::condition::ga:interestAffinityCategory==Games ; sessions::condition::ga:region==Americas;sessions::condition::ga:language==en-u

2. 행동: 세션이 100회를 초과하고, 지난 7일 동안 방문하지 않았으며, 세션당 2회 이상 거래를 하고, 세션당 사이트에 100초 넘게 머무른 사용자입니다.

users::condition::ga:sessions>100;ga:daysSinceLastSession>=7; perSession::ga:transactions>2;perSession::ga:sessionDuration>100

3. 세션: 브라우저를 Chrome으로, 국가를 미국으로, 조회당 예외가 1회를 초과하는 세션을 선택하고, 세션당 이탈 횟수가 2회 미만인 사용자를 선택합니다.

sessions::condition::ga:browser==Chrome;ga:country==US;perHit::ga:exceptions>1; users::condition::perSession::ga:exits<2

4. 시퀀스가 있는 세션: 단계: Chrome 및 조회당 총 이벤트 수가 5보다 큰 세션 및 단계: 데스크톱에서 '단계: 모바일'을 선택한 사용자를 선택합니다.

sessions::sequence::ga:browser==Chrome;condition::perHit::ga:totalEvents>5;users::sequence::ga:deviceCategory==desktop->>ga:deviceCategory=mobile

5. 세션 날짜: 2014년 5월 20일부터 2014년 5월 30일 사이에 첫 번째 세션을 시작했고 사이트에서 600초 넘게 머무른 사용자를 선택합니다.

users::sequence::^ga:sessionCount==1;dateOfSession<>2014-05-20_2014-05-30;->>ga:sessionDurationBucket>600

측정항목: 기본 범위 참조

측정항목 기본 범위
ga:adClicks히트
ga:adCost히트
ga:adsenseAdsClicks히트
ga:adsenseAdsViewed히트
ga:adsenseAdUnitsViewed히트
ga:adsenseCTR히트
ga:adsenseECPM히트
ga:adsensePageImpressions히트
ga:adsenseRevenue히트
ga:avgDomainLookupTime히트
ga:avgDomContentLoadedTime히트
ga:avgDomInteractiveTime히트
ga:avgEventValue히트
ga:avgPageDownloadTime히트
ga:avgPageLoadTime히트
ga:avgRedirectionTime히트
ga:avgScreenviewDuration히트
ga:avgSearchDepth히트
ga:avgSearchDuration히트
ga:avgSearchResultViews히트
ga:avgServerConnectionTime히트
ga:avgServerResponseTime히트
ga:avgUserTimingValue히트
ga:costPerConversion히트
ga:costPerGoalConversion히트
ga:costPerTransaction히트
ga:CPC히트
ga:CPM히트
ga:CTR히트
ga:domainLookupTime히트
ga:domContentLoadedTime히트
ga:domInteractiveTime히트
ga:domLatencyMetricsSample히트
ga:eventValue히트
ga:exceptions히트
ga:exceptionsPerScreenview히트
ga:fatalExceptions히트
ga:fatalExceptionsPerScreenview히트
ga:goalAbandonRateAll히트
ga:goalAbandonsAll히트
ga:goalCompletionsAll히트
ga:goalStartsAll히트
ga:goalValueAll히트
ga:goalValueAllPerSearch히트
ga:goalXXAbandonRate히트
ga:goalXXAbandons히트
ga:goalXXCompletions히트
ga:goalXXStarts히트
ga:goalXXValue히트
ga:impressions히트
ga:itemQuantity히트
ga:itemRevenue히트
ga:itemsPerPurchase히트
ga:localItemRevenue히트
ga:localTransactionRevenue히트
ga:localTransactionShipping히트
ga:localTransactionTax히트
ga:margin히트
ga:metricXX히트
ga:pageDownloadTime히트
ga:pageLoadSample히트
ga:pageLoadTime히트
ga:pageValue히트
ga:pageviews히트
ga:percentSearchRefinements히트
ga:redirectionTime히트
ga:revenuePerItem히트
ga:revenuePerTransaction히트
ga:ROI히트
ga:RPC히트
ga:screenviews히트
ga:searchDepth히트
ga:searchDuration히트
ga:searchGoalConversionRateAll히트
ga:searchGoalXXConversionRate히트
ga:searchRefinements히트
ga:searchResultViews히트
ga:searchUniques히트
ga:serverConnectionTime히트
ga:serverResponseTime히트
ga:socialActivities히트
ga:socialInteractions히트
ga:socialInteractionsPerSession히트
ga:speedMetricsSample히트
ga:timeOnScreen히트
ga:totalEvents히트
ga:totalValue히트
ga:transactionRevenue히트
ga:transactions히트
ga:transactionShipping히트
ga:transactionTax히트
ga:uniqueAppviews히트
ga:uniqueEvents히트
ga:uniquePageviews히트
ga:uniquePurchases히트
ga:uniqueScreenviews히트
ga:uniqueSocialInteractions히트
ga:userTimingSample히트
ga:userTimingValue히트
ga:adsenseExits세션
ga:avgTimeOnPage세션
ga:avgSessionDuration세션
ga:bounces세션
ga:entranceBounceRate세션
ga:entranceRate세션
ga:entrances세션
ga:eventsPerSessionWithEvent세션
ga:exitRate세션
ga:exits세션
ga:goalConversionRateAll세션
ga:goalValuePerSession세션
ga:goalXXConversionRate세션
ga:organicSearches세션
ga:pageviewsPerSession세션
ga:percentSessionsWithSearch세션
ga:screenviewsPerSession세션
ga:searchExitRate세션
ga:searchExits세션
ga:searchSessions세션
ga:sessionDuration세션
ga:transactionRevenuePerSession세션
ga:transactionsPerSession세션
ga:bounceRate세션
ga:sessions세션
ga:sessionsWithEvent세션
ga:newSessions사용자
ga:percentNewSessions사용자
ga:users사용자