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

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

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

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

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

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

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

18.09.2024 Добавлена ​​функция создания снимков квот на недвижимость.

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

28.06.2024 Добавлена ​​квота на "ошибки клиентов по проекту и объекту недвижимости".

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

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

14.05.2024 Добавлена ​​функция сравнений.

С помощью функции «Сравнения» вы можете сравнивать подмножества ваших данных параллельно.

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

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

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

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

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

08.05.2024 В API данных версии 1alpha добавлены задачи создания отчетов — функция асинхронного формирования отчетов.

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

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

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

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

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

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

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

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

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

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

25.03.2024 Добавлены основные параметры группы каналов, источник трафика, определяемый вручную, и параметры, специфичные для интеграции.

В схему API данных добавлены основные группы каналов, источники трафика, указанные вручную, и специфические для интеграции с CM360, DV360, SA360 измерения.

Размеры аудитории:

  • audienceId идентификатор аудитории. Числовой идентификатор аудитории.

Размеры основной группы каналов:

  • firstUserPrimaryChannelGroup Первая основная группа каналов пользователя

  • primaryChannelGroup основная группа каналов

  • sessionPrimaryChannelGroup Группа основных каналов сессии

Размеры источников трафика, заданные вручную:

  • manualCampaignId Идентификатор кампании, указанный вручную

  • manualCampaignName Название кампании, созданной вручную

  • manualCreativeFormat Ручной творческий формат

  • manualMarketingTactic тактика Ручная маркетинговая тактика

  • manualMedium средняя

  • manualSource Ручной источник

  • manualSourceMedium Ручной источник / носитель

  • manualSourcePlatform Ручная исходная платформа

  • firstUserManualCampaignId Идентификатор кампании, созданной вручную пользователем

  • firstUserManualCampaignName Название кампании, созданной вручную первым пользователем

  • firstUserManualCreativeFormat Первое руководство пользователя в формате Creative Format

  • firstUserManualMarketingTactic Руководство пользователя по маркетинговой тактике

  • firstUserManualMedium Первое руководство пользователя среднего размера

  • firstUserManualSource Первый источник руководства пользователя

  • firstUserManualSourceMedium Первое руководство пользователя источник / medium

  • firstUserManualSourcePlatform Первая платформа исходных файлов руководства пользователя

  • sessionManualCampaignId Идентификатор ручной кампании сессии

  • sessionManualCampaignName Название ручной кампании сессии

  • sessionManualCreativeFormat Руководство по проведению сессии, креативный формат

  • sessionManualMarketingTactic Руководство по маркетинговой тактике

  • sessionManualMedium Руководство по проведению сессии, средний уровень

  • sessionManualSource Исходный код руководства сессии

  • sessionManualSourceMedium Сессия, ручной источник / носитель

  • sessionManualSourcePlatform Сессия ручная исходная платформа

Размеры интеграции с Campaign Manager 360 (CM360):

  • cm360AccountId CM360 account ID

  • cm360AccountName Имя учетной записи CM360

  • cm360AdvertiserId CM360 advertiser ID

  • cm360AdvertiserName CM360 advertiser name

  • cm360CampaignId CM360 campaign ID

  • cm360CampaignName Название кампании CM360

  • cm360CreativeFormat CM360 creative format

  • cm360CreativeId CM360 creative ID

  • cm360CreativeName CM360 creative name

  • cm360CreativeType CM360 creative type

  • cm360CreativeTypeId CM360 creative type ID

  • cm360CreativeVersion CM360 creative version

  • cm360Medium CM360 средний

  • cm360PlacementCostStructure Структура затрат на размещение CM360

  • cm360PlacementId CM360 placement ID

  • cm360PlacementName Название места размещения CM360

  • cm360RenderingId CM360 rendering ID

  • cm360SiteId CM360 site ID

  • cm360SiteName Название сайта CM360

  • cm360Source CM360 source

  • cm360SourceMedium CM360 источник / средний

  • firstUserCm360AccountId Идентификатор учетной записи первого пользователя CM360

  • firstUserCm360AccountName Имя учетной записи первого пользователя CM360

  • firstUserCm360AdvertiserId Идентификатор первого пользователя рекламодателя CM360

  • firstUserCm360AdvertiserName Имя первого пользователя рекламодателя CM360

  • firstUserCm360CampaignId Идентификатор кампании первого пользователя в CM360

  • firstUserCm360CampaignName Название кампании CM360 первого пользователя

  • firstUserCm360CreativeFormat Первый пользователь CM360 креативный формат

  • firstUserCm360CreativeId Первый пользователь CM360 creative ID

  • firstUserCm360CreativeName Имя первого пользователя CM360 creative name

  • firstUserCm360CreativeType Первый пользователь CM360 креативный тип

  • firstUserCm360CreativeTypeId Идентификатор первого пользователя CM360 creative type

  • 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 creative format

  • sessionCm360CreativeId Session CM360 creative ID

  • sessionCm360CreativeName Session CM360 creative name

  • sessionCm360CreativeType Session CM360 creative type

  • sessionCm360CreativeTypeId Идентификатор креативного типа сессии CM360

  • sessionCm360CreativeVersion Session CM360 creative version

  • sessionCm360Medium Session CM360 medium

  • sessionCm360PlacementCostStructure Структура затрат на размещение в рамках сессии CM360

  • sessionCm360PlacementId Идентификатор размещения сессии CM360

  • sessionCm360PlacementName Название размещения сессии CM360

  • sessionCm360RenderingId Идентификатор рендеринга сессии CM360

  • sessionCm360SiteId Идентификатор сайта CM360 (Session CM360SiteId)

  • sessionCm360SiteName Имя сайта сессии CM360

  • sessionCm360Source Session CM360 source

  • sessionCm360SourceMedium Session CM360 source / medium

