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

Чтобы получать официальные объявления об API Google Аналитики, подпишитесь на группу Google Analytics API Notify.

14 сентября 2026 г. Добавлена поддержка разговорных запросов в v1 alpha.

Добавлен метод properties.chat для взаимодействия с данными Google Аналитики с помощью запросов на естественном языке.

  • Тело запроса принимает запрос, необязательный идентификатор сеанса для продолжения предыдущего разговора и необязательный параметр returnPropertyQuota.
  • Ответ возвращает структурированные данные ответа чата в объектах ResponseBlock, идентификатор сеанса и сведения о квоте токенов свойств с помощью PropertyChatQuota, если они запрошены.
  • Область действия OAuth https://www.googleapis.com/auth/analytics.chatbot.read предоставляет доступ на чтение к методу properties.chat.

14.09.2026 В ответы отчетов добавлены причины усечения данных.

В ResponseMetaData в версиях 1 beta и 1 alpha добавлено поле dataTruncationReasons. Если данные в отчете усечены, это поле будет содержать список объектов DataTruncationReason, в которых указаны тип усечения, описательное сообщение и затронутые даты.

23.04.2026 Добавлена поддержка отчетов о конверсиях в альфа-версии 1.

Добавлена поддержка получения данных из отчета об эффективности конверсий с помощью метода runReport в Data API v1 alpha. Это позволяет получать те же данные о конверсиях, которые доступны в интерфейсе Google Аналитики в разделе Реклама > Эффективность конверсий.

  • В RunReportRequest добавлено поле ConversionSpec, которое позволяет фильтровать конверсии с помощью conversionActions (идентификаторов действий-конверсий) и выбирать AttributionModel (DATA_DRIVEN или LAST_CLICK).
  • В ResponseMetaData добавлено поле Section, позволяющее определить, получены ли данные в отчете из стандартных отчетов (SECTION_REPORT) или регистрации конверсий (SECTION_ADVERTISING).

Обновлен метод getMetadata в альфа-версии Data API v1, чтобы предоставлять информацию для отчетов о конверсиях:

  • В ответ добавлено поле conversions, которое возвращает список объектов ConversionMetadata, сопоставляющих идентификаторы действий-конверсий с отображаемыми названиями.
  • В DimensionMetadata и MetricMetadata добавлено поле sections, позволяющее определить, совместимо ли определенное поле со стандартными отчетами, регистрацией конверсий или с обоими типами отчетов.

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

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

15.10.2024 В метод reportTasks добавлена функция уровня выборки.

С помощью поля samplingLevel метода properties.runReportTask можно управлять уровнем выборки отчета.

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

18 сентября 2024 г. Добавлена функция "Сводка по квотам ресурса".

С помощью метода properties.getPropertyQuotasSnapshot можно получить текущую сводку по всем квотам ресурса, упорядоченным по категориям.

28 июня 2024 г. Добавлена квота "Ошибок клиента на один проект в одном ресурсе".

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

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

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

Функция Сравнения позволяет сопоставлять разные наборы данных,

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

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

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

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

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

08.05.2024. В Data API v1alpha добавлены задачи отчетов – функция асинхронных отчетов.

С помощью задач отчетов можно инициировать длительный асинхронный запрос, чтобы сформировать специальный отчет по данным о событиях Google Аналитики.

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

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.03.2024. Добавлены основная группа каналов, источник трафика, заданный вручную, и параметры, связанные с интеграцией.

