Журнал изменений

Для получения официальных объявлений об API Google Analytics подпишитесь на группу уведомлений Google Analytics API .

25 марта 2024 г. Добавлена ​​основная группа каналов, ручной источник трафика и параметры интеграции.

В схему API данных добавлены основная группа каналов, источник трафика, заданный вручную, а также специальные параметры интеграции CM360, DV360, SA360.

Размеры аудитории:

  • audienceId Идентификатор аудитории. Числовой идентификатор аудитории.

Размеры основной группы каналов:

  • firstUserPrimaryChannelGroup Первая группа основных каналов пользователя

  • primaryChannelGroup Основная группа каналов

  • sessionPrimaryChannelGroup Группа основных каналов сеанса

Параметры источника трафика вручную:

  • manualCampaignId Идентификатор кампании, созданный вручную

  • manualCampaignName Название кампании, заданное вручную

  • manualCreativeFormat Ручной формат объявления

  • manualMarketingTactic Ручная маркетинговая тактика

  • manualMedium Ручной средний

  • manualSource Источник руководства

  • manualSourceMedium Ручной источник/носитель

  • manualSourcePlatform Платформа с ручным исходным кодом

  • firstUserManualCampaignId Идентификатор первой кампании, созданной вручную,

  • firstUserManualCampaignName Название первой кампании по руководству пользователя

  • firstUserManualCreativeFormat Первый формат объявления для руководства пользователя

  • firstUserManualMarketingTactic Первое руководство пользователя, маркетинговая тактика

  • firstUserManualMedium Первый носитель руководства пользователя

  • firstUserManualSource Первый источник руководства пользователя

  • firstUserManualSourceMedium Первый источник/носитель руководства пользователя

  • firstUserManualSourcePlatform Первая исходная платформа руководства пользователя

  • sessionManualCampaignId Идентификатор кампании, созданной вручную для сеанса

  • sessionManualCampaignName Имя кампании, созданной вручную для сеанса

  • sessionManualCreativeFormat Формат объявления вручную для сеанса

  • sessionManualMarketingTactic Руководство по маркетинговой тактике сеанса

  • sessionManualMedium Ручной носитель сеанса

  • sessionManualSource Источник руководства по сеансу

  • sessionManualSourceMedium Ручной источник/носитель сеанса

  • sessionManualSourcePlatform Платформа исходного кода вручную сеанса

Параметры интеграции Менеджера кампаний 360 (CM360):

  • cm360AccountId Идентификатор аккаунта CM360

  • cm360AccountName Имя учетной записи CM360

  • cm360AdvertiserId Идентификатор рекламодателя CM360

  • cm360AdvertiserName Имя рекламодателя CM360

  • cm360CampaignId Идентификатор кампании CM360

  • cm360CampaignName Название кампании CM360

  • cm360CreativeFormat Формат объявления CM360

  • cm360CreativeId Идентификатор объявления CM360

  • cm360CreativeName Название объявления CM360

  • cm360CreativeType Тип объявления CM360

  • cm360CreativeTypeId Идентификатор типа объявления CM360

  • cm360CreativeVersion Версия объявления CM360

  • cm360Medium CM360 средний

  • cm360PlacementCostStructure Структура стоимости размещения в CM360

  • cm360PlacementId Идентификатор места размещения CM360

  • cm360PlacementName Название места размещения CM360

  • cm360RenderingId Идентификатор отрисовки CM360

  • cm360SiteId Идентификатор сайта CM360

  • cm360SiteName Имя сайта CM360

  • Источник cm360Source CM360

  • cm360SourceMedium Источник/носитель CM360

  • firstUserCm360AccountId Идентификатор учетной записи первого пользователя CM360

  • firstUserCm360AccountName Имя учетной записи первого пользователя CM360

  • firstUserCm360AdvertiserId Идентификатор первого пользователя рекламодателя CM360

  • firstUserCm360AdvertiserName Имя первого пользователя-рекламодателя CM360

  • firstUserCm360CampaignId Идентификатор кампании первого пользователя в CM360

  • firstUserCm360CampaignName Название кампании CM360 первого пользователя

  • firstUserCm360CreativeFormat Формат первого пользовательского объявления CM360

  • firstUserCm360CreativeId Идентификатор объявления первого пользователя в CM360

  • firstUserCm360CreativeName Название первого пользовательского объявления CM360

  • firstUserCm360CreativeType Тип объявления первого пользователя CM360

  • firstUserCm360CreativeTypeId Идентификатор типа объявления первого пользователя CM360

  • firstUserCm360CreativeVersion Первая версия пользовательского объявления CM360

  • firstUserCm360Medium Первый пользовательский CM360 средний

  • firstUserCm360PlacementCostStructure Структура стоимости размещения первого пользователя в CM360

  • firstUserCm360PlacementId Идентификатор места размещения первого пользователя в CM360

  • firstUserCm360PlacementName Название места размещения первого пользователя в CM360

  • firstUserCm360RenderingId Идентификатор отрисовки первого пользователя CM360

  • firstUserCm360SiteId Идентификатор сайта первого пользователя CM360

  • firstUserCm360SiteName Имя сайта первого пользователя CM360

  • firstUserCm360Source Источник первого пользователя CM360

  • firstUserCm360SourceMedium Источник/канал первого пользователя CM360

  • sessionCm360AccountId Идентификатор учетной записи сеанса CM360

  • sessionCm360AccountName Имя учетной записи сеанса CM360

  • sessionCm360AdvertiserId Идентификатор рекламодателя сеанса CM360

  • sessionCm360AdvertiserName Имя рекламодателя сеанса CM360

  • sessionCm360CampaignId Идентификатор кампании сеанса CM360

  • sessionCm360CampaignName Название кампании сеанса CM360

  • sessionCm360CreativeFormat Формат объявления сеанса CM360

  • sessionCm360CreativeId Идентификатор объявления сеанса CM360

  • sessionCm360CreativeName Название креатива сеанса CM360

  • sessionCm360CreativeType Тип объявления сеанса CM360

  • sessionCm360CreativeTypeId Идентификатор типа объявления сеанса CM360

  • sessionCm360CreativeVersion Версия объявления сеанса CM360

  • sessionCm360Medium Сеанс CM360 средний

  • sessionCm360PlacementCostStructure Структура стоимости размещения сеанса CM360

  • sessionCm360PlacementId Идентификатор места размещения сеанса CM360

  • sessionCm360PlacementName Имя места размещения сеанса CM360

  • sessionCm360RenderingId Идентификатор отрисовки сеанса CM360

  • sessionCm360SiteId Идентификатор сайта сеанса CM360

  • sessionCm360SiteName Имя сайта сеанса CM360

  • sessionCm360Source Источник сеанса CM360

  • sessionCm360SourceMedium Источник/носитель сеанса CM360

Параметры интеграции Google Display & Video 360 (DV360):

  • dv360AdvertiserId Идентификатор рекламодателя DV360

  • dv360AdvertiserName Имя рекламодателя DV360

  • dv360CampaignId Идентификатор кампании DV360

  • dv360CampaignName Название кампании DV360

  • dv360CreativeFormat Формат объявления DV360

  • dv360CreativeId Идентификатор объявления DV360

  • dv360CreativeName Название объявления DV360

  • dv360ExchangeId Идентификатор обмена DV360

  • dv360ExchangeName Имя обмена DV360

  • dv360InsertionOrderId Идентификатор заказа на размещение DV360

  • dv360InsertionOrderName Название заказа на размещение DV360

  • dv360LineItemId Идентификатор позиции DV360

  • dv360LineItemName Название позиции DV360

  • dv360Medium DV360 средний

  • dv360PartnerId Идентификатор партнера DV360

  • dv360PartnerName Имя партнера DV360

  • Источник dv360Source DV360

  • dv360SourceMedium Источник/носитель DV360

  • firstUserDv360AdvertiserId Идентификатор первого пользователя рекламодателя DV360

  • firstUserDv360AdvertiserName Имя первого пользователя рекламодателя DV360

  • firstUserDv360CampaignId Идентификатор кампании первого пользователя DV360

  • firstUserDv360CampaignName Название кампании DV360 первого пользователя

  • firstUserDv360CreativeFormat Формат первого пользовательского объявления DV360

  • firstUserDv360CreativeId Идентификатор первого пользовательского объявления DV360

  • firstUserDv360CreativeName Название первого пользовательского объявления DV360

  • firstUserDv360ExchangeId Идентификатор обмена DV360 первого пользователя

  • firstUserDv360ExchangeName Имя первого пользователя обмена DV360

  • firstUserDv360InsertionOrderId Идентификатор заказа на размещение первого пользователя в DV360

  • firstUserDv360InsertionOrderName Имя первого пользователя в заказе на размещение DV360

  • firstUserDv360LineItemId Идентификатор позиции первого пользователя в DV360

  • firstUserDv360LinteItemName Название позиции первого пользователя в DV360

  • firstUserDv360Medium Первый пользователь DV360 Medium

  • firstUserDv360PartnerId Идентификатор первого пользователя партнера DV360

  • firstUserDv360PartnerName Имя первого пользователя-партнера DV360

  • firstUserDv360Source Первый пользовательский источник DV360

  • firstUserDv360SourceMedium Первый пользовательский источник/канал DV360

  • sessionDv360AdvertiserId Идентификатор рекламодателя сеанса DV360

  • sessionDv360AdvertiserName Имя рекламодателя сеанса DV360

  • sessionDv360CampaignId Идентификатор кампании сеанса DV360

  • sessionDv360CampaignName Название кампании сеанса DV360

  • sessionDv360CreativeFormat Формат объявления сеанса DV360

  • sessionDv360CreativeId Идентификатор объявления сеанса DV360

  • sessionDv360CreativeName Название креатива DV360 сеанса

  • sessionDv360ExchangeId Идентификатор обмена сеанса DV360

  • sessionDv360ExchangeName Имя сеанса обмена DV360

  • sessionDv360InsertionOrderId Идентификатор заказа на размещение сеанса DV360

  • sessionDv360InsertionOrderName Название заказа на размещение сеанса DV360

  • sessionDv360LineItemId Идентификатор позиции сеанса DV360

  • sessionDv360LineItemName Название позиции сеанса DV360

  • sessionDv360Medium Сеанс DV360 средний

  • sessionDv360PartnerId Идентификатор партнера сеанса DV360

  • sessionDv360PartnerName Имя партнера сеанса DV360

  • sessionDv360Source Источник сеанса DV360

  • sessionDv360SourceMedium Источник/канал сеанса DV360

