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

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

20.10.2024 Добавлен тип фильтра измерения EmptyFilter

Используя фильтр измерения EmptyFilter , вы можете создать условия фильтрации для сравнения с пустым значением.

15 октября 2024 г. в метод reportTasks добавлена ​​функция уровня выборки.

Используя поле sampleLevel метода Properties.runReportTask , вы можете контролировать уровень выборки отчета.

Эта функция предоставляет ресурсам Google Analytics 360 доступ к более высоким ограничениям выборки — 1 миллиарду событий. Кроме того, для ограничений выборки можно установить значение UNSAMPLED для несемплированных результатов с большим количеством событий.

18 сентября 2024 г. Добавлена ​​функция моментального снимка квот собственности.

Используя метод Properties.getPropertyQuotasSnapshot , вы можете получить текущий снимок всех квот свойств, организованных по категориям квот для данного свойства.

28 июня 2024 г. Добавлена ​​квота «Ошибки клиента на проект и ресурс».

Теперь для каждого проекта и каждого ресурса в течение 15 минут разрешено ограничение в 10 000 ошибок сервера API. Сюда входят все запросы, приводящие к ответу с любым кодом, кроме 500 или 200 . Примеры ошибок, подпадающих под эту квоту: использование несовместимых комбинаций параметров и показателей, все ошибки аутентификации.

Если этот предел превышен, дальнейшие вызовы API к этому свойству будут временно заблокированы для связанного проекта Google Cloud до истечения 15-минутного периода.

14 мая 2024 г. Добавлена ​​функция сравнения.

Используя Сравнения , вы можете параллельно оценивать подмножества ваших данных.

Основные методы отчетности Data API v1beta обновлены для поддержки поля comparisons , которое, если оно включено, определяет запрошенную конфигурацию сравнений.

В запросе вы можете указать либо базовое сравнение, предоставив выражение dimensionFilter вместе с запросом, либо использовать сохраненное сравнение, указав имя ресурса сравнения в поле comparison .

Метод getMetadata обновляется и теперь отображает все сохраненные сравнения, доступные для свойства, в поле ответа comparisons .

Если в запросе указано хотя бы одно сравнение, ответ будет содержать столбец comparison идентифицирующий каждое сравнение.

В настоящее время сохраненные сравнения можно создавать только с помощью пользовательского интерфейса Google Analytics.

08 мая 2024 г. В Data API v1alpha добавлены задачи отчетов (функция асинхронных отчетов).

Используя задачи отчета, вы можете инициировать длительный асинхронный запрос для формирования настраиваемого отчета на основе данных событий Google Analytics.

В Data API v1alpha добавлены следующие методы управления задачами отчета:

06.05.2024 Новые измерения ключевых событий

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

Измените запросы отчетов, в которых используется измерение isConversionEvent , чтобы вместо него использовалось измерение isKeyEvent .

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

Устаревшая метрика Ключевой показатель событий
advertiserAdCostPerConversion advertiserAdCostPerKeyEvent
conversions keyEvents
firstTimePurchaserConversionRate firstTimePurchaserRate
purchaserConversionRate purchaserRate
sessionConversionRate sessionKeyEventRate
userConversionRate userKeyEventRate

Внесите аналогичные изменения в любое использование показателей ключевых событий для одного ключевого события в запросах отчетов.

Ответ на метод properties/getMetadata отражает введение ключевых измерений и показателей событий в объекты DimensionMetadata и MetricMetadata следующим образом:

  • apiName , uiName и description содержат имя API ключевого события, имя пользовательского интерфейса и описание.
  • Повторяющееся поле deprecatedApiNames содержит запись с устаревшим именем 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

6 марта 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 .

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

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

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

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

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

12.09.2023 Правила упорядочивания списка AudienceList по умолчанию

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

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

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

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

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

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

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

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

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
Токенов ядра на проект на недвижимость в час 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
Токенов ядра на проект на недвижимость в час 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 октября 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 Путь страницы (Web) или класс экрана (приложение), на котором было зарегистрировано событие.