В схему Data 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

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

  • 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 Дисплеем и Видео 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, связанный с первым взаимодействием пользователя

  • 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 Поисковой рекламой 360:

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

  • firstUserSa360AdGroupName Название группы объявлений Поиска 360, связанной с первым взаимодействием пользователя

  • firstUserSa360CampaignId Идентификатор кампании в Поиске 360, связанный с первым взаимодействием пользователя

  • firstUserSa360CampaignName Кампания Поиска 360, связанная с первым взаимодействием пользователя

  • firstUserSa360CreativeFormat Формат объявления Поиска 360, связанного с первым взаимодействием пользователя

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

  • firstUserSa360EngineAccountName Название системного аккаунта Поиска 360, связанного с первым взаимодействием пользователя

  • firstUserSa360EngineAccountType Тип системного аккаунта Поиска 360, связанного с первым взаимодействием пользователя

  • firstUserSa360KeywordText Текст ключевых слов Поиска 360, связанных с первым взаимодействием пользователя

  • firstUserSa360ManagerAccountId Идентификатор управляющего аккаунта Поиска 360, связанного с первым взаимодействием пользователя

  • firstUserSa360ManagerAccountName Название управляющего аккаунта Поиска 360, связанного с первым взаимодействием пользователя

  • firstUserSa360Medium Канал Поиска 360, связанный с первым взаимодействием пользователя

  • firstUserSa360Query Запрос Поиска 360, связанный с первым взаимодействием пользователя

  • firstUserSa360Source Источник Поиска 360, связанный с первым взаимодействием пользователя

  • firstUserSa360SourceMedium Источник или канал в Поиске 360, связанный с первым взаимодействием пользователя

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

  • sa360CampaignId Идентификатор кампании в Поиске 360

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

  • sa360CampaignName кампания в Поиске 360;

  • sa360CreativeFormat Формат объявления Поиска 360

  • sa360EngineAccountId Идентификатор аккаунта системы Поиска 360

  • sa360EngineAccountName Название системного аккаунта Поиска 360

  • sa360EngineAccountType Тип системного аккаунта Поиска 360

  • sa360KeywordText Текст ключевого слова в Поиске 360

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

  • sa360ManagerAccountName Название управляющего аккаунта Поиска 360

  • sa360Medium Канал Поиска 360

  • sa360Query Запрос Поиска 360

  • sa360Source Источник Поиска 360

  • sa360SourceMedium Источник/канал в Поиске 360

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

  • sessionSa360CampaignId Идентификатор кампании Поиска 360, связанной с сеансом

  • sessionSa360ManagerAccountId Идентификатор управляющего аккаунта Поиска 360, связанного с сеансом

  • sessionSa360ManagerAccountName Название управляющего аккаунта Поиска 360, связанного с сеансом

  • sessionSa360SourceMedium Источник или канал в Поиске 360, связанный с сеансом

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

Функция экспорта аудиторий теперь лучше поддерживает экспорт аудиторий неактивных пользователей. Пользователи попадают в такие аудитории без выполнения определенных действий. Например, пользователь может попасть в аудиторию, если он не посещал ваш сайт в течение семи дней. Примеры аудиторий неактивных пользователей: "Покупатели, неактивные в течение 7 дней", "Пользователи, неактивные в течение 7 дней" и "Пользователи, не получавшие уведомлений за последние 7 дней". Подробнее о рекомендуемых аудиториях…

28.02.2024. При экспорте аудиторий возвращается идентификатор пользователя, указанный в тегах.

Теперь при экспорте аудиторий возвращается идентификатор пользователя, указанный в тегах, даже если в ресурсе включен сбор данных, предоставленных пользователями. Если сбор данных, предоставленных пользователями, включен, эти данные вместе с User-ID можно отправлять в Google Аналитику с помощью тегов, чтобы улучшить отслеживание. Подробнее о сборе данных, предоставленных пользователями…

30.01.2024. В Data API v1 alpha добавлена поддержка уведомлений вебхуков для списков аудиторий и повторяющихся списков аудиторий.

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

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

18.01.2024. Улучшена совместимость параметров, включающих строку запроса или компонент минуты.

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

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

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

13.12.2023. Специальные параметры на уровне позиции

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

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

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

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

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

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

28.11.2023 В ответ на отчет добавлено поле samplingMetadatas.

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

28.11.2023. В Data API v1 alpha добавлена функция повторяющегося экспорта списков аудиторий.

В Data API v1 alpha добавлены методы properties.recurringAudienceLists.create, properties.recurringAudienceLists.create и properties.recurringAudienceLists.list.

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