Параметры интеграции Google Search Ads 360 (SA360):

  • firstUserSa360AdGroupId Идентификатор группы объявлений SA360 первого пользователя

  • firstUserSa360AdGroupName Название группы объявлений SA360 первого пользователя

  • firstUserSa360CampaignId Идентификатор кампании SA360 для первого пользователя

  • firstUserSa360CampaignName Первая пользовательская кампания SA360

  • firstUserSa360CreativeFormat Формат первого пользовательского объявления SA360

  • firstUserSa360EngineAccountId Идентификатор учетной записи системы SA360 первого пользователя

  • firstUserSa360EngineAccountName Имя учетной записи системы SA360 первого пользователя

  • firstUserSa360EngineAccountType Тип учетной записи первого пользователя в системе SA360

  • firstUserSa360KeywordText Текст ключевого слова SA360 для первого пользователя

  • firstUserSa360ManagerAccountId Идентификатор управляющего аккаунта первого пользователя SA360

  • firstUserSa360ManagerAccountName Имя управляющего аккаунта первого пользователя SA360

  • firstUserSa360Medium Первый пользователь SA360 средний

  • firstUserSa360Query Первый пользовательский запрос SA360

  • firstUserSa360Source Первый пользовательский источник SA360

  • firstUserSa360SourceMedium Первый пользовательский источник/канал SA360

  • sa360AdGroupId Идентификатор группы объявлений SA360

  • sa360CampaignId Идентификатор кампании SA360

  • sa360AdGroupName Название группы объявлений SA360

  • sa360CampaignName Кампания SA360

  • sa360CreativeFormat Формат объявления SA360

  • sa360EngineAccountId Идентификатор учетной записи системы SA360

  • sa360EngineAccountName Имя учетной записи механизма SA360

  • sa360EngineAccountType Тип учетной записи системы SA360

  • sa360KeywordText Текст ключевого слова SA360

  • sa360ManagerAccountId Идентификатор управляющего аккаунта SA360

  • sa360ManagerAccountName Имя управляющего аккаунта SA360

  • sa360Medium SA360 средний

  • sa360Query Запрос SA360

  • Источник sa360Source SA360

  • sa360SourceMedium Источник/носитель SA360

  • sessionSa360AdGroupId Идентификатор группы объявлений SA360 сеанса

  • sessionSa360CampaignId Идентификатор кампании SA360 сеанса

  • sessionSa360ManagerAccountId Идентификатор управляющего аккаунта сеанса SA360

  • sessionSa360ManagerAccountName Имя управляющего аккаунта сеанса SA360

  • sessionSa360SourceMedium Источник/носитель сеанса SA360

06.03.2024 Поддержка аудиторий неактивных пользователей в экспорте аудиторий.

Функция экспорта аудитории лучше поддерживает экспорт аудиторий неактивных пользователей. Пользователи входят в эту аудиторию без соответствующего события; например, пользователь может войти в аудиторию, не посещая ваш сайт в течение семи дней. Примеры аудиторий неактивных пользователей включают «неактивных покупателей в течение 7 дней», «неактивных пользователей в течение 7 дней» и «пользователей, не получающих уведомления в течение 7 дней». Дополнительную информацию об этих предлагаемых аудиториях см. в разделе Рекомендуемые аудитории .

2024-02-28 Экспорт аудитории возвращает идентификатор пользователя, указанный в тегах.

Экспорт аудитории теперь возвращает идентификатор пользователя, указанный в тегах, даже если для вашего ресурса включены данные, предоставляемые пользователями. Если включен сбор данных, предоставляемых пользователями, предоставленные пользователем данные вместе с идентификатором пользователя можно отправлять в Google Analytics в виде тегов для улучшения измерения. Дополнительную информацию см. в разделе Сбор данных, предоставляемых пользователями .

30 января 2024 г. Поддержка уведомлений Webhook для списков аудиторий и повторяющихся списков аудиторий в альфа-версии Data API v1.

Поля AudienceList.webhookNotification и RecurringAudienceList.webhookNotification можно указать при создании списка аудитории (с использованием Properties.audienceLists.create ) или повторяющегося списка аудитории (с помощью Properties.recurringAudienceLists.create ).

Эта функция позволяет асинхронно получать уведомления Webhook, когда список аудитории становится доступным.

2024-01-18 Улучшена совместимость для измерений, включающих строку запроса или минутный компонент.

Измерения, включающие строку запроса, теперь совместимы с большинством полей. Такие измерения, как pagePathPlusQueryString , unifiedPageScreen , pageLocation и fullPageUrl , теперь совместимы со многими дополнительными полями, включая sessionSource , browser , city и landingPage .

Измерения, включающие минутный компонент, теперь совместимы с большинством полей. Такие измерения, как minute , nthMinute и dateHourMinute , теперь совместимы с аналогичным набором дополнительных полей.

Подробную информацию о совместимости см. в обозревателе параметров и показателей GA4 .

13.12.2023 Параметры пользовательского элемента

Специальные измерения на уровне элемента теперь можно включать в запросы Analytics Data API, используя следующий синтаксис:

Общее имя API Описание
customItem: имя_параметра Специальный параметр на уровне элемента для параметра имя_параметра

Дополнительную информацию см. в разделе «Измерения и метрики API» .

05.12.2023 Списки аудиторий доступны в бета-версии Data API v1 в виде экспорта аудитории.

Функция «Списки аудиторий» была переименована в «Экспорт аудиторий» и добавлена ​​в бета-версию Data API v1.

В бета-версию Data API v1 добавлены следующие методы:

28.11.2023 Добавлены samplingMetadatas для ответа на отчет.

Добавлены samplingMetadatas в ResponseMetaData . Эта коллекция будет содержать SampleMetadata для каждого диапазона дат в запросе, для которого были выбраны результаты. Google Analytics будет применять выборку только в том случае, если предполагает, что ограничения по количеству элементов приведут к снижению качества данных.

28.11.2023 Добавлена ​​функция повторяющегося экспорта списка аудитории в альфа-версию Data API v1.

В альфа-версию Data API v1 добавлены методы properties.recurringAudienceLists.create , properties.recurringAudienceLists.create , properties.recurringAudienceLists.list .

Эта функция позволяет создавать списки аудитории ежедневно по мере изменения членства в аудитории. Повторяющиеся списки аудитории гарантируют, что вы будете работать с самыми свежими результатами членства в аудитории.

08.11.2023 Добавлен экспорт списка аудитории в таблицы в альфа-версию Data API v1.

В альфа-версию Data API v1 добавлен метод properties.audienceLists.exportSheet , который позволяет экспортировать список аудитории в Google Таблицы.

13.10.2023 Добавлена ​​поддержка аудиторий с длительностью членства в 1 день.

Аудитории с продолжительностью членства в 1 день теперь поддерживаются функцией экспорта списков аудиторий .

2023-09-12 Правила упорядочивания AudienceList по умолчанию

По умолчанию отчеты, созданные с помощью функции экспорта списков аудиторий, подчиняются тем же правилам упорядочивания, что и другие методы отчетности Data API: порядок будет по убыванию по первому столбцу, затем по убыванию по второму столбцу и т. д.

До этого изменения вы могли получить следующий отчет:

идентификатор устройства isAdsПерсонализацияРазрешено
АВС истинный
ЦАП ЛОЖЬ
АВС ЛОЖЬ
ААА истинный

После этого изменения вы получите следующий отчет:

идентификатор устройства isAdsПерсонализацияРазрешено
ААА истинный
АВС ЛОЖЬ
АВС истинный
ЦАП ЛОЖЬ

15 августа 2023 г. в схему экспорта списка аудитории добавлено измерение isLimitedAdTracking

15 августа 2023 г. Добавлено измерение currencyCode , метрика itemDiscountAmount .

  • currencyCode код местной валюты (на основе стандарта ISO 4217) события электронной коммерции. Например, «USD» или «GBP».

  • itemDiscountAmount Денежное значение скидок на товары в событиях электронной коммерции. Этот показатель заполняется при разметке с помощью параметра позиции «скидка».

Дополнительную информацию см. в разделе Схема отчетов Data API .

10 августа 2023 г. в схему экспорта списка аудитории добавлено измерение isAdsPersonalizationAllowed

  • isAdsPersonalizationAllowed — разрешена ли персонализация рекламы. Если пользователь имеет право на персонализацию рекламы isAdsPersonalizationAllowed возвращает true . Если пользователь не имеет права на персонализацию рекламы, isAdsPersonalizationAllowed возвращает false .

    Дополнительную информацию см. в разделе «Параметры списка аудитории» .

10 июля 2023 г. Списки аудитории

Поддержка списков аудиторий добавлена ​​в альфа-версию Data API v1. Списки аудиторий включают снимок пользователей в аудитории на момент создания списка аудитории.

В альфа-версию Data API v1 добавлены следующие методы:

19 мая 2023 г. Пользовательские группы каналов

В Data API добавлена ​​поддержка групп пользовательских каналов .

2023-05-11 Изменение квоты токенов.

Система квот API данных была обновлена, чтобы обеспечить более точную оплату.

Количество токенов, взимаемых за каждый запрос, было обновлено в соответствии с изменением квоты и перебалансировано таким образом, чтобы обеспечить большее количество простых запросов отчетов, в то же время взимая значительно больше токенов квоты для отчетов с большими датами.

После этого изменения, хотя плата за некоторые запросы останется прежней, стоимость более сложных запросов заметно увеличится. Например, за запросы данных за период более 6 месяцев может взиматься плата в размере 1000 или более токенов квоты.

Стандартные свойства