2021-09-07 Схема API меняется.

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

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

Предстоящее объявление об изменениях:

  • firstUserTrafficOrigin Происхождение трафика, которое впервые приобрело пользователя. Пожалуйста, не зависят от этого поля, возвращающего «Руководство» для трафика, который использует UTMS; Это поле будет обновлять от возврата «Руководство» к возвращению '(не установлено)' для предстоящего запуска функции.

  • sessionTrafficOrigin Происхождение кампании сессии. Пожалуйста, не зависят от этого поля, возвращающего «Руководство» для трафика, который использует UTMS; Это поле будет обновлять от возврата «Руководство» к возвращению '(не установлено)' для предстоящего запуска функции.

  • trafficOrigin ПРОИЗВОДИТЕЛЬНОЕ ПРОИЗВОДСТВО ПРОИЗВОДСТВА ПРИМЕНЕНИЯ СОБЫТИЯ СОБЫТИЯ. Пожалуйста, не зависят от этого поля, возвращающего «Руководство» для трафика, который использует UTMS; Это поле будет обновлять от возврата «Руководство» к возвращению '(не установлено)' для предстоящего запуска функции.

2021-09-07 Метод checkCompatibility добавлен в API.

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

2021-07-21 Репортаж в реальном времени.

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

2021-07-21 Новые размеры группировки каналов.

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

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

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

2021-06-10 схемы API меняется.

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

  • googleAdsCreativeId измерение добавлено к схеме API данных. Это измерение содержит идентификатор Google Ads Creative, приписываемого событию конверсии.

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

  • firstUserCreativeId Dimension переименован в firstUserGoogleAdsCreativeId в схеме API данных. Это измерение содержит идентификатор Google Ads Creative, который впервые приобрел пользователя.

2021-04-09 Google Analytics Data API V1 Beta.

  • Конечная точка 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.

2021-02-19 изменений страниц.

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

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

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

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

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

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

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

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-10-20 Добавлен тип фильтра EmptyFilter Dimension

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

2024-10-15 Добавлена ​​функция уровня выборки к методу reportTasks

Используя поле Samplingelel метода Properties.RunreportTask , вы можете управлять уровнем отбора отбора.

Эта функция дает Google Analytics 360 доступ к более высоким пределам выборки в 1 миллиард событий. Кроме того, пределы выборки могут быть установлены на UNSAMPLED для большого количества несампликованных результатов.

2024-09-18 Добавлена ​​функция снимка квотов свойств

Используя метод Properties.getPropertyQuotassNapShot , вы можете получить текущий снимок всех квот о свойствах, организованных категорией квот для данного свойства.

2024-06-28 Добавлены «Клиентские ошибки на каждую проект на недвижимость».

В настоящее время существует предел 10 000 ошибок API-сервера, разрешенных по проекту, в соответствии с свойством, в течение 15-минутного окна. Это включает в себя все запросы, приводящие к ответу с любым кодом, отличным от 500 или 200 . Примеры ошибок, подпадающих под эту квоту: использование несовместимых измерений и комбинаций метрик, все ошибки аутентификации.

Если этот предел будет превышен, дальнейшие вызовы API к этому свойству будут временно заблокированы для соответствующего проекта Google Cloud до тех пор, пока 15-минутное окно не закончится.

2024-05-14 добавлена ​​функция сравнения

Используя сравнения , вы можете оценить подмножества ваших данных рядом.

Основные методы отчетности данных API V1Beta обновляются, чтобы поддержать поле comparisons , которое при включении указывает на конфигурацию запрошенных сравнений.

В запросе вы можете указать либо базовое сравнение, предоставив выражение dimensionFilter с запросом, или использовать сохраненное сравнение, предоставив имя ресурса сравнения в поле comparison .

Метод GetMetAdata обновляется для перечисления всех сохраненных сравнений, доступных для свойства в поле ответа comparisons .

Когда по крайней мере одно сравнение указано в запросе, ответ будет содержать столбец comparison идентифицирующий каждое сравнение.