13.10.2023 Добавлена поддержка аудиторий со сроком хранения данных в один день

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

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

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

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

deviceId isAdsPersonalizationAllowed
ABC true
DAC false
ABC false
AAA true

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

deviceId isAdsPersonalizationAllowed
AAA true
ABC false
ABC true
DAC false

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

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

    Подробнее см. Параметры списка аудитории.

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

  • currencyCode Код местной валюты (в соответствии со стандартом ISO 4217) события электронной торговли. Пример: USD или RUB.

  • itemDiscountAmount Денежная ценность скидок на товары в событиях электронной торговли. Заполняется с помощью параметра товара discount.

Подробнее о схеме отчетов Data API…

10.08.2023 В схему экспорта списка аудиторий добавлен параметр isAdsPersonalizationAllowed.

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

    Подробнее см. Параметры списка аудитории.

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

В Data API версии 1 (альфа) добавлена поддержка списков аудиторий. Списки аудиторий содержат сводные данные о пользователях аудитории на момент создания списка.

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

19 мая 2023 г. Собственные группы каналов

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

11 мая 2023 г. Изменения квоты на токены.

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

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

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

  • itemListPosition Позиция в списке товаров. Позиция товара (например, того, который вы продаете) в списке. Этот параметр заполняется при добавлении тегов с помощью параметра index в массиве items.

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

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

21.02.2023 Добавлен параметр "Целевая страница + строка запроса".

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

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

28.01.2023 Добавлены показатели "Просмотров на пользователя" и "Пользователи, прокрутившие страницу".

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

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

23.01.2023 Добавлены параметры "Континент" и "Идентификатор континента".

  • continent Континент. Континент, на котором были зарегистрированы действия пользователя. Примеры: Americas или Asia.

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

23.01.2023 Добавлен параметр "Идентификатор тестового фильтра данных".

  • testDataFilterId Идентификатор фильтра тестовых данных. Числовой идентификатор фильтра данных в режиме тестирования. С помощью фильтров данных можно включать в отчеты данные событий или исключать их на основе значений параметра события. Подробнее https://support.google.com/analytics/answer/10108813…

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

  • advertiserAdClicks кликов по объявлениям. Сколько всего раз пользователи нажали на объявление, чтобы обратиться к ресурсу.
  • advertiserAdCost Стоимость рекламы. Общая сумма расходов на объявления.
  • advertiserAdCostPerClick Цена за клик по объявлению. Цена за клик по объявлению – это стоимость рекламы, разделенная на количество кликов по объявлению. Часто используется сокращение "цена за клик".
  • 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 Изменения квот.

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

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

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

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

3 августа 2022 г. Добавлены параметры Поиска 360 на уровне сеанса.

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

  • sessionSa360CampaignName Кампания в Поиске 360, связанная с сеансом. Название кампании из Поисковой рекламы 360, которая привела к этому сеансу.

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

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

  • sessionSa360EngineAccountName Название системного аккаунта Поиска 360, связанного с сеансом. Название системного аккаунта в Поиске 360, который привел к этому сеансу.

  • sessionSa360EngineAccountType Тип системного аккаунта Поиска 360, связанного с сеансом. Тип системного аккаунта в Поисковой рекламе 360, который привел к этому сеансу. Например, "Google Реклама", "bing" или "baidu".

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

  • sessionSa360Medium Канал Поиска 360, связанный с сеансом. Ключевое слово из Поисковой рекламы 360, которое привело к сеансу. Пример: cpc.

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

  • sessionSa360Source Источник Поиска 360, связанный с сеансом. Источник трафика из Поисковой рекламы 360, который привел к этому сеансу. Например, "example.com" или "google".

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

11.07.2022 Добавлены показатели коэффициента конверсии.

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

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

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

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

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

  • userConversionRate:event_name Доля пользователей, которые запустили определенное событие-конверсию.