Название квоты Старый лимит Новый лимит
Базовых токенов на недвижимость в день 25 000 200 000
Токенов ядра на ресурс в час 5000 40 000
Core токены на проект на недвижимость в час 1750 14 000
Токенов реального времени на каждый объект недвижимости в день 25 000 200 000
Токенов реального времени на ресурс в час 5000 40 000
Токенов реального времени на проект на объект в час 1750 14 000
Токенов воронки на ресурс в день 25 000 200 000
Токенов воронки на ресурс в час 5000 40 000
Токенов воронки на проект на объект в час 1750 14 000

Ресурсы Аналитики 360

Название квоты Старый лимит Новый лимит
Базовых токенов на недвижимость в день 250 000 2 000 000
Токенов ядра на ресурс в час 50 000 400 000
Core токены на проект на недвижимость в час 17 500 140 000
Токенов реального времени на каждый объект недвижимости в день 250 000 2 000 000
Токенов реального времени на ресурс в час 50 000 400 000
Токенов реального времени на проект на объект в час 17 500 140 000
Токенов воронки на ресурс в день 250 000 2 000 000
Токенов воронки на ресурс в час 50 000 400 000
Токенов воронки на проект на объект в час 17 500 140 000

02.03.2023 Добавлены измерения даты.

  • dayOfWeekName Название дня недели. День недели на английском языке. Это измерение имеет значения Sunday , Monday и т. д.

  • isoWeek Неделя года по ISO. Номер недели по ISO, где каждая неделя начинается в понедельник. Подробности см. https://en.wikipedia.org/wiki/ISO_week_date . Примеры значений: 01 , 02 и 53 .

  • isoYear Год ISO. Год проведения мероприятия по стандарту ISO. Подробности см. https://en.wikipedia.org/wiki/ISO_week_date . Примеры значений включают 2022 и 2023 .

  • isoYearIsoWeek Неделя ISO в году ISO. Объединенные значения isoWeek и isoYear . Примеры значений: 201652 и 201701 .

  • yearMonth Год месяц. Комбинированные значения year и month . Примеры значений включают 202212 или 202301 .

  • yearWeek Годовая неделя. Комбинированные значения year и week . Примеры значений включают 202253 или 202301 .

27 февраля 2023 г. Добавлены параметры электронной коммерции.

  • itemListPosition Позиция в списке элементов. Положение элемента (например, продукта, который вы продаете) в списке. Это измерение заполняется при тегировании параметром index в массиве элементов.

  • itemLocationID Идентификатор местоположения элемента. Физическое местоположение, связанное с товаром (например, физическое местоположение магазина). Рекомендуется использовать идентификатор места Google , соответствующий связанному элементу. Также можно использовать собственный идентификатор местоположения. Это поле заполняется при тегировании параметром location_id в массиве элементов.

  • itemPromotionCreativeSlot Креативный слот для продвижения предмета. Название рекламного креатива, связанного с элементом. Это измерение можно указать в тегах с помощью параметра creative_slot на уровне события или элемента. Если параметр указан как на уровне события, так и на уровне элемента, используется параметр уровня элемента.

21 февраля 2023 г. Добавлен параметр «Целевая страница + строка запроса».

  • landingPagePlusQueryString Целевая страница + строка запроса. Путь к странице + строка запроса, связанная с первым просмотром страницы в сеансе.

Это поле заменяет параметр landingPage , который устарел и будет обновлен, чтобы не возвращать строку запроса 14 мая 2023 г.

28 января 2023 г. Добавлены показатели «Просмотры на пользователя», «Прокрутленные пользователи».

  • screenPageViewsPerUser Количество просмотров на пользователя. Количество экранов приложений или веб-страниц, просмотренных вашими пользователями, на каждого активного пользователя. Повторные просмотры одной страницы или экрана засчитываются. (screen_view + page_view events) / active users .

  • scrolledUsers Прокручиваемые пользователи. Количество уникальных пользователей, прокрутивших не менее 90 % страницы.

23 января 2023 г. Добавлены измерения «Континент», «Идентификатор континента».

  • continent Континент. Континент, с которого произошла активность пользователя. Например, Americas или Asia .

  • continentId Идентификатор континента. Географический идентификатор континента, с которого произошла активность пользователя, полученный на основе его IP-адреса.

23 января 2023 г. Добавлено измерение «Идентификатор фильтра тестовых данных».

  • testDataFilterId Идентификатор фильтра тестовых данных. Числовой идентификатор фильтра данных в состоянии тестирования. Вы используете фильтры данных, чтобы включать или исключать данные о событиях из ваших отчетов на основе значений параметров событий. Дополнительную информацию см. на странице https://support.google.com/analytics/answer/10108813 .

18.10.2022 Добавлены показатели рекламы.

  • advertiserAdClicks Клики по рекламе. Общее количество раз, когда пользователи нажимали на объявление, чтобы попасть на объект.
  • advertiserAdCost Стоимость рекламы. Общая сумма, которую вы заплатили за рекламу.
  • advertiserAdCostPerClick Стоимость объявления за клик. Стоимость объявления за клик — это стоимость объявления, разделенная на количество кликов по объявлению, и часто сокращается до CPC.
  • advertiserAdCostPerConversion Стоимость конверсии. Цена за конверсию – это стоимость рекламы, разделенная на число конверсий.
  • advertiserAdImpressions Показы рекламы. Общее количество показов.
  • returnOnAdSpend Окупаемость расходов на рекламу. Рентабельность расходов на рекламу (ROAS) – это общий доход, разделенный на стоимость рекламы рекламодателя.

17.10.2022 Добавлены метрики на уровне элемента.

  • itemsAddedToCart Товары добавлены в корзину. Количество единиц, добавленных в корзину для одного товара.
  • itemsCheckedOut Элементы, извлеченные. Количество единиц, проверенных для одного товара.
  • itemsClickedInList Элементы, выбранные в списке. Количество единиц, выбранных в списке для одного элемента.
  • itemsClickedInPromotion Элементы, на которые нажимали при продвижении. Количество единиц, нажатых в рамках промоакции для одного товара.
  • itemsViewed просмотренные предметы. Количество просмотренных единиц одного товара.
  • itemsViewedInList Элементы, просматриваемые в списке. Количество единиц, просмотренных в списке для одного элемента.
  • itemsViewedInPromotion Товары, просмотренные по акции. Количество единиц, просмотренных по акции для одного товара.

13 сентября 2022 г. Объявление об изменениях совместимости схемы.

1 декабря 2022 года произойдут следующие серьезные изменения:

  1. Измерения на уровне элемента, такие как itemName становятся несовместимыми с метриками на уровне событий, такими как eventCount . Измерения на уровне элемента по-прежнему будут совместимы с метриками на уровне элемента, такими как itemRevenue , метриками на основе пользователей, такими как activeUsers , и метриками на основе сеансов, такими как sessions .

  2. Параметры атрибуции, такие как source становятся несовместимыми с некоторыми метриками на уровне событий, такими как eventCount . Параметры атрибуции по-прежнему будут совместимы с атрибутивными показателями, такими как conversions , метриками на основе пользователей, такими как activeUsers , и метриками на основе сеансов, такими как sessions .

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

Чтобы узнать больше, ознакомьтесь с подробным объяснением изменений совместимости .

01.09.2022 Изменения квот.

  • Квоты Requests per day , Requests Per Minute , Requests Per Minute Per User удалены из Data API.

  • В API добавлена ​​квота Tokens Per Project Per Property Per Hour .

  • Каждый запрос использует квоту как для Tokens Per Property Per Hour так и Tokens Per Project Per Property Per Hour .

    Подробную информацию о новых квотах см. в документации по квотам .

03 августа 2022 г. Добавлены измерения SA360 на уровне сеанса.

  • sessionSa360AdGroupName Имя группы объявлений сеанса SA360. Название группы объявлений из Search Ads 360, которое привело к этому сеансу.

  • sessionSa360CampaignName Сеансовая кампания SA360. Название кампании из Search Ads 360, которая привела к этому сеансу.

  • sessionSa360CreativeFormat Формат объявления сеанса SA360. Тип креатива в Search Ads 360, который привел к этому сеансу. Например, "Адаптивное поисковое объявление" или "Развернутое текстовое объявление".

  • sessionSa360EngineAccountId Идентификатор учетной записи механизма сеанса SA360. Идентификатор учетной записи системы в SA360, которая привела к этому сеансу.

  • sessionSa360EngineAccountName Имя учетной записи механизма сеанса SA360. Имя учетной записи системы в SA360, которая привела к этому сеансу.

  • sessionSa360EngineAccountType Тип учетной записи механизма сеанса SA360. Тип учетной записи системы в Search Ads 360, которая привела к этому сеансу. Например, «Google Реклама», «Bing» или «Baidu».

  • sessionSa360Keyword Текст ключевого слова сеанса SA360. Ключевое слово поисковой системы из Search Ads 360, которое привело к этому сеансу.

  • sessionSa360Medium Сеанс SA360 средний. Ключевое слово поисковой системы из Search Ads 360, которое привело к этому сеансу. Например, «цена за клик».

  • sessionSa360Query Запрос сеанса SA360. Поисковый запрос из Search Ads 360, который привел к этому сеансу.

  • sessionSa360Source Источник сеанса SA360. Источник трафика из Search Ads 360, который привел к этому сеансу. Например, «example.com» или «google».

  • Параметры sessionCampaignId и sessionCampaignName теперь поддерживают кампании Search Ads 360.

11 июля 2022 г. Добавлены показатели коэффициента конверсии.

Коэффициент конверсии

  • sessionConversionRate Процент сеансов, в которых было инициировано какое-либо событие конверсии.

  • userConversionRate Процент пользователей, инициировавших какое-либо событие конверсии.

Показатели коэффициента конверсии для одной конверсии

  • sessionConversionRate:event_name Процент сеансов, в которых было инициировано определенное событие-конверсия.

  • userConversionRate:event_name Процент пользователей, инициировавших определенное событие-конверсию.

5 мая 2022 г. В альфа-канал добавлена ​​функция отчетов по воронке.

16 февраля 2022 г. Добавлены новые измерения.

