Базовый API отчетности – сегменты

В этом документе описываются синтаксис и рекомендации по использованию сегментов в Core Reporting API.

Введение

При использовании функции сегментации Core Reporting API вы можете запросить сегмент в Core Reporting API двумя способами:

  1. Сегменты по идентификатору : запрос с использованием числового идентификатора встроенного или настраиваемого сегмента.
  2. Динамические сегменты : укажите сегмент динамически во время запроса.

Сегментировать по идентификатору

Вы можете запросить сегмент в Core Reporting API, используя идентификатор встроенного или настраиваемого сегмента. Все доступные для пользователя сегменты можно получить с помощью метода list коллекции Segments в API управления Google Analytics. Для каждого сегмента идентификатор доступен в свойстве id ресурса Segment .

Дополнительную информацию об использовании идентификаторов сегментов в запросах API см. в справочнике по 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.
    • 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:pageviews и ga:transactions являются метриками уровня HIT, поскольку они происходят при обращении, тогда как ga:sessionDuration и ga:bounces являются метриками уровня SESSION, поскольку для каждого сеанса существует одно значение. Концептуально USER — это область самого высокого уровня, а HIT — область самого низкого уровня.

Значения метрики также могут сообщаться в областях, превышающих его основную область. Например, ga:pageviews и ga:transactions можно сообщать на уровне SESSION и USER, просто суммируя их для каждого обращения, которое происходит в этих сеансах или для этих пользователей.

Вы можете указать область действия для каждого условия метрики, которая будет определять уровень применения этого условия. Области метрик указываются с помощью префикса 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. Указанная область метрики должна быть равна или превышать ее основную область, определенную в модели данных. Полный список метрик и их основных областей см. в справочнике «Метрики: первичная область действия» .

Например, допустимыми областями действия метрик являются следующие:

  • Области условий и метрик одинаковы (т. е. уровень USER).
    • users::condition::perUser::ga:transactionRevenue>10
  • Область действия условия превышает область действия метрики (т. е. ПОЛЬЗОВАТЕЛЬ > СЕССИЯ).
    • 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

Например, следующие области являются недопустимыми метриками :

  • Следующий сегмент недействителен, поскольку область родительского условия ниже области метрики (т. е. SESSION < USER).
    • sessions::condition::perUser::ga:transactionRevenue>10
  • Использование области уровня HIT для метрики уровня SESSION и уровня HIT < уровня SESSION.
    • users::condition::perHit::ga:sessionDuration>60

Область действия по умолчанию

Если область действия метрического условия не указана явно, по умолчанию используется область условия. Например, следующий сегмент будет использовать область уровня USER для всех своих условий метрик: users::condition::ga:transactionRevenue>=10;ga:sessionDuration>60

Справочник по синтаксису динамических сегментов

Базовый синтаксис

Синтаксис определения сегмента имеет следующий вид: segment=<segmentCondition>+ . Другими словами, сегмент состоит из одного или нескольких операторов segmentCondition .

<segmentCondition> определяется как: <conditionScope><conditionType><dimensionOrMetricConditions>

где:
conditionScope определяет область действия условия(ий) верхнего уровня.
conditionType указывает тип условия(ий).
dimensionOrMetricConditions определяет условия измерения/метрики или шаги последовательности.

условиеОбъем

Указывает область верхнего уровня условий. Возможные значения:

  • users:: для выбора пользователей.
  • sessions:: для выбора сеансов.

Ограничения и соображения для conditionScope :

  • Если в одном сегменте указано несколько условий «пользователи» и «сеансы», их необходимо объединить с помощью оператора «И».
  • Условия, которые выбирают как пользователей, так и сеансы, также должны быть объединены оператором AND. Если указаны условия как для пользователей, так и для сеансов, сначала применяются все пользовательские условия для поиска подходящих пользователей, а затем все условия сеанса в сеансах, принадлежащих этим подходящим пользователям.
  • Если вы используете какие-либо условия на уровне пользователя, диапазон дат не должен превышать 90 дней .
  • Область условия также определяет уровень области по умолчанию для всех условий метрики ниже него. (Более подробную информацию об уровнях области см. в разделе «Метрики: справочник по первичной области »).