05.05.2022. В альфа-версию добавлена функция отчетов о воронках.

  • В версию v1alpha API добавлен метод runFunnelReport, который возвращает отчет о воронке с данными о событиях Google Аналитики, созданный на основе заданных вами параметров.

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

16.02.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 DAU / MAU. Процент активных пользователей за 30 дней, которые также являются активными пользователями за один день.

  • dauPerWau DAU / WAU. Процент активных пользователей за 7 дней, которые также являются активными пользователями за один день.

  • 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-атрибут class для исходящей ссылки.

  • linkDomain Целевой домен исходящей ссылки.

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

  • linkText Текст ссылки для скачивания файла.

  • linkUrl Полный URL для исходящей ссылки или скачивания файла.

  • method Способ, которым было активировано событие.

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

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

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

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

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

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

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

  • videoUrl URL видео.

  • visible Возвращает значение true, если контент виден.

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

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

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

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

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

  • firstUserTrafficOrigin Источник трафика, через который был впервые привлечен пользователь. Не рассчитывайте на то, что для трафика, в котором используются UTM-метки, в этом поле будет возвращаться значение Manual. В ближайшее время мы планируем запустить новую функцию, и в этом поле вместо Manual будет возвращаться значение (not set).

  • sessionTrafficOrigin Источник трафика кампании, связанной с сеансом. Не рассчитывайте на то, что для трафика, в котором используются UTM-метки, в этом поле будет возвращаться значение Manual. В ближайшее время мы планируем запустить новую функцию, после чего в этом поле вместо Manual будет возвращаться значение (not set).

  • trafficOrigin Источник трафика кампании события-конверсии. Не рассчитывайте на то, что для трафика, в котором используются UTM-метки, в этом поле будет возвращаться значение Manual. В ближайшее время мы планируем запустить новую функцию, и в этом поле вместо Manual будет возвращаться значение (not set).

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

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

21.07.2021. Изменения в отчетах в реальном времени.

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

21.07.2021. Новые параметры группы каналов.

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

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

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

10 июня 2021 г. Изменения в схеме API.

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

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

  • В схему Data API добавлен параметр sessionGoogleAdsCreativeId. Этот параметр содержит идентификатор креатива 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 Аналитики 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 строк, используйте разбивку на страницы.

08.02.2021. Новые параметры и показатели электронной торговли.

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

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

Показатели: adUnitExposure, addToCarts, cartToViewRate, checkouts, ecommercePurchases, firstTimePurchasers, itemListClickThroughRate, itemListClicks, itemListViews, itemPromotionClickThroughRate, itemPromotionClicks, itemPromotionViews, itemPurchaseQuantity, itemRevenue, itemViews, publisherAdClicks, publisherAdImpressions, totalPurchasers.

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

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

08.02.2021 dayOfWeek, week Изменения параметров.

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

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

28.01.2021. Добавлены варианты агрегирования для специальных показателей.

Для каждого специального показателя, зарегистрированного ресурсом, создается три варианта показателя API: сумма, среднее значение и количество.

28.01.2021. Добавлены новые параметры даты и времени.

В схему API добавлены следующие новые параметры: hour, nthHour, nthYear, dateHour.

28 января 2021 г. В Data API уменьшено количество токенов квоты, списываемых за запрос.

В Data API снижено количество токенов квоты, списываемых за запрос. Лимиты на количество токенов квоты ресурса в час и в день не изменились.

09.11.2020. Удален метод getUniversalMetadata.

Метод getUniversalMetadata удален. Используйте getMetadata. Ограничение на максимальный диапазон дат в один год для запроса к API было снято.

02.11.2020 Добавлен метод отчетов в реальном времени.

Примеры вы найдете в статье Создание отчета в реальном времени, а справочную документацию по REST – в статье runRealtimeReport.

19.10.2020 Обновлены артефакты клиентской библиотеки.

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

13.10.2020. Ресурсы типа "Приложение и сайт" переименованы в "Google Аналитика 4" (GA4).

08.10.2020 В API добавлен метод getMetadata.

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

08.10.2020. В отчетах доступны специальные параметры и показатели.

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