Условия и содержание вручную

  • firstUserManualAdContent Содержание первого объявления в руководстве пользователя. Рекламный контент, который первым привлек пользователя. Заполняется параметром utm_content .

  • firstUserManualTerm Первый термин руководства пользователя. Термин, который первым приобрел пользователь. Заполняется параметром utm_term .

  • manualAdContent Содержание объявления, заданное вручную. Содержание объявления, связанное с событием-конверсией. Заполняется параметром utm_content .

  • manualTerm Ручной термин. Термин, связанный с событием конверсии. Заполняется параметром utm_term .

  • sessionManualAdContent Содержимое объявления, созданное вручную. Содержание объявления, которое привело к сеансу. Заполняется параметром utm_content .

  • sessionManualTerm Ручной срок сеанса. Термин, который привел к сеансу. Заполняется параметром utm_term .

Анализ сбоев

  • crashAffectedUsers Пользователи, пострадавшие от сбоя. Количество пользователей, зафиксировавших сбой в этой строке отчета.

  • crashFreeUsersRate Оценка пользователей без сбоев.

Приложение/Интернет

  • averageSessionDuration Средняя продолжительность (в секундах) сеансов пользователей.

  • newVsReturning Новые/вернувшиеся пользователи.

  • screenPageViewsPerSession Просмотров за сеанс.

  • landingPage страница. Путь к странице + строка запроса, связанная с первым просмотром страницы в сеансе.

  • platformDeviceCategory Платформа и тип устройства, на котором работал ваш веб-сайт или мобильное приложение.

Мобильное приложение

  • averagePurchaseRevenuePerUser Средний доход от покупок на одного пользователя.

  • firstTimePurchaserConversionRate Процент активных пользователей, совершивших первую покупку.

  • firstTimePurchasersPerNewUser Среднее количество первых покупок на одного нового пользователя.

  • dauPerMau ДАУ/МАУ. Скользящий процент активных пользователей в течение 30 дней, которые также являются активными пользователями в течение 1 дня.

  • dauPerWau ДАУ/ВАУ. Скользящий процент активных пользователей в течение 7 дней, которые также являются активными пользователями в течение 1 дня.

  • wauPerMau ВАУ/МАУ. Скользящий процент активных пользователей в течение 30 дней, которые также являются активными пользователями в течение 7 дней.

  • purchaserConversionRate Процент активных пользователей, совершивших одну или несколько транзакций покупки.

  • transactionsPerPurchaser Транзакции на одного покупателя.

Кампания Google Рекламы

  • firstUserGoogleAdsCampaignType — тип кампании Google Рекламы, которая первой привлекла пользователя.

  • googleAdsCampaignType Тип кампании Google Рекламы, связанный с событием-конверсией.

  • sessionGoogleAdsCampaignType — тип кампании Google Рекламы, которая привела к этому сеансу.

07.09.2021 Добавлены новые измерения даты/времени.

  • dateHourMinute Объединенные значения даты, часа и минуты в формате ГГГГММДДЧЧММ.

  • minute Двузначная минута часа, в течение которого было зарегистрировано событие.

  • nthMinute Число минут с начала диапазона дат.

07.09.2021 Добавлены новые измерения, заполняемые параметрами событий.

  • achievementId Идентификатор достижения в игре для события.

  • character Персонаж игрока в игре для события.

  • fileExtension Расширение загруженного файла.

  • fileName Путь к странице загруженного файла.

  • groupId Идентификатор группы игроков в игре для события.

  • linkClasses Атрибут класса HTML для исходящей ссылки.

  • linkDomain Домен назначения исходящей ссылки.

  • linkId Атрибут HTML-id для исходящей ссылки или загрузки файла.

  • linkText Текст ссылки на загрузку файла.

  • linkUrl Полный URL-адрес исходящей ссылки или загрузки файла.

  • method Метод, с помощью которого было инициировано событие.

  • outbound Возвращает значение true, если ссылка ведет на сайт, не являющийся частью домена ресурса.

  • pageLocation Протокол, имя хоста, путь к странице и строка запроса для посещенных веб-страниц.

  • pageReferrer Полный URL-адрес ссылки, включая имя хоста и путь.

  • percentScrolled Процент страницы, которую пользователь прокрутил (например, «90»).

  • searchTerm Термин, который ищет пользователь.

  • videoProvider Источник видео (например, «youtube»).

  • videoTitle Название видео.

  • videoUrl URL-адрес видео.

  • visible Возвращает «истину», если содержимое видимо.

  • unifiedPagePathScreen Путь к странице (веб-сайт) или класс экрана (приложение), на котором было зарегистрировано событие.

07.09.2021 Изменения в схеме API.

Изменения в существующих размерах:

  • unifiedPageScreen Для событий, созданных через Интернет, это измерение теперь возвращает путь к странице и строку запроса , в которой было зарегистрировано событие.

Анонс предстоящих изменений:

  • firstUserTrafficOrigin источник трафика, который первым привлек пользователя. Пожалуйста, не полагайтесь на то, что это поле возвращает значение «Вручную» для трафика, использующего UTM; это поле изменится с значения «Вручную» на значение «(не установлено)» для предстоящего запуска функции.

  • sessionTrafficOrigin источник трафика кампании сеанса. Пожалуйста, не полагайтесь на то, что это поле возвращает значение «Вручную» для трафика, использующего UTM; это поле изменится с «Вручную» на «(не установлено)» для предстоящего запуска функции.

  • trafficOrigin — источник трафика кампании события-конверсии. Пожалуйста, не полагайтесь на то, что это поле возвращает значение «Вручную» для трафика, использующего UTM; это поле изменится с «Вручную» на «(не установлено)» для предстоящего запуска функции.

07.09.2021 В API добавлен метод checkCompatibility .

Метод checkCompatibility перечисляет измерения и показатели, которые можно добавить в запрос отчета и обеспечить совместимость.

21 июля 2021 г. Изменения в отчетности в реальном времени.

Теперь можно указать минутные диапазоны данных событий для чтения с помощью параметра minuteRanges метода runRealtimeReport .

21 июля 2021 г. Новые параметры группировки каналов.

В схему отчетов Data API добавлены новые параметры группировки каналов:

  • firstUserDefaultChannelGrouping Первая группа каналов пользователя по умолчанию.

  • defaultChannelGrouping Группировка каналов по умолчанию.

10.06.2021 Изменения в схеме API .

  • Измерение minutesAgo добавлено в схему реального времени Data API и может использоваться в запросах к методу runRealtimeReport . Это измерение содержит количество минут назад, когда было зарегистрировано событие. 00 — текущая минута, а 01 — предыдущая минута.

  • Измерение googleAdsCreativeId добавлено в схему Data API. Этот параметр содержит идентификатор объявления Google Рекламы, связанного с событием конверсии.

  • Измерение sessionGoogleAdsCreativeId добавлено в схему Data API. Этот параметр содержит идентификатор объявления Google Рекламы, которое привело к сеансу на вашем веб-сайте или в приложении.

  • Измерение firstUserCreativeId переименовано в firstUserGoogleAdsCreativeId в схеме Data API. Этот параметр содержит идентификатор объявления Google Рекламы, которое первым привлекло пользователя.

09.04.2021 Выпущена бета-версия Google Analytics Data API v1.

  • Конечная точка API обновлена ​​до https://analyticsdata.googleapis.com/v1beta .

  • Методы runReport , runPivotReport , batchRunReports , batchRunPivotReports теперь принимают идентификатор свойства Google Analytics 4 в параметре property URL-пути вместо поля entity тела запроса:

    POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports

  • Клиентские библиотеки API были обновлены для использования новой конечной точки API.

19 февраля 2021 г. Изменения в нумерации страниц.

  • Размер ответа отчета по умолчанию увеличился с 10 до 10 000 строк данных о событиях.

  • "limit" : -1 значение, которое использовалось для указания попытки извлечь все строки, больше не поддерживается в Runreportrequest .

  • Максимальное значение limit поля установлено на 100000 . Используйте лиц , чтобы получить отчеты, содержащие более 100 000 строк.

2021-02-08 Новые размеры и метрики электронной коммерции.

Новые размеры электронной коммерции и метрики были добавлены в схему API :

Размеры: adFormat , adSourceName , adUnitName , itemBrand , itemCategory , itemCategory2 , itemCategory3 , itemCategory4 , itemCategory5 itemId , itemListId , itemListName , itemName , itemPromotionCreativeName , itemPromotionId , itemPromotionName , orderCoupon , transactionId .

Метрики: adUnitExposure , addToCarts , cartToViewRate itemPurchaseQuantity checkouts , ecommercePurchases , firstTimePurchasers itemViews itemListClickThroughRate , itemListClicks publisherAdImpressions itemPromotionClickThroughRate totalPurchasers itemPromotionClicks , itemListViews , itemRevenue , itemPromotionViews publisherAdClicks .

2021-02-08 добавил новые аспекты кампании.

Новые аспекты кампании были добавлены в схему API : campaignId , campaignName , googleAdsAccountName , googleAdsAdGroupId , googleAdsAdGroupName , googleAdsAdNetworkType , source , trafficOrigin

2021-02-08 dayOfWeek , week изменения измерения.

  • Значение dayOfWeek Dimension теперь начинается с 0 вместо 1.

  • Значение week измерения теперь начинается с 01 и возвращает двухзначный номер с 01 до 53. Каждую неделю начинается в воскресенье. 1 января всегда на неделе 01.

2021-01-28 Добавленные варианты агрегации для пользовательских метрик.

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

2021-01-28 Добавлены новые измерения даты/времени.

Следующие новые измерения были добавлены к схеме API : hour , nthHour , nthYear , dateHour .

2021-01-28 API данных уменьшил токены квот, заряженные за запрос.

API данных уменьшил токены квоты, заряженные за запрос. Пределы квот для токенов к квотам в час и в день не были изменены.

2020-11-09 Метод getUniversalMetadata был удален.

Метод getUniversalMetadata был удален. Пожалуйста, используйте GetMetadata . Максимальный диапазон дат на один год для запроса API был удален.