В настоящее время сохраненные сравнения могут быть созданы только с помощью пользовательского интерфейса Google Analytics.

2024-05-08 Добавлены задачи отчетов, асинхронная функция отчетности, к API Data V1alpha.

Используя задачи отчетов, вы можете инициировать давний асинхронный запрос, чтобы сформировать настраиваемый отчет о ваших данных о событиях Google Analytics.

Следующие методы манипуляции с задачами были добавлены в API Data V1alpha:

2024-05-06 Новые размеры для ключевых событий

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

Измените запросы отчета, которые используют размер isConversionEvent для использования измерения isKeyEvent .

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

Устаревшая метрика Ключевой метрика события
advertiserAdCostPerConversion advertiserAdCostPerKeyEvent
conversions keyEvents
firstTimePurchaserConversionRate firstTimePurchaserRate
purchaserConversionRate purchaserRate
sessionConversionRate sessionKeyEventRate
userConversionRate userKeyEventRate

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

Ответ для метода properties/getMetadata отражает введение ключевых размеров событий и метрик в объектах DimensionMetadata и MetricMetadata следующим образом:

  • apiName , uiName и description содержат имя API события, имя пользовательского интерфейса и описание.
  • Повторное поле deprecatedApiNames имеет запись с устаревшим именем API конверсии.

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 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.recurringudiencelists.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 данных: упорядочение будет спускаться по первым столбцам, а затем спускается по вторым столбцам и т. Д.

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

DeviceId IsadspersonalizationAllowed
АВС истинный
Цем ЛОЖЬ
АВС ЛОЖЬ
ААА истинный

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

DeviceId 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 . Attribution dimensions will still be compatible with attributable metrics like conversions , user-based metrics like activeUsers , and session-based metrics like sessions .

  3. Dimensions that include the query string like pagePathPlusQueryString will only be compatible with a limited set of dimensions & metrics.

To learn more, see the detailed explanation of compatibility changes .

2022-09-01 Quota changes.

  • Requests per day , Requests Per Minute , Requests Per Minute Per User quotas are removed from the Data API.

  • Tokens Per Project Per Property Per Hour quota has been added to the API.

  • Each request consumes quota for both Tokens Per Property Per Hour and Tokens Per Project Per Property Per Hour .

    See the Quotas documentation for the detailed information on new quotas.

2022-08-03 Added session scoped SA360 dimensions.

  • sessionSa360AdGroupName Session SA360 ad group name. The Ad Group name from Search Ads 360 that led to this session.

  • sessionSa360CampaignName Session SA360 campaign. The Campaign name from Search Ads 360 that led to this session.

  • sessionSa360CreativeFormat Session SA360 creative format. The type of creative in Search Ads 360 that led to this session. For example, 'Responsive search ad' or 'Expanded text ad'.

  • sessionSa360EngineAccountId Session SA360 engine account ID. The ID of the engine account in SA360 that led to this session.

  • sessionSa360EngineAccountName Session SA360 engine account name. The name of the engine account in SA360 that led to this session.

  • sessionSa360EngineAccountType Session SA360 engine account type. The type of the engine account in Search Ads 360 that led to this session. For example, 'google ads', 'bing', or 'baidu'.

  • sessionSa360Keyword Session SA360 keyword text. The search engine keyword from Search Ads 360 that led to this session.

  • sessionSa360Medium Session SA360 medium. The search engine keyword from Search Ads 360 that led to this session. For example, 'cpc'.

  • sessionSa360Query Session SA360 query. The search query from Search Ads 360 that led to this session.

  • sessionSa360Source Session SA360 source. The source of the traffic from Search Ads 360 that led to this session. For example, 'example.com' or 'google'.

  • sessionCampaignId , sessionCampaignName dimensions now support Search Ads 360 campaigns.

2022-07-11 Added conversion rate metrics.

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

  • sessionConversionRate The percentage of sessions in which any conversion event was triggered.

  • userConversionRate The percentage of users who triggered any conversion event.