Размеры интеграции Google Display & Video 360 (DV360):

  • dv360AdvertiserId DV360 advertiser ID

  • dv360AdvertiserName DV360 advertiser name

  • dv360CampaignId DV360 campaign ID

  • dv360CampaignName DV360 campaign name

  • dv360CreativeFormat DV360 creative format

  • dv360CreativeId DV360 creative ID

  • dv360CreativeName DV360 creative name

  • dv360ExchangeId DV360 exchange ID

  • dv360ExchangeName DV360 exchange name

  • dv360InsertionOrderId DV360 идентификатор заказа на вставку

  • dv360InsertionOrderName DV360 — название заказа на вставку

  • dv360LineItemId DV360 line item ID

  • dv360LineItemName DV360 line item name

  • dv360Medium DV360 средний

  • dv360PartnerId DV360 partner ID

  • dv360PartnerName DV360 partner name

  • dv360Source DV360 source

  • dv360SourceMedium DV360 источник / средний

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

  • firstUserDv360AdvertiserName Имя первого пользователя рекламодателя DV360

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

  • firstUserDv360CampaignName Имя кампании первого пользователя DV360

  • firstUserDv360CreativeFormat Первый пользователь DV360 креативный формат

  • firstUserDv360CreativeId Первый пользователь DV360 creative ID

  • firstUserDv360CreativeName Имя первого пользователя DV360 creative name

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

  • firstUserDv360ExchangeName Имя первого пользователя DV360 exchange

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

  • firstUserDv360InsertionOrderName Имя заказа на вставку первого пользователя DV360

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

  • firstUserDv360LinteItemName Название позиции первого пользователя DV360

  • firstUserDv360Medium Первый пользователь DV360 средний

  • firstUserDv360PartnerId Первый пользователь, идентификатор партнера DV360

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

  • firstUserDv360Source Первый пользователь DV360 источник

  • firstUserDv360SourceMedium Первый пользователь DV360 источник / средний

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

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

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

  • sessionDv360CampaignName Название кампании Session DV360

  • sessionDv360CreativeFormat Session DV360 creative format

  • sessionDv360CreativeId Session DV360 creative ID

  • sessionDv360CreativeName Session DV360 creative name

  • sessionDv360ExchangeId Идентификатор обмена сессии DV360

  • sessionDv360ExchangeName Имя обмена сессии DV360

  • sessionDv360InsertionOrderId Идентификатор заказа на вставку Session DV360

  • sessionDv360InsertionOrderName Название заказа на вставку Session DV360

  • sessionDv360LineItemId Идентификатор позиции в сессии DV360

  • sessionDv360LineItemName Название позиции заказа в сессии DV360

  • sessionDv360Medium Session DV360 medium

  • sessionDv360PartnerId Идентификатор партнера Session DV360

  • sessionDv360PartnerName Имя партнера Session DV360

  • sessionDv360Source Session DV360 source

  • sessionDv360SourceMedium Session DV360 source / medium