2020-11-02 добавил метод отчетности в реальном времени.

См. Создание отчета в режиме реального времени для примеров и RunrealTimeReport для справочной документации для остальной.

2020-10-19 Клиентская библиотека обновлена.

Артефакты клиентской библиотеки обновляются вместе с инструкциями по использованию и образцами кода.

2020-10-13 Приложение + веб-свойства были переименованы в Google Analytics 4 (GA4).

2020-10-08 Метод getMetadata добавлен в API.

Метод GetMetAdata возвращает пользовательские размеры и метрики, доступные для указанного идентификатора свойства GA4, а также универсальные метаданные.

2020-10-08 Пользовательские размеры и метрики доступны в отчетах.

См. Документацию схемы API для документации по пользовательским аспектам и метрикам. Это обновление включает в себя пользовательские аспекты и метрики с учетом событий, а также пользовательские пользовательские размеры.

,

Для официальных объявлений API Google Analytics, пожалуйста, подпишитесь на Google Analytics API Group .

2024-03-25 Добавлены группы первичных каналов, ручной источник трафика и специфические размеры интеграции.

Группа первичных каналов, ручный источник трафика и CM360, DV360, SA360 Интеграция специфические размеры, добавленные к схеме API данных.

Аудитория измерения:

  • audienceId идентификатор аудитории. Числовой идентификатор аудитории.

Основные измерения группы каналов:

  • firstUserPrimaryChannelGroup First User Group Group

  • primaryChannelGroup Primary Channel Group

  • sessionPrimaryChannelGroup Session Group Group

Ручные размеры источника трафика:

  • manualCampaignId Manual Campaign

  • manualCampaignName Название кампании

  • Ручной формат ручного manualCreativeFormat

  • manualMarketingTactic Manal Marketing Tactic

  • manualMedium Medmedium Medium

  • manualSource ручному ручному источнику

  • Руководство по ручному manualSourceMedium среду ручной работы / среда

  • manualSourcePlatform ручной платформы ручной работы

  • firstUserManualCampaignId Первый идентификатор управления пользователем

  • firstUserManualCampaignName Первое руководство пользователя Имя кампании

  • firstUserManualCreativeFormat Persing Руководство пользователя творческий формат

  • firstUserManualMarketingTactic Первая пользовательская маркетинговая тактика маркетинга

  • firstUserManualMedium Первый пользователь средний

  • firstUserManualSource Первый пользовательский источник пользователя

  • firstUserManualSourceMedium Первый пользовательский ручный источник / средний

  • firstUserManualSourcePlatform First User Manual Platform

  • sessionManualCampaignId Manual Manual Campaign

  • sessionManualCampaignName Session Manual Название кампании

  • sessionManualCreativeFormat Session Manual Creative Format

  • sessionManualMarketingTactic Session Manual Marketing Tactic

  • sessionManualMedium Session Medium Medium

  • sessionManualSource Session Manual Source

  • sessionManualSourceMedium Session Manual Source / Medium

  • sessionManualSourcePlatform Session Manual Platform

Менеджер кампании 360 (CM360) Размеры интеграции:

  • cm360AccountId CM360 идентификатор учетной записи

  • cm360AccountName CM360 Имя учетной записи

  • cm360AdvertiserId CM360 идентификатор рекламодателя

  • cm360AdvertiserName CM360 Имя рекламодателя

  • cm360CampaignId CM360 ID кампании

  • cm360CampaignName CM360 Название кампании

  • cm360CreativeFormat CM360 Творческий формат

  • cm360CreativeId CM360 Creative ID

  • cm360CreativeName CM360 Творческое имя

  • cm360CreativeType CM360 Творческий тип

  • cm360CreativeTypeId CM360 Творческий тип идентификатор типа

  • cm360CreativeVersion CM360 Творческая версия

  • cm360Medium CM360 среда

  • cm360PlacementCostStructure CM360 Структура стоимости размещения

  • cm360PlacementId CM360 ID размещения

  • cm360PlacementName CM360 Имя размещения

  • cm360RenderingId CM360 идентификатор рендеринга

  • cm360SiteId CM360 ID сайта

  • cm360SiteName CM360 Имя сайта

  • cm360Source CM360 Источник

  • cm360SourceMedium cm360 Source / Medium

  • firstUserCm360AccountId ID FIRST USER CM360

  • firstUserCm360AccountName FIRST USER USER CM360 Имя учетной записи

  • firstUserCm360AdvertiserId First User CM360 идентификатор рекламодателя

  • firstUserCm360AdvertiserName First User CM360 Имя рекламодателя

  • firstUserCm360CampaignId Первый пользователь CM360 идентификатор кампании

  • firstUserCm360CampaignName First User CM360 Имя кампании

  • firstUserCm360CreativeFormat First User CM360 Creative Format

  • firstUserCm360CreativeId Первый пользователь CM360 Creative ID

  • firstUserCm360CreativeName First User CM360 Творческое имя

  • firstUserCm360CreativeType первого пользователя CM360 Creative Type

  • firstUserCm360CreativeTypeId первого пользователя CM360 идентификатор творческого типа

  • firstUserCm360CreativeVersion Первый пользователь CM360 Творческая версия

  • firstUserCm360Medium First User CM360 Medium

  • firstUserCm360PlacementCostStructure First User CM360 Структура стоимости размещения

  • firstUserCm360PlacementId идентификатор размещения CM360 CM360

  • firstUserCm360PlacementName FIRST USER CM360 Имя размещения

  • firstUserCm360RenderingId Первый пользователь CM360 идентификатор рендеринга

  • firstUserCm360SiteId Первый пользователь CM360 ID сайта

  • firstUserCm360SiteName First User CM360 Имя сайта

  • firstUserCm360Source First User CM360 Source

  • firstUserCm360SourceMedium First User CM360 Source / Medium

  • sessionCm360AccountId SESSION CM360 Идентификатор учетной записи

  • sessionCm360AccountName SESSION CM360 Имя учетной записи

  • sessionCm360AdvertiserId Session CM360 идентификатор рекламодателя

  • sessionCm360AdvertiserName SESSION CM360 Имя рекламодателя

  • sessionCm360CampaignId Session Cm360 ID кампании

  • sessionCm360CampaignName Session CM360 Название кампании

  • sessionCm360CreativeFormat Session Cm360 Творческий формат

  • sessionCm360CreativeId Session CM360 Creative ID

  • sessionCm360CreativeName SESSION CM360 Творческое имя

  • sessionCm360CreativeType Session Cm360 Творческий тип

  • sessionCm360CreativeTypeId Session CM360

  • sessionCm360CreativeVersion Session CM360 Творческая версия

  • sessionCm360Medium Session CM360 среда

  • sessionCm360PlacementCostStructure SESSION CM360 Структура стоимости размещения

  • sessionCm360PlacementId Session CM360 ID размещения

  • sessionCm360PlacementName SESSION CM360 Имя размещения

  • sessionCm360RenderingId Session Cm360 ID рендеринг

  • sessionCm360SiteId Session CM360 ID сайта

  • sessionCm360SiteName Session CM360 Имя сайта

  • sessionCm360Source Session CM360 Source

  • sessionCm360SourceMedium session CM360 Source / Medium

Google Display & Video 360 (DV360) Размеры интеграции:

  • dv360AdvertiserId DV360 идентификатор рекламодателя

  • dv360AdvertiserName DV360 Имя рекламодателя

  • dv360CampaignId DV360 ID кампании

  • dv360CampaignName DV360 Название кампании

  • dv360CreativeFormat DV360 Творческий формат

  • dv360CreativeId DV360 Creative ID

  • dv360CreativeName DV360 Творческое имя

  • dv360ExchangeId DV360 Exchange ID

  • dv360ExchangeName DV360 Exchange Имя

  • dv360InsertionOrderId DV360 ID вставки

  • dv360InsertionOrderName DV360 Имя заказа заказа

  • dv360LineItemId DV360 ID строки

  • dv360LineItemName DV360

  • dv360Medium DV360 среда

  • dv360PartnerId DV360 ID партнера

  • dv360PartnerName DV360 Имя партнера

  • dv360Source DV360 Источник

  • dv360SourceMedium DV360 Source / Medium

  • firstUserDv360AdvertiserId First User DV360 идентификатор рекламодателя

  • firstUserDv360AdvertiserName Первый пользователь DV360 Имя рекламодателя

  • firstUserDv360CampaignId Первый пользователь DV360 идентификатор кампании DV360

  • firstUserDv360CampaignName First User DV360 Имя кампании

  • firstUserDv360CreativeFormat First User Dv360 Creative Format

  • firstUserDv360CreativeId Первый пользователь DV360 Creative ID

  • firstUserDv360CreativeName Первый пользователь DV360 Творческое имя

  • firstUserDv360ExchangeId первого пользователя DV360 ID Exchange ID

  • firstUserDv360ExchangeName First User DV360 Exchange Имя

  • firstUserDv360InsertionOrderId Первый пользователь DV360 идентификатор порядок вставки

  • firstUserDv360InsertionOrderName Первый пользователь DV360 Имя заказа заказа

  • firstUserDv360LineItemId Первый пользователь DV360 идентификатор строки линии

  • firstUserDv360LinteItemName First User DV360

  • firstUserDv360Medium First User DV360 Medium

  • firstUserDv360PartnerId First User DV360 ID партнера

  • firstUserDv360PartnerName First User DV360 Имя партнера

  • firstUserDv360Source First User DV360 Source

  • firstUserDv360SourceMedium Первый пользователь DV360 Source / Medium

  • sessionDv360AdvertiserId Session DV360 идентификатор рекламодателя

  • sessionDv360AdvertiserName Session DV360 Имя рекламодателя

  • sessionDv360CampaignId Session DV360 идентификатор кампании

  • sessionDv360CampaignName Session DV360 Название кампании

  • sessionDv360CreativeFormat Session DV360 Творческий формат

  • sessionDv360CreativeId Session DV360 Creative ID

  • sessionDv360CreativeName SESSION DV360 Творческое название

  • sessionDv360ExchangeId Session DV360 Exchange ID

  • sessionDv360ExchangeName Session DV360 Имя обмена

  • sessionDv360InsertionOrderId Session DV360 ID Заказа

  • sessionDv360InsertionOrderName Session DV360 Имя заказа заказа

  • sessionDv360LineItemId Session DV360 ID позиции

  • sessionDv360LineItemName Session DV360

  • sessionDv360Medium Session DV360 Среда

  • sessionDv360PartnerId Session DV360 ID партнера

  • sessionDv360PartnerName Session DV360 Имя партнера

  • sessionDv360Source Session DV360 Source

  • sessionDv360SourceMedium Session DV360 Source / Medium

