Для получения официальных объявлений об 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.
08 мая 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
.
Измените все запросы отчетов, которые используют устаревшую метрику в следующей таблице, чтобы вместо нее использовать метрику ключевых событий .
Устаревшая метрика | Ключевой показатель событий |
---|---|
advertiserAdCostPerConversion | advertiserAdCostPerKeyEvent |
conversions | keyEvents |
firstTimePurchaserConversionRate | firstTimePurchaserRate |
purchaserConversionRate | purchaserRate |
sessionConversionRate | sessionKeyEventRate |
userConversionRate | userKeyEventRate |
Внесите аналогичные изменения в любое использование показателей ключевых событий для одного ключевого события в запросах отчетов.
Ответ на метод properties/getMetadata
отражает введение ключевых измерений и показателей событий в объекты DimensionMetadata
и MetricMetadata
следующим образом:
-
apiName
,uiName
иdescription
содержат имя API ключевого события, имя пользовательского интерфейса и описание. - Повторяющееся поле
deprecatedApiNames
содержит запись с устаревшим именем API преобразования.
25 марта 2024 г. Добавлена основная группа каналов, ручной источник трафика и параметры интеграции.
В схему API данных добавлены основная группа каналов, источник трафика, заданный вручную, а также специальные параметры интеграции CM360, DV360, SA360.
Размеры аудитории:
-
audienceId
Идентификатор аудитории. Числовой идентификатор аудитории.
Размеры основной группы каналов:
firstUserPrimaryChannelGroup
Первая группа основных каналов пользователяprimaryChannelGroup
Основная группа каналовsessionPrimaryChannelGroup
Группа основных каналов сеанса
Параметры источника трафика вручную:
manualCampaignId
Идентификатор кампании, созданной вручнуюmanualCampaignName
Название кампании, заданное вручнуюmanualCreativeFormat
Ручной формат объявленияmanualMarketingTactic
Ручная маркетинговая тактикаmanualMedium
Ручной среднийmanualSource
Источник руководстваmanualSourceMedium
Ручной источник/носительmanualSourcePlatform
Платформа с ручным исходным кодомfirstUserManualCampaignId
Идентификатор первой кампании, созданной вручную,firstUserManualCampaignName
Название первой кампании по руководству пользователяfirstUserManualCreativeFormat
Первый формат объявления для руководства пользователяfirstUserManualMarketingTactic
Первое руководство пользователя, маркетинговая тактикаfirstUserManualMedium
Первый носитель руководства пользователяfirstUserManualSource
Первый источник руководства пользователяfirstUserManualSourceMedium
Первый источник/носитель руководства пользователяfirstUserManualSourcePlatform
Первая исходная платформа руководства пользователяsessionManualCampaignId
Идентификатор кампании, созданной вручную для сеансаsessionManualCampaignName
Имя кампании, созданной вручную для сеансаsessionManualCreativeFormat
Формат объявления вручную для сеансаsessionManualMarketingTactic
Руководство по маркетинговой тактике сеансаsessionManualMedium
Ручной носитель сеансаsessionManualSource
Источник руководства по сеансуsessionManualSourceMedium
Ручной источник/носитель сеансаsessionManualSourcePlatform
Платформа исходного кода вручную сеанса
Параметры интеграции Менеджера кампаний 360 (CM360):
cm360AccountId
Идентификатор аккаунта CM360cm360AccountName
Имя учетной записи CM360cm360AdvertiserId
Идентификатор рекламодателя CM360cm360AdvertiserName
Имя рекламодателя CM360cm360CampaignId
Идентификатор кампании CM360cm360CampaignName
Название кампании CM360cm360CreativeFormat
Формат объявления CM360cm360CreativeId
Идентификатор объявления CM360cm360CreativeName
Название объявления CM360cm360CreativeType
Тип объявления CM360cm360CreativeTypeId
Идентификатор типа объявления CM360cm360CreativeVersion
Версия объявления CM360cm360Medium
CM360 среднийcm360PlacementCostStructure
Структура стоимости размещения в CM360cm360PlacementId
Идентификатор места размещения CM360cm360PlacementName
Название места размещения CM360cm360RenderingId
Идентификатор отрисовки CM360cm360SiteId
Идентификатор сайта CM360cm360SiteName
Имя сайта CM360Источник
cm360Source
CM360cm360SourceMedium
Источник/носитель CM360firstUserCm360AccountId
Идентификатор учетной записи первого пользователя CM360firstUserCm360AccountName
Имя учетной записи первого пользователя CM360firstUserCm360AdvertiserId
Идентификатор первого пользователя рекламодателя CM360firstUserCm360AdvertiserName
Имя первого пользователя-рекламодателя CM360firstUserCm360CampaignId
Идентификатор кампании первого пользователя в CM360firstUserCm360CampaignName
Название кампании CM360 первого пользователяfirstUserCm360CreativeFormat
Формат первого пользовательского объявления CM360firstUserCm360CreativeId
Идентификатор объявления первого пользователя в CM360firstUserCm360CreativeName
Название первого пользовательского объявления CM360firstUserCm360CreativeType
Тип объявления первого пользователя CM360firstUserCm360CreativeTypeId
Идентификатор типа объявления первого пользователя CM360firstUserCm360CreativeVersion
Первая версия пользовательского объявления CM360firstUserCm360Medium
Первый пользовательский CM360 среднийfirstUserCm360PlacementCostStructure
Структура стоимости размещения первого пользователя в CM360firstUserCm360PlacementId
Идентификатор места размещения первого пользователя в CM360firstUserCm360PlacementName
Название места размещения первого пользователя в CM360firstUserCm360RenderingId
Идентификатор отрисовки первого пользователя CM360firstUserCm360SiteId
Идентификатор сайта первого пользователя CM360firstUserCm360SiteName
Имя сайта первого пользователя CM360firstUserCm360Source
Источник первого пользователя CM360firstUserCm360SourceMedium
Источник/канал первого пользователя CM360sessionCm360AccountId
Идентификатор учетной записи сеанса CM360sessionCm360AccountName
Имя учетной записи сеанса CM360sessionCm360AdvertiserId
Идентификатор рекламодателя сеанса CM360sessionCm360AdvertiserName
Имя рекламодателя сеанса CM360sessionCm360CampaignId
Идентификатор кампании сеанса CM360sessionCm360CampaignName
Название кампании сеанса CM360sessionCm360CreativeFormat
Формат объявления сеанса CM360sessionCm360CreativeId
Идентификатор объявления сеанса CM360sessionCm360CreativeName
Название объявления сеанса CM360sessionCm360CreativeType
Тип объявления сеанса CM360sessionCm360CreativeTypeId
Идентификатор типа объявления сеанса CM360sessionCm360CreativeVersion
Версия объявления CM360 для сеансаsessionCm360Medium
Сеанс CM360 среднийsessionCm360PlacementCostStructure
Структура стоимости размещения сеанса CM360sessionCm360PlacementId
Идентификатор места размещения сеанса CM360sessionCm360PlacementName
Имя места размещения сеанса CM360sessionCm360RenderingId
Идентификатор отрисовки сеанса CM360sessionCm360SiteId
Идентификатор сайта сеанса CM360sessionCm360SiteName
Имя сайта сеанса CM360sessionCm360Source
Источник сеанса CM360sessionCm360SourceMedium
Источник/носитель сеанса CM360
Параметры интеграции Google Display & Video 360 (DV360):
dv360AdvertiserId
Идентификатор рекламодателя DV360dv360AdvertiserName
Имя рекламодателя DV360dv360CampaignId
Идентификатор кампании DV360dv360CampaignName
Название кампании DV360dv360CreativeFormat
Формат объявления DV360dv360CreativeId
Идентификатор объявления DV360dv360CreativeName
Название объявления DV360dv360ExchangeId
Идентификатор обмена DV360dv360ExchangeName
Имя обмена DV360dv360InsertionOrderId
Идентификатор заказа на размещение DV360dv360InsertionOrderName
Название заказа на размещение DV360dv360LineItemId
Идентификатор позиции DV360dv360LineItemName
Название позиции DV360dv360Medium
DV360 среднийdv360PartnerId
Идентификатор партнера DV360dv360PartnerName
Имя партнера DV360Источник
dv360Source
DV360dv360SourceMedium
Источник/носитель DV360firstUserDv360AdvertiserId
Идентификатор первого пользователя рекламодателя DV360firstUserDv360AdvertiserName
Имя первого пользователя рекламодателя DV360firstUserDv360CampaignId
Идентификатор кампании первого пользователя DV360firstUserDv360CampaignName
Название кампании DV360 первого пользователяfirstUserDv360CreativeFormat
Формат первого пользовательского объявления DV360firstUserDv360CreativeId
Идентификатор первого пользовательского объявления DV360firstUserDv360CreativeName
Название первого пользовательского объявления DV360firstUserDv360ExchangeId
Идентификатор обмена DV360 первого пользователяfirstUserDv360ExchangeName
Имя первого пользователя обмена DV360firstUserDv360InsertionOrderId
Идентификатор заказа на размещение первого пользователя в DV360firstUserDv360InsertionOrderName
Имя первого пользователя в заказе на размещение DV360firstUserDv360LineItemId
Идентификатор позиции первого пользователя в DV360firstUserDv360LinteItemName
Название позиции первого пользователя в DV360firstUserDv360Medium
Первый пользователь DV360 MediumfirstUserDv360PartnerId
Идентификатор первого пользователя партнера DV360firstUserDv360PartnerName
Имя первого пользователя-партнера DV360firstUserDv360Source
Первый пользовательский источник DV360firstUserDv360SourceMedium
Первый пользовательский источник/канал DV360sessionDv360AdvertiserId
Идентификатор рекламодателя сеанса DV360sessionDv360AdvertiserName
Имя рекламодателя сеанса DV360sessionDv360CampaignId
Идентификатор кампании сеанса DV360sessionDv360CampaignName
Название кампании сеанса DV360sessionDv360CreativeFormat
Формат объявления сеанса DV360sessionDv360CreativeId
Идентификатор объявления сеанса DV360sessionDv360CreativeName
Название креатива DV360 сеансаsessionDv360ExchangeId
Идентификатор обмена сеанса DV360sessionDv360ExchangeName
Имя сеанса обмена DV360sessionDv360InsertionOrderId
Идентификатор заказа на размещение сеанса DV360sessionDv360InsertionOrderName
Название заказа на размещение сеанса DV360sessionDv360LineItemId
Идентификатор позиции сеанса DV360sessionDv360LineItemName
Название позиции сеанса DV360sessionDv360Medium
Сеанс DV360 среднийsessionDv360PartnerId
Идентификатор партнера сеанса DV360sessionDv360PartnerName
Имя партнера сеанса DV360sessionDv360Source
Источник сеанса DV360sessionDv360SourceMedium
Источник/канал сеанса DV360
Параметры интеграции Google Search Ads 360 (SA360):
firstUserSa360AdGroupId
Идентификатор группы объявлений SA360 первого пользователяfirstUserSa360AdGroupName
Название группы объявлений SA360 первого пользователяfirstUserSa360CampaignId
Идентификатор кампании SA360 для первого пользователяfirstUserSa360CampaignName
Первая пользовательская кампания SA360firstUserSa360CreativeFormat
Формат первого пользовательского объявления SA360firstUserSa360EngineAccountId
Идентификатор учетной записи системы SA360 первого пользователяfirstUserSa360EngineAccountName
Имя учетной записи системы SA360 первого пользователяfirstUserSa360EngineAccountType
Тип учетной записи первого пользователя в системе SA360firstUserSa360KeywordText
Текст ключевого слова SA360 для первого пользователяfirstUserSa360ManagerAccountId
Идентификатор управляющего аккаунта первого пользователя SA360firstUserSa360ManagerAccountName
Имя управляющего аккаунта первого пользователя SA360firstUserSa360Medium
Первый пользовательский SA360 среднийfirstUserSa360Query
Первый пользовательский запрос SA360firstUserSa360Source
Первый пользовательский источник SA360firstUserSa360SourceMedium
Первый пользовательский источник/канал SA360sa360AdGroupId
Идентификатор группы объявлений SA360sa360CampaignId
Идентификатор кампании SA360sa360AdGroupName
Название группы объявлений SA360sa360CampaignName
Кампания SA360sa360CreativeFormat
Формат объявления SA360sa360EngineAccountId
Идентификатор учетной записи системы SA360sa360EngineAccountName
Имя учетной записи механизма SA360sa360EngineAccountType
Тип учетной записи системы SA360sa360KeywordText
Текст ключевого слова SA360sa360ManagerAccountId
Идентификатор управляющего аккаунта SA360sa360ManagerAccountName
Имя управляющего аккаунта SA360sa360Medium
SA360 среднийsa360Query
Запрос SA360Источник
sa360Source
SA360sa360SourceMedium
Источник/носитель SA360sessionSa360AdGroupId
Идентификатор группы объявлений SA360 сеансаsessionSa360CampaignId
Идентификатор кампании SA360 сеансаsessionSa360ManagerAccountId
Идентификатор управляющего аккаунта сеанса SA360sessionSa360ManagerAccountName
Имя управляющего аккаунта сеанса SA360sessionSa360SourceMedium
Источник/носитель сеанса SA360
6 марта 2024 г. Поддержка аудиторий неактивных пользователей при экспорте аудиторий.
Функция экспорта аудитории лучше поддерживает экспорт аудиторий неактивных пользователей. Пользователи входят в эту аудиторию без соответствующего события; например, пользователь может войти в аудиторию, не посещая ваш сайт в течение семи дней. Примеры аудиторий неактивных пользователей включают «неактивных покупателей в течение 7 дней», «неактивных пользователей в течение 7 дней» и «пользователей, не получающих уведомления в течение 7 дней». Дополнительную информацию об этих предлагаемых аудиториях см. в разделе Рекомендуемые аудитории .
2024-02-28 Экспорт аудитории возвращает идентификатор пользователя, указанный в тегах.
Экспорт аудитории теперь возвращает идентификатор пользователя, указанный в тегах, даже если для вашего ресурса включены данные, предоставляемые пользователями. Если включен сбор предоставленных пользователем данных, предоставленные пользователем данные вместе с идентификатором пользователя можно отправлять в Google Analytics в виде тегов для улучшения измерения. Дополнительную информацию см. в разделе Сбор данных, предоставляемых пользователями .
30 января 2024 г. Поддержка уведомлений Webhook для списков аудиторий и повторяющихся списков аудиторий в альфа-версии Data API v1.
Поля AudienceList.webhookNotification
и RecurringAudienceList.webhookNotification
можно указать при создании списка аудитории (с использованием Properties.audienceLists.create ) или повторяющегося списка аудитории (с использованием Properties.recurringAudienceLists.create ).
Эта функция позволяет асинхронно получать уведомления Webhook, когда список аудитории становится доступным.
2024-01-18 Улучшена совместимость для измерений, включающих строку запроса или минутный компонент.
Измерения, включающие строку запроса, теперь совместимы с большинством полей. Такие измерения, как pagePathPlusQueryString
, unifiedPageScreen
, pageLocation
и fullPageUrl
теперь совместимы со многими дополнительными полями, включая sessionSource
, browser
, city
и landingPage
.
Измерения, включающие минутный компонент, теперь совместимы с большинством полей. Такие измерения, как minute
, nthMinute
и dateHourMinute
теперь совместимы с аналогичным набором дополнительных полей.
Подробную информацию о совместимости см. в обозревателе параметров и показателей GA4 .
13.12.2023 Параметры пользовательского элемента
Специальные измерения на уровне элемента теперь можно включать в запросы Analytics Data API, используя следующий синтаксис:
Общее имя API | Описание |
---|---|
customItem: имя_параметра | Специальный параметр на уровне элемента для параметра имя_параметра |
Дополнительную информацию см. в разделе «Измерения и метрики API» .
05.12.2023 Списки аудиторий доступны в бета-версии Data API v1 в виде экспорта аудитории.
Функция «Списки аудиторий» была переименована в «Экспорт аудиторий» и добавлена в бета-версию Data API v1.
В бета-версию Data API v1 добавлены следующие методы:
28.11.2023 Добавлены samplingMetadatas
для ответа на отчет.
Добавлены samplingMetadatas
в ResponseMetaData
. Эта коллекция будет содержать SampleMetadata
для каждого диапазона дат в запросе, для которого были выбраны результаты. Google Analytics будет применять выборку только в том случае, если предполагает, что ограничения по количеству элементов приведут к снижению качества данных.
28.11.2023 Добавлена функция повторяющегося экспорта списка аудитории в альфа-версию Data API v1.
В альфа-версию Data API v1 добавлены методы properties.recurringAudienceLists.create
, properties.recurringAudienceLists.create
, properties.recurringAudienceLists.list
.
Эта функция позволяет создавать списки аудитории ежедневно по мере изменения членства в аудитории. Повторяющиеся списки аудитории гарантируют, что вы будете работать с самыми свежими результатами членства в аудитории.
8 ноября 2023 г. в альфа-версию Data API v1 добавлена функция экспорта списка аудитории в таблицы.
В альфа-версию Data API v1 добавлен метод properties.audienceLists.exportSheet
, который позволяет экспортировать список аудитории в Google Таблицы.
13.10.2023 Добавлена поддержка аудиторий с длительностью членства в 1 день.
Аудитории с продолжительностью членства в 1 день теперь поддерживаются функцией экспорта списков аудиторий .
12.09.2023 Правила упорядочивания списка AudienceList по умолчанию
По умолчанию отчеты, созданные с помощью функции экспорта списков аудиторий, подчиняются тем же правилам упорядочивания, что и другие методы отчетности API данных: порядок будет убывать по первому столбцу, затем по убыванию по второму столбцу и т. д.
До этого изменения вы могли получить следующий отчет:
идентификатор устройства | isAdsПерсонализацияРазрешено |
---|---|
АВС | истинный |
ЦАП | ЛОЖЬ |
АВС | ЛОЖЬ |
ААА | истинный |
После этого изменения вы получите следующий отчет:
идентификатор устройства | isAdsПерсонализацияРазрешено |
---|---|
ААА | истинный |
АВС | ЛОЖЬ |
АВС | истинный |
ЦАП | ЛОЖЬ |
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 добавлены следующие методы:
19 мая 2023 г. Пользовательские группы каналов
В Data API добавлена поддержка групп пользовательских каналов .
2023-05-11 Изменение квоты токенов.
Система квот 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 |
Ресурсы Аналитики 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 февраля 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 года произойдут следующие серьезные изменения:
Измерения на уровне элемента, такие как
itemName
становятся несовместимыми с метриками на уровне событий, такими какeventCount
. Измерения на уровне элемента по-прежнему будут совместимы с метриками на уровне элемента, такими какitemRevenue
, метриками на основе пользователей, такими какactiveUsers
, и метриками на основе сеансов, такими какsessions
.Параметры атрибуции, такие как
source
становятся несовместимыми с некоторыми метриками на уровне событий, такими какeventCount
. Параметры атрибуции по-прежнему будут совместимы с атрибутивными показателями, такими какconversions
, метриками на основе пользователей, такими какactiveUsers
, и метриками на основе сеансов, такими какsessions
.Измерения, включающие строку запроса, например
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
измерение добавлено к схеме API данных. Это измерение содержит идентификатор креативной рекламы Google, который приводит к сеансу на вашем веб -сайте или в приложении.firstUserCreativeId
Dimension переименован вfirstUserGoogleAdsCreativeId
в схеме API данных. Это измерение содержит идентификатор Google Ads Creative, который впервые приобрел пользователя.
2021-04-09 Google Analytics Data API V1 Beta.
Конечная точка API обновлена на
https://analyticsdata.googleapis.com/v1beta
.runReport
,runPivotReport
,batchRunReports
, методыbatchRunPivotReports
теперь принимают идентификатор свойства Google Analytics 4 в параметреproperty
пути URL вместо поляentity
образного тела:POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports
Библиотеки клиентов API были обновлены, чтобы использовать новую конечную точку API.
2021-02-19 изменений страниц.
Размер ответа отчета по умолчанию увеличился с 10 до 10 000 строк данных о событиях.
"limit" : -1
значение, которое использовалось для указания попытки извлечь все строки, больше не поддерживается в Runreportrequest .Максимальное значение
limit
поля установлено на100000
. Используйте лиц, чтобы получить отчеты, содержащие более 100 000 строк.
2021-02-08 Новые размеры и метрики электронной коммерции.
Новые размеры электронной коммерции и метрики были добавлены в схему API :
Размеры: adFormat
, adSourceName
, adUnitName
, itemBrand
, itemCategory
, itemCategory2
, itemCategory3
, itemCategory4
transactionId
itemCategory5
itemId
, itemListId
, itemListName
, itemName
, itemPromotionCreativeName
itemPromotionId
, itemPromotionName
, orderCoupon
.
Метрики: adUnitExposure
, addToCarts
, cartToViewRate
, checkouts
, ecommercePurchases
, firstTimePurchasers
, itemListClickThroughRate
, itemListClicks
, itemListViews
, itemPromotionClickThroughRate
, itemPromotionClicks
, itemPromotionViews
, iTeMpashAsequantity, itemPurchaseQuantity
, 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 для документации по пользовательским аспектам и метрикам. Это обновление включает в себя пользовательские аспекты и метрики с учетом событий, а также пользовательские пользовательские размеры.
,Для официальных объявлений API Google Analytics, пожалуйста, подпишитесь на Google Analytics API Group .
2024-10-20 Добавлен тип фильтра EmptyFilter
Dimension
Используя фильтр измерения пустогофильтера , вы можете создать условия фильтрации для сравнения с пустым значением.
2024-10-15 Добавлена функция уровня выборки к методу reportTasks
Используя поле Samplingelel метода Properties.RunreportTask , вы можете управлять уровнем отбора отбора.
Эта функция дает Google Analytics 360 доступ к более высоким пределам выборки в 1 миллиард событий. Кроме того, пределы выборки могут быть установлены на UNSAMPLED
для большого количества несампликованных результатов.
2024-09-18 Добавлена функция снимка квотов свойств
Используя метод Properties.getPropertyQuotassNapShot , вы можете получить текущий снимок всех квот о свойствах, организованных категорией квот для данного свойства.
2024-06-28 Добавлены «Клиентские ошибки на каждую проект на недвижимость».
В настоящее время существует предел 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 Data V1alpha.
Используя задачи отчетов, вы можете инициировать давний асинхронный запрос, чтобы сформировать настраиваемый отчет о ваших данных о событиях Google Analytics.
Следующие методы манипуляции с задачами были добавлены в API Data V1alpha:
- Properties.ReportTasks.Create
- Properties.ReportTasks.get
- Properties.ReportTasks.List
- Properties.ReportTasks.Query
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 Добавлены группы первичных каналов, ручной источник трафика и специфические размеры интеграции.
Группа первичных каналов, ручный источник трафика и CM360, DV360, SA360 Интеграция специфические размеры, добавленные к схеме API данных.
Аудитория измерения:
-
audienceId
идентификатор аудитории. Числовой идентификатор аудитории.
Основные измерения группы каналов:
firstUserPrimaryChannelGroup
First User Group GroupprimaryChannelGroup
Primary Channel GroupsessionPrimaryChannelGroup
Session Group Group
Ручные размеры источника трафика:
manualCampaignId
Manual CampaignmanualCampaignName
Название кампанииРучной формат ручного формата
manualCreativeFormat
manualMarketingTactic
Manal Marketing TacticРуководство
manualMedium
MediumРуководство по
manualSource
источникуРуководство
manualSourceMedium
/ среду ручной работы / средаmanualSourcePlatform
платформа ручной платформы ручной работыfirstUserManualCampaignId
Первый идентификатор управления пользователемfirstUserManualCampaignName
Первое руководство пользователя Имя кампанииfirstUserManualCreativeFormat
Persing Руководство пользователя творческий форматfirstUserManualMarketingTactic
Первая пользовательская маркетинговая тактика маркетингаfirstUserManualMedium
Первый пользователь среднийfirstUserManualSource
Первый пользовательский источник пользователяfirstUserManualSourceMedium
Первый пользовательский ручный источник / среднийfirstUserManualSourcePlatform
First User Manual PlatformsessionManualCampaignId
Manual Manual CampaignsessionManualCampaignName
Session Manual Название кампанииsessionManualCreativeFormat
Session Manual Creative FormatsessionManualMarketingTactic
Session Manual Marketing TacticsessionManualMedium
Session Medium MediumsessionManualSource
Session Manual SourcesessionManualSourceMedium
Session Manual Source / MediumsessionManualSourcePlatform
Session Manual Platform
Менеджер кампании 360 (CM360) Размеры интеграции:
cm360AccountId
CM360 идентификатор учетной записиcm360AccountName
CM360 Имя учетной записиcm360AdvertiserId
CM360 идентификатор рекламодателяcm360AdvertiserName
CM360 Имя рекламодателяcm360CampaignId
CM360 ID кампанииcm360CampaignName
CM360 Название кампанииcm360CreativeFormat
CM360 Творческий форматcm360CreativeId
CM360 Creative IDcm360CreativeName
CM360 Творческое имяcm360CreativeType
CM360 Творческий типcm360CreativeTypeId
CM360 Творческий тип идентификатор типаcm360CreativeVersion
CM360 Творческая версияcm360Medium
CM360 средаcm360PlacementCostStructure
CM360 Структура стоимости размещенияcm360PlacementId
CM360 ID размещенияcm360PlacementName
CM360 Имя размещенияcm360RenderingId
CM360 идентификатор рендерингаcm360SiteId
CM360 ID сайтаcm360SiteName
CM360 Имя сайтаcm360Source
CM360 Источникcm360SourceMedium
cm360 Source / MediumfirstUserCm360AccountId
ID FIRST USER CM360firstUserCm360AccountName
FIRST USER USER CM360 Имя учетной записиfirstUserCm360AdvertiserId
First User CM360 идентификатор рекламодателяfirstUserCm360AdvertiserName
First User CM360 Имя рекламодателяfirstUserCm360CampaignId
Первый пользователь CM360 идентификатор кампанииfirstUserCm360CampaignName
First User CM360 Имя кампанииfirstUserCm360CreativeFormat
First User CM360 Creative FormatfirstUserCm360CreativeId
Первый пользователь CM360 Creative IDfirstUserCm360CreativeName
First User CM360 Творческое имяfirstUserCm360CreativeType
первого пользователя CM360 Creative TypefirstUserCm360CreativeTypeId
первого пользователя CM360 идентификатор творческого типаfirstUserCm360CreativeVersion
Первый пользователь CM360 Творческая версияfirstUserCm360Medium
First User CM360 MediumfirstUserCm360PlacementCostStructure
First User CM360 Структура стоимости размещенияfirstUserCm360PlacementId
идентификатор размещения CM360 CM360firstUserCm360PlacementName
FIRST USER CM360 Имя размещенияfirstUserCm360RenderingId
Первый пользователь CM360 идентификатор рендерингаfirstUserCm360SiteId
Первый пользователь CM360 ID сайтаfirstUserCm360SiteName
First User CM360 Имя сайтаfirstUserCm360Source
First User CM360 SourcefirstUserCm360SourceMedium
First User CM360 Source / MediumsessionCm360AccountId
SESSION CM360 Идентификатор учетной записиsessionCm360AccountName
SESSION CM360 Имя учетной записиsessionCm360AdvertiserId
Session CM360 идентификатор рекламодателяsessionCm360AdvertiserName
SESSION CM360 Имя рекламодателяsessionCm360CampaignId
Session Cm360 ID кампанииsessionCm360CampaignName
Session CM360 Название кампанииsessionCm360CreativeFormat
Session Cm360 Творческий форматsessionCm360CreativeId
Session CM360 Creative IDsessionCm360CreativeName
SESSION CM360 Творческое имяsessionCm360CreativeType
Session Cm360 Творческий типsessionCm360CreativeTypeId
Session CM360sessionCm360CreativeVersion
Session CM360 Творческая версияsessionCm360Medium
Session CM360 средаsessionCm360PlacementCostStructure
SESSION CM360 Структура стоимости размещенияsessionCm360PlacementId
Session CM360 ID размещенияsessionCm360PlacementName
SESSION CM360 Имя размещенияsessionCm360RenderingId
Session Cm360 ID рендерингsessionCm360SiteId
Session CM360 ID сайтаsessionCm360SiteName
Session CM360 Имя сайтаsessionCm360Source
Session CM360 SourcesessionCm360SourceMedium
session CM360 Source / Medium
Google Display & Video 360 (DV360) Размеры интеграции:
dv360AdvertiserId
DV360 идентификатор рекламодателяdv360AdvertiserName
DV360 Имя рекламодателяdv360CampaignId
DV360 ID кампанииdv360CampaignName
DV360 Название кампанииdv360CreativeFormat
DV360 Творческий форматdv360CreativeId
DV360 Creative IDdv360CreativeName
DV360 Творческое имяdv360ExchangeId
DV360 Exchange IDdv360ExchangeName
DV360 Exchange Имяdv360InsertionOrderId
DV360 ID вставкиdv360InsertionOrderName
DV360 Имя заказа заказаdv360LineItemId
DV360 ID строкиdv360LineItemName
DV360dv360Medium
DV360 средаdv360PartnerId
DV360 ID партнераdv360PartnerName
DV360 Имя партнераdv360Source
DV360 Источникdv360SourceMedium
DV360 Source / MediumfirstUserDv360AdvertiserId
First User DV360 идентификатор рекламодателяfirstUserDv360AdvertiserName
Первый пользователь DV360 Имя рекламодателяfirstUserDv360CampaignId
Первый пользователь DV360 идентификатор кампании DV360firstUserDv360CampaignName
First User DV360 Имя кампанииfirstUserDv360CreativeFormat
First User Dv360 Creative FormatfirstUserDv360CreativeId
Первый пользователь DV360 Creative IDfirstUserDv360CreativeName
Первый пользователь DV360 Творческое имяfirstUserDv360ExchangeId
первого пользователя DV360 ID Exchange IDfirstUserDv360ExchangeName
First User DV360 Exchange ИмяfirstUserDv360InsertionOrderId
Первый пользователь DV360 идентификатор порядок вставкиfirstUserDv360InsertionOrderName
Первый пользователь DV360 Имя заказа заказаfirstUserDv360LineItemId
Первый пользователь DV360 идентификатор строки линииfirstUserDv360LinteItemName
First User DV360firstUserDv360Medium
First User DV360 MediumfirstUserDv360PartnerId
First User DV360 ID партнераfirstUserDv360PartnerName
First User DV360 Имя партнераfirstUserDv360Source
First User DV360 SourcefirstUserDv360SourceMedium
Первый пользователь DV360 Source / MediumsessionDv360AdvertiserId
Session DV360 идентификатор рекламодателяsessionDv360AdvertiserName
Session DV360 Имя рекламодателяsessionDv360CampaignId
Session DV360 идентификатор кампанииsessionDv360CampaignName
Session DV360 Название кампанииsessionDv360CreativeFormat
Session DV360 Творческий форматsessionDv360CreativeId
Session DV360 Creative IDsessionDv360CreativeName
SESSION DV360 Творческое названиеsessionDv360ExchangeId
Session DV360 Exchange IDsessionDv360ExchangeName
Session DV360 Имя обменаsessionDv360InsertionOrderId
Session DV360 ID ЗаказаsessionDv360InsertionOrderName
Session DV360 Имя заказа заказаsessionDv360LineItemId
Session DV360 ID позицииsessionDv360LineItemName
Session DV360sessionDv360Medium
Session DV360 СредаsessionDv360PartnerId
Session DV360 ID партнераsessionDv360PartnerName
Session DV360 Имя партнераsessionDv360Source
Session DV360 SourcesessionDv360SourceMedium
Session DV360 Source / Medium
Google Search Ads 360 (SA360) Размеры интеграции:
firstUserSa360AdGroupId
Первый пользователь SA360 идентификатор группы объявленийfirstUserSa360AdGroupName
Первый пользователь SA360 AD Имя группыfirstUserSa360CampaignId
First User Id CampaignfirstUserSa360CampaignName
Первый пользователь SA360 КампанияfirstUserSa360CreativeFormat
Первый пользователь SA360 Creative FormatfirstUserSa360EngineAccountId
First User SA360 идентификатор учетной записи двигателяfirstUserSa360EngineAccountName
первого пользователя SA360 Имя учетной записи двигателяfirstUserSa360EngineAccountType
первого пользователя SA360firstUserSa360KeywordText
Первый пользователь SA360 Текст ключевого словаfirstUserSa360ManagerAccountId
Первый пользователь SA360 идентификатор учетной записи менеджераfirstUserSa360ManagerAccountName
Первый пользователь SA360 Manager Имя учетной записиfirstUserSa360Medium
Первый пользователь SA360 MediumfirstUserSa360Query
Первый пользователь SA360 запросfirstUserSa360Source
First User SARESE SA360firstUserSa360SourceMedium
Первый пользователь SA360 Source / Mediumsa360AdGroupId
SA360 AD Group IDsa360CampaignId
SA360 ID кампанииsa360AdGroupName
SA360 AD Group Названиеsa360CampaignName
SA360 Кампанияsa360CreativeFormat
SA360 Творческий форматsa360EngineAccountId
SA360 идентификатор аккаунта двигателяsa360EngineAccountName
SA360 Имя учетной записи двигателяsa360EngineAccountType
SA360 Тип учетной записи двигателяsa360KeywordText
SA360 Текст ключевого словаsa360ManagerAccountId
SA360 Manager Id Accountsa360ManagerAccountName
SA360 Имя учетной записи менеджераsa360Medium
SA360 средаsa360Query
SA360 Запросsa360Source
SA360 Источникsa360SourceMedium
SA360 Source / MediumsessionSa360AdGroupId
SESSION SA360 AD GROUP IDsessionSa360CampaignId
Session Search ID кампанииsessionSa360ManagerAccountId
Session SeshipsessionSa360ManagerAccountName
Session SA360 Имя учетной записи менеджераsessionSa360SourceMedium
SESSION SA360 Source / Medium
2024-03-06 Неактивная пользовательская аудитория поддерживает экспорт аудитории.
Экспорт аудитории лучше поддерживает экспорт неактивной пользовательской аудитории. Пользователи вводят эту аудиторию без квалификационного события; Например, пользователь может ввести аудиторию, не посещая ваш сайт в течение семи дней. Примеры неактивной пользовательской аудитории включают «7-дневные неактивные покупатели», «7-дневные неактивные пользователи» и «7-дневные незамеченные пользователи». Чтобы узнать больше об этой предложенной аудитории, см. Предлагаемую аудиторию .
2024-02-28 Экспорт аудитории возвращает идентификатор пользователя, указанный при теги.
Экспорт аудитории теперь возвращает идентификатор пользователя, указанный при теге, даже если предоставленные пользователем данные включены для вашего свойства. Если включен сбор данных, предоставленные пользователем, предоставленные пользователями данные вместе с пользователем идентификацией могут быть отправлены в Google Analytics при теге для улучшения измерения. Чтобы узнать больше, см. Пользовательский сбор данных .
2024-01-30 Уведомления Webhook. Поддержка списков аудитории, повторяющиеся списки аудитории в API Data V1 Alpha.
AudienceList.webhookNotification
и RecurringAudienceList.webhookNotification
Поля могут быть указаны при создании списка аудитории (с использованием свойств. Audiencelists.create ) или повторяющегося списка аудитории (с использованием Properties.recurringudiencelists.create ).
Эта функциональность позволяет вам асинхронно получать уведомления WebHook, когда список аудитории становится доступным.
2024-01-18 Улучшенная совместимость для размеров, которые включают в себя строку запроса или минутный компонент.
Размеры, которые включают строку запроса, теперь совместимы с большинством полей. Такие размеры, как pagePathPlusQueryString
, unifiedPageScreen
, pageLocation
и fullPageUrl
в настоящее время совместимы со многими дополнительными областями, включая sessionSource
, browser
, city
и landingPage
.
Размеры, которые включают в себя минутный компонент, теперь совместимы с большинством полей. Размеры, такие как minute
, nthMinute
и dateHourMinute
теперь совместимы с аналогичным набором дополнительных полей.
См. Измерения GA4 и исследователь метрик для комплексной информации о совместимости.
2023-12-13 Пользовательские параметры обзорного элемента
Пользовательские пользовательские размеры теперь могут быть включены в аналитические запросы API данных с использованием следующего синтаксиса:
Общее имя API | Описание |
---|---|
CustomItem: parameter_name | Пользовательский измерение на предмет PARATEREMER_NAME |
См. Размеры и метрики API для получения дополнительной информации.
2023-12-05 Списки аудитории доступны в бета-версии API V1 в качестве экспорта аудитории
Функция списков аудитории была переименована в экспорт аудитории и добавлена в бета -версию Data V1.
Добавлены следующие методы в бета -версию API V1:
2023-11-28 добавил samplingMetadatas
для сообщений о ответе
Добавлено samplingMetadatas
в ResponseMetaData
. Эта коллекция будет содержать SampleMetadata
для каждого диапазона дат в запросе, для которого были отобраны результаты. Google Analytics будет применять выборку только в том случае, если она ожидает, что ограничения кардинальности снижают качество данных.
2023-11-28 Добавлены повторяющиеся функции экспорта списка аудитории в API V1 Data V1
Добавлены properties.recurringAudienceLists.create
, properties.recurringAudienceLists.create
, properties.recurringAudienceLists.list
Методы данных API v1 alpha.
Эта функциональность позволяет вам ежедневно производить списки аудитории по мере изменения членства в аудитории. Повторяющиеся списки аудитории гарантируют, что вы работаете с самыми свежими результатами членства в аудитории.
2023-11-08 Добавлен экспорт списка аудитории в функциональность листов в API V1 API V1
Добавлены метод properties.audienceLists.exportSheet
в API Data V1 Alpha, который позволяет вам экспортировать список аудитории в Google Sheets.
2023-10-13 Добавлена поддержка аудитории с продолжительностью членства в 1 день
Аудитория с продолжительностью членства в течение 1 дня теперь поддерживается списками аудитории, функциональными экспортами .
2023-09-12 Правила заказа по умолчанию по умолчанию
По умолчанию отчеты, созданные с использованием аудитории, перечисляют функциональность экспорта, следуют тем же правилам упорядочения, что и другие методы отчетности API данных: упорядочение будет спускаться по первым столбцам, а затем спускается по вторым столбцам и т. Д.
Перед этим изменением вы могли бы получить следующий отчет:
DeviceId | IsadspersonalizationAllowed |
---|---|
АВС | истинный |
Цем | ЛОЖЬ |
АВС | ЛОЖЬ |
ААА | истинный |
После этого изменения вы получите следующий отчет:
DeviceId | IsadspersonalizationAllowed |
---|---|
ААА | истинный |
АВС | ЛОЖЬ |
АВС | истинный |
Цем | ЛОЖЬ |
2023-08-15 Добавлены измерение isLimitedAdTracking
в список экспорта списка аудитории
isLimitedAdTracking
ограниченная настройка отслеживания объявлений устройства. Возможные значения включают в себя:true
,false
и(not set)
.Чтобы узнать больше, увидеть измерения списка аудитории .
2023-08-15 Добавленное измерение currencyCode
, метрика itemDiscountAmount
currencyCode
локальный код валюты (на основе стандарта ISO 4217) события электронной коммерции. Например, «USD» или «GBP».itemDiscountAmount
Монетарная стоимость скидок на элементы в событиях электронной коммерции. Этот показатель заполняется в помечении параметром элемента «скидка».
Чтобы узнать больше, см. Схему отчетности API данных .
2023-08-10 Добавлены измерение isAdsPersonalizationAllowed
в список экспорта списка аудитории
isAdsPersonalizationAllowed
- это персонализация рекламы. Если пользователь имеет право на рекламу персонализацииisAdsPersonalizationAllowed
возвращаетtrue
. Если пользователь не имеет права на персонализацию рекламы,isAdsPersonalizationAllowed
возвращаетfalse
.Чтобы узнать больше, увидеть измерения списка аудитории .
2023-07-10 Списки аудитории
Аудитория перечисляет поддержку, добавленную в API Data V1 Alpha. Списки аудитории включают в себя снимок пользователей в аудитории во время создания списка аудитории.
Следующие методы, добавленные в API Data V1 Alpha:
2023-05-19 пользовательских групп каналов
Пользовательские группы каналов поддерживают добавленные в API данных.
2023-05-11 изменений квоты токенов.
Система квот 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 Properties
Название квоты | Старый предел | Новый предел |
---|---|---|
Ядры токены на недвижимость в день | 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 Year. Объединенные значенияisoWeek
иisoYear
. Пример значения включают201652
и201701
.yearMonth
год месяц. Объединенные значенияyear
иmonth
. Пример значения включают202212
или202301
.yearWeek
год недели. Объединенные ценностиyear
иweek
. Пример значения включают202253
или202301
.
2023-02-27 Добавлены размеры электронной коммерции.
itemListPosition
ITEM СПИСОК ПОЛОЖЕНИЕ. Положение предмета (например, продукт, который вы продаете) в списке. Это измерение заполняется в помечении параметром «индекс» в массиве элементов.itemLocationID
It ID местоположения. Физическое местоположение, связанное с предметом (например, местоположение физического магазина). Рекомендуется использовать идентификатор Google Place , который соответствует соответствующему элементу. Также можно использовать пользовательский идентификатор местоположения. Это поле заполняется в помечении параметром «location_id» в массиве элементов.itemPromotionCreativeSlot
lete Promotion Creative Plot. Название рекламного творческого слота, связанного с предметом. Это измерение может быть указано при теге с помощью параметраcreative_slot
на уровне событий или элемента. Если параметр указан как на уровне событий, так и на уровне элемента, используется параметр уровня элемента.
2023-02-21 Добавлена «Целевая страница + строка запроса».
-
landingPagePlusQueryString
Целевая страница + строка запроса. Строка PARE + PARE + запрос, связанный с первым просмотром страниц в сеансе.
Это поле заменяет измерение landingPage
, которое устарело и будет обновлено, чтобы не возвращать строку запроса 14 мая 2023 года.
2023-01-28 Добавлены «представления на пользователя», «Прокрученные пользователи».
screenPageViewsPerUser
Views на одного пользователя. Количество экранов приложений или веб -страниц, которые ваши пользователи просмотрели на активного пользователя. Подсчитаны повторные представления одной страницы или экрана.(screen_view + page_view events) / active users
.scrolledUsers
пользователи прокручивали пользователей. Количество уникальных пользователей, которые прокрутили не менее 90% страницы.
2023-01-23 Добавлены «Континент», «Идентификатор континента».
continent
. Континент, с которого возникла активность пользователя. Например,Americas
илиAsia
.continentId
идентификатор континента. Географический идентификатор континента, с которого возникла активность пользователя, получен из их IP -адреса.
2023-01-23 Добавлены измерение «Идентификатор фильтра данных».
-
testDataFilterId
Test Data Id. Целый идентификатор фильтра данных в состоянии тестирования. Вы используете фильтры данных для включения или исключения данных о событиях из ваших отчетов на основе значений параметра событий. Чтобы узнать больше, см . Https://support.google.com/analytics/answer/10108813 .
2022-10-18 Добавлены метрики рекламы.
-
advertiserAdClicks
Ads Clicks. Общее количество раз, когда пользователи нажимали на рекламу, чтобы достичь свойства. -
advertiserAdCost
стоимость рекламы. Общая сумма, которую вы заплатили за свои объявления. -
advertiserAdCostPerClick
Ads стоимость за клик. Стоимость рекламы за клик - это стоимость рекламы, разделенная на рекламные клики, и часто является сокращенным CPC. -
advertiserAdCostPerConversion
Стоимость конвертации. Стоимость за конверсию - это стоимость рекламы, разделенная на конверсии. -
advertiserAdImpressions
впечатления от рекламы. Общее количество впечатлений. -
returnOnAdSpend
return на рекламу. Возврат на рекламу (ROAS) - это общий доход, разделенный на рекламные расходы.
2022-10-17 Добавлены метрики с обширным элементом.
-
itemsAddedToCart
элементы добавлены в корзину. Количество единиц, добавленных в корзину для одного предмета. -
itemsCheckedOut
предметы проверены. Количество подразделений проверяется на один элемент. -
itemsClickedInList
Items, нажимающие в списке. Количество единиц, щелкнувших в списке для одного элемента. -
itemsClickedInPromotion
Itsement нажали на продвижение по службе. Количество единиц, нажавших на акцию для одного элемента. -
itemsViewed
элементы. Количество единиц, просмотренных для одного элемента. -
itemsViewedInList
Элементы, просмотренные в списке. Количество единиц, просмотренных в списке для одного элемента. -
itemsViewedInPromotion
пункты, просмотренные в продвижении. Количество единиц, просмотренных в продвижении по службе для одного элемента.
2022-09-13 Объявление о совместимости схемы.
1 декабря 2022 года произойдут следующие нарушительные изменения:
Размеры, такие как элементы, такие как
itemName
становятся несовместимыми с такими показателями, какeventCount
. Размеры с общепринятыми элементами по-прежнему будут совместимы с метриками, такими какitemRevenue
, пользовательские метрики, такие какactiveUsers
, и метрики на основе сеансов, такие какsessions
.Размеры атрибуции, такие как
source
становятся несовместимыми с некоторыми показателями, такими какeventCount
. Attribution dimensions will still be compatible with attributable metrics likeconversions
, user-based metrics likeactiveUsers
, and session-based metrics likesessions
.Dimensions that include the query string like
pagePathPlusQueryString
will only be compatible with a limited set of dimensions & metrics.
To learn more, see the detailed explanation of compatibility changes .
2022-09-01 Quota changes.
Requests per day
,Requests Per Minute
,Requests Per Minute Per User
quotas are removed from the Data API.Tokens Per Project Per Property Per Hour
quota has been added to the API.Each request consumes quota for both
Tokens Per Property Per Hour
andTokens Per Project Per Property Per Hour
.See the Quotas documentation for the detailed information on new quotas.
2022-08-03 Added session scoped SA360 dimensions.
sessionSa360AdGroupName
Session SA360 ad group name. The Ad Group name from Search Ads 360 that led to this session.sessionSa360CampaignName
Session SA360 campaign. The Campaign name from Search Ads 360 that led to this session.sessionSa360CreativeFormat
Session SA360 creative format. The type of creative in Search Ads 360 that led to this session. For example, 'Responsive search ad' or 'Expanded text ad'.sessionSa360EngineAccountId
Session SA360 engine account ID. The ID of the engine account in SA360 that led to this session.sessionSa360EngineAccountName
Session SA360 engine account name. The name of the engine account in SA360 that led to this session.sessionSa360EngineAccountType
Session SA360 engine account type. The type of the engine account in Search Ads 360 that led to this session. For example, 'google ads', 'bing', or 'baidu'.sessionSa360Keyword
Session SA360 keyword text. The search engine keyword from Search Ads 360 that led to this session.sessionSa360Medium
Session SA360 medium. The search engine keyword from Search Ads 360 that led to this session. For example, 'cpc'.sessionSa360Query
Session SA360 query. The search query from Search Ads 360 that led to this session.sessionSa360Source
Session SA360 source. The source of the traffic from Search Ads 360 that led to this session. For example, 'example.com' or 'google'.sessionCampaignId
,sessionCampaignName
dimensions now support Search Ads 360 campaigns.
2022-07-11 Added conversion rate metrics.
Коэффициент конверсии
sessionConversionRate
The percentage of sessions in which any conversion event was triggered.userConversionRate
The percentage of users who triggered any conversion event.
Conversion Rate Metrics For One Conversion
sessionConversionRate:event_name
The percentage of sessions in which a specific conversion event was triggered.userConversionRate:event_name
The percentage of users who triggered a specific conversion event.
2022-05-05 Added Funnel reporting functionality to the Alpha channel.
runFunnelReport
method added to the v1alpha version of the API, which returns a customized funnel report of your Google Analytics event data.This method is introduced at alpha stability with the intention of gathering feedback on syntax and capabilities before entering beta. Please complete the Google Analytics Data API Funnel Reporting Feedback to give your feedback on this API.
2022-02-16 Added new dimensions.
Manual term & content
firstUserManualAdContent
First user manual ad content. The ad content that first acquired the user. Populated by theutm_content
parameter.firstUserManualTerm
First user manual term. The term that first acquired the user. Populated by theutm_term
parameter.manualAdContent
Manual ad content. The ad content attributed to the conversion event. Populated by theutm_content
parameter.manualTerm
Manual term. The term attributed to the conversion event. Populated by theutm_term
parameter.sessionManualAdContent
Session manual ad content. The ad content that led to a session. Populated by theutm_content
parameter.sessionManualTerm
Session manual term. The term that led to a session. Populated by theutm_term
parameter.
Crash analysis
crashAffectedUsers
Crash-affected users. The number of users that logged a crash in this row of the report.crashFreeUsersRate
Crash-free users rate.
App/Web
averageSessionDuration
The average duration (in seconds) of users' sessions.newVsReturning
New / returning users.screenPageViewsPerSession
Views per session.landingPage
Landing page. The page path + query string associated with the first pageview in a session.platformDeviceCategory
The platform and type of device on which your website or mobile app ran.
Mobile App
averagePurchaseRevenuePerUser
Average purchase revenue per user.firstTimePurchaserConversionRate
The percentage of active users who made their first purchase.firstTimePurchasersPerNewUser
The average number of first time purchasers per new user.dauPerMau
DAU / MAU. The rolling percent of 30-day active users who are also 1-day active users.dauPerWau
DAU / WAU. The rolling percent of 7-day active users who are also 1-day active users.wauPerMau
WAU / MAU. The rolling percent of 30-day active users who are also 7-day active users.purchaserConversionRate
The percentage of active users who made 1 or more purchase transactions.transactionsPerPurchaser
Transactions per purchaser.
Google Ads campaign
firstUserGoogleAdsCampaignType
The campaign type of the Google Ads campaign that first acquired the user.googleAdsCampaignType
The campaign type for the Google Ads campaign attributed to the conversion event.sessionGoogleAdsCampaignType
The campaign type for the Google Ads campaign that led to this session.
2021-09-07 Added new Date/time dimensions.
dateHourMinute
The combined values of date, hour, and minute formatted as YYYYMMDDHHMM.minute
The two-digit minute of the hour that the event was logged.nthMinute
The number of minutes since the start of the date range.
2021-09-07 Added new dimensions populated by event parameters.
achievementId
The achievement ID in a game for an event.character
The player character in a game for an event.fileExtension
The extension of the downloaded file.fileName
The page path of the downloaded file.groupId
The player group ID in a game for an event.linkClasses
The HTML class attribute for an outbound link.linkDomain
The destination domain of the outbound link.linkId
The HTML id attribute for an outbound link or file download.linkText
The link text of the file download.linkUrl
The full url for an outbound link or file download.method
The method by which an event was triggered.outbound
Returns 'true' if the link leads to a site is not a part of the property's domain.pageLocation
The protocol, hostname, page path, and query string for web pages visited.pageReferrer
The full referring URL including the hostname and path.percentScrolled
The percentage down the page that the user has scrolled (for example, '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 therunRealtimeReport
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 tofirstUserGoogleAdsCreativeId
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 theproperty
parameter of the URL path instead of theentity
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 to100000
. 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.