Размеры интеграции 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 Manager

  • firstUserSa360ManagerAccountName Имя учетной записи первого пользователя SA360 Manager

  • firstUserSa360Medium Первый пользователь SA360 средний

  • firstUserSa360Query Первый пользователь SA360 запрос

  • firstUserSa360Source Первый пользовательский источник SA360

  • firstUserSa360SourceMedium Первый пользователь SA360 источник / средний

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

  • sa360CampaignId SA360 campaign ID

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

  • sa360CampaignName SA360 campaign

  • sa360CreativeFormat SA360 креативный формат

  • sa360EngineAccountId Идентификатор учетной записи двигателя SA360

  • sa360EngineAccountName Имя учетной записи двигателя SA360

  • sa360EngineAccountType Тип учетной записи двигателя SA360

  • sa360KeywordText SA360 ключевой текст

  • sa360ManagerAccountId Идентификатор учетной записи менеджера SA360

  • sa360ManagerAccountName Имя учетной записи менеджера SA360

  • sa360Medium SA360 средний

  • sa360Query SA360 query

  • sa360Source SA360 source

  • sa360SourceMedium SA360 источник / средний

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

  • sessionSa360CampaignId Session SA360 campaign ID

  • sessionSa360ManagerAccountId Идентификатор учетной записи менеджера сессии SA360

  • sessionSa360ManagerAccountName Имя учетной записи менеджера сессии SA360

  • sessionSa360SourceMedium Session SA360 source / medium

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

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

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

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

30.01.2024 Поддержка уведомлений Webhook для списков аудитории и списков повторяющейся аудитории в альфа-версии Data API v1.

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

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

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

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

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

Для получения исчерпывающей информации о совместимости см. раздел «Обозреватель размеров и показателей GA4» .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2023-09-12 Правила сортировки по умолчанию в списке аудитории

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

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

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

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

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

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

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

    Для получения более подробной информации см. раздел «Параметры списка аудитории» .

15.08.2023 Добавлены измерения currencyCode и itemDiscountAmount .

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

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

Для получения более подробной информации см. схему отчетности Data API .

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

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

    Для получения более подробной информации см. раздел «Параметры списка аудитории» .

10.07.2023 Списки аудитории

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

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

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

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

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

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

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

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

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

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

Свойства Analytics 360

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

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

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

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

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

  • isoYearIsoWeek это ISO-неделя ISO-года. Суммарные значения isoWeek и isoYear . Примеры значений: 201652 и 201701 .

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

  • yearWeek неделя. Совокупные значения year и week . Примеры значений: 202253 или 202301 .

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

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

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

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

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

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

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

28.01.2023 Добавлены метрики «Просмотры на пользователя» и «Пользователи, прокручивающие страницу».

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

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

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

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

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

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

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

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

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

17.10.2022 Добавлены метрики, ограниченные областью действия элемента.

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

13.09.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 удалены из API данных.

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

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

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

03.08.2022 Добавлены измерения SA360, ограниченные областью действия сессии.

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

  • sessionSa360CampaignName название кампании Session 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 — это поисковый запрос из Search Ads 360, который привёл к этой сессии.

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

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

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

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

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

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

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

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

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

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

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

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

16.02.2022 Добавлены новые измерения.

Условия и содержание руководства

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

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

  • manualAdContent — это содержимое объявления, привязанное к событию конверсии. Заполняется параметром utm_content .

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

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

  • sessionManualTerm это термин, используемый для создания сессии. Термин, который привёл к созданию сессии. Заполняется параметром utm_term .

Анализ крушения

  • crashAffectedUsers — количество пользователей, у которых произошел сбой. Число пользователей, зарегистрировавших сбой в этой строке отчета.

  • crashFreeUsersRate — рейтинг пользователей, у которых не было сбоев.

Приложение/Веб

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

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

  • screenPageViewsPerSession количество просмотров за сессию.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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 The term searched by the user.

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

  • videoTitle The title of the video.

  • videoUrl The url of the video.

  • visible Returns 'true' if the content is visible.

  • unifiedPagePathScreen The page path (web) or screen class (app) on which the event was logged.

2021-09-07 API schema changes.

Changes in existing dimensions:

  • unifiedPageScreen For web generated events, this dimension now returns the page path and query string on which the event was logged.

Upcoming changes announcement:

  • firstUserTrafficOrigin The traffic origin that first acquired the user. Please do not depend on this field returning 'Manual' for traffic that uses UTMs; this field will update from returning 'Manual' to returning '(not set)' for an upcoming feature launch.

  • sessionTrafficOrigin The traffic origin of the session's campaign. Please do not depend on this field returning 'Manual' for traffic that uses UTMs; this field will update from returning 'Manual' to returning '(not set)' for an upcoming feature launch.

  • trafficOrigin The traffic origin of the conversion event's campaign. Please do not depend on this field returning 'Manual' for traffic that uses UTMs; this field will update from returning 'Manual' to returning '(not set)' for an upcoming feature launch.

2021-09-07 checkCompatibility method added to the API.