Google Search Ads 360 (SA360) Размеры интеграции:

  • firstUserSa360AdGroupId Первый пользователь SA360 идентификатор группы объявлений

  • firstUserSa360AdGroupName Первый пользователь SA360 AD Имя группы

  • firstUserSa360CampaignId First User Id Campaign

  • firstUserSa360CampaignName Первый пользователь SA360 Кампания

  • firstUserSa360CreativeFormat Первый пользователь SA360 Creative Format

  • firstUserSa360EngineAccountId First User SA360 идентификатор учетной записи двигателя

  • firstUserSa360EngineAccountName первого пользователя SA360 Имя учетной записи двигателя

  • firstUserSa360EngineAccountType первого пользователя SA360

  • firstUserSa360KeywordText Первый пользователь SA360 Текст ключевого слова

  • firstUserSa360ManagerAccountId Первый пользователь SA360 идентификатор учетной записи менеджера

  • firstUserSa360ManagerAccountName Первый пользователь SA360 Manager Имя учетной записи

  • firstUserSa360Medium Первый пользователь SA360 Medium

  • firstUserSa360Query Первый пользователь SA360 запрос

  • firstUserSa360Source First User SARESE SA360

  • firstUserSa360SourceMedium Первый пользователь SA360 Source / Medium

  • sa360AdGroupId SA360 AD Group ID

  • sa360CampaignId SA360 ID кампании

  • sa360AdGroupName SA360 AD Group Название

  • sa360CampaignName SA360 Кампания

  • sa360CreativeFormat SA360 Творческий формат

  • sa360EngineAccountId SA360 идентификатор аккаунта двигателя

  • sa360EngineAccountName SA360 Имя учетной записи двигателя

  • sa360EngineAccountType SA360 Тип учетной записи двигателя

  • sa360KeywordText SA360 Текст ключевого слова

  • sa360ManagerAccountId SA360 Manager Id Account

  • sa360ManagerAccountName SA360 Имя учетной записи менеджера

  • sa360Medium SA360 среда

  • sa360Query SA360 Запрос

  • sa360Source SA360 Источник

  • sa360SourceMedium SA360 Source / Medium

  • sessionSa360AdGroupId SESSION SA360 AD GROUP ID

  • sessionSa360CampaignId Session Search ID кампании

  • sessionSa360ManagerAccountId Session Seship

  • sessionSa360ManagerAccountName Session SA360 Имя учетной записи менеджера

  • sessionSa360SourceMedium SESSION SA360 Source / Medium

2024-03-06 Неактивная пользовательская аудитория поддерживает экспорт аудитории.

Экспорт аудитории лучше поддерживает экспорт неактивной пользовательской аудитории. Пользователи вводят эту аудиторию без квалификационного события; Например, пользователь может ввести аудиторию, не посещая ваш сайт в течение семи дней. Примеры неактивной пользовательской аудитории включают «7-дневные неактивные покупатели», «7-дневные неактивные пользователи» и «7-дневные незамеченные пользователи». Чтобы узнать больше об этой предложенной аудитории, см. Предлагаемую аудиторию .

2024-02-28 Экспорт аудитории возвращает идентификатор пользователя, указанный при теги.

Экспорт аудитории теперь возвращает идентификатор пользователя, указанный при теге, даже если предоставленные пользователем данные включены для вашего свойства. Если предоставленная пользователя сбор данных включен, предоставленные пользователем данные вместе с пользователем идентификацией могут быть отправлены в Google Analytics при тегике для улучшения измерения. Чтобы узнать больше, см. Пользовательский сбор данных .

2024-01-30 Уведомления Webhook. Поддержка списков аудитории, повторяющиеся списки аудитории в API Data V1 Alpha.

AudienceList.webhookNotification и RecurringAudienceList.webhookNotification Поля могут быть указаны при создании списка аудитории (с использованием свойств. Audiencelists.create ) или повторяющегося списка аудитории (с использованием properties.recurringaudiencelists.create ).

Эта функциональность позволяет вам асинхронно получать уведомления WebHook, когда список аудитории становится доступным.

2024-01-18 Улучшенная совместимость для размеров, которые включают в себя строку запроса или минутный компонент.

Размеры, которые включают строку запроса, теперь совместимы с большинством полей. Такие размеры, как pagePathPlusQueryString , unifiedPageScreen , pageLocation и fullPageUrl в настоящее время совместимы со многими дополнительными областями, включая sessionSource , browser , city и landingPage .

Размеры, которые включают в себя минутный компонент, теперь совместимы с большинством полей. Размеры, такие как minute , nthMinute и dateHourMinute , теперь совместимы с аналогичным набором дополнительных полей.

См. Измерения GA4 и исследователь метрик для комплексной информации о совместимости.

2023-12-13 Пользовательские параметры обзорного элемента

Пользовательские пользовательские размеры теперь могут быть включены в аналитические запросы API данных с использованием следующего синтаксиса:

Общее имя API Описание
CustomItem: parameter_name Пользовательский измерение на предмет PARATEREMER_NAME

См. Размеры и метрики API для получения дополнительной информации.

2023-12-05 Списки аудитории доступны в бета-версии API V1 в качестве экспорта аудитории

Функция списков аудитории была переименована в экспорт аудитории и добавлена ​​в бета -версию Data V1.

Добавлены следующие методы в бета -версию API V1:

2023-11-28 добавил samplingMetadatas для сообщений о ответе

Добавлено samplingMetadatas в ResponseMetaData . Эта коллекция будет содержать SampleMetadata для каждого диапазона дат в запросе, для которого были отобраны результаты. Google Analytics будет применять выборку только в том случае, если она ожидает, что ограничения кардинальности снижают качество данных.

2023-11-28 Добавлены повторяющиеся функции экспорта списка аудитории в API V1 Data V1

Добавлены properties.recurringAudienceLists.create , properties.recurringAudienceLists.create , properties.recurringAudienceLists.list Методы данных API v1 alpha.

Эта функциональность позволяет вам ежедневно производить списки аудитории по мере изменения членства в аудитории. Повторяющиеся списки аудитории гарантируют, что вы работаете с самыми свежими результатами членства в аудитории.

2023-11-08 Добавлен экспорт списка аудитории в функциональность листов в API V1 API V1

Добавлены метод properties.audienceLists.exportSheet в API Data V1 Alpha, который позволяет вам экспортировать список аудитории в Google Sheets.

2023-10-13 Добавлена ​​поддержка аудитории с продолжительностью членства в 1 день

Аудитория с продолжительностью членства в течение 1 дня теперь поддерживается списками аудитории, функциональными экспортами .

2023-09-12 Правила заказа по умолчанию по умолчанию

По умолчанию отчеты, созданные с использованием аудитории, перечисляют функциональность экспорта, следуют тем же правилам упорядочения, что и другие методы отчетности API данных: упорядочение будет спускаться по первым столбцам, а затем спускается по вторым столбцам и т. Д.

Перед этим изменением вы могли бы получить следующий отчет:

идентификатор устройства IsadspersonalizationAllowed
АВС истинный
ЦАП ЛОЖЬ
АВС ЛОЖЬ
ААА истинный

После этого изменения вы получите следующий отчет:

идентификатор устройства IsadspersonalizationAllowed
ААА истинный
АВС ЛОЖЬ
АВС истинный
ЦАП ЛОЖЬ

2023-08-15 Добавлены измерение isLimitedAdTracking в список экспорта списка аудитории

  • isLimitedAdTracking ограниченная настройка отслеживания объявлений устройства. Возможные значения включают в себя: true , false и (not set) .

    Чтобы узнать больше, увидеть измерения списка аудитории .

2023-08-15 Добавленное измерение currencyCode , метрика itemDiscountAmount

  • currencyCode локальный код валюты (на основе стандарта ISO 4217) события электронной коммерции. Например, «USD» или «GBP».

  • itemDiscountAmount Монетарная стоимость скидок на элементы в событиях электронной коммерции. Этот показатель заполняется в помечении параметром элемента «скидка».

Чтобы узнать больше, см. Схему отчетности API данных .

2023-08-10 Добавлены измерение isAdsPersonalizationAllowed в список экспорта списка аудитории

  • isAdsPersonalizationAllowed - это персонализация рекламы. Если пользователь имеет право на рекламу персонализации isAdsPersonalizationAllowed возвращает true . Если пользователь не имеет права на персонализацию рекламы, isAdsPersonalizationAllowed возвращает false .

    Чтобы узнать больше, увидеть измерения списка аудитории .

2023-07-10 Списки аудитории

Аудитория перечисляет поддержку, добавленную в API Data V1 Alpha. Списки аудитории включают в себя снимок пользователей в аудитории во время создания списка аудитории.

Следующие методы, добавленные в API Data V1 Alpha:

2023-05-19 пользовательских групп каналов

Пользовательские группы каналов поддерживают добавленные в API данных.

2023-05-11 изменений квоты токенов.

Система квот API данных была обновлена, чтобы обеспечить более точные заряды.

Количество токенов, взимаемых за каждый запрос, было обновлено в соответствии с изменением квоты и перебалансировано таким образом, чтобы обеспечить большее количество простых запросов отчетности, в то же время взимая значительно больше токенов квот для больших отчетов о дате.

После этого изменения, в то время как плата за некоторые запросы останется прежним, будет заметное увеличение сборов за более сложные запросы. Например, запросы на более 6 месяцев данных могут взимать 1000 или более жетонов квот.

Стандартные свойства

