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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Properties.reportTasks.create
• Properties.reportTasks.get
• Properties.reportTasks.list
• свойства.reportTasks.query

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

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

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

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

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

Ответ на метод 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» .

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

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

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

• properties.audienceExports.create

• properties.audienceExports.get

• properties.audienceExports.list

• properties.audienceExports.query

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• properties.audienceLists.create

• properties.audienceLists.get

• properties.audienceLists.list

• properties.audienceLists.query

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

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

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

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

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

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

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

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

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 г. В альфа-канал добавлена ​​функция отчетов по воронке.

• Метод runFunnelReport , добавленный в альфа-версию API v1 , возвращает настроенный отчет по воронке данных о ваших событиях Google Analytics.

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

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

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

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

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

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

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

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

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

Анализ сбоев

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• videoUrl URL видео.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• sessionGoogleAdsCreativeId Dimension добавлен в схему 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 itemPromotionId itemCategory2 , itemCategory3 , itemCategory4 , itemCategory5 itemId orderCoupon itemListId , itemListName , itemName , itempromotion -creative, itemPromotionName itemPromotionCreativeName transactionId .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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