тип условия

Указывает тип условий. Возможные значения:

  • condition:: для указания простых (т. е. не основанных на последовательности) условий.
  • sequence:: для указания условий на основе последовательности.

Ограничения и соображения для conditionType :

  • Если указано несколько «простых условий» и «последовательностей», их всегда необходимо комбинировать с помощью оператора «И».
  • В каждом сегменте допускается максимум 10 шагов для условий на основе последовательности.

Простые условия

Простые условия состоят из одного или нескольких условий измерения/метрики, которые можно комбинировать.

Допустимые операторы условий для простых условий:

Синтаксис простых условий:

condition::<dimensionOrMetricConditions>

Пример простых условий:

  • users::condition::ga:transactionRevenue>10;ga:sessionDuration>60
  • Можно указать оператор отрицания верхнего уровня, чтобы найти дополнение к заданному простому условию, которое может содержать несколько условий измерения/метрики. Например, users::condition::!ga:transactionRevenue>10;ga:sessionDuration>60

Исключающие условия

Условие исключения используется для создания сегмента, который не соответствует определенному условию.

В синтаксисе используется оператор NOT (символ ! ) для отрицания условия и исключения сеансов, соответствующих этому условию.

Исключите сеансы, в которых страница выхода точно соответствует пути к корневой странице:
sessions::condition:: ! ga:exitPagePath==/

Несколько условий

Вы можете либо сгруппировать все условия уровня пользователя под одним префиксом users:: , либо использовать отдельный префикс users:: для каждого условия. То же самое справедливо и для условий уровня сеанса.

Например, следующие сегменты эквивалентны. В обоих случаях условие1 и условие2 обрабатываются оператором AND для выбора пользователей:
users::<condition1>;<condition2>
users::<condition1>users::<condition2>

Условия последовательности

Условия последовательности состоят из одного или нескольких шагов, где каждый шаг определяется одним или несколькими условиями измерения/метрики. Несколько шагов можно объединить с помощью специальных операторов последовательности.

Допустимыми операторами последовательности для условий последовательности являются:

  • Оператор –>> указывает, что предыдущий шаг предшествует следующему шагу.
  • Оператор –> указывает, что предыдущий шаг непосредственно предшествует следующему шагу.

Синтаксис условий последовательности:

sequence:: NOT? FIRST_HIT_MATCHES_FIRST_STEP? (AND (PRECEDES|IMMEDIATELY_PRECEDES) <step>)* 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 ; В сочетании с оператором <> вы можете ограничить сегмент группой пользователей, которые инициировали сеанс в определенном диапазоне дат. Максимальный диапазон дат для dateOfSession31 день . Подробную информацию о его использовании см. в примере даты сеанса ниже.

Размеры и метрические условия

Объединение условий

Вы можете объединить одно или несколько условий измерения с операторами 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 условий измерения или показателя на сегмент.
  • Максимальная длина выражения для условий измерения — 1024 символа.

Миграция устаревших динамических сегментов

Устаревшие динамические сегменты, использующие префикс dynamic:: эквивалентны сегментам уровня сеанса с условиями измерения и метрики в текущем синтаксисе. Если вы используете устаревшие динамические сегменты, вам следует перейти на новый синтаксис, заменив префикс dynamic:: префиксом sessions::condition:: . Например, два приведенных ниже сегмента эквивалентны:

dynamic::ga:browser==Chrome
равно:
sessions::condition::ga:browser==Chrome

Примеры сегментов

1. Демографические данные : мужчины Языки: EN-US, интересуются играми, выходцы из Америки.

Сегменты на основе пользователей применяются в первую очередь. Таким образом, условие на основе пользователей возвращает пользователей мужского пола, интересующихся играми. На сеансы, принадлежащие этим пользователям, затем распространяются условия, основанные на сеансах, чтобы получить сеансы из Америки и с языком 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. Дата сеанса : выберите пользователей, у которых был первый сеанс в период с 20 мая 2014 г. по 30 мая 2014 г. и которые провели на сайте > 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 ПОЛЬЗОВАТЕЛЬ