Название квоты Старый предел Новый лимит
Ядры токены на недвижимость в день 25 000 200 000
Серженные жетоны на недвижимость в час 5000 40 000
Основные токены на проект на недвижимость в час 1750 14 000
Токены в реальном времени на недвижимость в день 25 000 200 000
Токены в реальном времени за недвижимость в час 5000 40 000
Токены в реальном времени на проект за недвижимость в час 1750 14 000
Токены воронки на недвижимость в день 25 000 200 000
Токены воронки за недвижимость в час 5000 40 000
Тордные токены на проект на недвижимость в час 1750 14 000

Analytics 360 Properties

Название квоты Старый предел Новый лимит
Ядры токены на недвижимость в день 250 000 2 000 000
Серженные жетоны на недвижимость в час 50 000 400 000
Основные токены на проект на недвижимость в час 17 500 140 000
Токены в реальном времени на недвижимость в день 250 000 2 000 000
Токены в реальном времени за недвижимость в час 50 000 400 000
Токены в реальном времени на проект за недвижимость в час 17 500 140 000
Токены воронки на недвижимость в день 250 000 2 000 000
Токены воронки за недвижимость в час 50 000 400 000
Тордные токены на проект на недвижимость в час 17 500 140 000

2023-03-02 Добавленные размеры даты.

  • dayOfWeekName День недели имя. День недели на английском языке. Это измерение имеет ценности Sunday , Monday и т. Д.

  • isoWeek ISO Неделя года. Недельный номер ISO, где каждую неделю начинается в понедельник. Подробнее см. Https://en.wikipedia.org/wiki/iso_week_date . Примеры значений включают 01 , 02 и 53 .

  • isoYear ISO год. ISO год мероприятия. Подробнее см. Https://en.wikipedia.org/wiki/iso_week_date . Пример значения включают 2022 и 2023 .

  • isoYearIsoWeek ISO Неделя ISO Year. Объединенные значения isoWeek и isoYear . Пример значения включают 201652 и 201701 .

  • yearMonth год месяц. Объединенные значения year и month . Пример значения включают 202212 или 202301 .

  • yearWeek год недели. Объединенные ценности year и week . Пример значения включают 202253 или 202301 .

2023-02-27 Добавлены размеры электронной коммерции.

  • itemListPosition ITEM СПИСОК ПОЛОЖЕНИЕ. Положение элемента (например, продукта, который вы продаете) в списке. Это измерение заполняется в помечении параметром «индекс» в массиве элементов.

  • itemLocationID It ID местоположения. Физическое местоположение, связанное с предметом (например, местоположение физического магазина). Рекомендуется использовать идентификатор Google Place , который соответствует соответствующему элементу. Также можно использовать пользовательский идентификатор местоположения. Это поле заполняется в помечении параметром «location_id» в массиве элементов.

  • itemPromotionCreativeSlot lete Promotion Creative Plot. Название рекламного творческого слота, связанного с предметом. Это измерение может быть указано при теге с помощью параметра creative_slot на уровне событий или элемента. Если параметр указан как на уровне событий, так и на уровне элемента, используется параметр уровня элемента.

2023-02-21 Добавлена ​​«Целевая страница + строка запроса».

  • landingPagePlusQueryString Целевая страница + строка запроса. Строка PARE + PARE + запрос, связанный с первым просмотром страниц в сеансе.

Это поле заменяет измерение landingPage , которое устарело и будет обновлено, чтобы не возвращать строку запроса 14 мая 2023 года.

2023-01-28 Добавлены «представления на пользователя», «Прокрученные пользователи».

  • screenPageViewsPerUser Views на одного пользователя. Количество экранов приложений или веб -страниц, которые ваши пользователи просмотрели на активного пользователя. Подсчитаны повторные представления одной страницы или экрана. (screen_view + page_view events) / active users .

  • scrolledUsers прокручивали пользователей. Количество уникальных пользователей, которые прокрутили не менее 90% страницы.

2023-01-23 Добавлены «Континент», «Идентификатор континента».

  • Континент continent . Континент, с которого возникла активность пользователя. Например, Americas или Asia .

  • Континент идентификатор continentId . Географический идентификатор континента, с которого возникла активность пользователя, получен из их IP -адреса.

2023-01-23 Добавлены измерение «Идентификатор фильтра данных».

  • testDataFilterId Test Data Id. Целый идентификатор фильтра данных в состоянии тестирования. Вы используете фильтры данных для включения или исключения данных о событиях из ваших отчетов на основе значений параметра событий. Чтобы узнать больше, см. Https://support.google.com/analytics/answer/10108813 .

2022-10-18 Добавлены метрики рекламы.

  • advertiserAdClicks Ads Clicks. Общее количество раз, когда пользователи нажимали на рекламу, чтобы достичь свойства.
  • advertiserAdCost стоимость рекламы. Общая сумма, которую вы заплатили за свои объявления.
  • advertiserAdCostPerClick Ads стоимость за клик. Стоимость рекламы за клик - это стоимость рекламы, разделенная на рекламные клики, и часто является сокращенным CPC.
  • advertiserAdCostPerConversion Стоимость конвертации. Стоимость за конверсию - это стоимость рекламы, разделенная на конверсии.
  • advertiserAdImpressions впечатления от рекламы. Общее количество впечатлений.
  • returnOnAdSpend return на рекламу. Возврат на рекламу (ROAS) - это общий доход, разделенный на рекламные расходы.

2022-10-17 Добавлены метрики с обширным элементом.

  • itemsAddedToCart элементы добавлены в корзину. Количество единиц, добавленных в корзину для одного предмета.
  • itemsCheckedOut предметы проверены. Количество подразделений проверяется на один элемент.
  • itemsClickedInList Items, нажимающие в списке. Количество единиц, щелкнувших в списке для одного элемента.
  • itemsClickedInPromotion Itsement нажали на продвижение по службе. Количество единиц, нажавших на акцию для одного элемента.
  • itemsViewed элементы. Количество единиц, просмотренных для одного элемента.
  • itemsViewedInList Элементы, просмотренные в списке. Количество единиц, просмотренных в списке для одного элемента.
  • itemsViewedInPromotion пункты, просмотренные в продвижении. Количество единиц, просмотренных в продвижении по службе для одного элемента.

2022-09-13 Объявление о совместимости схемы.

1 декабря 2022 года произойдут следующие нарушительные изменения:

  1. Размеры, такие как элементы, такие как itemName становятся несовместимыми с такими показателями, как eventCount . Размеры с общепринятыми элементами по-прежнему будут совместимы с метриками, такими как itemRevenue , пользовательские метрики, такие как activeUsers , и метрики на основе сеансов, такие как sessions .

  2. Размеры атрибуции, такие как source становятся несовместимыми с некоторыми показателями, такими как eventCount . Размеры атрибуции по-прежнему будут совместимы с атрибутируемыми метриками, такими как conversions , пользовательские метрики, такие как activeUsers , и метрики на основе сеансов, такие как sessions .

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

Чтобы узнать больше, см. Подробное объяснение изменений совместимости .

2022-09-01 Изменения квоты.

  • Requests per day , Requests Per Minute , Requests Per Minute Per User удаляются из API данных.

  • Tokens Per Project Per Property Per Hour квота была добавлена ​​в API.

  • Каждый запрос потребляет квоту как для Tokens Per Property Per Hour так и Tokens Per Project Per Property Per Hour .

    Смотрите документацию квотов для подробной информации о новых квотах.

2022-08-03 Добавлены сессионные размеры SA360.

  • sessionSa360AdGroupName SESSION SA360 AD GROUP Имя. Название группы рекламной группы от поискового объявления 360, которое привело к этому сеансу.

  • sessionSa360CampaignName SESSION SESCOLE SA360. Название кампании от поискового объявления 360, которое привело к этой сессии.

  • sessionSa360CreativeFormat SESSION SA360 Творческий формат. Тип креативного в поисковой рекламе 360, который привел к этой сессии. Например, «Адаптивное поисковое объявление» или «расширенное текстовое объявление».

  • sessionSa360EngineAccountId SESSION SA360 Идентификатор аккаунта двигателя. Идентификатор учетной записи двигателя в SA360, который привел к этому сеансу.

  • sessionSa360EngineAccountName SESSION SA360 Имя аккаунта двигателя. Название учетной записи двигателя в SA360, которое привело к этой сессии.

  • sessionSa360EngineAccountType SESSION SA360 Тип учетной записи двигателя. Тип учетной записи двигателя в поисковой рекламе 360, который привел к этому сеансу. Например, «Google Ads», «Bing» или «Baidu».

  • sessionSa360Keyword Session SA360 Текст ключевого слова. Ключевое слово поисковой системы из поискового объявления 360, которое привело к этому сеансу.

  • sessionSa360Medium SESSION SA360 Среда. Ключевое слово поисковой системы из поискового объявления 360, которое привело к этому сеансу. Например, «CPC».

  • sessionSa360Query SESSION SA360 Запрос. Поисковый запрос от поисковой рекламы 360, который привел к этому сеансу.

  • sessionSa360Source SESSION SA360 Source. Источник трафика из поисковой рекламы 360, который привел к этому сеансу. Например, «example.com» или «Google».

  • sessionCampaignId , sessionCampaignName Dimensions теперь поддерживают поисковые рекламные объявления 360.

2022-07-11 Добавлены показатели конверсии.

Коэффициент конверсии

  • sessionConversionRate Процент сеансов, в которых было вызвано любое событие конверсии.

  • userConversionRate процент пользователей, которые вызвали любое событие конверсии.

Метрики коэффициента конверсии для одного преобразования

  • sessionConversionRate:event_name процент сеансов, в которых было запускается конкретное событие конверсии.

  • userConversionRate:event_name Процент пользователей, которые вызвали конкретное событие конверсии.

2022-05-05 Добавлено функциональность отчетности воронки к альфа-каналу.

  • Метод runFunnelReport Добавлена ​​в версию API V1Alpha , которая возвращает индивидуальный отчет о воронке ваших данных о событиях Google Analytics.

  • Этот метод вводится на альфа -стабильности с намерением сбора обратной связи по синтаксису и возможностям перед входом в бета -версию. Пожалуйста, заполните отчеты о отчете Google Analytics Data Fendel, чтобы дать обратную связь по этому API.