checkCompatibility method lists dimensions and metrics that can be added to a report request and maintain compatibility.

2021-07-21 Realtime reporting changes.

It is now possible to specify the minute ranges of event data to read using the minuteRanges parameter of the runRealtimeReport method.

2021-07-21 New channel grouping dimensions.

New channel grouping dimensions added to the Data API reporting schema :

  • firstUserDefaultChannelGrouping First user default channel grouping.

  • defaultChannelGrouping Default channel grouping.

2021-06-10 API schema changes.

  • minutesAgo dimension added to the Data API realtime schema and can be used in queries to the runRealtimeReport method. This dimension contains the number of minutes ago that an event was collected. 00 is the current minute, and 01 means the previous minute.

  • googleAdsCreativeId dimension added to the Data API schema. This dimension contains the ID of the Google Ads creative attributed to the conversion event.

  • sessionGoogleAdsCreativeId dimension added to the Data API schema. This dimension contains the ID of the Google Ads creative that lead to a session on your website or app.

  • firstUserCreativeId dimension renamed to firstUserGoogleAdsCreativeId in the Data API schema. This dimension contains the ID of the Google Ads creative that first acquired the user.

2021-04-09 The Google Analytics Data API v1 beta has been released.

  • The API endpoint updated to https://analyticsdata.googleapis.com/v1beta .

  • runReport , runPivotReport , batchRunReports , batchRunPivotReports methods now accept the id of a Google Analytics 4 property in the property parameter of the URL path instead of the entity field of a request body:

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

  • API client libraries have been updated to use the new API endpoint.

2021-02-19 Pagination changes.

  • The default report response size increased from 10 to 10,000 rows of event data.

  • "limit" : -1 value that was used to indicate an attempt to retrieve all rows is no longer supported in RunReportRequest .

  • The maximum value of the limit field is set to 100000 . Use pagination to retrieve reports containing more than 100,000 rows.

2021-02-08 New e-commerce dimensions and metrics.

New e-commerce dimensions and metrics have been added to the API schema :

Dimensions: adFormat , adSourceName , adUnitName , itemBrand , itemCategory , itemCategory2 , itemCategory3 , itemCategory4 , itemCategory5 itemId , itemListId , itemListName , itemName , itemPromotionCreativeName , itemPromotionId , itemPromotionName , orderCoupon , transactionId .

Metrics: adUnitExposure , addToCarts , cartToViewRate , checkouts , ecommercePurchases , firstTimePurchasers , itemListClickThroughRate , itemListClicks , itemListViews , itemPromotionClickThroughRate , itemPromotionClicks , itemPromotionViews , itemPurchaseQuantity , itemRevenue , itemViews , publisherAdClicks , publisherAdImpressions , totalPurchasers .

2021-02-08 Added new campaign dimensions.

New campaign dimensions have been added to the API schema : campaignId , campaignName , googleAdsAccountName , googleAdsAdGroupId , googleAdsAdGroupName , googleAdsAdNetworkType , source , trafficOrigin

2021-02-08 dayOfWeek , week dimension changes.

  • The value of dayOfWeek dimension now starts with 0 instead of 1.

  • The value of week dimension now starts with 01 and returns a two-digit number from 01 to 53. Each week starts on Sunday. January 1st is always in week 01.

2021-01-28 Added aggregation variants for custom metrics.

Each custom metric that a property registers creates three API metric variants : a sum, an average, and a count.

2021-01-28 Added new Date/time dimensions.

The following new dimensions have been added to the API schema : hour , nthHour , nthYear , dateHour .

2021-01-28 The Data API reduced the quota tokens charged per query.

The Data API reduced the quota tokens charged per query. The quota limits for property quota tokens per hour and per day were not changed.

2020-11-09 The method getUniversalMetadata has been deleted.

The method getUniversalMetadata has been deleted. Please use getMetadata . The one year maximum date range per API request has been removed.

2020-11-02 Added a Realtime Reporting Method.

See the Creating a Realtime Report for examples and runRealtimeReport for the REST reference documentation.

2020-10-19 Client library artifacts updated.

Client library artifacts updated along with usage instructions and code samples.

2020-10-13 App + Web properties have been renamed to Google Analytics 4 (GA4).

2020-10-08 getMetadata method added to the API.

getMetadata method returns Custom dimensions and metrics available for the specified GA4 property ID, as well as Universal metadata.

2020-10-08 Custom dimensions and metrics are available in reports.

See the API schema documentation for documentation on custom dimensions and metrics. This update includes Event-scoped Custom Dimensions and metrics as well as User-scoped Custom Dimensions.