Conversion Rate Metrics For One Conversion

  • sessionConversionRate:event_name The percentage of sessions in which a specific conversion event was triggered.

  • userConversionRate:event_name The percentage of users who triggered a specific conversion event.

2022-05-05 Added Funnel reporting functionality to the Alpha channel.

  • runFunnelReport method added to the v1alpha version of the API, which returns a customized funnel report of your Google Analytics event data.

  • This method is introduced at alpha stability with the intention of gathering feedback on syntax and capabilities before entering beta. Please complete the Google Analytics Data API Funnel Reporting Feedback to give your feedback on this API.

2022-02-16 Added new dimensions.

Manual term & content

  • firstUserManualAdContent First user manual ad content. The ad content that first acquired the user. Populated by the utm_content parameter.

  • firstUserManualTerm First user manual term. The term that first acquired the user. Populated by the utm_term parameter.

  • manualAdContent Manual ad content. The ad content attributed to the conversion event. Populated by the utm_content parameter.

  • manualTerm Manual term. The term attributed to the conversion event. Populated by the utm_term parameter.

  • sessionManualAdContent Session manual ad content. The ad content that led to a session. Populated by the utm_content parameter.

  • sessionManualTerm Session manual term. The term that led to a session. Populated by the utm_term parameter.

Crash analysis

  • crashAffectedUsers Crash-affected users. The number of users that logged a crash in this row of the report.

  • crashFreeUsersRate Crash-free users rate.

App/Web

  • averageSessionDuration The average duration (in seconds) of users' sessions.

  • newVsReturning New / returning users.

  • screenPageViewsPerSession Views per session.

  • landingPage Landing page. The page path + query string associated with the first pageview in a session.

  • platformDeviceCategory The platform and type of device on which your website or mobile app ran.

Mobile App

  • averagePurchaseRevenuePerUser Average purchase revenue per user.

  • firstTimePurchaserConversionRate The percentage of active users who made their first purchase.

  • firstTimePurchasersPerNewUser The average number of first time purchasers per new user.

  • dauPerMau DAU / MAU. The rolling percent of 30-day active users who are also 1-day active users.

  • dauPerWau DAU / WAU. The rolling percent of 7-day active users who are also 1-day active users.

  • wauPerMau WAU / MAU. The rolling percent of 30-day active users who are also 7-day active users.

  • purchaserConversionRate The percentage of active users who made 1 or more purchase transactions.

  • transactionsPerPurchaser Transactions per purchaser.

Google Ads campaign

  • firstUserGoogleAdsCampaignType The campaign type of the Google Ads campaign that first acquired the user.

  • googleAdsCampaignType The campaign type for the Google Ads campaign attributed to the conversion event.

  • sessionGoogleAdsCampaignType The campaign type for the Google Ads campaign that led to this session.

2021-09-07 Added new Date/time dimensions.

  • dateHourMinute The combined values of date, hour, and minute formatted as YYYYMMDDHHMM.

  • minute The two-digit minute of the hour that the event was logged.

  • nthMinute The number of minutes since the start of the date range.

2021-09-07 Added new dimensions populated by event parameters.

  • achievementId The achievement ID in a game for an event.

  • character The player character in a game for an event.

  • fileExtension The extension of the downloaded file.

  • fileName The page path of the downloaded file.

  • groupId The player group ID in a game for an event.

  • linkClasses The HTML class attribute for an outbound link.

  • linkDomain The destination domain of the outbound link.

  • linkId The HTML id attribute for an outbound link or file download.

  • linkText The link text of the file download.

  • linkUrl The full url for an outbound link or file download.

  • method The method by which an event was triggered.

  • outbound Returns 'true' if the link leads to a site is not a part of the property's domain.

  • pageLocation The protocol, hostname, page path, and query string for web pages visited.

  • pageReferrer The full referring URL including the hostname and path.

  • percentScrolled The percentage down the page that the user has scrolled (for example, '90').

  • searchTerm The term searched by the user.

  • videoProvider The source of the video (for example, 'youtube').

  • videoTitle The title of the video.

  • videoUrl The url of the video.

  • visible Returns 'true' if the content is 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.