2022-02-16 добавлены новые размеры.

Ручной термин и контент

  • firstUserManualAdContent Первый пользовательский Руководство Руководство пользователя. Содержание рекламы, которое впервые приобрело пользователя. Заполняется параметром utm_content .

  • firstUserManualTerm Первый пользовательский термин. Термин, который впервые приобрел пользователя. Заполняется параметром utm_term .

  • manualAdContent Manual Ad Content. Содержание рекламы, приписываемое событию конверсии. Заполняется параметром utm_content .

  • manualTerm срок срока. Термин, приписанный конверсии. Заполняется параметром utm_term .

  • sessionManualAdContent Session Manual Ad Content. Содержание рекламы, которое привело к сеансу. Заполняется параметром utm_content .

  • sessionManualTerm РУКОВОДСТВО РУКОВОДСТВО СЕССИЯ. Термин, который привел к сеансу. Заполняется параметром utm_term .

Анализ аварии

  • Пользователи, пострадавшие от crashAffectedUsers . Количество пользователей, которые вошли в сбой в этой строке отчета.

  • crashFreeUsersRate Без сбоев пользователей.

Приложение/Интернет

  • averageSessionDuration средней продолжительности (в секундах) сеансов пользователей.

  • newVsReturning новых / возвращающихся пользователей.

  • screenPageViewsPerSession за сеанс.

  • landingPage страница. Строка PARE + PARE + запрос, связанный с первым просмотром страниц в сеансе.

  • platformDeviceCategory Платформа и тип устройства, на котором работал ваш сайт или мобильное приложение.

Мобильное приложение

  • averagePurchaseRevenuePerUser Средний доход за покупку на пользователя.

  • firstTimePurchaserConversionRate процент активных пользователей, которые совершили свою первую покупку.

  • firstTimePurchasersPerNewUser Среднее количество покупателей первого времени на нового пользователя.

  • dauPerMau Дау / Мау. Процент проката 30-дневных активных пользователей, которые также являются активными пользователями 1-дневного.

  • dauPerWau Дау / Вау. Процент проката 7-дневных активных пользователей, которые также являются активными пользователями 1-дневного.

  • wauPerMau Wau / Mau. Процент проката 30-дневных активных пользователей, которые также являются 7-дневными активными пользователями.

  • purchaserConversionRate процент активных пользователей, которые совершили 1 или более транзакций за покупку.

  • transactionsPerPurchaser Transactions на каждого покупателя.

Кампания Google Рекламы

  • firstUserGoogleAdsCampaignType Тип кампании кампании Google Ads, которая впервые приобрела пользователя.

  • googleAdsCampaignType Тип кампании для кампании Google Ads, приписываемой конверсии.

  • sessionGoogleAdsCampaignType Тип кампании для кампании Google Ads, которая привела к этой сессии.

2021-09-07 Добавлены новые измерения даты/времени.

  • dateHourMinute Комбинированные значения даты, часа и минуты отформатированы как yyyymmddhhmm.

  • minute двухзначная минута часа, когда событие было зарегистрировано.

  • nthMinute количества минут с момента начала диапазона дат.

2021-09-07 Добавлены новые размеры, населенные параметрами события.

  • achievementId идентификатор достижения в игре для события.

  • character персонаж игрока в игре для события.

  • fileExtension расширение загруженного файла.

  • fileName Путь страницы загруженного файла.

  • groupId Идентификатор группы игроков в игре для мероприятия.

  • linkClasses атрибут класса HTML для исходящей ссылки.

  • linkDomain домена назначения исходящей ссылки.

  • linkId Атрибут HTML ID для исходящей ссылки или загрузки файла.

  • linkText Текст ссылки загрузки файла.

  • linkUrl Полный URL для исходящей ссылки или загрузки файла.

  • method метод, с помощью которого было вызвано событие.

  • outbound возвращает «Истина», если ссылка ведет к сайту, не является частью домена свойства.

  • pageLocation Протокол, имя хоста, путь страницы и строка запроса для посещения веб -страниц.

  • pageReferrer Полный ссылочный URL, включая имя хоста и путь.

  • percentScrolled процент вниз по странице, которую пользователь прокрутил (например, «90»).

  • searchTerm Термин, который искал пользователь.

  • videoProvider Источник видео (например, «YouTube»).

  • videoTitle название видео.

  • videoUrl URL видео.

  • visible возвращает «истин», если контент видим.

  • unifiedPagePathScreen The page path (web) or screen class (app) on which the event was logged.

2021-09-07 API schema changes.

Changes in existing dimensions:

  • unifiedPageScreen For web generated events, this dimension now returns the page path and query string on which the event was logged.

Upcoming changes announcement:

  • firstUserTrafficOrigin The traffic origin that first acquired the user. Please do not depend on this field returning 'Manual' for traffic that uses UTMs; this field will update from returning 'Manual' to returning '(not set)' for an upcoming feature launch.

  • sessionTrafficOrigin The traffic origin of the session's campaign. Please do not depend on this field returning 'Manual' for traffic that uses UTMs; this field will update from returning 'Manual' to returning '(not set)' for an upcoming feature launch.

  • trafficOrigin The traffic origin of the conversion event's campaign. Please do not depend on this field returning 'Manual' for traffic that uses UTMs; this field will update from returning 'Manual' to returning '(not set)' for an upcoming feature launch.

2021-09-07 checkCompatibility method added to the API.

checkCompatibility method lists dimensions and metrics that can be added to a report request and maintain compatibility.

2021-07-21 Realtime reporting changes.

It is now possible to specify the minute ranges of event data to read using the minuteRanges parameter of the runRealtimeReport method.

2021-07-21 New channel grouping dimensions.

New channel grouping dimensions added to the Data API reporting schema :

  • firstUserDefaultChannelGrouping First user default channel grouping.

  • defaultChannelGrouping Default channel grouping.

2021-06-10 API schema changes.

  • minutesAgo dimension added to the Data API realtime schema and can be used in queries to the runRealtimeReport method. This dimension contains the number of minutes ago that an event was collected. 00 is the current minute, and 01 means the previous minute.

  • googleAdsCreativeId dimension added to the Data API schema. This dimension contains the ID of the Google Ads creative attributed to the conversion event.

  • sessionGoogleAdsCreativeId dimension added to the Data API schema. This dimension contains the ID of the Google Ads creative that lead to a session on your website or app.

  • firstUserCreativeId dimension renamed to firstUserGoogleAdsCreativeId in the Data API schema. This dimension contains the ID of the Google Ads creative that first acquired the user.

2021-04-09 The Google Analytics Data API v1 beta has been released.

  • The API endpoint updated to https://analyticsdata.googleapis.com/v1beta .

  • runReport , runPivotReport , batchRunReports , batchRunPivotReports methods now accept the id of a Google Analytics 4 property in the property parameter of the URL path instead of the entity field of a request body:

    POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports

  • API client libraries have been updated to use the new API endpoint.

2021-02-19 Pagination changes.

  • The default report response size increased from 10 to 10,000 rows of event data.

  • "limit" : -1 value that was used to indicate an attempt to retrieve all rows is no longer supported in RunReportRequest .

  • The maximum value of the limit field is set to 100000 . Use pagination to retrieve reports containing more than 100,000 rows.

2021-02-08 New e-commerce dimensions and metrics.

New e-commerce dimensions and metrics have been added to the API schema :

Dimensions: adFormat , adSourceName , adUnitName , itemBrand , itemCategory , itemCategory2 , itemCategory3 , itemCategory4 , itemCategory5 itemId , itemListId , itemListName , itemName , itemPromotionCreativeName , itemPromotionId , itemPromotionName , orderCoupon , transactionId .

Metrics: adUnitExposure , addToCarts , cartToViewRate , checkouts , ecommercePurchases , firstTimePurchasers , itemListClickThroughRate , itemListClicks , itemListViews , itemPromotionClickThroughRate , itemPromotionClicks , itemPromotionViews , itemPurchaseQuantity , itemRevenue , itemViews , publisherAdClicks , publisherAdImpressions , totalPurchasers .

2021-02-08 Added new campaign dimensions.

New campaign dimensions have been added to the API schema : campaignId , campaignName , googleAdsAccountName , googleAdsAdGroupId , googleAdsAdGroupName , googleAdsAdNetworkType , source , trafficOrigin

2021-02-08 dayOfWeek , week dimension changes.

  • The value of dayOfWeek dimension now starts with 0 instead of 1.

  • The value of week dimension now starts with 01 and returns a two-digit number from 01 to 53. Each week starts on Sunday. January 1st is always in week 01.

2021-01-28 Added aggregation variants for custom metrics.

Each custom metric that a property registers creates three API metric variants : a sum, an average, and a count.

2021-01-28 Added new Date/time dimensions.

The following new dimensions have been added to the API schema : hour , nthHour , nthYear , dateHour .

2021-01-28 The Data API reduced the quota tokens charged per query.

The Data API reduced the quota tokens charged per query. The quota limits for property quota tokens per hour and per day were not changed.

2020-11-09 The method getUniversalMetadata has been deleted.

The method getUniversalMetadata has been deleted. Please use getMetadata . The one year maximum date range per API request has been removed.

2020-11-02 Added a Realtime Reporting Method.

See the Creating a Realtime Report for examples and runRealtimeReport for the REST reference documentation.

2020-10-19 Client library artifacts updated.

Client library artifacts updated along with usage instructions and code samples.

2020-10-13 App + Web properties have been renamed to Google Analytics 4 (GA4).

2020-10-08 getMetadata method added to the API.

getMetadata method returns Custom dimensions and metrics available for the specified GA4 property ID, as well as Universal metadata.

2020-10-08 Custom dimensions and metrics are available in reports.

See the API schema documentation for documentation on custom dimensions and metrics. This update includes Event-scoped Custom Dimensions and metrics as well as User-scoped Custom Dimensions.