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

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

2024-10-20 Добавлен тип фильтра измерения EmptyFilter

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

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

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

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

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

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

28 июня 2024 г. Добавлена ​​квота «количество клиентских ошибок на проект и объект недвижимости».

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

В схему 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 Исходная платформа для сеанса с руководством

Параметры интеграции Campaign Manager 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 Формат креатива Session CM360

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

  • sessionCm360CreativeName Имя креатива сеанса CM360

  • sessionCm360CreativeType Тип креатива Session 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 средний

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

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

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

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

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

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

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

  • sessionDv360CampaignName Имя кампании Session 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

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

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

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

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

2024-01-30 Поддержка уведомлений Webhook для списков аудитории, повторяющихся списков аудитории в альфа-версии 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 .

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

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

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

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

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

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

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

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

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

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

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

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

13 октября 2023 г. Добавлена ​​поддержка аудиторий со сроком членства 1 день.

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

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

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

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

идентификатор устройства isAdsPersonalizationAllowed
Азбука истинный
ЦАП ЛОЖЬ
Азбука ЛОЖЬ
ААА истинный

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

идентификатор устройства isAdsPersonalizationAllowed
ААА истинный
Азбука ЛОЖЬ
Азбука истинный
ЦАП ЛОЖЬ

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

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

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

15.08.2023 Добавлено измерение currencyCode , метрика itemDiscountAmount

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

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

Более подробную информацию см. в разделе Схема отчетности API данных .

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

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

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

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

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

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

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

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

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

Система квот API данных была обновлена ​​для обеспечения более точной оплаты.

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

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

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

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

Аналитика 360 Свойства

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

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

  • dayOfWeekName — название дня недели. День недели на английском языке. Возможные значения: Sunday , Monday и т. д.

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

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

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

  • yearMonth Год месяц. Объединенные значения year и month . Примеры значений: 202212 или 202301 .

  • yearWeek год, неделя. Объединённые значения year и week . Примеры значений: 202253 или 202301 .

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

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

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

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

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

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

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

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

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

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

2023-01-23 Добавлены измерения «Континент», «ID континента».

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

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

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

  • testDataFilterId — идентификатор тестового фильтра данных. Числовой идентификатор фильтра данных в состоянии тестирования. Фильтры данных используются для включения или исключения данных о событиях из отчётов на основе значений параметров событий. Подробнее см. на странице https://support.google.com/analytics/answer/10108813 .

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

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

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

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

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

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 удаляются из API данных.

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

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

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

2022-08-03 Добавлены измерения 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 Ads», «Bing» или «Baidu».

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

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

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

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

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

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

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

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

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

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

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

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

05.05.2022 Добавлена ​​функциональность воронкообразной отчетности в альфа-канал.

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

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

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

Термин и содержание руководства

  • 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 дней, которые также являются активными в течение 1 дня.

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

  • wauPerMau WAU / MAU. Текущий процент пользователей, активных в течение 30 дней, которые также являются активными в течение 7 дней.

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

  • transactionsPerPurchaser Количество транзакций на покупателя.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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.01.2021 Data API уменьшил количество токенов квоты, взимаемых за запрос.

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

09.11.2020 Метод getUniversalMetadata был удален.

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

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

Примеры см. в разделе «Создание отчета в реальном времени» , а справочную документацию по REST — запустите RealtimeReport .

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

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

13.10.2020 Свойства приложения и сайта были переименованы в Google Analytics 4 (GA4).

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

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

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

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