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

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

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 день теперь поддерживаются функцией экспорта списков аудиторий .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

11.05.2023 Изменения квоты на токены.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

17 октября 2022 г. Добавлены метрики на уровне элемента.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ручной термин и содержание

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

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

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

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

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

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

Анализ сбоев

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • firstUserTrafficOrigin Происхождение трафика, которое впервые приобрело пользователя. Пожалуйста, не зависят от этого поля, возвращающего «Руководство» для трафика, который использует 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 , itemCategory5 itemId , itemListId , itemListName , itemName , itemPromotionCreativeName , itemPromotionId , itemPromotionName , orderCoupon , transactionId .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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