На этой странице документируются изменения, внесенные во все API и SDK Google Analytics. Он включает журналы изменений для всего сбора, отчетности и конфигурации. Мы рекомендуем вам периодически проверять этот список на наличие новых объявлений. Вы также можете подписаться на изменения через каналы, перечисленные в разделе «Подписка» ниже.
Подпишитесь на соответствующие журналы изменений
Включает все API сбора, настройки и отчетности.
Core Reporting API — выпуск от 19 марта 2019 г. (19 марта 2019 г.)
Это первый выпуск API активности пользователей.
- API активности пользователей позволяет получать все данные, связанные с одним идентификатором клиента или идентификатором пользователя, за определенный диапазон дат. В первую очередь он предназначен для поддержки владельцев собственности, которые хотят предоставить автоматический доступ к данным пользователя непосредственно этому пользователю. Для получения более подробной информации посетите Руководство по API активности пользователей .
API управления – выпуск от 17 июля 2018 г. (17 июля 2018 г.)
Метод hashClientId добавлен в Management API.
Метод hashClientId предоставляет хеш данного идентификатора клиента, который можно найти в определенных форматах экспортируемых данных, например в данных Google Analytics, экспортированных в BigQuery .
API управления — выпуск от 11 мая 2018 г. (11 мая 2018 г.)
Настройки хранения пользовательских данных в Management API
Теперь можно программно настроить параметры хранения пользовательских данных, используя новые поля dataRetentionTtl и dataRetentionResetOnNewActivity, добавленные в ресурс WebProperty .
API удаления пользователей — выпуск 2018-05 (10 мая 2018 г.)
Это первоначальная версия API удаления пользователей:
- API удаления пользователей позволяет клиенту Google Analytics удалять данные определенного конечного пользователя из проекта или веб-ресурса. Запросы на удаление пользователей можно отправлять с помощью проектов Firebase или свойств Google Analytics. Посетите обзор API удаления пользователей для получения более подробной информации.
Management API – выпуск от 22 февраля 2018 г. (22 февраля 2018 г.)
Операции записи в Management API
Операции записи в Management API (например, создание, обновление, удаление, исправление) для ресурсов веб-ресурса, представления (профиля) и цели больше не требуют внесения в белый список. Дневной лимит по умолчанию для всех операций записи в Management API составляет 50 операций записи в день. Дополнительную информацию см. на странице «Лимиты и квоты» .
Core Reporting API — выпуск от 23 января 2018 г. (23 января 2018 г.)
В этом выпуске система квот на основе ресурсов для Google Analytics Reporting API v4 доступна всем клиентам Analytics 360 (Премиум).
API отчетов в реальном времени — выпуск от 29 ноября 2017 г. (29 ноября 2017 г.)
В этом выпуске внесены изменения в квоты и ограничения API Analytics Real Time .
Вызовы API отчетов Analytics в реальном времени используются для достижения лимита в 10 000 вызовов на представление (профиль) в день наравне с другими вызовами API Analytics. Теперь вызовы Analytics Real Time Reporting API учитываются отдельно, что означает, что можно совершать 10 000 вызовов в день для каждого представления (профиля) с помощью Analytics Real Time Reporting API И делать еще 10 000 вызовов в день для каждого представления (профиля) с помощью любого другого Аналитические API. Дополнительную информацию см. на странице «Лимиты и квоты» .
Это изменение обеспечивает более детальный и надежный подход к управлению квотами, поэтому частые вызовы с использованием API отчетов в реальном времени Analytics не будут случайно блокировать все другие вызовы API аналитики на оставшуюся часть дня для отдельного профиля.
Core Reporting API — выпуск 29 ноября 2017 г. (29 ноября 2017 г.)
В этом выпуске увеличено максимальное количество строк, возвращаемых в наборе результатов Analytics Reporting API v4.
Максимальное количество строк, возвращаемых в объекте ReportData Analytics Reporting API v4, увеличено с 10 000 до 100 000.
Core Reporting API — выпуск 31 октября 2017 г. (31 октября 2017 г.)
В этом выпуске добавлена предварительная версия системы квот на основе ресурсов для Google Analytics Reporting API v4, которая позволяет использовать более высокие пороговые значения выборки для клиентов Analytics 360 (Премиум).
Веб-отслеживание (analytics.js) – выпуск от 21 сентября 2017 г. (21 сентября 2017 г.)
Добавлены URL-адреса «android-app://» в качестве допустимого источника перехода.
Веб-отслеживание (analytics.js) – выпуск от 12 июля 2017 г. (12 июля 2017 г.)
В этом выпуске добавлена новая задача customTask .
Core Reporting API – выпуск от 2 июня 2017 г. (2 июня 2017 г.)
В этом выпуске прекращена поддержка функции «Сопутствующие товары» , а также связанных с ней параметров и показателей; Полный список определений см. в Справочнике по параметрам и показателям . Ознакомьтесь с Политикой устаревания данных для получения подробной информации об удалении данных:
Сопутствующие товары
В этом выпуске больше не поддерживаются следующие параметры и показатели:
-
ga:correlationModelId
-
ga:queryProductId
-
ga:queryProductName
-
ga:queryProductVariation
-
ga:relatedProductId
-
ga:relatedProductName
-
ga:relatedProductVariation
-
ga:correlationScore
-
ga:queryProductQuantity
-
ga:relatedProductQuantity
API управления – выпуск от 19 апреля 2017 г. (19 апреля 2017 г.)
Аудитория ремаркетинга – поддержка оптимизации
В этом выпуске добавлена поддержка Google Optimize и OPTIMIZE
в качестве типа связанного рекламного аккаунта. Подробную информацию см. в справочной документации по Аудитории ремаркетинга и в руководстве разработчика по Аудитории ремаркетинга .
Core Reporting API — выпуск от 11 апреля 2017 г. (11 апреля 2017 г.)
В этом выпуске к API добавлено новое измерение; Полный список определений см. в Справочнике по параметрам и метрикам . В этом выпуске также удалено несколько устаревших параметров и показателей; ознакомьтесь с Политикой устаревания данных для API Google Analytics, чтобы понять весь процесс удаления данных.
Время
- Новое измерение
ga:dateHourMinute
, которое объединяетga:date
,ga:hour
иga:minute
.
Удаление данных
В этом выпуске удалены следующие устаревшие параметры и показатели:
-
ga:socialactivities
-
ga:socialactivityaction
-
ga:socialactivitydisplayname
-
ga:socialactivityendorsingurl
-
ga:socialactivitynetworkaction
-
ga:socialactivitypost
-
ga:socialactivitytagssummary
-
ga:socialactivitytimestamp
-
ga:socialactivityuserhandle
-
ga:socialactivityuserphotourl
-
ga:socialactivityuserprofileurl
-
ga:socialinteractionspervisit
API управления — выпуск 23 марта 2017 г. (23 марта 2017 г.)
Аудитория ремаркетинга
В этом выпуске к ресурсу «Аудитория ремаркетинга» добавлена команда DELETE
. Подробную информацию см. в руководстве для разработчиков «Аудитории ремаркетинга» .
- Аудитория ремаркетинга: удалить — удаляет аудиторию ремаркетинга.
Core Reporting API – выпуск от 8 марта 2017 г. (8 марта 2017 г.)
В этом выпуске обновляются существующие метрики и параметры API. Полный список определений см. в Справочнике по измерениям и метрикам .
Пользовательские метрики
Расчет показателей «Пользователи» и «Активные пользователи» был обновлен для более эффективного подсчета пользователей. Вы можете увидеть небольшое изменение в своих показателях. Дополнительную информацию см. в разделе «Как пользователи идентифицируются по пользовательским метрикам» .
Пользовательские показатели, на которые влияет обновление расчета:
-
ga:users
— общее количество пользователей за запрошенный период времени. -
ga:1dayusers
— общее количество активных пользователей за 1 день за каждый день запрошенного периода времени. -
ga:7dayusers
— общее количество активных пользователей за 7 дней за каждый день запрошенного периода времени. -
ga:14dayusers
— общее количество активных пользователей за 14 дней за каждый день запрошенного периода времени. -
ga:30dayusers
— общее количество активных пользователей за 30 дней за каждый день запрошенного периода времени.
Уникальные события
Срок прекращения поддержки ga:uniqueEvents
приближается к концу. После 26 марта 2017 г. определение ga:uniqueEvents
будет обновлено, а частная метрика ga:uniqueEventsTemporary
будет удалена из API. Дополнительную информацию см. в справочной документации по уникальным событиям .
Core Reporting API — выпуск от 14 февраля 2017 г. (14 февраля 2017 г.)
В этом выпуске добавлено новое измерение в API, улучшены сообщения об ошибках и введено в действие ранее объявленные изменения для параметров и показателей AdSense.
Размеры пользователя
- Измерение —
ga:userBucket
— для любого пользователя измерение «Пользовательский сегмент» (значения от 1 до 100) указывает сегмент, к которому назначен пользователь. Подробности читайте в статье «Тестирование кампаний ремаркетинга» .
Сообщения об ошибках
Если раньше API возвращал ошибочное сообщение об ошибке: Unknown dimension(s):
или Unknown metric(s):
при запросе данных с условиями, которые не были выполнены, теперь API возвращает сообщение: Restricted metric(s): ... can only be queried under certain conditions.
Параметры и показатели AdSense
Связанным представлениям, не связанным с AdSense, будет запрещено запрашивать параметры и показатели AdSense. Запрос этих параметров и показателей с помощью связанных представлений, не связанных с AdSense, приведет к ошибке.
Management API – выпуск от 09 февраля 2017 г. (9 февраля 2017 г.)
Пользовательские метрики
Это выпуск с исправлением ошибок; он устраняет проблему, из-за которой не удавалось создать специальную метрику типа TIME
, если min_value
не было установлено. Запросы без min_value
теперь создают пользовательскую метрику с min_value
по умолчанию, равным 0 .
Core Reporting API — выпуск от 11 января 2017 г. (11 января 2017 г.)
Это выпуск с исправлением ошибок, который устраняет проблему с параметрами и показателями AdSense и объявляет о предстоящих изменениях в этих параметрах и показателях.
Параметры и показатели AdSense
В этом выпуске исправлена проблема, возникшая 7 января 2017 г., из-за которой запрос параметров и показателей AdSense возвращал ошибку «Неизвестный показатель» для связанных представлений, не связанных с AdSense.
Грядущие изменения
С 31 января 2017 г. или после этой даты для связанных представлений, не связанных с AdSense, будет запрещено запрашивать параметры и показатели AdSense. Запрос этих параметров и показателей с помощью связанных представлений, не связанных с AdSense, приведет к ошибке.
Core Reporting API — выпуск от 12 октября 2016 г. (12 октября 2016 г.)
В этом выпуске в API добавлена следующая новая метрика. Полный список определений см. в Справочнике по измерениям и метрикам .
Расчетные метрики
В этом выпуске добавлена поддержка вычисляемых метрик .
- Метрика —
ga:calcMetric_
- Значение запрошенной вычисляемой метрики, где относится к определяемому пользователем имени вычисляемой метрики. Обратите внимание, что тип данных ga:calcMetric_
может быть FLOAT, INTEGER, CURRENCY, TIME или PERCENT. Подробности см. в разделе О вычисляемых метриках .
Core Reporting API — выпуск от 26 сентября 2016 г. (26 сентября 2016 г.)
В этом выпуске в API добавлена новая метрика. Это также делает устаревшей существующую метрику. Полный список определений см. в Справочнике по измерениям и метрикам .
Отслеживание событий
Определение ga:uniqueEvents
изменится, чтобы более точно отражать количество уникальных событий. Чтобы повлиять на это изменение, мы технически упраздним текущую метрику ga:uniqueEvents
в соответствии с нашей политикой прекращения поддержки данных . Если вы хотите опробовать новое определение, вы можете воспользоваться частной метрикой ga:uniqueEventsTemporary
, которая более точно рассчитывает количество уникальных событий. Мы также представим новую метрику ga:uniqueDimensionCombinations
, которая сохранит текущее определение ga:uniqueEvents
. По истечении надлежащего периода прекращения поддержки (приблизительно 6 месяцев) частная метрика ga:uniqueEventsTemporary
будет удалена, а исходная метрика ga:uniqueEvents
будет правильно представлять количество уникальных событий. Дополнительную информацию см. в справочных документах по уникальным событиям .
Уникальные события
- Метрика —
ga:uniqueEvents
— определениеga:uniqueEvents
скоро изменится, чтобы более точно отражать количество уникальных событий. Вместо этого используйтеga:uniqueDimensionCombinations
если вы хотите сохранить существующее определение. Дополнительную информацию см. в справочной документации по уникальным событиям . - Метрика —
ga:uniqueDimensionCombinations
— Уникальные комбинации измерений подсчитывает количество уникальных комбинаций измерений и значений для каждого измерения в отчете. Это позволяет создавать постобработку комбинированных (объединенных) измерений, что позволяет создавать более гибкие отчеты без необходимости обновлять реализацию отслеживания или использовать дополнительные слоты для специальных измерений. Дополнительную информацию см. в справочной документации по уникальным событиям .
Тестирование перехода – частное
- Метрика —
ga:uniqueEventsTemporary
— количество уникальных событий; это будет новое определение дляga:uniqueEvents
. Вы можете использовать эту метрику, чтобы понять новое определение до внесения изменений. Обратите внимание, что этот показатель является частным и не будет отображаться в Справочнике по измерениям и метрикам .
iOS SDK — выпуск версии 3.17 (12 сентября 2016 г.)
Этот выпуск содержит:
Гугл Аналитика
- Совместимость с iOS 10 и исправления ошибок.
iOS SDK — выпуск версии 3.16 (10 августа 2016 г.)
Этот выпуск содержит:
Гугл Аналитика
- Исправления сбоев.
Core Reporting API – выпуск от 09 августа 2016 г. (9 августа 2016 г.)
В этом выпуске в API добавлены новые параметры и показатели. Полный список определений см. в Справочнике по измерениям и метрикам .
Менеджер ставок DoubleClick
- Измерение –
ga:dbmClickAdvertiser
– имя рекламодателя DBM для клика DBM, соответствующего сеансу Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmClickAdvertiserId
– идентификатор рекламодателя DBM для клика DBM, соответствующего сеансу Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmClickCreativeId
– идентификатор объявления DBM для клика DBM, соответствующего сеансу Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmClickExchange
– имя обмена DBM для клика DBM, соответствующего сеансу Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmClickExchangeId
– идентификатор обмена DBM для клика DBM, соответствующего сеансу Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmClickInsertionOrder
– название заказа на размещение в DBM для клика DBM, соответствующего сеансу Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmClickInsertionOrderId
– идентификатор заказа на размещение в DBM для клика DBM, соответствующего сеансу Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmClickLineItem
– название позиции DBM для клика DBM, соответствующего сеансу Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmClickLineItemId
– идентификатор позиции DBM для клика DBM, соответствующего сеансу Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmClickSite
– имя сайта DBM, на котором было показано объявление DBM и на который был сделан клик для клика DBM, соответствующего сеансу Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmClickSiteId
– идентификатор сайта DBM, на котором было показано объявление DBM и на который был сделан клик для клика DBM, соответствующего сеансу Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmLastEventAdvertiser
– имя рекламодателя DBM для последнего события DBM (показа или клика в окне ретроспективного анализа DBM), связанного с сеансом Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmLastEventAdvertiserId
– идентификатор рекламодателя DBM последнего события DBM (показа или клика в окне ретроспективного анализа DBM), связанного с сеансом Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmLastEventCreativeId
– идентификатор объявления DBM последнего события DBM (показ или клик в окне ретроспективного анализа DBM), связанного с сеансом Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmLastEventExchange
– имя обмена DBM последнего события DBM (показа или клика в окне ретроспективного анализа DBM), связанного с сеансом Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmLastEventExchangeId
– идентификатор обмена DBM последнего события DBM (показа или клика в окне ретроспективного анализа DBM), связанного с сеансом Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmLastEventInsertionOrder
– название заказа на размещение в DBM для последнего события DBM (показа или клика в окне ретроспективного анализа DBM), связанного с сеансом Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmLastEventInsertionOrderId
– идентификатор заказа на размещение в DBM последнего события DBM (показа или клика в окне ретроспективного анализа DBM), связанного с сеансом Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmLastEventLineItem
– название позиции DBM последнего события DBM (показа или клика в окне ретроспективного анализа DBM), связанного с сеансом Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmLastEventLineItemId
– идентификатор позиции DBM последнего события DBM (показа или клика в окне ретроспективного анализа DBM), связанного с сеансом Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmLastEventSite
– имя сайта DBM, на котором было показано объявление DBM и на котором был выполнен клик для последнего события DBM (показа или клика в окне ретроспективного анализа DBM), связанного с сеансом Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Измерение –
ga:dbmLastEventSiteId
– идентификатор сайта DBM, на котором было показано объявление DBM и на котором был выполнен клик для последнего события DBM (показа или клика в окне ретроспективного анализа DBM), связанного с сеансом Google Analytics (только для Analytics 360, требуется интеграция с DBM). - Метрика –
ga:dbmCPA
– доход от DBM (эфф. цена за конверсию) (только для Analytics 360, требуется интеграция с DBM). - Метрика –
ga:dbmCPC
– доход в DBM (эффективная цена за клик) (только для Analytics 360, требуется интеграция с DBM). - Метрика –
ga:dbmCPM
– доход от DBM (эффективная цена за тысячу показов) (только для Analytics 360, требуется интеграция с DBM). - Метрика –
ga:dbmCTR
– CTR в DBM (только для Analytics 360, требуется интеграция с DBM). - Метрика –
ga:dbmClicks
– общее количество кликов в DBM (только для Analytics 360, требуется интеграция с DBM). - Метрика –
ga:dbmConversions
– общее количество конверсий в DBM (только для Analytics 360, требуется интеграция с DBM). - Метрика —
ga:dbmCost
— стоимость DBM (только для Analytics 360, требуется интеграция с DBM). - Метрика –
ga:dbmImpressions
– общее количество показов в DBM (только для Analytics 360, требуется интеграция с DBM). - Метрика –
ga:dbmROAS
– рентабельность инвестиций в рекламу в DBM (только для Analytics 360, требуется интеграция с DBM).
Поиск DoubleClick
- Измерение –
ga:dsAdGroup
– группа объявлений DS (только для Analytics 360, требуется интеграция с DS). - Измерение –
ga:dsAdGroupId
– идентификатор группы объявлений DS (только для Analytics 360, требуется интеграция с DS). - Параметр –
ga:dsAdvertiser
– рекламодатель DS (только для Analytics 360, требуется интеграция с DS). - Измерение –
ga:dsAdvertiserId
– идентификатор рекламодателя DS (только для Analytics 360, требуется интеграция с DS). - Измерение –
ga:dsAgency
– DS Agency (только для Analytics 360, требуется интеграция с DS). - Измерение –
ga:dsAgencyId
– идентификатор агентства DS (только для Analytics 360, требуется интеграция с DS). - Измерение –
ga:dsCampaign
– DS Campaign (только для Analytics 360, требуется интеграция с DS). - Измерение –
ga:dsCampaignId
– идентификатор кампании DS (только для Analytics 360, требуется интеграция с DS). - Измерение —
ga:dsEngineAccount
— учетная запись DS Engine (только для Analytics 360, требуется интеграция с DS). - Измерение —
ga:dsEngineAccountId
— идентификатор учетной записи DS Engine (только для Analytics 360, требуется интеграция с DS). - Измерение —
ga:dsKeyword
— ключевое слово DS (только для Analytics 360, требуется интеграция с DS). - Измерение —
ga:dsKeywordId
— идентификатор ключевого слова DS (только для Analytics 360, требуется интеграция с DS). -
ga:dsCPC
— стоимость DS для рекламодателя за клик (только для Analytics 360, требуется интеграция с DS). -
ga:dsCTR
— рейтинг кликов DS (только для Analytics 360, требуется интеграция с DS). -
ga:dsClicks
– клики DS (только для Analytics 360, требуется интеграция с DS). -
ga:dsCost
– стоимость DS (только для Analytics 360, требуется интеграция с DS). -
ga:dsImpressions
— показы DS (только для Analytics 360, требуется интеграция с DS). -
ga:dsProfit
— DS Profie (только для Analytics 360, требуется интеграция с DS). -
ga:dsReturnOnAdSpend
— рентабельность инвестиций в рекламу DS (только для Analytics 360, требуется интеграция с DS). -
ga:dsRevenuePerClick
— доход DS за клик (только для Analytics 360, требуется интеграция с DS).
Management API – выпуск от 09 августа 2016 г. (9 августа 2016 г.)
Валюты
Это выпуск с исправлением ошибок; исправлена проблема, из-за которой подмножество валют поддерживалось в веб-интерфейсе Analytics, но не поддерживалось в API . В этом выпуске добавлена поддержка следующих валют:
- UAH, AED, BOB, CLP, COP, EGP, HRK, ILS, MAD, MYR, PEN, PKR, RON, RSD, SAR, SGD, VEF, LVL
Для получения дополнительной информации см.: - Справочник по представлениям (профилям) . – Статья Справочного центра «Справочник валют» .
API управления – выпуск от 8 августа 2016 г. (8 августа 2016 г.)
В этом выпуске в Management API добавлены аудитории ремаркетинга.
Аудитории ремаркетинга
API управления позволяет create
, get
, list
, update
и patch
аудитории ремаркетинга для ресурса Google Analytics. Дополнительную информацию о том, как работают аудитории ремаркетинга, можно найти в статье Справочного центра «Об аудиториях ремаркетинга в Analytics» .
API для создания отчетов по многоканальным последовательностям – выпуск от 14 июля 2016 г. (14 июля 2016 г.)
В этом выпуске API добавлено новое измерение. Полный список определений см. в Справочнике по измерениям и метрикам .
ID транзакции
- измерение —
mcf:transactionId
— идентификатор транзакции, предоставленный методом отслеживания электронной торговли, для покупки в корзине.
Core Reporting API — выпуск от 14 июля 2016 г. (14 июля 2016 г.)
В этом выпуске API добавлено новое измерение. В этом выпуске также добавлены определенные ограничения на комбинацию измерений, которые можно запрашивать вместе. Полный список определений см. в Справочнике по измерениям и метрикам .
Геосеть
- Измерение —
ga:continentId
— идентификатор континента пользователя, полученный на основе IP-адресов или географических идентификаторов пользователей.
Ограничения
Следующие измерения в следующих группах нельзя запросить с измерениями в других группах:
- Посетите группу информации о покупках
-
ga:checkoutOptions
-
ga:shoppingStage
-
- Экспериментальная группа GWO
-
ga:experimentVariant
-
ga:experimentId
-
- Группа по интересам
-
ga:interestOtherCategory
-
- Группа по рыночным интересам
-
ga:interestInMarketCategory
-
- Внутренняя группа продвижения:
-
ga:internalPromotionCreative
-
ga:internalPromotionId
-
ga:internalPromotionName
-
ga:internalPromotionPosition
-
- Группа по интересам в области брендинга:
-
ga:interestAffinityCategory
-
Core Reporting API — выпуск от 8 июля 2016 г. (8 июля 2016 г.)
В этом выпуске представлены новые ограничения и квоты. Подробности см. в документации по лимитам и квотам .
Отчеты об ошибках
В этом выпуске начинают действовать ограничения на неудачные запросы отчетов ( 5XX
).
- 10 неудачных запросов на проект на профиль в час.
- 50 неудачных запросов на проект на профиль в день.
Ограничения поворота
В этом выпуске начинают действовать ограничения на сводные запросы:
- Запрос отчета теперь может иметь максимум 2 сводных отчета .
- Поворотная точка может иметь максимум 4 измерения .
- Сводные измерения являются частью ограничения на общее количество измерений, разрешенных в запросе.
- Метрики сводной таблицы являются частью ограничения на общее количество метрик, разрешенных в запросе.
Core Reporting API — выпуск от 17 июня 2016 г. (17 июня 2016 г.)
В этом выпуске в API добавлены новые параметры и показатели. Полный список определений см. в Справочнике по измерениям и метрикам .
Геосеть
- Измерение —
ga:metroId
— трехзначный код назначенной рыночной зоны (DMA), откуда поступил трафик, полученный на основе IP-адресов или географических идентификаторов пользователей.
DoubleClick для издателей
- Метрика –
ga:dfpImpressions
. Показ объявления DFP регистрируется каждый раз, когда на веб-сайте отображается отдельное объявление. Например, если страница с двумя рекламными блоками просматривается один раз, мы отобразим два показа (связь с DFP включена, а скрыть доход от DFP не включена).» - Метрика –
ga:dfpCoverage
– охват – это процент запросов объявлений, по которым было возвращено хотя бы одно объявление. Как правило, охват может помочь определить сайты, на которых аккаунт DFP не может предоставлять таргетированную рекламу. (Показы объявлений / Общее количество запросов объявлений) * 100 (связь с DFP включена, а скрыть доход от DFP не включена).“ - Метрика –
ga:dfpMonetizedPageviews
– измеряет общее количество просмотров страниц ресурса, которые были показаны с рекламой из связанного аккаунта DFP. Обратите внимание, что на одной странице может быть несколько рекламных блоков (связь с DFP включена, а скрытие дохода от DFP не включена).» - Метрика –
ga:dfpImpressionsPerSession
– соотношение показов объявлений DFP и сеансов Analytics (показы объявлений/сеансы Analytics) (связывание с DFP включено, а скрытие доходов от DFP не включено).“ - Метрика —
ga:dfpViewableImpressionsPercent
— процент показов объявления в видимой области экрана. Показ считается показом в видимой области экрана, если он появился в браузерах пользователей и его можно увидеть (связь с DFP включена, а скрыть доход от DFP не включена).» - Метрика –
ga:dfpClicks
– количество кликов по объявлениям DFP на сайте (связывание с DFP включено, а скрытие дохода от DFP не включено).“ - Метрика –
ga:dfpCTR
– процент просмотров страниц, которые привели к клику по объявлению DFP (связь с DFP включена, а скрытие дохода от DFP не включена).“ - Метрика –
ga:dfpRevenue
– доход от DFP – это оценка общего дохода от рекламы на основе выполненных показов (связывание с DFP включено, а скрытие дохода от DFP не включено).“ - Метрика –
ga:dfpRevenuePer1000Sessions
– общий расчетный доход от объявлений DFP за 1000 сеансов Google Analytics. Обратите внимание, что этот показатель основан на сеансах на сайте, а не на показах рекламы (связь с DFP включена, а скрыть доход от DFP не включена). - Метрика —
ga:dfpECPM
— эффективная цена за тысячу просмотров страниц. Это доход DFP на 1000 просмотров страниц (связь с DFP включена, а скрыть доход от DFP не включена).“ - Метрика –
ga:backfillImpressions
. Показы для заполнения – это сумма всех показов объявлений AdSense или Ad Exchange, выполненных в качестве заполнения через DFP. О показе объявления сообщается каждый раз, когда на веб-сайте отображается отдельное объявление. Например, если страница с двумя рекламными блоками просматривается один раз, мы отобразим два показа (связь с DFP включена, а скрыть доход от DFP не включена).» - Метрика –
ga:backfillCoverage
. Покрытие заполнения – это процент запросов объявлений для заполнения, по которым вернулось хотя бы одно объявление. Как правило, охват может помочь выявить сайты, на которых учетная запись издателя не может предоставлять таргетированную рекламу. (Показы объявлений / Общее количество запросов объявлений) * 100. Если и AdSense, и Ad Exchange предоставляют рекламу для заполнения, этот показатель представляет собой средневзвешенное значение двух аккаунтов для заполнения (связывание с DFP включено, а скрытие дохода от DFP не включено)». - Метрика –
ga:backfillMonetizedPageviews
– измеряет общее количество просмотров страниц ресурса, которые были показаны хотя бы с одним объявлением из связанных аккаунтов резервного заполнения. Обратите внимание, что один монетизированный просмотр страницы может включать в себя несколько показов рекламы (связь с DFP включена, а скрытие дохода от DFP не включена).» - Метрика —
ga:backfillImpressionsPerSession
— соотношение показов объявлений для заполнения к сеансам Google Analytics (Ad Impressions/Analytics Sessions). Если и AdSense, и Ad Exchange предоставляют объявления для заполнения, этот показатель представляет собой сумму двух аккаунтов для заполнения (связь с DFP включена, а скрытие дохода от DFP не включена). - Метрика —
ga:backfillViewableImpressionsPercent
— процент показов объявлений для заполнения, которые были видимыми. Показ считается видимым показом, если он появился в браузерах пользователей и имел возможность быть увиденным. Если AdSense и Ad Exchange предоставляют рекламу для заполнения, этот показатель представляет собой средневзвешенное значение двух аккаунтов для заполнения (связь с DFP включена, а скрытие дохода от DFP не включена)». - Метрика —
ga:backfillClicks
— количество кликов по объявлениям с заполнением на сайте. Если AdSense и Ad Exchange предоставляют рекламу для заполнения, этот показатель представляет собой сумму двух аккаунтов для заполнения (связь с DFP включена, а скрытие дохода от DFP не включена). - Метрика –
ga:backfillCTR
– процент повторных показов, которые привели к клику по объявлению. Если AdSense и Ad Exchange предоставляют рекламу для заполнения, этот показатель представляет собой средневзвешенное значение двух аккаунтов для заполнения (связь с DFP включена, а скрытие дохода от DFP не включена)». - Метрика –
ga:backfillRevenue
– общий расчетный доход от объявлений для заполнения. Если AdSense и Ad Exchange предоставляют рекламу для заполнения, этот показатель представляет собой сумму двух аккаунтов для заполнения (связь с DFP включена, а скрытие дохода от DFP не включена). - Метрика –
ga:backfillRevenuePer1000Sessions
– общий расчетный доход от объявлений-заполнителей за 1000 сеансов Google Analytics. Обратите внимание, что этот показатель основан на сеансах сайта, а не на показах рекламы. Если и AdSense, и Ad Exchange предоставляют объявления для заполнения, этот показатель представляет собой сумму двух аккаунтов для заполнения (связь с DFP включена, а скрытие дохода от DFP не включена). - Метрика —
ga:backfillECPM
— эффективная цена за тысячу просмотров страниц. Это доход от заполнения DFP на 1000 просмотров страниц. Если и AdSense, и Ad Exchange предоставляют объявления для заполнения, этот показатель представляет собой сумму двух аккаунтов для заполнения (связь с DFP включена, а скрытие дохода от DFP не включена).
Core Reporting API — выпуск от 18 мая 2016 г. (18 мая 2016 г.)
Это выпуск с исправлением ошибок, который устраняет проблему с сегментами и выборкой.
Сегменты
В этом выпуске исправлена проблема, из-за которой подмножество запросов с сегментом «Все пользователи» ( gaid::-1
) не учитывалось в Core Reporting API V3 и разделялось на два сегмента в Analytics Reporting API V4 .
Выборка
В этом выпуске исправлена проблема, из-за которой подмножество запросов из пользовательских таблиц возвращало выборочные данные .
Core Reporting API — выпуск от 29 апреля 2016 г. (29 апреля 2016 г.)
Это выпуск с исправлением ошибок, который устраняет проблему при выполнении когортных запросов Analytics Reporting API V4 .
Когортные запросы
Запросы на когорты теперь могут запрашивать все измерения когорты ; ранее API возвращал ошибку при запросе измерений ga:acquisition...
Общая ценность запроса на общую ценность
Обратите внимание, что запросы общей ценности могут создавать отчеты о общей ценности только для просмотров приложения .
API метаданных – выпуск от 8 апреля 2016 г. (8 апреля 2016 г.)
В этом выпуске добавлен новый атрибут addedInApiVersion
.
Добавлено в версию API
-
addedInApiVersion
— это числовой атрибут, который можно использовать для проверки того, можно ли использовать столбец в API отчетов указанной версии; Подробности см. в Metadata API — Руководство разработчика .
Core Reporting API – выпуск от 8 апреля 2016 г. (8 апреля 2016 г.)
В этом выпуске анонсируется новая версия API — Analytics Reporting API V4 . Этот новый API представляет собой самый продвинутый программный метод доступа к данным отчетов в Google Analytics.
Ключевая особенность
Google Analytics построен на мощной инфраструктуре отчетности. API предоставляет разработчикам доступ к возможностям платформы Google Analytics. Некоторые ключевые функции Analytics Reporting API V4 включают следующее:
- Метрические выражения. API позволяет запрашивать не только встроенные метрики, но и математические выражения метрик. Например, количество выполненных целей за количество сеансов можно выразить в запросе как
ga:goal1completions/ga:sessions
. - Несколько диапазонов дат. Поддержка запроса двух диапазонов дат, позволяющая сравнивать данные за два периода в одном запросе.
- Когорты и пожизненная ценность. API имеет богатый словарь для запроса отчетов по когортам и пожизненной ценности.
- Несколько сегментов. Теперь вы можете запросить несколько сегментов в одном запросе.
Начиная
Подробную информацию о начале работы с API см. в документации для разработчиков .
Политика квот
Analytics Reporting API версии 4 имеет свои собственные квоты и ограничения ; поскольку это новый API, эти ограничения и квоты могут быть изменены.
Миграция
Наряду с руководством по миграции мы также размещаем на Github библиотеку совместимости Python .
Размеры и показатели
В этом выпуске также добавлен набор параметров и показателей специально для Analytics Reporting API V4. Полный список определений см. в проводнике параметров и показателей .
Параметр –
ga:cohort
– название когорты, к которой принадлежит пользователь, на основе определения когорты. В зависимости от того, как определены когорты, пользователь может принадлежать к нескольким когортам, аналогично тому, как пользователь может принадлежать к нескольким сегментам.Измерение –
ga:cohortNthDay
– смещение дня, отсчитываемое от 0, относительно даты определения когорты. Например, если когорта определена с датой первого посещения 01 сентября 2015 г., то для даты 04 сентября 2015 г. значение ga:cohortNthDay будет равно 3.ga:cohortNthMonth
— смещение месяца, отсчитываемое от 0, относительно даты определения когорты.Размер -
ga:cohortNthWeek
- 0 Основное смещение на основе недели относительно даты определения когорты.Размер -
ga:acquisitionTrafficChannel
- канал трафика, через который был приобретен пользователь. Он извлечен из первого сеанса пользователя. Канал трафика вычисляется на основе правил группировки каналов по умолчанию (на уровне просмотра, если доступно) во время получения пользователя.Размер -
ga:acquisitionSource
- источник, через который был приобретен пользователь. Получено из первого сеанса пользователя.Размер -
ga:acquisitionMedium
- среда, через которую был приобретен пользователь. Получено из первого сеанса пользователя.Размер -
ga:acquisitionSourceMedium
- комбинированное значение GA: UserCquisitionSource и GA: AquisitionMedium.Размер -
ga:acquisitionCampaign
Кампания, через которую был приобретен пользователь. Получено из первого сеанса пользователя.Метрика -
ga:cohortActiveUsers
- этот показатель актуальна в контексте 0 измерений смещения (ga:cohortNthDay
,ga:cohortNthWeek
илиga:cohortNthMonth
). Это указывает на количество пользователей в когорте, которые активны в временном окне, соответствующем группе Nth Day/Week/Month. Например, дляga:cohortNthWeek = 1
, количество пользователей (в когорте), которые активны на второй неделе. Если запрос не имеет ни одного изga:cohortNthDay
,ga:cohortNthWeek
илиga:cohortNthMonth
, этот показатель будет иметь то же значение, что иga:cohortTotalUsers
.Метрика -
ga:cohortTotalUsers
- Количество пользователей, принадлежащих к когорте, также известных как размер когорты.Метрика -
ga:cohortAppviewsPerUser
- Просмотры приложений на пользователя для когорты.Метрика -
ga:cohortGoalCompletionsPerUser
- По завершении целей на одного пользователя для когорты.Метрика -
ga:cohortPageviewsPerUser
- PageViews на пользователя для когорты.Метрика -
ga:cohortRetentionRate
- Коэффициент удержания когорты.Метрика -
ga:cohortRevenuePerUser
- Доход на пользователя для когорты.Метрика -
ga:cohortVisitDurationPerUser
- продолжительность сеанса на пользователя для когорты.Метрика -
ga:cohortSessionsPerUser
- сеансы на пользователя для когорты.Метрика -
ga:cohortTotalUsersWithLifetimeCriteria
- Это имеет отношение к контексте запроса, в котором есть аспектыga:acquisitionTrafficChannel
,ga:acquisitionSource
,ga:acquisitionMedium
, илиga:acquisitionCampaign
. Он представляет количество пользователей в когортах, которые приобретаются через текущий канал, источник, среду или кампанию. Например, дляga:acquisitionTrafficChannel=Direct
, он представляет число пользователей в когорте, которые были приобретены напрямую. Если ни одного из упомянутых измерений не присутствует, то его значение равноga:cohortTotalUsers
.Метрика -
ga:cohortAppviewsPerUserWithLifetimeCriteria
- Просмотры приложений на пользователя для измерения приобретения для когорты.Метрика -
ga:cohortGoalCompletionsPerUserWithLifetimeCriteria
- Завершение целей на одного пользователя для измерения сбора для когорты.Метрика -
ga:cohortPageviewsPerUserWithLifetimeCriteria
- Просмотр страниц на пользователя для измерения сбора для когорты.Метрика -
ga:cohortRevenuePerUserWithLifetimeCriteria
- Доход на одного пользователя для измерения приобретения для когорты.Метрика -
ga:cohortSessionsPerUserWithLifetimeCriteria
- Продолжительность сеанса на пользователя для измерения сбора для когорты.
API Core Reporting-выпуск 2016-03-30 (30 марта 2016 г.)
Размеры и метрики в центре социальных данных устарели и будут сообщать только об исторических данных , начиная с 30 апреля 2016 года ; После этой даты не появятся новые данные. Согласно политике снижения данных , эти измерения и метрики будут удалены после 30 сентября 2016 года .
Просмотрите ссылки на размеры и метрики для полного списка определений.
Культурно-просветительные мероприятия
Эти измерения и показатели были устарели и будут удалены после 30 сентября 2016 года . Просмотрите политику снижения данных для получения подробной информации об удалении данных:
- Измерение -
ga:socialActivityEndorsingUrl
- Для деятельности в центре социальных данных это URL социальной деятельности (например, URL -адрес Google+, URL -адрес комментария в блоге и т. Д.). - Размер -
ga:socialActivityDisplayName
- Для деятельности в центре социальных данных это название социальной деятельности, опубликованной пользователями социальной сети. - Размер -
ga:socialActivityPost
- Для активности в центре социальных данных это содержание социальной деятельности (например, содержание сообщения, размещенного в Google+), опубликованного пользователями социальных сетей. - Измерение -
ga:socialActivityTimestamp
- Для активности в центре социальных данных это время, когда социальная деятельность произошла в социальной сети. - Измерение -
ga:socialActivityUserHandle
- Для активности в центре социальных данных это руководитель социальной сети (например, имя или удостоверение личности) пользователей, которые инициировали социальную деятельность ». - Размер -
ga:socialActivityUserPhotoUrl
- Для деятельности в центре социальных данных это URL фотографии, связанной с профилями социальной сети пользователей ». - Измерение -
ga:socialActivityUserProfileUrl
- Для деятельности в центре социальных данных это URL -адрес ассоциированных профилей социальной сети соответствующих пользователей. - Измерение -
ga:socialActivityTagsSummary
- Для деятельности в центре социальных данных это, разделяемый запятой, набор тегов, связанных с социальной деятельностью ». - Измерение -
ga:socialActivityAction
- Для деятельности в центре социальных данных это представляет тип социальных действий (например, голосование, комментарий, +1 и т. Д.), Связанный с деятельностью. - Измерение -
ga:socialActivityNetworkAction
- Для активности в центре социальных данных это тип социальных действий и социальная сеть, где возникла деятельность. - Измерение -
ga:socialActivityContentUrl
- Для деятельности в центре социальных данных это URL -адрес, разделяемый ассоциированными пользователями социальной сети. - Метрика -
ga:socialActivities
- Общее количество действий, в которых URL -адрес контента был обмен или упомянут в партнерской сети контента социальных данных.
Management API-релиз 2016-03-11 (11 марта 2016 г.)
В главной роли
Этот релиз добавляет starred
собственность к сводкам , учетным записям , веб -свойствам и представлениям (профили) .
Management API-релиз 2016-02-25 (25 февраля 2016 г.)
Ограничение частоты ошибок
Наша политика всегда была в том, что разработчики должны реализовать экспоненциальный откат при обработке ответов 500 или 503 . Сегодня мы вводим ограничение по ставке на 500 и 503 ошибках для обеспечения соблюдения этой политики.
- 50 неудачных запросов на запись в час.
API Core Reporting-выпуск 2016-02-03 (3 февраля 2016 г.)
Этот релиз добавляет новое измерение в API. Просмотрите ссылки на размеры и метрики для полного списка определений.
Платформа или устройство
- Размер -
ga:browserSize
- размер видового порта браузеров пользователей. Размер браузера - это размер сеанса, которая фиксирует начальные размеры видового тома в пикселях и отформатируется как ширина x высота. Например, 1920x960.
Management API-выпуск 2016-02-01 (1 февраля 2016 г.)
Unsampled Reports
Unsampled Reports API больше не имеет предела 100 отчетов в день. API использует ту же систему токенов в день, что и при создании несоответствующего отчета через веб-интерфейс.
Management API-выпуск 2016-01-26 (26 января 2016 г.)
Unsampled Reports
Отсутствующие отчеты, которые недоступны для текущего пользователя, больше не будут иметь ссылку для загрузки в сообщении ответа API Management. Это поведение теперь согласуется с функциональностью пользовательского интерфейса, когда только владельцы отчетов могут увидеть ссылку для загрузки для сгенерированного документа.
Management API-релиз 2015-12-17 (17 декабря 2015 г.)
Просмотры (профили)
Этот релиз добавляет свойство botFilteringEnabled
в ресурс View (профиль). Это свойство указывает, включена ли фильтрация бота для представления (профиль). Смотрите ссылки на представление (профили) для получения подробной информации.
Unsampled Reports
Этот релиз добавляет метод delete
в незамеченные отчеты. См. Несоответствующие отчеты Удалить справочные документы для получения подробной информации.
iOS SDK - выпуск версии 3.15 (23 ноября 2015 г.)
Этот релиз содержит:
Гугл Аналитика
- Без изменений.
Диспетчер тегов Google
- Исправлена проблема , которая приведет к сбою при выполнении модульных тестов.
Management API-релиз 2015-11-17 (17 ноября 2015 г.)
Сегменты
Это релиз исправления ошибок. Этот релиз решает проблему, которая может привести к тому, что сегменты со значениями валюты в определении появляются неправильно при вызове метода списка сегментов .
Основная отчетность API-выпуск 2015-11-16 (16 ноября 2015 г.)
Этот выпуск добавляет новый параметр в API.
Включите пустые ряды
- Этот выпуск добавляет новый необязательный параметр
include-empty-rows
, которые при установке наfalse
строки без данных будут опущены из ответа. Значение по умолчаниюtrue
, которое является неразрывным изменением, и, как таковое, не должно требовать обновления кода. См. Основную справочную документацию API отчетности для получения подробной информации.
iOS SDK - выпуск версии 3.14 (23 октября 2015 г.)
Этот релиз содержит:
Гугл Аналитика
- Добавлена поддержка биткода.
Диспетчер тегов Google
- Добавлена поддержка биткода.
API Core Reporting-выпуск 2015-10-06 (6 октября 2015 г.)
Этот релиз добавляет новые метрики в API. Просмотрите ссылки на размеры и метрики для полного списка определений.
Пользователь
- Метрика -
ga:1dayUsers
- общее количество активных пользователей 1 -дневного за каждый день в запрошенный период времени. По крайней мере, один из GA: Nthday, GA: Date или GA: День должен быть указан как измерение, чтобы запросить эту метрику. В течение данной даты возвращенным значением станет общим уникальным пользователем за 1 день, заканчивающийся на дату. - Метрика -
ga:7dayUsers
- общее количество 7 -дневных активных пользователей для каждого дня в запрошенный период времени. По крайней мере, один из GA: Nthday, GA: Date или GA: День должен быть указан как измерение, чтобы запросить эту метрику. В течение данной даты возвращенным значением станет общим уникальным пользователем за 7 -дневный период, заканчивающийся на дату. - Метрика -
ga:14dayUsers
- общее количество 14 -дневных активных пользователей за каждый день в запрошенный период времени. По крайней мере, один из GA: Nthday, GA: Date или GA: День должен быть указан как измерение, чтобы запросить эту метрику. В течение данной даты возвращенным значением станет общим уникальным пользователем за 14 -дневный период, заканчивающийся на дату. - Метрика -
ga:30dayUsers
- общее количество 30 -дневных активных пользователей для каждого дня в запрошенный период времени. По крайней мере, один из GA: Nthday, GA: Date или GA: День должен быть указан как измерение, чтобы запросить эту метрику. В течение данной даты возвращенным значением станет общим уникальным пользователем за 30 -дневный период, заканчивающийся на дату.
Management API-релиз 2015-10-06 (6 октября 2015 г.)
Сегменты
Это релиз исправления ошибок. Этот выпуск решает проблему, которая заставит пользователей с частными сегментами, прикрепленными к нескольким представлениям (профили), чтобы получить ответ ошибки 500
при вызове метода списка сегментов .
API Core Reporting-Release 2015-09-11 (11 сентября 2015 г.)
Этот релиз добавляет новые метрики в API. Просмотрите ссылки на размеры и метрики для полного списка определений.
DoubleClick Ad Exchange (ADX)
- Метрика -
ga:adxCTR
- процент просмотров страниц, которые привели к щелчке ADX AD. - Метрика -
ga:adxClicks
- количество раздачи ADX на вашем сайте щелкнуло. - Метрика -
ga:adxCoverage
- Покрытие - это процент запросов на рекламу, которые вернули как минимум одно объявление. Как правило, покрытие может помочь вам определить сайты, на которых ваша учетная запись ADX не может предоставить целевую рекламу. (Рекламные впечатления / общие запросы на рекламу) * 100 - Метрика -
ga:adxECPM
- Эффективная стоимость за тысячу просмотров страниц. Это ваш доход ADX на 1000 просмотров страниц. - Метрика -
ga:adxImpressions
- AD -впечатление ADX сообщается, когда на вашем сайте отображается отдельное объявление. Например, если страница с двумя объявлениями просмотрена один раз, мы отобразим два впечатления. - Метрика -
ga:adxImpressionsPerSession
- соотношение впечатлений AD AD к аналитическим сеансам (AD впечатления / аналитические сеансы). - Метрика -
ga:adxMonetizedPageviews
- Монетизированные просмотр страниц измеряют общее количество просмотров страниц в вашем свойстве, которые были показаны с объявлением из вашей связанной учетной записи ADX. Примечание: одна страница может иметь несколько рекламных единиц. - Метрика -
ga:adxRevenue
- общий оценочный доход от ADX Ads. - Метрика -
ga:adxRevenuePer1000Sessions
- Общий оценочный доход от ADX ADS на 1000 аналитических сессий. Обратите внимание, что этот показатель основан на сеансах на ваш сайт, а не на рекламные впечатления. - Метрика -
ga:adxViewableImpressionsPercent
- процент от впечатлений от AD, которые можно было просматривать. Впечатление считается видным впечатлением, когда оно появилось в браузере пользователя и имело возможность увидеть.
Provisioning API - релиз 2015-09 (10 сентября 2015 г.)
Этот релиз добавляет дополнительный параметр в URL API TOS API :
- Добавление параметра URL,
provisioningSignup=false
, исправляет проблему, которая возникает при обеспечении учетной записи Google Analytics для пользователя без каких -либо учетных записей Google Analytics. Разработчики должны обновить свой код, чтобы добавить этот параметр в URL TOS.
Management API-релиз 2015-09-03 (3 сентября 2015 г.)
Партия
С этим выпуском, в дополнение к общей поддержке партии , мы добавили специальную поддержку API разрешений пользователей . В пакетных запросах на разрешения пользователей будет значительно повысить производительность и сокращение использования квот.
Management API-релиз 2015-08-06 (6 августа 2015 г.)
Просмотры (профили)
С этим выпуском currency
View (профиль) теперь по умолчанию будет по умолчанию в долларах США , если не будет установлено во время операции вставки . Также операции get
и list
возвращаются в доллар США (профили), которые ранее были созданы без currency
свойства.
Пожалуйста, смотрите Руководство по разработке View (профиль) для получения подробной информации об использовании просмотра (профили) в API управления.
Пожалуйста, смотрите ссылку на представление (профили) для полного списка параметров для ресурса View (профиль).
Основная отчетность API-релиз 2015-07-23 (23 июля 2015 г.)
Этот релиз осуждает существующие измерения или метрики. Просмотрите ссылки на размеры и метрики для полного списка определений.
Устаревшие измерения
Эти измерения устарели. Просмотрите политику снижения данных для получения подробной информации об удалении данных:
- Размер -
ga:adSlotPosition
- Используйтеga:adSlot
вместо этого. - Размер -
ga:nextPagePath
- используйтеga:pagePath
вместо этого. - Dimension -
ga:nextContentGroupXX
- используйтеga:contentGroupXX
вместо этого.
iOS SDK - выпуск версии 3.13 (21 июля 2015 г.)
Этот релиз содержит:
Гугл Аналитика
- Исправлена проблема, которая вызвала сбои при использовании SetCampainParametersfromurl. Выпуск 636 .
Диспетчер тегов Google
- Без изменений.
Management API-релиз 2015-05-28 (28 мая 2015 г.)
Фильтры
Этот выпуск знаменует собой окончательное удаление устаревших полей фильтра IS_MOBILE
и IS_TABLET
, которые следует заменить на DEVICE_CATEGORY=mobile
и DEVICE_CATEGORY=tablet
. Вставьте, обновлять и исправить запросы, которые устанавливают поля фильтра для использования IS_MOBILE
, и IS_TABLET
вернет ошибку.
Пожалуйста, смотрите Руководство по разработчику фильтра для получения подробной информации об использовании фильтров в API управления.
Пожалуйста, смотрите ссылку на фильтры для полного списка параметров для ресурса фильтра.
iOS SDK - выпуск версии 3.12 (11 мая 2015 г.)
Этот релиз содержит:
Гугл Аналитика
- Без изменений.
Диспетчер тегов Google
- Исправлена конфликт имени класса. Выпуск 631 .
Основная отчетная API-релиз 2015-05-06 (6 мая 2015 г.)
Этот релиз добавляет новое измерение в API. Обзорные измерения и ссылки на метрики для полного списка измерений и метрик.
Adwords
- Размер -
ga:adQueryWordCount
- Количество слов в поисковом запросе.
Management API-релиз 2015-05-05 (5 мая 2015 г.)
Фильтры
Этот выпуск добавляет поддержку для использования пользовательского измерения для поля фильтра, добавив свойство fieldIndex
во все разделы сведений о фильтре. Например, теперь можно установить выражение фильтра с "field": "CUSTOM_DIMENSION"
и "fieldIndex": "1"
чтобы фильтр работал над первым пользовательским измерением.
Пожалуйста, смотрите Руководство по разработчику фильтра для получения подробной информации об использовании фильтров в API управления.
Пожалуйста, смотрите ссылку на фильтры для полного списка параметров для ресурса фильтра.
Цели
Этот релиз также решает проблему при создании цели с "comparisonValue": "0"
потерпит неудачу.
Пожалуйста, смотрите Руководство по разработчику целей для получения подробной информации об использовании целей в API управления.
Пожалуйста, смотрите ссылку на цели для полного списка параметров для целевого ресурса.
Android SDK - выпуск версии 4.5 - Google Play Services 7.3 (1 мая 2015 г.)
Этот релиз содержит:
Гугл Аналитика
- Добавлена поддержка для отправки фона на устройствах, не являющихся Google Play.
- Умеренный аналитический логист/loglevel. Analytics теперь использует журналирование Android. Чтобы включить журнал журнала отладки, запустить
adb shell setprop log.tag.GAv4 DEBUG
. - Рефакторинг для улучшения доставки данных и установки атрибуции кампании.
- Ошибка разбора кампании исправлена. Выпуск 596 .
- Недоставленный приложение исключения в течение первых секунд аналитической инициализации правильно сообщаются. Выпуск 443 .
Диспетчер тегов Google
- Без изменений.
iOS SDK - выпуск версии 3.11 (30 апреля 2015 г.)
Этот релиз содержит:
Гугл Аналитика
- Сообщите о разрешении экрана с использованием Nativebounds на iOS 8.0 и новее. Это адреса выпуска 504 .
- Добавлена поддержка параметров кампании, связанных с кликом.
- Сообщите об аппаратной модели iOS в дополнение к версии ОС устройства. Это адреса выпуска 408 .
- Отчет IAD установить атрибуцию на iOS 7.1 и новее. Это требует IAD Framework.
- Добавлено предупреждение о том, как тип Hit Appview.
- SQLite3 теперь требуется библиотека.
Диспетчер тегов Google
- Исправлена сбоя строки NIL в TagDispatcher.
Веб-отслеживание (Analytics.js)-выпуск 2015-04-13 (13 апреля 2015 г.)
Этот релиз содержит добавление нового поля. Просмотрите ссылку на поля для полного списка полей.
Транспорт
- Транспортное поле позволяет вам установить механизм, с помощью которого будут отправлены удары.
Другие изменения
- Опция
useBeacon
устарела. - Исправление ошибок
Android SDK - выпуск версии 4.0.6 - Google Play Services 7.0 (19 марта 2015 г.)
Этот релиз содержит:
Гугл Аналитика
- Исправленная проблема 440: CampaicingTrackingService NullPointerException
- Фиксированный выпуск 552: Googleanalytics.getInstance () блокируется
- Исправленная проблема 564: Analytics Auto Activity Отчеты об отчетности UnsupportedOperationException
- Мелкие исправления.
Диспетчер тегов Google
- Мелкие исправления.
Management API-релиз 2015-03-13 (13 марта 2015 г.)
Этот релиз знаменует собой окончательный перерыв и удаление dailyUpload
Resouce. Ресурс dailyUpload
был официально устарел 20 июня 2014 года; Весь импорт данных затрат теперь должен быть выполнен с помощью ресурса загрузки .
- Пожалуйста, обратитесь к Политике снижения данных для более подробной информации о процессе искажения API Google Analytics.
- См. Руководство разработчика импорта данных для получения подробной информации о том, как использовать для импорта данных в Google Analytics.
Основная отчетность API-релиз 2015-02-20 (20 февраля 2015 г.)
Этот релиз добавляет новые размеры в API. Обзорные измерения и ссылки на метрики для полного списка измерений и метрик.
Платформа или устройство
- Размер -
ga:dataSource
- источник данных HIT. Хиты, отправленные из GA.JS и Analytics.js, сообщаются как «Интернет»; Хиты, отправленные с мобильных SDK, сообщаются как «приложение». Эти значения могут быть переопределены.
Внутренний поиск
- Размер -
ga:searchAfterDestinationPage
- страница, которую пользователь посетил после выполнения внутреннего поиска на вашем сайте.
Android SDK - выпуск версии 4.0.5 - Google Play Services 6.7 (17 февраля 2015 г.)
Этот релиз содержит:
Гугл Аналитика
- Мелкие исправления.
Диспетчер тегов Google
- Исправлена ошибка в условиях гонки, связанную с тем , как избежать Tagmanager «OldalStateException: результаты уже были установлены» .
Репортаж в реальном времени-релиз 2015-02-12 (12 февраля 2015 г.)
Это релиз исправления ошибок:
- Этот выпуск решает проблему в обеспечении соблюдения ограничений фильтрации в запросе API в реальном времени. Запросы с
rt:activeUsers
и фильтр в размере уровня событий приведут к ошибке сbadRequest
причиной и сообщениемOR operator not supported for a hit level filter
. Посетите руководство по разработке разработчиков API в реальном времени для получения более подробной информации о ограничениях запроса.
Протокол измерения-выпуск 2015-01-30 (30 января 2015 г.)
Этот релиз добавляет новый параметр HIT. Просмотрите ссылку на параметр для полного списка параметров.
Источник данных
- Параметр источника данных
ds
позволяет установить источник данных HIT.
Веб-отслеживание (Analytics.js)-выпуск 2015-01-30 (30 января 2015 г.)
Этот релиз содержит добавление нового поля. Просмотрите ссылку на поля для полного списка полей.
Источник данных
- Поле источника данных позволяет установить источник данных удара.
Протокол измерения-выпуск 2015-01-29 (29 января 2015 г.)
Этот релиз добавляет новый параметр HIT. Просмотрите ссылку на параметр для полного списка параметров.
Географический переопределение
-
geoid
географический переопределение позволяет вам явно установить географическое местоположение пользователя.
Management API-релиз 2015-01-23 (23 января 2015 г.)
Этот релиз добавляет две новые коллекции в API управления, пользовательские аспекты и пользовательские метрики.
Пользовательские размеры и метрики
Теперь можно создавать, перечислить, получать, исправлять и обновить пользовательские измерения и метрики с помощью API управления.
Основная отчетность API-релиз 2015-01-21 (21 января 2015 г.)
Этот релиз добавляет новые измерения и метрики в API и осуществляет два существующих показателя. Просмотрите ссылки на размеры и метрики для полного списка определений.
Электронная коммерция
- Метрика -
ga:transactionsPerUser
- общее количество транзакций, деленных на общее количество пользователей. - Метрика -
ga:revenuePerUser
- Общая выручка от продажи, предоставленная в сделке, за исключением доставки и налогов, деленных на общее количество пользователей.
Пользователь
- Метрика -
ga:sessionsPerUser
- общее количество сеансов, деленных на общее количество пользователей.
Geo Network
- Размер -
ga:cityId
- городские идентификаторы пользователей, полученные из IP -адресов или географических идентификаторов. - Размер -
ga:countryIsoCode
- страна ISO -код пользователей, полученный из IP -адресов или географических идентификаторов. Значения приведены в виде кода Alpha-2 ISO-3166-1. - Размер -
ga:regionId
- идентификатор региона пользователей, полученный из IP -адресов или географических идентификаторов. В США регион - это штат, такой как Нью -Йорк. - Размер -
ga:regionIsoCode
- регион ISO -код пользователей, полученный из IP -адресов или географических идентификаторов. Значения приведены в виде кода ISO-3166-2. - Размер -
ga:subContinentCode
- субконтинентный код пользователей, полученный из IP -адресов или географических идентификаторов. Например, Полинезия или Северная Европа. Значения приведены в виде кода ООН М.49.
Менеджер кампании DoubleClick
- Метрика -
ga:dcmROAS
- DCM Возврат на рекламу (ROAS) (только премиум).
Устаревшие метрики
Эти метрики устарели. Просмотрите Политику снижения данных для получения подробной информации об удалении данных: + Метрика - ga:dcmROI
- вместо этого используйте ga:dcmROAS
. + Метрика - ga:dcmMargen
- используйте ga:dcmROAS
вместо этого.
Management API-релиз 2015-01-08 (8 января 2015 г.)
Ответ метода list
для всех коллекций теперь включает в себя пустой список для свойства items
, когда коллекция не содержит ресурсов. Ранее свойство items
будет опущено из ответа. См. Ссылку API для получения полной информации о запросах и ответах для данных конфигурации Google Analytics.
Management API-релиз 2014-12-16 (16 декабря 2014 г.)
Исправление ошибок
- Исправлено для выпуска 467 - Сборник сегментов теперь возвращает сегменты, которые используют синтаксис
dateOfSession
.
Android SDK - выпуск версии 4.0.4 - Google Play Services 6.5 (24 ноября 2014 г.)
Этот релиз содержит:
Гугл Аналитика
- Улучшения для отслеживания исключений, связанных с выпуском 443: Google Play Services не отправляет исключения .
- Мелкие исправления.
Диспетчер тегов Google
- Нет изменений в Google Tag Manager.
Management API-выпуск 2014-11-20 (20 ноября 2014 г.)
Этот релиз представляет новую область для API Google Analytics Management . - analytics.manage.users.readonly
- Посмотреть разрешения пользователя Google Analytics.
Management API-релиз 2014-11-05 (5 ноября 2014 г.)
Было добавлено новое поле фильтров DEVICE_CATEGORY
, а IS_MOBILE
и IS_TABLET
теперь устарели. Используйте DEVICE_CATEGORY=mobile
и DEVICE_CATEGORY=tablet
.
iOS SDK - выпуск версии 3.10 (5 ноября 2014 г.)
Этот релиз содержит:
Гугл Аналитика
- Исправлена проблема, которая мешала отправлять всех маяков при отправке маяков.
- Обновленные приложения Cuteanimals, чтобы продемонстрировать, как отправить приложение, когда приложение входит в фон.
- Добавлена поддержка дополнительных расширенных полей электронной коммерции.
- Удаленные предупреждающие сообщения о классах Gaihit и Gaiproperty отсутствуют при компиляции против iOS SDK 8.0; Эти классы были удалены.
- Отправка маяков в настоящее время более эффективно, причем несколько маяков отправляются в одном запросе HTTPS.
- Запросы будут сжаты для сохранения использования плана данных при определенных обстоятельствах.
Диспетчер тегов Google
- Очередь на основе таркондерфуты opencontainerwithid. Использование этого API на iOS8 приводит к ошибкам, если GET вызывается на некоторых этапах жизненного цикла UIAPPDELEGATE.
- Добавлена поддержка пользовательских метрик и пользовательских аспектов для улучшения электронной коммерции для тега Google Universal Analytics.
- Исправлена ошибка, которая требовала продуктов для расширенных действий электронной коммерции, которые имеют дополнительные продукты.
- Поддержите функции идентификатора рекламы для тега Google Universal Analytics.
- Обновленные приложения Cuteanimals, чтобы продемонстрировать, как отправлять данные, когда приложение переходит в фоновое представление.
Management API-релиз 2014-10-29 (29 октября 2014 г.)
Ресурс View (профиль) теперь включает в себя свойство enhancedECommerceTracking
, которое указывает, включено ли расширенное электронную коммерцию ( true
) или отключено ( false
).
API Core Reporting-выпуск 2014-10-09 (9 октября 2014 г.)
Этот релиз добавляет новую метрику в API и осуществляет два существующих показателя. Проверьте ссылки на размеры и метрики для полного списка определений.
Adwords
- Метрика -
ga:ROAS
- Возвращение на рекламу (ROAS) - это общий доход от транзакций и стоимость цели, разделенная на производные затраты на рекламу.
Устаревшие измерения и метрики
Эти измерения и метрики устарели. Просмотрите политику снижения данных для получения подробной информации об удалении данных: + Метрика - ga:ROI
- используйте вместо этого ga:ROAS
. + Метрика - ga:margin
- используйте ga:ROAS
вместо этого.
Репортаж в реальном времени-релиз 2014-10-01 (1 октября 2014 г.)
Этот релиз включает в себя новое измерение. Просмотрите ссылки на размеры и метрики для полного списка определений.
Время
- Размер -
rt:minutesAgo
- количество минут назад произошел удар.
API Core Reporting-выпуск 2014-10-01 (1 октября 2014 г.)
Этот релиз добавляет новые метрики в API. Проверьте ссылки на размеры и метрики для полного списка определений.
АдСенс
- Метрика -
ga:adsenseCoverage
- процент запросов на рекламу, которые вернули как минимум одно объявление. - Метрика -
ga:adsenseViewableImpressionPercent
- процент от впечатлений, которые можно было просматривать.
Android SDK - выпуск версии 4.0.3 - Google Play Services 6.1 (25 сентября 2014 г.)
Этот релиз содержит:
Гугл Аналитика
- Мелкие исправления.
Диспетчер тегов Google
- Поддержка расширенной электронной коммерции была добавлена. Для получения подробной информации см. Усовершенствованное руководство по разработчике электронной коммерции .
Веб-отслеживание (Analytics.js)-выпуск 2014-09-02 (2 сентября 2014 г.)
- Теперь можно отправить хиты с использованием
navigator.sendBeacon
(в поддерживаемых браузерах), передавая параметрuseBeacon
. - Набор файлов cookie под плагином дисплея был переименован от
_dc
до_gat
.
Multi-Channel Funnels Reporting API-релиз 2014-08-25 (25 августа 2014 г.)
Этот релиз добавляет новые размеры и метрики к API. Проверьте ссылки на размеры и метрики для полного списка определений.
Пути конверсии
- Размер -
mcf:dcmAd
- DCM AD Имя события DCM (впечатление или щелчок) Сопоставление конверсии Google Analytics. - Размер -
mcf:dcmAdPath
- Путь к конверсии, где взаимодействия на пути представлены DCM ADS. - Размер -
mcf:dcmAdType
- DCM Тип объявления Имя события DCM (впечатление или щелчок) Сопоставление конверсии Google Analytics. - Размер -
mcf:dcmAdvertiser
- DCM Advertiser name события DCM (впечатление или щелчок), соответствующее конверсии Google Analytics. - Размер -
mcf:dcmAdvertiserPath
- путь к конверсии, где взаимодействия на пути представлены рекламодателями DCM. - Размер -
mcf:dcmCampaign
- DCM Имя кампании события DCM (впечатление или щелчок) Сопоставление конверсии Google Analytics. - Измерение -
mcf:dcmCampaignPath
- путь к конверсии, где взаимодействия на пути представлены кампаниями DCM. - Размер -
mcf:dcmCreative
- Creative Name DCM события (впечатление или щелчок), соответствующее конверсии Google Analytics. - Размер -
mcf:dcmCreativePath
- путь к преобразованию, где взаимодействия на пути представлены креативщиками DCM. - Размер -
mcf:dcmCreativeVersion
- Creative Version DCM события DCM (впечатление или щелчок) Сопоставление конверсии Google Analytics. - Размер -
mcf:dcmCreativeVersionPath
- путь к преобразованию, где взаимодействия на пути представлены творческими версиями DCM. - Размер -
mcf:dcmNetwork
- используемая сеть. - Размер -
mcf:dcmPlacement
- DCM -сайт Имя события DCM (впечатление или щелчок) Сопоставление конверсии Google Analytics. - Размер -
mcf:dcmPlacementPath
- путь к преобразованию, где взаимодействия на пути представлены размещением DCM. - Размер -
mcf:dcmSite
- Имя сайта DCM, где было показано Creative DCM для события DCM (впечатление или клик), соответствующее конверсии Google Analytics. - Размер -
mcf:dcmSitePath
- Путь к преобразованию, где взаимодействия на пути представлены сайтами DCM. - Метрика -
mcf:firstImpressionConversions
- количество конверсий, для которых впечатление кампании DCM было первым взаимодействием конверсии в 30 -дневном окне Lookback. Это измерение включает в себя как достижение целей, так и транзакции. - Метрика -
mcf:firstImpressionValue
- ценность конверсий, для которых впечатление кампании DCM было первым взаимодействием конверсии в 30 -дневном окне Lookback. Это измерение включает в себя как достижение целей, так и транзакции. - Метрика -
mcf:impressionAssistedConversions
- количество конверсий, для которых впечатление кампании DCM появилось на пути преобразования, но не было окончательным взаимодействием конверсии. Это измерение включает в себя как достижение целей, так и транзакции. - Метрика -
mcf:impressionAssistedValue
- ценность конверсий, для которых на пути преобразования появилось впечатление кампании DCM, но не было окончательным взаимодействием конверсии. Это измерение включает в себя как достижение целей, так и транзакции.
Основная отчетная API-релиз 2014-08-25 (25 августа 2014 г.)
Этот релиз включает в себя добавление новой метрики сеанса, новое измерение источников трафика, а также новые аспекты менеджера кампании DoubleClick и метрики.
Размеры и метрики
Просмотрите ссылки на размеры и метрики для полного списка определений.
Сессия
- Метрика -
ga:hits
- общее количество хитов, отправленных Google Analytics. Этот показатель суммирует все типы попаданий (например, страница, событие, время и т. Д.)
Источники трафика
- Размер -
ga:campaignCode
- При использовании ручного отслеживания кампании значение параметра отслеживания кампании UTM_ID.
Менеджер кампании DoubleClick
- Размер -
ga:dcmClickAd
- DCM AD Имя DCM Click Matching Сеанс Google Analytics (только премиум). - Размер -
ga:dcmClickAdId
- DCM AD идентификатор DCM Click, соответствующий сеансу Google Analytics (только премиум). - Dimension -
ga:dcmClickAdType
- DCM ad type name of the DCM click matching the Google Analytics session (premium only). - Dimension -
ga:dcmClickAdTypeId
- DCM ad type ID of the DCM click matching the Google Analytics session (premium only). - Dimension -
ga:dcmClickAdvertiser
- DCM advertiser name of the DCM click matching the Google Analytics session (premium only). - Dimension -
ga:dcmClickAdvertiserId
- DCM advertiser ID of the DCM click matching the Google Analytics session (premium only). - Dimension -
ga:dcmClickCampaign
- DCM campaign name of the DCM click matching the Google Analytics session (premium only). - Dimension -
ga:dcmClickCampaignId
- DCM campaign ID of the DCM click matching the Google Analytics session (premium only). - Dimension -
ga:dcmClickCreative
- DCM creative name of the DCM click matching the Google Analytics session (premium only). - Dimension -
ga:dcmClickCreativeId
- DCM creative ID of the DCM click matching the Google Analytics session (premium only). - Dimension -
ga:dcmClickCreativeType
- DCM creative type name of the DCM click matching the Google Analytics session (premium only). - Dimension -
ga:dcmClickCreativeTypeId
- DCM creative type ID of the DCM click matching the Google Analytics session (premium only). - Dimension -
ga:dcmClickCreativeVersion
- DCM creative version of the DCM click matching the Google Analytics session (premium only). - Dimension -
ga:dcmClickRenderingId
- DCM rendering ID of the DCM click matching the Google Analytics session (premium only). - Dimension -
ga:dcmClickSite
- Site name where the DCM creative was shown and clicked on for the DCM click matching the Google Analytics session (premium only). - Dimension -
ga:dcmClickSiteId
- DCM site ID where the DCM creative was shown and clicked on for the DCM click matching the Google Analytics session (premium only). - Dimension -
ga:dcmClickSitePlacement
- DCM site placement name of the DCM click matching the Google Analytics session (premium only). - Dimension -
ga:dcmClickSitePlacementId
- DCM site placement ID of the DCM click matching the Google Analytics session (premium only). - Dimension -
ga:dcmClickSpotId
- DCM Floodlight configuration ID of the DCM click matching the Google Analytics session (premium only). - Dimension -
ga:dcmFloodlightActivity
- DCM Floodlight activity name associated with the floodlight conversion (premium only). - Dimension -
ga:dcmFloodlightActivityAndGroup
- DCM Floodlight activity name and group name associated with the floodlight conversion (premium only). - Dimension -
ga:dcmFloodlightActivityGroup
- DCM Floodlight activity group name associated with the floodlight conversion (premium only). - Dimension -
ga:dcmFloodlightActivityGroupId
- DCM Floodlight activity group ID associated with the floodlight conversion (premium only). - Dimension -
ga:dcmFloodlightActivityId
- DCM Floodlight activity ID associated with the floodlight conversion (premium only). - Dimension -
ga:dcmFloodlightAdvertiserId
- DCM Floodlight advertiser ID associated with the floodlight conversion (premium only). - Dimension -
ga:dcmFloodlightSpotId
- DCM Floodlight configuration ID associated with the floodlight conversion (premium only). - Dimension -
ga:dcmLastEventAd
- DCM ad name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only). - Dimension -
ga:dcmLastEventAdId
- DCM ad ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only). - Dimension -
ga:dcmLastEventAdType
- DCM ad type name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only). - Dimension -
ga:dcmLastEventAdTypeId
- DCM ad type ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only). - Dimension -
ga:dcmLastEventAdvertiser
- DCM advertiser name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only). - Dimension -
ga:dcmLastEventAdvertiserId
- DCM advertiser ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only). - Dimension -
ga:dcmLastEventAttributionType
- There are two possible values (ClickThrough and ViewThrough). If the last DCM event associated with the Google Analytics session was a click, then the value will be ClickThrough. If the last DCM event associated with the Google Analytics session was an ad impression, then the value will be ViewThrough (premium only). - Dimension -
ga:dcmLastEventCampaign
- DCM campaign name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only). - Dimension -
ga:dcmLastEventCampaignId
- DCM campaign ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only). - Dimension -
ga:dcmLastEventCreative
- DCM creative name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only). - Dimension -
ga:dcmLastEventCreativeId
- DCM creative ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only). - Dimension -
ga:dcmLastEventCreativeType
- DCM creative type name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only). - Dimension -
ga:dcmLastEventCreativeTypeId
- DCM creative type ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only). - Dimension -
ga:dcmLastEventCreativeVersion
- DCM creative version of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only). - Dimension -
ga:dcmLastEventRenderingId
- DCM rendering ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only). - Dimension -
ga:dcmLastEventSite
- Site name where the DCM creative was shown and clicked on for the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only). - Dimension -
ga:dcmLastEventSiteId
- DCM site ID where the DCM creative was shown and clicked on for the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only). - Dimension -
ga:dcmLastEventSitePlacement
- DCM site placement name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only). - Dimension -
ga:dcmLastEventSitePlacementId
- DCM site placement ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only). - Dimension -
ga:dcmLastEventSpotId
- DCM Floodlight configuration ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only). - Metric -
ga:dcmFloodlightQuantity
- The number of DCM Floodlight conversions (premium only). - Metric -
dcmFloodlightRevenue
- DCM Floodlight revenue (premium only).
iOS SDK - Release Version 3.09 (July 31, 2014)
This release contains:
Гугл Аналитика
- Без изменений.
Диспетчер тегов Google
- Enhanced Ecommerce support has been added to the Google Universal Analytics Tag.
- New
dispatch
anddispatchWithCompletionHandler
methods have been added to the TAGManager class.
Core Reporting API - Release 2014-07-14 (July 14, 2014)
This release includes the addition of the new content grouping dimensions and metrics.
Dimensions and Metrics
Review the Dimensions and Metrics Reference for the complete list of definitions.
Content Grouping
- Dimension -
ga:landingContentGroupXX
- The first matching content group in a user's session. - Dimension -
ga:nextContentGroupXX
- Refers to content group that was visited after another content group. - Dimension -
ga:contentGroupXX
- Content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/url regex match, or predefined rules. - Dimension -
ga:previousContentGroupXX
- Refers to content group that was visited before another content group. - Metric -
ga:contentGroupUniqueViewsXX
- The number of different (unique) pages within a session for the specified content group. This takes into account both the pagePath and pageTitle to determine uniqueness.
Android SDK - Release Version 4.0.2 - Google Play Services 5.0 (July 1, 2014)
This release contains:
Гугл Аналитика
- Support for enhanced ecommerce has been added. See the Enhanced Ecommerce Developer Guide for details.
- The client ID will now reset every time the advertising ID is changed.
- Advertising ID collection is off by default.
- Added programmatic APIs for exception reporting.
- Bug fixes in documentation.
- Мелкие исправления.
Диспетчер тегов Google
- No changes to Google Tag Manager.
iOS SDK - Release Version 3.08 (June 25, 2014)
This release contains:
Гугл Аналитика
- The SDK will now collect IDFA and the advertiser tracking enabled flag if the library libAdIdAccess.a (provided as part of the SDK) is included in the application and the
allowIDFACollection
property is set to true on the tracker. - Enhanced Ecommerce support has been added.
- Added screenview hit type to replace appview hit type.
- A hit id parameter is now added to each hit. It is changed every time an appview, screenview or pageview hit is generated.
- ClientId will now be reset every time the IDFA value is changes. This only happens when IDFA is collected in a tracker.
- A new
dispatchWithCompletionHandler
method has been added to the GAI class. - Fixed an issue where the SDK could send a beacon without a clientId or with an empty clientId.
Диспетчер тегов Google
- Без изменений
Web Tracking (analytics.js) - Release 2014-06-25 (June 25, 2014)
- Hits that do not contain a valid tracking id are now dropped.
- Added support for Regular Expressions in Cross Domain linking plugin .
Web Tracking (ga.js) - Release 2014-06-25 (June 25, 2014)
- Hits that do not contain a valid tracking id are now dropped.
Management API - Release 2014-06 (June 20, 2014)
This release includes new data import types and the deprecation of the dailyUpload
resource.
Data Import
See the Data Import Developer Guide for details how to use the Management API to import data to your Google Analytics account.
Загрузки
- The
upload
resource now supports the following upload types:- Campaign Data
- Content Data
- Cost Data
- Данные продукта
- Refund Data
- Данные пользователя
- The
upload
resource has a newmigrateDataImport
method to migrate existing Cost DatacustomDataSources
.
Daily Uploads Deprecation
- The
dailyUpload
resource is now deprecated! see the Migration Guide for details on migrating to use the Data Import feature. - The
dailyUpload
resource will continue to work for six more months, at which point any remainingcustomDataSources
withuploadType
property set toanalytics#dailyUploads
will be automatically migrated and only work with theupload
resource. - Current users of the
dailyUpload
resource should update their code and migrate to use the Upload resource as soon as possible.
Core Reporting API - Release 2014-06-12 (June 12, 2014)
This release includes a new dateOfSession
condition for Segments and the addition of new Enhanced Ecommerce dimensions and metrics.
Сегменты
Segments now support a new dateOfSession
condition which can restrict a segment to a group of users who have initiated a session within a certain date range. See the Segments Developer Guide for details.
Dimensions and Metrics
Review the Dimensions and Metrics Reference for the complete list of definitions for Enhanced Ecommerce .
Enhanced Ecommerce
- Dimension -
ga:internalPromotionCreative
- The creative content designed for a promotion. - Dimension -
ga:internalPromotionId
- The ID you are using for the promotion. - Dimension -
ga:internalPromotionName
- The name of the promotion. - Dimension -
ga:internalPromotionPosition
- The position of the promotion on the web page or application screen. - Dimension -
ga:orderCouponCode
- Code for the order-level coupon. - Dimension -
ga:productBrand
- The brand name under which the product is sold. - Dimension -
ga:productCategoryHierarchy
- The hierarchical category in which the product is classified (Enhanced Ecommerce). - Dimension -
ga:productCategoryLevelXX
- Level (1-5) in the product category hierarchy, starting from the top. - Dimension -
ga:productCouponCode
- Code for the product-level coupon. - Dimension -
ga:productListName
- The name of the product list in which the product appears. - Dimension -
ga:productListPosition
- The position of the product in the product list. - Dimension -
ga:productVariant
- The specific variation of a product, eg, XS, S, M, L for size or Red, Blue, Green, Black for color. - Dimension -
ga:checkoutOptions
- User options specified during the checkout process, eg, FedEx, DHL, UPS for delivery options or Visa, MasterCard, AmEx for payment options. This dimension should be used along with Shopping Stage. - Dimension -
ga:shoppingStage
- Various stages of the shopping experience that users completed in a session, eg, PRODUCT_VIEW, ADD_TO_CART, CHECKOUT, etc. - Metric -
ga:internalPromotionCTR
- The rate at which users clicked through to view the internal promotion (number of clicks / number of times promotion appeared). - Metric -
ga:internalPromotionClicks
- The number of clicks on an internal promotion. - Metric -
ga:internalPromotionViews
- The number of views of an internal promotion. - Metric -
ga:localProductRefundAmount
- Refund amount for a given product in the local currency. - Metric -
ga:localRefundAmount
- Total refund amount for the transaction in the local currency. - Metric -
ga:productAddsToCart
- Number of times the product was added to the shopping cart. - Metric -
ga:productCheckouts
- Number of times the product was included in the check-out process. - Metric -
ga:productDetailViews
- Number of times users viewed the product-detail page. - Metric -
ga:productListClicks
- Number of times users clicked the product when it appeared in the product list. - Metric -
ga:productListViews
- Number of times the product appeared in a product list. - Metric -
ga:productListCTR
- The rate at which users clicked through on the product in a product list. - Metric -
ga:productRefunds
- Number of times a refund was issued for the product. - Metric -
ga:productRefundAmount
- Total refund amount associated with the product. - Metric -
ga:productRemovesFromCart
- Number of times the product was removed from shopping carts. - Metric -
ga:productRevenuePerPurchase
- Average product revenue per purchase (commonly used with Product Coupon Code). - Metric -
ga:buyToDetailRate
- Unique purchases divided by views of product detail pages. - Metric -
ga:cartToDetailRate
- Product adds divided by views of product details. - Metric -
ga:quantityAddedToCart
- Number of product units added to cart. - Metric -
ga:quantityCheckedOut
- Number of product units included in check out. - Metric -
ga:quantityRefunded
- Number of product units refunded. - Metric -
ga:quantityRemovedFromCart
- Number of product units removed from cart. - Metric -
ga:refundAmount
- Currency amount refunded for a transaction. - Metric -
ga:totalRefunds
- Number of refunds that have been issued.
Core Reporting API - Release 2014-06-04 (June 4, 2014)
This release includes a bug fix for column header names as well as the addition of new dimensions and metrics.
Dimensions and Metrics
Review the Dimensions and Metrics Reference for the complete list of definitions.
Система
- Dimension -
ga:sourcePropertyDisplayName
- Source property display name of roll-up properties. This is valid only for roll-up properties. - Dimension -
ga:sourcePropertyTrackingId
- Source property tracking ID of roll-up properties. This is valid only for roll-up properties
Channel Grouping
- Dimension -
ga:channelGrouping
- The default channel grouping that is shared within the View (Profile).
сопутствующие товары
- Dimension -
ga:correlationModelId
- Correlation Model ID for related products. - Dimension -
ga:queryProductId
- ID of the product being queried. - Dimension -
ga:queryProductName
- Name of the product being queried. - Dimension -
ga:queryProductVariation
- Variation of the product being queried. - Dimension -
ga:relatedProductId
- ID of the related product. - Dimension -
ga:relatedProductName
- Name of the related product. - Dimension -
ga:relatedProductVariation
- Variation of the related product. - Metric -
ga:correlationScore
- Correlation Score for related products. - Metric -
ga:queryProductQuantity
- Quantity of the product being queried. - Metric -
ga:relatedProductQuantity
- Quantity of the related product.
Header column name correction
- There was a bug in the 2014-04-16 release; if you queried for a deprecated dimension or metric, the API would return column headers with the replacement dimension or metric. Now it correctly returns the same dimension or metric name used in the request.
Metadata API - Release 2014-06-03 (June 3, 2014)
This release includes a naming convention change for the uiName
attribute.
uiName Change
- The uiName attribute for templatized columns now uses
XX
to represent the numeric index instead of1
. For example,Goal 1 Value
is nowGoal XX Value
.
Embed API - Release 2014-05 (May 28, 2014)
This is the initial release of the Embed API:
- The Google Analytics Embed API is a JavaScript library that allows you to easily create and embed a dashboard on a 3rd party website in a matter of minutes. Visit the Embed API Overview for more details.
- Includes components: auth, view selector, data, and data chart.
Provisioning API - Release 2014-05 (May 28, 2014)
This is the initial release of the Provisioning API:
- The Provisioning API can be used to programmatically create new Google Analytics accounts. This API is invite-only and intended for qualified service providers and large partners. Visit the Provisioning API Overview for more details.
Management API - Release 2014-05 (May 28, 2014)
This release adds two new configuration APIs.
AdWords Links
AdWords Links in the Management API allows you to create, list, get, update, patch, and delete links between Google AdWords accounts and Google Analytics properties and manage which Views (Profiles) are linked to Adwords data.
Фильтры
Filters in the Management API allows you to create, list, get, update, patch, and delete filters for your Google Analytics account. Profile Filter Links allow you to create, list, get, update, patch, and delete links between Filters and Views (Profiles).
Management API - Release 2014-05-27 (May 27, 2014)
Unsampled Reports: Management API
A new resource is being added to the Management API called Unsampled Reports . Unsampled reports are Google Analytics (GA) reports that have been generated using unsampled data. Unsampled reports are currently only available to GA Premium users.
- See the Developer Guide
Measurement Protocol - Release 2014-05-12 (May 12, 2014)
Updated the list of supported organic sources.
- Removed : Netscape, About, Mamma, Voila, Live, Wirtulana Polska, Yam, Ozu.
- Added/Updated : Baidu, DOCOMO, Onet, Centrum, Sogou, Tut.By, Globo, Ukr.net, So.com, au one.
Web Tracking (analytics.js) - Release 2014-05-12 (May 12, 2014)
Updated the list of supported organic sources.
- Removed : Netscape, About, Mamma, Voila, Live, Wirtulana Polska, Yam, Ozu.
- Added/Updated : Baidu, DOCOMO, Onet, Centrum, Sogou, Tut.By, Globo, Ukr.net, So.com, au one.
iOS SDK - Release Version 3.07 (May 9, 2014)
This release contains:
Гугл Аналитика
- Added User Id field.
Диспетчер тегов Google
- Fixed a bug in Id for Advertising Macro so that it can correctly return identifier for advertiser (IDFA) if available.
- Fixed an issue so users can use
NSNumber
for ecommerce data.
Metadata API - Release 2014-04-16 (April 16, 2014)
This release includes the deprecation of the appUiName
attribute. Review the Data Deprecation Policy for details on attribute removal:
appUiName Deprecation
- The
appUiName
has been deprecated. It is no longer required in the Metadata API because UI names for web and app views (profiles) have been unified. You should remove any code that uses theappUiName
attribute and only use theuiName
attribute.
Real Time Reporting API - Release 2014-04-16 (April 16, 2014)
This release includes the renaming of dimensions and metrics. Review the Dimensions and Metrics Reference for the complete list of definitions.
Переименованные параметры и показатели
The following dimensions and metrics have been renamed. Review the Data Deprecation Policy for details on data renaming:
Пользователь
- Dimension -
rt:visitorType
- Usert:userType
instead. - Metric -
rt:activeVisitors
- Usert:activeUsers
instead.
Core Reporting API - Release 2014-04-16 (April 16, 2014)
This release includes the addition and renaming of dimensions and metrics. Review the Dimensions and Metrics Reference for the complete list of definitions.
New Dimensions and Metrics
The following dimensions have been added to the Core Reporting API:
AdWords
- Dimension -
ga:isTrueViewVideoAd
-Yes
orNo
- Indicates whether the ad is an AdWords TrueView video ad.
Время
- Dimension -
ga:nthHour
- Index for each hour in the specified date range. Index for the first hour of first day (ie, start-date) in the date range is 0, 1 for the next hour, and so on.
Переименованные параметры и показатели
All visitor and visit based dimensions and metrics have been renamed to instead use user and session respectively.
The following dimensions and metrics have been renamed. Review the Data Deprecation Policy for details on data renaming:
Аудитория
- Dimension -
ga:visitorAgeBracket
- Usega:userAgeBracket
instead. - Dimension -
ga:visitorGender
- Usega:userGender
instead.
Электронная коммерция
- Metric -
ga:transactionRevenuePerVisit
- Usega:transactionRevenuePerSession
instead. - Metric -
ga:transactionsPerVisit
- Usega:transactionsPerSession
instead.
Отслеживание событий
- Metric -
ga:eventsPerVisitWithEvent
- Usega:eventsPerSessionWithEvent
instead. - Metric -
ga:visitsWithEvent
- Usega:sessionsWithEvent
instead.
Goal Conversions
- Metric -
ga:goalValuePerVisit
- Usega:goalValuePerSession
instead.
Internal Search
- Metric -
ga:percentVisitsWithSearch
- Usega:percentSessionsWithSearch
instead. - Metric -
ga:searchVisits
- Usega:searchSessions
instead.
Page Tracking
- Metric -
ga:pageviewsPerVisit
- Usega:pageviewsPerSession
instead.
Сессия
- Dimension -
ga:visitLength
- Usega:sessionDurationBucket
instead. - Metric -
ga:avgTimeOnSite
- Usega:avgSessionDuration
instead. - Metric -
ga:timeOnSite
- Usega:sessionDuration
instead. - Metric -
ga:visitBounceRate
- Usega:bounceRate
instead. - Metric -
ga:visits
- Usega:sessions
instead.
Социальные взаимодействия
- Dimension -
ga:socialInteractionNetworkActionVisit
- Usega:socialInteractionNetworkActionSession
instead. - Metric -
ga:socialInteractionsPerVisit
- Usega:socialInteractionsPerSession
instead.
Пользователь
- Dimension -
ga:daysSinceLastVisit
- Usega:daysSinceLastSession
instead. - Dimension -
ga:visitCount
- Usega:sessionCount
instead. - Dimension -
ga:visitorType
- Usega:userType
instead. - Dimension -
ga:visitsToTransaction
- Usega:sessionsToTransaction
instead. - Metric -
ga:newVisits
- Usega:newUsers
instead. - Metric -
ga:percentNewVisits
- Usega:percentNewSessions
instead. - Metric -
ga:visitors
- Usega:users
instead.
Measurement Protocol - Release 2014-04-16 (April 16, 2014)
This release contains the replacement of the appview
hit type and the addition and renaming of parameters. Review the Parameter Reference for the complete list of parameters.
appview Replacement
- The
appview
hit type has been replaced withscreenview
. Update your app tracking code as soon as possible to usescreenview
instead ofappview
.
New Parameters
- Application ID - Application identifier.
- Application Installer ID - Application installer identifier.
Parameter Rename
- Content Description has been renamed to Screen Name . The query parameter name,
cd
, will remain the same.
Web Tracking (analytics.js) - Release 2014-04-16 (April 16, 2014)
This release contains the replacement of the appview
hit type and the addition of new fields. Review the Field Reference for the complete list of fields.
appview Replacement
- The
appview
hit type has been replaced withscreenview
. Update your app tracking code as soon as possible to usescreenview
instead ofappview
.
New Fields
- Screen Name - The name of the page/screen. When not set it defaults to the page URL (web) or Id of the screen (app).
- Application ID - Application identifier.
- Application Installer ID - Application installer identifier.
Другие изменения
- Improved debug output.
- Fixed various prerendering bugs.
- Added support for unprefixed prerendering apis. Prerendering now works in IE11 in addition to Chrome.
- Other minor bug fixes in linker support.
Web Tracking (ga.js) - Release 2014-04-16 (April 16, 2014)
- Yahoo secure search is now correctly classified as an organic source.
- Added support for unprefixed prerendering apis. Prerendering now works in IE11 in addition to Chrome.
Core Reporting API - Release 2014-04-11 (April 11, 2014)
Segments: Core Reporting API v2.4 & v3.0
New segments support in the Core Reporting API.
- The
segment
parameter now supports user and sequence segments. User level and session level segments created in the web interface can be queried with thesegment
parameter. - A new syntax for dynamic segments is available to use with the
segment
parameter. For details see the Segments Dev Guide - The
dynamic::
prefix has been deprecated. It is recommended that you migrate to the new syntax as soon as possible.
Management API - Release 2014-04-11 (April 11, 2014)
Segments: Management API v2.4 & v3.0
The following changes have been made to the Segments Collection :
- User and sequence segments are now supported in the API.
- The Segments Collection now returns all built-in and custom session level and user level segments.
- The
definition
property for segments will now use the new segments syntax. This includes definitions for existing session level segments which will change fromdefinition: " "
definition: " "
definition: "sessions::condition:: "
definition: "sessions::condition:: "
- A new
type
property has been added to the Segment resource to indicate whether a segment isCUSTOM
(ie created by a user in the web interface) orBUILT_IN
(ie provided by Google Analytics).
Эксперименты
The following AdSense metrics can now be used as optimization objectives:
-
ga:adsenseAdsClicks
— The number of times AdSense ads on your site were clicked. -
ga:adsenseAdsViewed
— The number of AdSense ads viewed. Multiple ads can be displayed within an Ad Unit. -
ga:adsenseRevenue
— The total revenue from AdSense ads.
Web Tracking (analytics.js) - Release 2014-04 (April 2, 2014)
- Added the ability to override User ID parameter .
Management API - Release 2014-03-25 (March 25, 2014)
New Account Summaries Collection
- The AccountSummaries collection has been added to the Management API. It provides a summary of information for each account, property, and view (profile) an authorized user has access to in a single and fast request. See the Account Summaries Developer Guide for details.
Android SDK - Release Version 4 (March 25, 2014)
Google Analytics and Google Tag Manager
- The Google Analytics and Google Tag Manager SDKs are now part of the Google Play Services SDK 4.3 .
- This does not require devices to have Google Play Services installed. When Google Play Services is not available the SDK will automatically fall back to local dispatching.
- For details on how to get started see Google Tag Manager SDK v4 for Android and Google Analytics SDK v4 for Android
Real Time Reporting API - Release 2014-03 (March 20, 2014)
ga:
Prefix Deprecated
The ga:
prefix has been deprecated for all Real Time Dimensions and Metrics and has been replaced by the new rt:
prefix. API requests that use the ga:
prefix will continue to work for 6 months, after which an error will be returned.
New Dimensions and Metrics
This update adds new dimensions and metrics to the Real Time Reporting API. Check the Dimensions and Metrics Reference for the complete list.
Отслеживание событий
- Dimension -
rt:eventAction
- the action of the event. - Dimension -
rt:eventCategory
- the category of the event. - Dimension -
rt:eventLabel
- the label of the event. - Dimension -
rt:totalEvents
- the total number of events for the profile, across all categories.
Goal Tracking
- Dimension -
rt:goalId
- a string corresponding to the goal ID. - Metric -
rt:goalXXValue
- the total numeric value for the requested goal number, where XX is a number between 1 and 20. - Metric -
rt:goalValueAll
- the total numeric value for all goals defined for your profile. - Metric -
rt:goalXXCompletions
- the total number of completions for the requested goal number, where XX is a number between 1 and 20. - Metric -
rt:goalCompletionsAll
- the total number of completions for all goals defined for your profile.
Page Tracking
- Metric -
rt:pageViews
- the total number of page views.
App Tracking
- Metric -
rt:screenViews
- the total number of screen views.
iOS SDK - Release Version 3.06 (March 18, 2014)
This release contains:
Гугл Аналитика
- SDK will now populate the Application Id parameter (
&aid
) by default.
Диспетчер тегов Google
- Added support for Google Analytics Content Experiments Macro.
Android SDK - Release Version 3.02 (March 18, 2014)
This release contains:
Гугл Аналитика
- No changes to Google Analytics.
Диспетчер тегов Google
- Added support for Google Analytics Content Experiments Macro.
iOS SDK - Release Version 3.03c (February 19, 2014)
This release contains:
Гугл Аналитика
- No changes to Google Analytics directly. GA users should note that Google Tag Manager no longer has a dependency on
AdSupport.framework
by default. This may help resolve Issue 387 .
Диспетчер тегов Google
- Functions that call
AdSupport.framework
API are broken out into a separate library,libAdIdAccess.a
. Apps need to link with that library to have access to the advertising identifier (IDFA) string and advertiser tracking enabled flag.
Multi-Channel Funnels Reporting API - Release 2014-02-14 (February 14, 2014)
This release adds new dimensions and metrics to the API. Check the Dimensions and Metrics Reference for the complete list of definitions.
Conversion Paths
- Dimension -
mcf:adwordsCustomerIDPath
- Sequence of AdWords customer ID along conversion paths.
Interactions
- Dimension -
mcf:adwordsCustomerID
- Corresponds to AdWords APICustomer.id
.
Web Tracking (analytics.js) - Release 2014-02 (February 11, 2014)
- Linker parameters are no longer ignored when navigating across domains at different zoom levels in Firefox.
- Fixed a problem where In-Page Analytics would fail to load for certain URLs.
- Improvements to debug mode output.
Web Tracking (ga.js) - Release 2014-02 (February 11, 2014)
- Maintenance release.
iOS SDK - Release Version 3.03a (February 5, 2014)
This release contains: * Removed need for AdSupport.framework
. * Removed unused code.
iOS SDK - Release Version 3.03 (January 14, 2014)
This release contains: * Added support for 64-bit iOS 7.0 SDK. * Removed libGoogleAnalytics_debug.a
, it's part of the libGoogleAnalyticsServices.a
library. * Cleaned up CuteAnimals build file for Google Analytics.
Multi-Channel Funnels Reporting API - Release 2013-12-12 (December 12, 2013)
This release adds new dimensions and metrics to the API. Check the Dimensions and Metrics Reference for the complete list of definitions.
Conversion Paths
- Dimension -
mcf:adwordsAdGroupIDPath
- Sequence of AdWords ad group ID along conversion paths. - Dimension -
mcf:adwordsCampaignIDPath
- Sequence of AdWords campaign ID along conversion paths. - Dimension -
mcf:adwordsCreativeIDPath
- Sequence of AdWords creative ID along conversion paths. - Dimension -
mcf:adwordsCriteriaIDPath
- Sequence of AdWords criteria ID along conversion paths.
Interactions
- Dimension -
mcf:adwordsAdGroupID
- Corresponds to AdWords APIAdGroup.id
. - Dimension -
mcf:adwordsCampaignID
- Corresponds to AdWords APICampaign.id
. - Dimension -
mcf:adwordsCreativeID
- Corresponds to AdWords APIAd.id
. - Dimension -
mcf:adwordsCriteriaID
- Corresponds to AdWords APICriterion.id
.
Core Reporting API - Release 2013-12-12 (December 12, 2013)
This release includes a new Data Table response format and the addition and deprecation of dimensions and metrics (Review the Dimensions and Metrics Reference for the complete list of definitions).
Data Table Output
To make it easier to render your Google Analytics data using Google Charts visualizations, the API can optionally return a Data Table object in the response.
- An optional
output
query parameter has been added to the API. It can be used to select the output format of Analytics data in the response, which is JSON by default. If set todatatable
, adataTable
property that contains a Data Table object is included in the response. This object can be used directly with Google Charts . See the Core Reporting API reference for details.
New Dimensions and Metrics
The following dimensions and metrics have been added to the Core Reporting API:
Время
- Dimension -
ga:minute
- Returns the minute in the hour. The possible values are between00
and59
. - Dimension -
ga:nthMinute
- Index for each minute in the specified date range. Index for the first minute of first day (ie, start-date) in the date range is0
,1
for the next minute, and so on.
Аудитория
- Dimension -
ga:visitorAgeBracket
- Age bracket of visitor. - Dimension -
ga:visitorGender
- Gender of visitor. - Dimension -
ga:interestAffinityCategory
- Indicates that users are more likely to be interested in learning about the specified category. - Dimension -
ga:interestInMarketCategory
- Indicates that users are more likely to be ready to purchase products or services in the specified category. - Dimension -
ga:interestOtherCategory
- Indicates that users are more likely to be interested in learning about the specified category, and more likely to be ready to purchase.
Dimensions and Metrics Allowed In Segments
These dimensions and metrics can now be used in segments:
- Dimension -
ga:sourceMedium
- Combined values ofga:source
andga:medium
. - Metric -
ga:localItemRevenue
- Product revenue in local currency.
Deprecated Dimensions and Metrics
These dimensions and metrics have been deprecated. Review the Data Deprecation Policy for details on data removal:
- Dimension -
ga:isMobile
- Usega:deviceCategory
instead (eg,ga:deviceCategory==mobile
). - Dimension -
ga:isTablet
- Usega:deviceCategory
instead (eg,ga:deviceCategory==tablet
). - Metric -
ga:entranceBounceRate
- Usega:visitBounceRate
instead.
Management API - Release 2013-12-12 (December 12, 2013)
The following changes have been made to default segments due to the deprecation of the ga:isMobile
and ga:isTablet
dimensions:
- Segment
gaid::-11
has been renamed from Mobile Traffic to Mobile and Tablet Traffic . The definition for this segment has been changed fromga:isMobile==Yes
toga:deviceCategory==mobile,ga:deviceCategory==tablet
. Note thatga:isMobile
included tablet traffic, which is reflected in the new definition. If you only want mobile traffic, excluding tablet, then switch to the new Mobile Traffic segment (gaid::-14
). - Segment
gaid::-13
definition has changed fromga:isTablet==Yes
toga:deviceCategory==tablet
. This continues to represent Tablet Traffic . - Segment
gaid::-14
has been added. The name of the segment is Mobile Traffic and the definition isga:deviceCategory==mobile
.
Web Tracking (analytics.js) - Release 2013-11 (November 22, 2013)
- Maintenance release.
Web Tracking (ga.js) - Release 2013-11 (November 22, 2013)
- Improvements to support Universal Analytics upgrades on sites that use multiple trackers.
Web Tracking (analytics.js) - Release 2013-11 (November 7, 2013)
- Added Automatic Cookie Domain Configuration
- Added Cross-Domain Auto Linking for Forms
- Исправление ошибок
Core Reporting API - Release 2013-10-28 (October 28, 2013)
This release adds new dimensions and metrics to the API. Check the Dimensions and Metrics Reference for the complete list of definitions.
Adsense
Access to Adsense data has been added:
- Met -
ga:adsenseRevenue
- The total revenue from AdSense ads. - Met -
ga:adsenseAdUnitsViewed
- The number of AdSense ad units viewed. An Ad unit is a set of ads displayed as a result of one piece of the AdSense ad code. Details: https://support.google.com/adsense/answer/32715 . - Met -
ga:adsenseAdsViewed
- The number of AdSense ads viewed. Multiple ads can be displayed within an Ad Unit. - Met -
ga:adsenseAdsClicks
- The number of times AdSense ads on your site were clicked. - Met -
ga:adsensePageImpressions
- The number of pageviews during which an AdSense ad was displayed. A page impression can have multiple Ad Units. - Met -
ga:adsenseCTR
- The percentage of page impressions that resulted in a click on an AdSense ad. (ga:adsenseAdsClicks/ga:adsensePageImpressions
) - Met -
ga:adsenseECPM
- The estimated cost per thousand page impressions. It is your AdSense Revenue per 1000 page impressions. (ga:adsenseRevenue/(ga:adsensePageImpressions/1000). - Met -
ga:adsenseExits
- The number of sessions that ended due to a user clicking on an AdSense ad.
- Met -
Время
- Dim -
ga:isoYear
- The ISO year of the visit. Details: http://en.wikipedia.org/wiki/ISO_week_date .ga:isoYear
should only be used withga:isoWeek
sincega:week
represents gregorian calendar. - Dim -
ga:isoYearIsoWeek
- Combined values ofga:isoYear
andga:isoWeek
.
Adwords
This data is found in Adwords reports:
- Dim -
ga:adKeywordMatchType
- The match types applied to your keywords (Phrase, Exact, Broad). Details: Understanding the Search terms report .
- Dim -
Management API - Release 2013-10-28 (October 28, 2013)
Исправление ошибок:
- Timezone information for views (profiles) has been fixed. Details : Before this fix, in certain cases when listing view (profiles) in the Management API, incorrect timezone information for a view (profile) was returned. Now timezone information for views (profiles) is consistent with what is set in the Google Analytics admin interface.
iOS SDK - Release Version 3.02 (October 18, 2013)
This release contains: * Fixed conflict with protocol buffer SDK. * Fixed linker error when code stripping was enabled.
API для создания отчетов по многоканальным последовательностям – выпуск от 14 октября 2013 г. (14 октября 2013 г.)
New Sample Size Control and Relative Dates Features
Relative Dates
- Support for relative dates has been added to the MCF Reporting API.
today
,yesterday
, andNdaysAgo
are now valid values for thestart-date
andend-date
query parameters. - Using these values will automatically determine the date range based on the current date at the time the query is made, and on the timezone of the view (profile) specified in the query. See the API Reference for additional details.
Sampling Level
- A new parameter,
samplingLevel
, has been introduced that allows you to set the sampling level (ie the number of visits used to calculate the result) for a reporting query. Allowed values are:DEFAULT
,FASTER
, andHIGHER_PRECISION
. - 2 new fields have been added to the API Response:
sampleSize
andsampleSpace
. You can use these values to calculate the percentage of visits that were used for a sampled response. - See the API Reference and Sampling for additional details.
Core Reporting API - Release 2013-10-14 (October 14, 2013)
New Sample Size Control and Relative Dates Features
Relative Dates
- Support for relative dates has been added to the Core Reporting API.
today
,yesterday
, andNdaysAgo
are now valid values for thestart-date
andend-date
query parameters. - Using these values will automatically determine the date range based on the current date at the time the query is made, and on the timezone of the view (profile) specified in the query. See the API Reference for additional details.
Sampling Level
- A new parameter,
samplingLevel
, has been introduced that allows you to set the sampling level (ie the number of visits used to calculate the result) for a reporting query. Allowed values are:DEFAULT
,FASTER
, andHIGHER_PRECISION
. - 2 new fields have been added to the API Response:
sampleSize
andsampleSpace
. You can use these values to calculate the percentage of visits that were used for a sampled response. - See the API Reference and Sampling for additional details.
Android SDK - Release Version 2.0beta6 (October 11, 2013)
This release contains: * Sixth beta release. * Made change required to avoid a runtime exception when an app targeting KitKat (API Level 19) uses the SDK.
Android SDK - Release Version 3.01 (October 11, 2013)
This release contains: * Second release of version 3.0. * Made change required to avoid a runtime exception when an app targeting KitKat (API Level 19) uses the SDK.
Management API - Release 2013-10-04 (October 4, 2013)
Uploads (Dimension Widening)
- The new Uploads resource enables uploading of Dimension Widening data. See the Data Import (Uploads) Developer Guide for details.
Management API - Release 2013-10-03 (October 3, 2013)
This release introduces write operations for Web Property, View (Profile), and Goal resources and a set of 3 new resources that enable User Permissions management.
Account Setup and Configuration APIs
- Views (Profiles) can now be created, updated, patched, and deleted. Review the View (Profiles) reference for details on the new methods.
- Web Properties and Goals can now be created, updated, and patched. Review the Web Properties reference and Goals reference for details on the new methods.
- A single Web Property, View (Profile), or Goal can now be requested with the
get
method. - These features are currently available as a developer preview in limited beta. If you're interested is signing up, request access to the beta .
User Permissions in the Management API
- The new accountUserLinks resource enables the management of account permissions for users.
- The new webpropertyUserLinks resource enables the management of property permissions for users.
- The new profileUserLinks resource enables the management of view (profile) permissions for users.
- Permissions for an authorized user are now available as part of the Account , Web Property and View (Profile) resources.
- A new scope has been introduced and is required to manage user permissions.
https://www.googleapis.com/auth/analytics.manage.users
. - See the User Permissions Dev Guide for additional details.
iOS SDK - Release Version 3.01 (September 20, 2013)
This release contains:
- Fixed link error when targeting iOS 7.0.
Metadata API - Release 2013-08 (August 20, 2013)
This is the initial release of the Metadata API:
- The Metadata API returns information about the dimensions and metrics exposed in Google Analytics reporting APIs. The metadata returned includes attributes like UI name, description, advanced segments support, and more. By using the Metadata API, your applications can automatically stay up to date with the latest data on the dimensions and metrics available for reporting queries. Visit the Metadata API Overview for more details.
iOS SDK - Release Version 3.0.0 (August 16, 2013)
This release contains: * First release of version 3.0 * SDK API change to align with analytics.js. track
send
send
and the GAIDictionaryBuilder
construct methods instead. * Most properties on the GAITracker
protocol have been removed. Use set
on the various fields instead. * All parameters set using the set
method will be persisted. Previously, several parameters would only be set for the next send/track call. * GAILogger
protocol is available for those wanting to implement their own custom logging for the SDK. * Minimium system requirements have changed. See Readme.txt for details. * All SDK activity (database and network access) is now done on a separate thread. * clientId
can now be read. Call [tracker get:kGAIClientId]
. Note that this call will block until the clientId
can be read from the database. * SDK no longer uses POST
unless the hit is larger than 2000 bytes. It will use GET
instead. * SDK will no longer retry sending hits based off the HTTP response code.
Android SDK - Release Version 3.0.0 (August 16, 2013)
This release contains: * First release of version 3.0 * SDK API rewritten to more closely align with analytics.js. See javadoc and /analytics/devguides/collection/android/v3/ for details. * All track
send
MapBuilder
class to send hits. See the class Fields
for a list of constants you can use to build hits using set
and send
. * Many of the various properties have also been removed, including useHttps
, anonymizeIp
, etc. You can set/reset those properties using the set
command. * EasyTracker
now extends Tracker
. There is no need to call EasyTracker.getTracker
to make tracking calls directly. * The SDK no longer sets the session control flag to start on startup. Developers are now responsible for determining if a new session is needed. Note that EasyTracker still handles session management as before. * The SDK now supports a custom logging class. See Logger
in the javadoc for details. * dryRun
mode has been added. * clientId
can now be read. Simply call tracker.get(Fields.CLIENT_ID)
. This call will block until the clientId
has been loaded from the persistent store. * The SDK will no longer retry hits based on the HTTP response code.
Real Time Reporting API - Release 2013-08 (August 1, 2013)
This is the initial release of the Real Time Reporting API in limited beta:
- The Real Time Reporting API allows you to report on activity occurring on your property right now. You can use the Real Time reporting API to query for dimensions and metrics in order to build customer facing web widgets and dashboards. Visit the Real Time Reporting API Overview for more details.
Core Reporting API - Release 2013-07-22 (July 23, 2013)
Исправление ошибок
- The
ga:adwordsCustomerID
now correctly returns the 10-digit AdWords Customer ID corresponding to the AdWords API AccountInfo.customerId . This fix makes it possible to join Analytics data with multiple AdWords accounts.
Core Reporting API - Release 2013-07-15 (July 16, 2013)
As part of the new segments launch , we will be rolling out the following changes to the Core Reporting API.
- The
segment
parameter now supports the new alphanumeric ID for custom advanced segments, which is returned in the Management API Segments collection . - The current numeric IDs for custom segments are now under deprecation. These legacy IDs will continue to be supported for 6 months. We recommend applications that save user segment IDs to switch to the new alphanumeric IDs. Once the deprecation period is over, any queries with the old numeric IDs will return an error.
- Currently, only the visit level segments created in the web interface will be queryable through the
segment
parameter. - The existing default segments with negative numeric IDs will not be affected. However, the new default segments are currently not supported.
Management API - Release 2013-07-15 (July 16, 2013)
As part of the new segments launch , we will be rolling out the following changes to the Segments Collection :
- All Segment IDs will be changed from positive integers to alphanumeric strings. If you have saved users' Segment IDs, we recommend you update them to use the new IDs.
- The Segments Collection will only return the existing visit level segments. The new visitor, cohort, and sequence segments are currently not supported in the API.
- The Segments Collection will continue to return the existing default segments with the same negative numeric IDs, however, the new default segments are currently not supported.
Core Reporting API - Release 2013-07-09 (July 9, 2013)
This release adds new dimensions and metrics to the API. Check the Dimensions and Metrics Reference for the complete list of definitions.
App Tracking
- This data is found in App profile reports:
- Dim -
ga:appId
- The id of the application. - Dim -
ga:appInstallerId
- ID of the installer (eg, Google Play Store) from which the app was downloaded. By default, the app installer id is set based on thePackageManager#getInstallerPackageName
method. - Dim -
ga:appName
- The name of the application. - Dim -
ga:appVersion
- The version of the application. - Dim -
ga:exitScreenName
- The name of the screen when the user exited the application. - Dim -
ga:landingScreenName
- The name of the first screen viewed. - Dim -
ga:screenDepth
- The number of screenviews per session reported as a string. Can be useful for historgrams. - Dim -
ga:screenName
- The name of the screen. - Met -
ga:avgScreenviewDuration
- The average amount of time users spent on a screen in seconds. - Met -
ga:timeOnScreen
- The time spent viewing the current screen. - Met -
ga:screenviews
- The total number of screen views. Use this instead ofga:appviews
. - Met -
ga:uniqueScreenviews
- The number of different (unique)ga:screenviews
within a session. Use this instead ofga:uniqueAppviews
. - Met -
ga:screenviewsPerSession
- The average number ofga:screenviews
per session. Use this instead ofga:appviewsPerVisit
.
- Dim -
Deprecated
The following metrics have been deprecated. Use the new metric name instead.
- Met -
ga:appviews
- Usega:screenviews
instead. - Met -
ga:uniqueAppviews
- Usega:uniqueScreenviews
instead. - Met -
ga:appviewsPerVisit
- Usega:screenviewsPerSession
instead.
Custom Variables or Columns
Access to custom dimension and metrics:
- Dim -
ga:dimensionXX
- The name of the requested custom dimension, whereXX
refers the number/index of the custom dimension. - Met -
ga:metricXX
- The name of the requested custom metric, whereXX
refers the number/index of the custom metric.
- Dim -
Documentation Changes
The following Custom Variable dimension and metric have been renamed. This is a documentation change only, it will not require you to update your queries.
-
ga:customVarName(n)
→ga:customVarNameXX
-
ga:customVarValue(n)
→ga:customVarValueXX
Электронная коммерция
- Dim -
ga:currencyCode
- The local currency code of the transaction based on ISO 4217 standard. - Met -
ga:localItemRevenue
- Product revenue in local currency. - Met -
ga:localTransactionRevenue
- Transaction revenue in local currency. - Met -
ga:localTransactionShipping
- Transaction shipping cost in local currency. - Met -
ga:localTransactionTax
- Transaction tax in local currency.
Исключения
- This data comes from exception tracking.
- Dim -
ga:exceptionDescription
- The description for the exception. - Met -
ga:exceptionsPerScreenview
- The number of exceptions thrown divided by the number of screenviews. - Met -
ga:fatalExceptionsPerScreenview
- The number of fatal exceptions thrown divided by the number of screenviews.
- Dim -
Goal Conversions
- Dim -
ga:goalCompletionLocation
- The page path or screen name that matched any destination type goal completion. - Dim -
ga:goalPreviousStep1
- The page path or screen name that matched any destination type goal, one step prior to the goal completion location. - Dim -
ga:goalPreviousStep2
- The page path or screen name that matched any destination type goal, two steps prior to the goal completion location. - Dim -
ga:goalPreviousStep3
- The page path or screen name that matched any destination type goal, three steps prior to the goal completion location.
Documentation Changes
The following Goal Conversions dimension and metrics have been renamed. This is a documentation change only, it will not require you to update your queries.
-
ga:goal(n)AbandonRate
→ga:goalXXAbandonRate
-
ga:goal(n)Abandons
→ga:goalXXAbandons
-
ga:goal(n)Completions
→ga:goalXXCompletions
-
ga:goal(n)ConversionRate
→ga:goalXXConversionRate
-
ga:goal(n)Starts
→ga:goalXXStarts
-
ga:goal(n)Value
→ga:goalXXValue
-
ga:searchGoal(n)ConversionRate
→ga:searchGoalXXConversionRate
Internal Search
- Met -
ga:percentSearchRefinements
- The percentage of number of times a refinement (ie, transition) occurs between internal search keywords within a session.
Page Tracking
- Met -
ga:pageValue
- The average value of this page or set of pages. Page Value is ((Transaction Revenue + Total Goal Value) divided by Unique Pageviews for the page or set of pages).
Platform or Device
This data is derived from the HTTP User-Agent string.
- Dim -
ga:deviceCategory
- The type of device: Desktop, Tablet, or Mobile. - Dim -
ga:isTablet
- Indicates tablet visitors. The possible values areYes
orNo
. - Dim -
ga:mobileDeviceMarketingName
- Marketing name used for mobile device.
- Dim -
Социальные взаимодействия
This data comes from onsite social interaction tracking.
- Dim -
ga:socialEngagementType
- Engagement type. Possible values areSocially Engaged
orNot Socially Engaged
.
- Dim -
Время
- Dim -
ga:dateHour
- Combined values ofga:date
andga:hour
. - Dim -
ga:dayOfWeekName
- The name of the day of the week (in English). - Dim -
ga:isoWeek
- The ISO week number, where each week starts with a Monday. Details: http://en.wikipedia.org/wiki/ISO_week_date . - Dim -
ga:yearMonth
- Combined values ofga:year
andga:month
. - Dim -
ga:yearWeek
- Combined values ofga:year
andga:week
.
Traffic Sources
- Dim -
ga:fullReferrer
- The full referring URL including the hostname and path. - Dim -
ga:sourceMedium
- The combined values ofga:source
andga:medium
.
Management API - Release 2013-06-05 (June 5, 2013)
This release adds 2 new properties to the Webproperty resource :
-
profileCount
- Returns profile count for a property. This allows you to filter properties that don't have any profiles (ie, profileCount = 0). -
industryVertical
- Returns the industry vertical/category selected for a property.
Исправление ошибок:
- The
eCommerceTracking
property of the Profile resource is now consistent with Ecommerce settings in the admin section of the web interface. Returnstrue
when Ecommerce tracking is enabled, andfalse
if not.
Management API - Release 2013-05-08 (May 8, 2013)
- The Webproperty resource now includes a
level
property to indicate whether the web property isPREMIUM
orSTANDARD
.
Android SDK - Release Version 2.0beta5 (April 10, 2013)
This release contains: * Fifth beta release. * EasyTracker exception parsing bug fix. When ga_reportUncaughtExceptions
flag is set, we were not initializing the exception parser, and as a result not parsing the location of an uncaught exception. With this fix, the crash and exception reports will report the location of uncaught exceptions when ga_reportUncaughtExceptions
is set to true.
Core Reporting API - Release 2013-04-04 (April 4, 2013)
- This release adds 2 new experiments metrics : -
ga:experimentId
-ga:experimentVariant
Management API - Release 2013-04-04 (April 4, 2013)
- A new endpoint has been added to the Management API v3 to access and modify Experiments resources.
Measurement Protocol - Release 2013-03 (March 22, 2013)
Today we launched the new Measurement Protocol into Public Beta.
Web Tracking (analytics.js) - Release 2013-03 (March 22, 2013)
Today we launched the new analytics.js collection library into Open Beta.
Web Tracking (ga.js) - Release 2013-02 (February 13, 2013)
The following changes have been pushed to the latest version of the tracking code:
- Added support for specifying local currencies with
_set
, eggaq.push(['_set', 'currencyCode', 'EUR'])
Core Reporting API - Release 2013-01-31 (January 31, 2013)
- This release adds 5 new site speed metrics:
-
ga:domInteractiveTime
-
ga:avgDomInteractiveTime
-
ga:domContentLoadedTime
-
ga:avgDomContentLoadedTime
-
ga:domLatencyMetricsSample
-
Core Reporting API - Release 2013-01-14 (January 14, 2013)
- This release adds a new default segment for Tablet Traffic,
gaid::-13
.
Management API - Release 2013-01-14 (January 14, 2013)
- The Profile resource now includes a
type
property to identify whether a profile is configured for a Web site or App. The two possible values are:WEB
orAPP
.
iOS SDK - Release Version 2.0beta4 (January 8, 2013)
This release contains:
- Change default appVersion to the value in
CFBundleShortVersionString
instead ofCFBundleVersionKey
. - Use HTTPS as the default protocol instead of HTTP.
- Track methods changed to Send (eg
trackView
now calledsendView
). - Some minor bug fixes.
Android SDK - Release Version 2.0beta4 (January 8, 2013)
This release contains: * Fourth beta release. * The SDK will now respect the sample rate setting. If you previously set the sample rate to other than 100% you will now see a corresponding decrease in some of your Analytics metrics compared with beta 3. * Changed track methods to send (eg trackView
now called sendView
). * Added local currency support via Transaction.setCurrencyCode
* Use HTTPS by default instead of HTTP. * SDK will not attempt to dispatch hits if there is no network connectivity. * Avoid ANRs while attempting to handle install campaign data. * Removed TrackedActivity
classes from the SDK. * Move SDK initialization off the main UI Thread. * Improve the SDK's ability to recover from a corrupted SQLite database. * Several other crashes and bugs fixed.
iOS SDK - Release Version 2.0beta3 iOS6 Update (September 26, 2012)
This release contains:
- Added armv7s architecture to libGoogleAnalytics.a.
- Removed armv6 architecture from libGoogleAnalytics.a.
Core Reporting API - Release 2012-09 (September 18, 2012)
This release adds new dimensions and metrics to the API. Check the Dimensions and Metrics Reference for definitions.
App Tracking
- This data is found in Mobile App tracking SDK reports:
- Met -
ga:uniqueAppviews
- The number of app views per session. - Met -
ga:appviews
- The total number of app views. - Met -
ga:appviewsPerVisit
- The average number of app views per session.
- Met -
Traffic Sources
- Dim -
ga:socialNetwork
- A string representing the social network name. This can be related to the referring social network for traffic sources, or to the social network for social data hub activities. Eg Google+, Blogger, reddit, etc. - Dim -
ga:hasSocialSourceReferral
- Indicates visits that arrived to the site from a social source (ie A social network such as Google+, Facebook, Twitter, etc.). The possible values are Yes or No, where the first letter must be capitalized.
Культурно-просветительные мероприятия
- This data comes from offsite activity imported from Social Data Hub partners.
- Dim -
ga:socialActivityDisplayName
- For a social data hub activity, this string represents the title of the social activity posted by the social network user. - Dim -
ga:socialActivityEndorsingUrl
- For a social data hub activity, this string represents the URL of the social activity (eg the Google+ post URL, the blog comment URL, etc.) - Dim -
ga:socialActivityPost
- For a social data hub activity, this string represents the content of the social activity posted by the social network user (eg The message content of a Google+ post) - Dim -
ga:socialActivityTimestamp
- For a social data hub activity, this string represents when the social activity occurred on the social network. - Dim -
ga:socialActivityUserPhotoUrl
- For a social data hub activity, this string represents the URL of the photo associated with the user's social network profile. - Dim -
ga:socialActivityUserProfileUrl
- For a social data hub activity, this string represents the URL of the associated user's social network profile. - Dim -
ga:socialActivityContentUrl
- For a social data hub activity, this string represents the URL shared by the associated social network user. - Dim -
ga:socialActivityTagsSummary
- For a social data hub activity, this is a comma-separated set of tags associated with the social activity. - Dim -
ga:socialActivityUserHandle
- For a social data hub activity, this string represents the social network handle (ie name) of the user who initiated the social activity. - Dim -
ga:socialActivityAction
- For a social data hub activity, this string represents the type of social action associated with the activity (eg vote, comment, +1, etc.). - Dim -
ga:socialActivityNetworkAction
- For a social data hub activity, this string represents the type of social action and the social network where the activity originated. - Met -
ga:socialActivities
- The count of activities where a content URL was shared/mentioned on a social data hub partner network.
- Dim -
Социальные взаимодействия
- This data comes from onsite social interaction tracking.
- Dim -
ga:socialInteractionAction
- For social interactions, a string representing the social action being tracked (eg +1, like, bookmark) - Dim -
ga:socialInteractionNetwork
- For social interactions, a string representing the social network being tracked (eg Google, Facebook, Twitter, LinkedIn) - Dim -
ga:socialInteractionNetworkAction
- For social interactions, a string representing the concatenation of thega:socialInteractionNetwork
andga:socialInteractionAction
being tracked (eg Google: +1, Facebook: like) - Dim -
ga:socialInteractionTarget
- For social interactions, a string representing the URL (or resource) which receives the social network action. - Met -
ga:socialInteractions
- The total number of social interactions on your site. - Met -
ga:uniqueSocialInteractions
- The total number of unique social interactions on your site. Based on the value pairga:socialInteractionNetwork
andga:socialInteractionAction
- Met -
ga:socialInteractionsPerVisit
-ga:socialInteractions
/ga:uniqueSocialInteractions
. The average number of social interactions per visit to your site.
- Dim -
Geo / Network
- Dim -
ga:metro
- The Designated Market Area (DMA) from where traffic originated.
Page Tracking
- Dim -
ga:pagePathLevel1
- This dimension rolls up all the pagePaths in the first hierarchical level in pagePath. - Dim -
ga:pagePathLevel2
- This dimension rolls up all the pagePaths in the second hierarchical level in pagePath. - Dim -
ga:pagePathLevel3
- This dimension rolls up all the pagePaths in the third hierarchical level in pagePath. - Dim -
ga:pagePathLevel4
- This dimension rolls up all the pagePaths in the fourth hierarchical level in pagePath. All the additional levels in the pagePath hierarchy are also rolled up in this dimension.
Exception Tracking
This data come from exception tracking data.
- Met -
ga:exceptions
- The number of exceptions that were sent to Google Analytics. - Met -
ga:fatalExceptions
- The number of exceptions where isFatal is set to true.
- Met -
User Timings
This data comes from user timing data.
- Dim -
ga:userTimingCategory
- A string for categorizing all user timing variables into logical groups for easier reporting purposes. - Dim -
ga:userTimingLabel
- A string to indicate the name of the action of the resource being tracked. - Dim -
ga:userTimingVariable
- A string that can be used to add flexibility in visualizing user timings in the reports. - Dim -
ga:userTimingValue
The number of milliseconds in elapsed time sent to Google Analytics. - Met -
ga:userTimingSample
- The number of samples that were sent. - Met -
ga:avgUserTimingValue
- The average user timing value.ga:userTimiingValue
/ga:userTimiingSample
.
- Dim -
Device / Platform
- This data comes from the user agent of the collected data.
- Dim -
ga:mobileDeviceBranding
- Mobile manufacturer or branded name (examples: Samsung, HTC, Verizon, T-Mobile). - Dim -
ga:mobileDeviceModel
- Mobile device model (example: Nexus S) - Dim -
ga:mobileInputSelector
- Selector used on the mobile device (examples: touchscreen, joystick, click-wheel, stylus) -
Dim - ga:mobileDeviceInfo
- The branding, model, and marketing name used to identify the mobile device.
- Dim -
iOS SDK - Release Version 1.5.1 (September 18, 2012)
This release contains:
Исправление ошибок:
- Remove NoThumb version of library.
- Drop support for armv6.
Новые возможности:
- Add support for armv7s (for iPhone5).
Android SDK - Release Version 1.5.1 (September 18, 2012)
This release contains:
- Исправление ошибок:
- Fix migration from pre-1.5 SDK CVs to 1.5 SDK custom variables.
- Honor user's background data restrictions setting.
iOS SDK - Release Version 1.5 (September 17, 2012)
This release contains:
- Исправление ошибок:
- GANTrackerDelegate protocol methods are now optional.
- Events now include the last tracked page view (utmp).
- Новые возможности:
- Support for up to 50 custom variables (Note: this feature is available for Google Analytics Premium users only).
- Updated BasicExample example app.
Android SDK - Release Version 1.5 (September 17, 2012)
This release contains:
Исправление ошибок:
- Fix memory leak.
- Events now include the last tracked page view (
utmp
).
Новые возможности:
- Support 50 custom variables (Note: this feature is available to Google Analytics Premium users only).
iOS SDK - Release Version 2.0beta3 (August 21, 2012)
This release contains:
- Added social tracking method to
GAITracker
:-
trackSocial:withAction:withTarget:
-
- Timing method signature changed to:
-
trackTiming:withValue:withName:withLabel:
-
- Manual construction and dispatch methods added to GAITracker:
-
set:value:
-
get:
-
send:params:
-
- Custom dimension setter methods added to GAITracker:
-
setCustom:dimension:
-
setCustom:metric:
-
- Architecture of data store refactored to prevent reported
CoreData
issues.
Android SDK - Release Version 2.0beta3 (August 21, 2012)
This release contains:
- Added support for custom dimensions and metrics.
- Added support for social interaction tracking.
- Made
StandardExceptionParser
class public - Fixed occasional crashes during initialization of the SDK.
- Fixed
INSTALL_REFERRER
broadcasts being ignored on some devices. - Fixed
ConcurrentModificationExceptions
inGoogleTracker
class. - Other bugfixes and enhancements
Multi-Channel Funnels Reporting API - Release 2012-08 (August 1, 2012)
This is the initial release of the Multi-Channel Funnels Reporting API:
- This new API enables you to request Multi-Channel Funnels data for an authenticated user. Data is derived from conversion path data, which shows user interactions with various traffic sources over multiple visits prior to converting. This allows you to analyze how multiple marketing channels influence conversions over time. For more details on what data is available and how to use the API see Multi-Channel Funnels Reporting API .
iOS SDK - Release Version 2.0beta2 (June 27, 2012)
This release contains:
- Updated to latest wire format.
-
sampleRate
changed to double-precision float. - Excessive tracking is throttled.
- Undispatched tracking information is deleted when opt-out is enabled.
- Undispatched tracking information older than 30 days will be deleted.
- Enhancements to hit dispatcher.
- Rather than periodically retry, the dispatcher will use the Reachability API when connectivity is lost to get notified when connectivity is reestablished.
- Updated example app.
- Other bugfixes and enhancements.
Android SDK - Release Version 2.0beta2 (June 21, 2012)
This release contains:
- Simplified EasyTracker interface.
- Control of dispatching moved to a new class,
GAServiceManager
. - Updated to latest wire format.
-
sampleRate
changed to double. - Excessive tracking is throttled.
- Undispatched tracking information is deleted when opt-out is enabled.
- Undispatched tracking information older than 30 days will be deleted.
- Other bugfixes and enhancements.
Core Reporting API - Release 2012-05 (May 31, 2012)
Исправление ошибок
- The API now correctly handles UTF-8 characters in a filter or dynamic segment.
iOS SDK - Release Version 2.0beta1 (May 25, 2012)
This release contains:
- Added uncaught exception handling facility.
- Removed
dispatchEnabled
property fromGAI
. - Added
defaultTracker
property toGAI
. - Added
close
method toGAITracker
. - Added timing tracking method to
GAITracker
. - Added
trackView
method toGAITracker
which takes no argument. - Transaction item field names updated.
- Updated to latest wire format.
- Event value is interpreted as a 64-bit integer.
- ARMV6 code generation switched from THUMB to ARM.
Android SDK - Release Version 2.0beta1 (May 25, 2012)
This release contains:
-
startSession
method has been removed. UsesetStartSession
instead. - Added
ga_sessionTimeout
parameter to EasyTracker. - Implemented power save mode.
- Added
trackView
method toGAITracker
which takes no argument. - Fixed a bug that prevented exception parameters from being sent on hits.
- Hits that can't be read from the database are discarded instead of permanently blocking all hits from being dispatched.
- Updated to latest wire format.
- Implemented timing hit type.
- Implemented Ecommerce hit types (transaction and item).
Базовый API отчетов — выпуск 2012–05 (24 мая 2012 г.)
This release enables Google Analytics premium accounts to access up to 50 custom variables.
Web Tracking (ga.js) - Release 2012-02 (February 24, 2012)
The following changes have been pushed to the latest version of the tracking code:
- The maximum allowed site speed sample rate (
_setSiteSpeedSampleRate
) has been increased from 10% to 100%. - The
_setAccount
method now trims any leading and trailing spaces.
Core Reporting API - Release 2012-02 (February 14, 2012)
This release fixes 2 bugs:
Исправление ошибок
Query filters that contain special characters inside regular expressions no longer return server errors.
Combining a metric filter with an advanced segment no longer returns an error.
Core Reporting API - Release 2012-02 (February 8, 2012)
This release add new site speed metrics to the API.
New Metrics
- The following site speed metrics have been added:
-
ga:speedMetricsSample
-
ga:domainLookupTime
-
ga:pageDownloadTime
-
ga:redirectionTime
-
ga:serverConnectionTime
-
ga:serverResponseTime
-
ga:avgDomainLookupTime
-
ga:avgPageDownloadTime
-
ga:avgRedirectionTime
-
ga:avgServerConnectionTime
-
ga:avgServerResponseTime
-
Check the Dimensions and Metrics Reference for definitions.
API Version 2.3 Deprecation Reminder
Version 2.3 of the Data Export API has been depreacted for 2 months. In roughly 4 more months we will shut down this service and only support the new Core Reporting API version 3.0 and version 2.4 .
We highly recommend you migrate your applications to version 3.0.
In 4 months requests to the legacy version 2.3 XML data feed will be forwarded to version 2.4 and return a version 2.4 XML response. At that point, all version 2.4 quota policies will apply to the version 2.3 requests.
All requests for version 2.3 JSON or the Google Data JavaScript client library that uses version 2.3 JSON output, will return
404
status codes.To get full quota, both version 3.0 and version 2.4 require you to register your application in the Google APIs Console and use an API key (or OAuth 2.0 token) in each request.
Web Tracking (ga.js) - Release 2012-02 (February 1, 2012)
The following changes have been pushed to the latest version of the tracking code:
- Updated the list of organic search engines detected by default. Added 'startsiden.no', 'rakuten.co.jp', 'biglobe.ne.jp', and 'goo.ne.jp'. Removed 'search' and added 'conduit.com', 'babylon.com', 'search-results.com', 'avg.com', 'comcast.net', and 'incredimail.com' all of which were previously attributed together as 'search'.
Core Reporting API - Release 2012-01 (January 26, 2012)
We fixed a small bug with ga:visitLength
. This dimension now returns correct data.
Management API - Release 2012-01 (January 26, 2012)
This release adds helpful error responses to the Management API.
- New error codes, reasons, and descriptions have been added to the body of API error responses. All the codes have been documented for both the versions - Version 2.4 and Version 3.0 - of the Management API.
Web Tracking (ga.js) - Release 2012-01 (January 26, 2012)
The following changes have been pushed to the latest version of the tracking code:
- The limit on custom variable length has been increased from 64 to 128 characters. Additionally, the length is now checked before URL encoding.
- The rate limit for event hits has been relaxed. You can now send 10 hits with 1 additional hit per second (previously this was limited to 1 hit every 5 seconds). Note that the 500 hits per session limit still applies.
-
__utmv
cookies are now written with a different variable separator (caret instead of comma) to be compatible with RFCs. This should fix some of the issues related to cookie encoding issues seen by customers.
Core Reporting API - Release 2011-12 (December 5, 2011)
This release effects all Google Analytics API developers. It announces two new versions of the API, requires applications to register, introduces a new quota policy, and it changes the API name to the Core Reporting API. Finally it deprecates the existing Data Export API version 2.3.
Version 3.0
The Core Reporting API version 3.0 is the latest major version of our API and is not backwards compatible. All future development of the API will be done on this version.
Новые возможности
- New JSON based output reduces the size of the response ~10x from the previous XML output.
- New Google API client libraries that support Java, JavaScript, Python, PHP, Ruby, and .Net.
- Support for the Google Discovery API .
- Support for OAuth 2.0 as the new, recommended way to authorize users.
Обновления
- New URL to make requests:
https://www.googleapis.com/analytics/v3/data/ga…
. - Registration and developers tokens required.
- All requests for configuration data should be done through the Management API .
- New URL to make requests:
Version 2.4
The Core Reporting API version 2.4 is a minor version upgrade that is mostly backwards compatible with the existing Data Export API version 2.3.
Обновления
- New URL to make requests:
https://www.googleapis.com/analytics/v2.4/data…
- Registration and developers tokens required.
- XML output consistent with version 2.3, so the other existing Google Data client libraries will continue to work.
- Error code for quota errors have changed from
503
to403
- JSON responses are not supported.
- Google Data JavaScript client library not supported.
- No Account Feed. All requests for configuration data should be done through the Management API .
- New URL to make requests:
Постановка на учет
All applications built using the Google Analytics API must be registered as a project through the Google APIs Console .
Each request to the API must include either a API key or for OAuth 2.0, a Client Id and Client Secret.
Quota Policy
The following quota applies to both Anlaytics APIs (Management API and Data Export API)
- 50,000 requests per project per day
- 10 queries per second (QPS) per IP address
The following quota applies to the Data Export API
- 10,000 requests per profile per day
- 10 concurrent requests per profile
For unregistered applications, we provide a very low grace quota to accommodate a small amount of testing.
Устаревания
This release also announces the deprecation of Version 2.3 and the upcoming shut down of the Account Feed in the Data Export API. In 6 months:
Requests to the version 2.3 XML data feed will be forwarded to version 2.4 and return a version 2.4 response. At that point, all version 2.4 quota policies will apply to the version 2.3 requests.
Requests to the version 2.3 JSON output will not be supported by the version 2.4 response and will return
404 Not Found
status codes. If you need a JSON response, upgrade to Version 3.0.Requests to the Account Feed in the Data Export API will return
404 Not Found
status codes. All requests for configuration data should be done through the Management API .
Management API - Release 2011-12 (December 5, 2011)
This release adds data, changes existing functionality and fixes a bug.
Новые данные
- The Advanced Segment collection now contains a
segmentId
field that can be used in the Data Export API segment parameter.
Изменения
The data type for
max-results
has been changed tointeger
.The default and maximum value for
max-results
has been changed to 1000.
Исправление ошибок
- Accounts, web properties, and profiles for Google Website Optimizer experiments are no longer included in their corresponding collections.
Android SDK - Release Version 1.4.2 (November 28, 2011)
This release contains:
Документация:
- The ReadMe.txt has been updated to point to the website for documentation.
Android SDK - Release Version 1.4.1 (November 22, 2011)
This release contains:
- Исправление ошибок:
- Fixed handling of Destination URL Autotracking from Google Play.
- Allow the referrer parameter to
setReferrer
to be url-encoded.
Web Tracking (ga.js) - Release 2011-11 (November 16, 2011)
Changes to Site Speed data collection:
- Site speed data is now automatically collected for all web properties at a 1% sample rate. The
_trackPageLoadTime
function, previously required to opt-in to site speed data collection, is now deprecated. - The default sample rate may be adjusted using the new
_setSiteSpeedSampleRate
function. - If a virtual path is used in the
_trackPageview
call, that path will now also be associated with any site speed data collected from that page.
iOS SDK - Release Version 1.4 (November 15, 2011)
This release contains:
- Исправление ошибок:
- Changed location of the database to from the Documents directory to the Library directory.
- The SDK no longer throws
NSAsserts
for SQLite database errors. - Fixed crash when calling
trackPageview
with an empty string. - Fixed crashes when calling various
GANTracker
methods afterstopTracker
was called. - Fixed several memory leaks, including one calling trackPageview with a pageURL that begins with '/'.
- Новые возможности:
- Added
dispatchSynchronously
method. - Exposed several useful constants (see GANTracker.h).
- Added
Android SDK - Release Version 1.4 (November 15, 2011)
This release contains:
- Исправление ошибок:
- Trapped and handled several
SQLiteExceptions
. - Fixed
NullPointerException
instopSession
if called prior to callingstartNewSession
. - Fixed Out Of Memory errors on HTC Thunderbolt and Motorola Droid Bionic devices.
- Eliminated unnecessary database access in the dispatch method.
- Trapped and handled several
Web Tracking (ga.js) - Release 2011-10 (October 17, 2011)
This release contains the following new feature:
- Events can be marked as non-interaction by setting the new
opt_noninteraction
parameter of the_trackEvent()
method totrue
. Marking an event as non-interaction indicates that hits from the tagged event will not impact bounce rate. For more information, see the ga.js reference .
This release contains the following bug fix:
- Fixed an issue where propagating the AdWords
gclid
URL parameter on internal site links could result in inflated paid visit counts.
Core Reporting API - Release 2011-09 (September 7, 2011)
This release adds fresher AdWords data and more combinations for AdWords dimensions and metrics.
AdWords data is now updated within an hour. Before the data was updated daily.
We've relaxed a number valid combinations restrictions with AdWords data.
A few weeks ago we made a change to disallow API queries that asked for ga:adGroup
or ga:adContent
with ga:impressions
, since this combination returned 0. With this change, this combination is now back and has been fixed to return correct data .
iOS SDK - Release Version 1.3 (September 6, 2011)
This release contains:
- Исправление ошибок:
- Fixed bus error when attempting to set
dryRun
flag prior to starting the tracker. - Fixed bus error when attempting to pass
NULL
for error. - Use correct language in HTTP header.
- Fixed bus error when attempting to set
- Новые возможности:
- Added
anonymizeIp
flag. - Added
sampleRate
parameter. - Added support for campaign referrals.
- Added
Android SDK - Release Version 1.3.1 (September 6, 2011)
This release contains:
- Исправление ошибок:
- Fixed bug in general campaign referral tracking.
- Fixed
anonymizeIp
flag interfering with campaign tracking.
Management API - Release 2011-08 (August 29, 2011)
This release adds two new versions of the API with many new features, and it deprecates the old version. The changes impact the way you request and handle data from the API.
Version 3.0
This is the latest major version of our API and is not backwards compatible. All future development of the API will be done on this version.
Новые данные
- Full representation of event goals
- An internal web property ID that can be used to deep link into the GA user interface
- Profile configurations for the default page and site search query parameters
Изменения
- A new quota policy
- Integration with the Google APIs Console to manage API access and request more quota
- Support for OAuth 2.0 as the new, recommended way to authorize users
- New URL to make requests:
https://www.googleapis.com/analytics/v3/management/…
- More compact API response using JSON
- New Google API client libraries that support many more languages
- Support for the Google Discovery API
Version 2.4
This is a minor version upgrade that is mostly backwards compatible with the existing Version 2.3.
Изменения
- A new quota policy
- Integration with the Google APIs Console to manage API access and request more quota
- Continued support for existing authorization mechanisms and OAuth 2.0
- New URL to make requests:
https://www.googleapis.com/analytics/v2.4/management/…
- Responses in XML only
- No support for the Google Data JavaScript client library
- XML output consistent with version 2.3, so the other existing Google Data client libraries will continue to work.
Устаревание
- We are announcing the deprecation of the legacy version 2.3 of the Management API. It will continue to work for two months, after which all v2.3 requests will return a v2.4 response.
Web Tracking (ga.js) - Release 2011-08 (August 16, 2011)
This release fixes a bug which caused inflated numbers of visits and/or a decrease in the number of new visitors for some sites. The first effect primarily affected sites with organic traffic coupled with specific user behavior. The second effect was only on sites using an unsupported tracking configuration with multiple trackers.
Core Reporting API - Release 2011-08 (August 11, 2011)
This release fixes some invalid combinations of dimensions and metrics
Fixed invalid metrics/dimensions combinations
Last month we announced some upcoming changes to the API to disallow some invalid queries in the data feed that do not return any data. We have now made those changes to the API, and the following combinations are now invalid:
- Product dimensions cannot be combined with transaction metrics.
-
ga:adContent
orga:adGroup
cannot be combined withga:impressions
.
Instead of returning a response with 0 results, the API now returns 400 error code for all queries that ask for these combinations.
Web Tracking (ga.js) - Release 2011-08 (August 11, 2011)
Changes to session calculations:
- One campaign per session: If a new campaign is started during an existing session, the tracking script will now automatically start a new session. A new campaign will be triggered by a change to any of the following fields: campaign id, name, source, medium, term, content, or gclid.
- The tracking script no longer starts a new session in the event that a user closes the browser.
Changes to cross-domain tracking:
- The call to
_setAllowHash(false)
is no longer required when configuring cross-domain tracking. Pages that already include a call to_setAllowHash(false)
will continue to work, but it is no longer required when setting up a new site. - The tracking script will now attempt to repair linker parameters that have been mangled by HTTP redirectors and browsers. Approximately 85% of linker values that are currently discarded due to encoding changes introduced by redirectors and browsers should now be successfully restored and accepted by the tracking script.
Android SDK - Release Version 1.3 (August 10, 2011)
This release contains:
- Исправление ошибок:
- Fixed several issues in database handling.
- Fixed exceptions while using custom variables.
- Hold the application context instead of the context passed into it.
- Removed the ability to accidently create phantom sessions.
- Новые возможности:
- Added the ability to set campaign referrals at any time
- Added
sampleRate
flag - Added
anonymizeIp
flag
Web Tracking (ga.js) - Release 2011-07 (July 26, 2011)
This release contains one new feature:
- The tracking code now postpones hits for prerendered pages until those pages are viewed by the user. If a prerendered page is never viewed, no hits are sent. This feature is only available to sites using the async tracking script. You can learn more about prerendering in Google Webmaster Central Blog .
Web Tracking (ga.js) - Release 2011-07 (July 14, 2011)
This release contains a variety of bug fixes and refactorings, and one new feature:
- Added social tracking support ( _trackSocial )
Core Reporting API - Release 2011-07 (July 11, 2011)
This release deprecates the confidence interval value in metrics.
Deprecation of Confidence Interval
If you haven't already done so, please stop using confidence interval values for metrics. With this release, the Data Export API Data Feed returns 0.0 for all the confidence interval values. In a month or so, we will we will completely remove this attribute from all metric elements.
To determine if a response has been sampled, please use the containsSampledData field in the response.
iOS SDK - Release Version 1.2 (June 27, 2011)
This release contains:
- Исправление ошибок:
- Fixed crash when using custom variables.
- Fixed memory leaks when using custom variables.
- Новые возможности:
- Added support for Ecommerce hits.
- Added
Debug
flag. - Added
DryRun
flag. - More descriptive error information on
SQLite3
failures
Android SDK - Release Version 1.2 (June 27, 2011)
This release contains:
Исправление ошибок:
- Fixed badly formatted
userAgent
String.
- Fixed badly formatted
Новые возможности:
- Added support for Ecommerce tracking
- Added
debug
flag - Added
dryRun
flag
Core Reporting API - Release 2011-05 (May 31, 2011)
This release adds 3 new metrics and updates the return value of two.
New Data Updates
- We added 3 new metrics dealing with site speed performance to the API:
-
ga:pageLoadSample
-
ga:pageLoadTime
-
ga:avgPageLoadTime
-
Metric Updates
To specify currency values in filters, you must specify the actual value passed in from the tracking code, (eg 1 unit will now be specified as 1).
ga:CTR
now returns the actual percent (eg a value of 2% is returned as 2).
Web Tracking (ga.js) - Release 2011-05 (May 18, 2011)
This release contains the following bug fixes.
- Fixed a bug in cross domain tracking that caused incorrect encoding of campaign data in some cases.
- Fixed a bug in cross domain tracking that caused cookies to be loaded from the URL more than once, causing incorrect cookies in some cases.
- Fixed a bug in Custom Variables that caused some values to be encoded in reports.
Android SDK - Release Version 1.1 (May 4, 2011)
This release contains:
Исправление ошибок:
- Fixed improper encoding of spaces.
-
SQLiteExceptions
no longer cause apps to crash.
Новые возможности:
- Added support for custom variables
Core Reporting API - Release 2011-04 (April 19, 2011)
This release improves improves Data Feed performance and adds new data:
Улучшение производительности
- This release improves data feed latency by 30 to 35%.
New Data Updates
- We have updated the list of dimensions and metrics that are allowed in Advanced Segments. Please refer to the updated list to make sure that your requests are valid.
Upcoming Changes
Currently, you need to specify a currency filter value as micro units, (eg 1 unit of currency is specified as 1000000). In the near future, you will need to specify the actual value passed in from the tracking code, (eg 1 unit will now be specified as 1).
Currently,
ga:CTR
is apercent
and returns the value 0.02. In the near future this will change to return the actual percent (eg 2).
Web Tracking (ga.js) - Release 2011-04 (April 14, 2011)
This release contains regular maintenance including bug fixes and refactorings. There is no change to the public APIs or functionality.
Web Tracking (ga.js) - Release 2011-03 (March 30, 2011)
This release contains updates and one new feature.
POST
support:- The tracking code can now send much larger tracking beacons. Traditionally, beacons have been sent via HTTP
GET
requests, which are limited to 2048 characters by some browsers and proxies. Requests over this limit were dropped and the data never reached Google Analytics. Starting with this release, requests longer than 2048 characters will be sent via HTTPPOST
, which has no such limit. The tracking code will now support beacons up to 8192 characters.
- The tracking code can now send much larger tracking beacons. Traditionally, beacons have been sent via HTTP
Core Reporting API - Release 2011-03 (March 9, 2011)
This release adds more data to the Data Feed:
New Data Updates
The following Time dimension has been added:
ga:dayOfWeek
The following Internal Search metric has been added:
ga:percentVisitsWithSearch
The following Event Tracking metrics have been added:
-
ga:visitsWithEvent
-
ga:eventsPerVisitWithEvent
-
Upcoming Changes
Currently the API returns 401
status codes for for various authorization issues. Within the next couple of weeks, the 401
status will be used exclusively for invalid tokens, giving developers a way to error handle this particular exception.
Web Tracking (ga.js) - Release 2011-02 (February 17, 2011)
This release contains the following bug fixes.
- Fixed a bug that prevented
_addIgnoredOrganic
and_addIgnoredRef
from working properly on the first visit to a site. - Fixed an issue related to tracking code running across multiple iframes.
iOS SDK - Release Version 1.1 (February 11, 2011)
This release contains:
- Новые возможности:
- Added support for custom variables.
- Added NoThumb version of the library.
Core Reporting API - Release 2011-01 (January 24, 2011)
This release adds significantly more data to the Data Feed:
New Data Updates
The calculation of
ga:visitors
has been changed to return the number of unique visitors across the date range and now supports more dimension and metric combinations.10 new AdWords dimensions have been added:
ga:adDistributionNetwork
,ga:adMatchType
,ga:adMatchedQuery
,ga:adPlacementDomain
,ga:adPlacementUrl
,ga:adFormat
,ga:adTargetingType
,ga:adTargetingOption
,ga:adDisplayUrl
,ga:adDestinationUrl
.The metric
ga:organicSearches
has been added to the campaign group.The metric
ga:searchResultViews
has been added to the internal site search group.3 new time-based dimensions have been added:
ga:nthDay
,ga:nthWeek
,ga:nthMonth
.The groupings of dimensions and metrics have been changed to better reflect the features they represent.
New Calculated Metrics
The following calculated metrics are derived from calculations using the base metrics. Note: Each name with (n)
supports values 1-20.
Goal Based:
ga:costPerConversion
,ga:costPerGoalConversion
,ga:costPerTransaction
,ga:goal(n)AbandonRate
,ga:goal(n)Abandons
,ga:goal(n)ConversionRate
,ga:goalAbandonRateAll
,ga:goalAbandonsAll
,ga:goalConversionRateAll
,ga:goalValueAllPerSearch
,ga:goalValuePerVisit
.Content Based:
ga:entranceBounceRate
,ga:visitBounceRate
,ga:entranceRate
,ga:exitRate
,ga:pageviewsPerVisit
,ga:avgTimeOnPage
,ga:avgTimeOnSite
,ga:avgEventValue
.Internal Site Search Based:
ga:avgSearchDepth
,ga:avgSearchDuration
,ga:avgSearchResultViews
,ga:searchGoalConversionRateAll
,ga:searchGoal(n)ConversionRate
,ga:searchExitRate
.Ecommerce Based:
ga:itemsPerPurchase
,ga:margin
,ga:percentNewVisits
,ga:revenuePerItem
,ga:revenuePerTransaction
,ga:ROI
,ga:RPC
,ga:totalValue
,ga:transactionRevenuePerVisit
,ga:transactionsPerVisit
.
Core Reporting API - Release 2010-11 (November 1, 2010)
This release adds a new feature to the Data Feed:
Новые возможности
- A new XML element has been added lets users know if the data has been sampled.
true
true
orfalse
. The Java and JavaScript libraries have also been updated with helper methods to access this element.
Web Tracking (ga.js) - Release 2010-10 (October 4, 2010)
This release contains regular maintenance including bug fixes and refactorings. There is no change to the public APIs or functionality.
iOS SDK - Release Version 1.0 (August 30, 2010)
This release contains:
Новые возможности:
- Added iOS4 support
Core Reporting API - Release 2010-08 (August 23, 2010)
This release fixes 2 bugs:
Исправление ошибок
Previously adding an OR operator to a filter expression with a dimension (ie,
ga:keyword==store,ga:keyword==bar
) could result in different values than if each filter was applied individually across multiple queries. This has been fixed and using the OR operator now returns consistent values.Some of the API error messages for invalid filters have been updated to NOT include whether it was a dimension or metric filter that caused the error (though the actual offending filter expression will continue to be returned).
Management API - Release 2010-08 (August 18, 2010)
This is the beta release of the Google Analytics Management API!
Новые каналы
Five new feeds have been created to simplify accessing Google Analytics account configuration data:
Updated Client Libraries
- The Management API is being released in the same library as the Google Analytics Data Export API. Both Google Data Java and JavaScript libraries have been updated. Each feed can be accessed by specifying the appropriate feed URI to the libraries
getManagementFeed()
method.
New Documentation
- A new section of the Google Analytics developer docs has been created to describe how the new Management API works.
Core Reporting API - Release 2010-07 (July 26, 2010)
This release fixes 3 bugs:
Исправление ошибок
An encoding issue in the JavaScript Client Library has been fixed. Analytics issue tracker
A bug that prevented the Account Feed to not return when a goal name, goal path, goal comparison value, or goal comparison type had been incorrectly set, has now been fixed.
It is invalid to OR a dimension and metric in the Data Feed query filter parameter. For example:
ga:source==google,ga:visits>5
. The error message for this invalid query has been updated to say:Cannot OR dimension filter(s) with metric filter
.
Core Reporting API - Release 2010-05 (May 4, 2010)
This release adds new data and fixes a bug:
Новые возможности
The following 5 dimensions have been added in the new category
D8. Adwords
:-
ga:adwordsAdGroupId
: corresponds to the AdWords API AdGroup.id -
ga:adwordsCampaignId
: corresponds to the AdWords API Campaign.id -
ga:adwordsCreativeId
: corresponds to the AdWords API Ad.id -
ga:adwordsCriteriaId
: corresponds to the AdWords API Criterion.id -
ga:adwordsCustomerId
: cooresponds to the AdWords API AccountInfo.customerId
-
Исправление ошибок
- We fixed an issue where the Account Feed would not return data if one of the profiles had a misconfigured goal or step.
Web Tracking (ga.js) - Release 2010-04 (April 20, 2010)
This release contains bug fixes and API cleanup.
Исправление ошибок:
- Fixed event tracking bug. Calling
_trackEvent
no longer requires calling_initData
or_trackPageview
first. - Updated async snippet so that it can be placed in the head on any page without causing problems in IE 6 and 7. See the Asynchronous Tracking Guide for the new snippet. This update occurred on 3/22/2010.
- Expanded async syntax to support calling methods on the
_gat
object.
- Fixed event tracking bug. Calling
Updated tracker initialization APIs to be consistent with async syntax. Also deprecated old functions.
- Added
_gat._createTracker(opt_account, opt_name)
function. Allows trackers to be named and later retrieved by their name.Use this instead of_gat._getTracker(account)
. - Added
_gat._getTrackerByName(name)
. Retrieves the tracker with the given name. - Added
tracker._getName()
. Returns the name given to the tracker when it was created. - Deprecated
_gaq._createAsyncTracker(account, opt_name)
. Use_gat._createTracker
instead. - Deprecated
_gaq._getAsyncTracker(name)
. Use_gat._getTrackerByName
instead.
- Added
See the Tracker Reference for details on these API changes.
Core Reporting API - Release 2010-03 (March 22, 2010)
This release adds a number of new features and fixes a bug:
Новые возможности
The iPhone Default Segment (gaid::-11) has been enhanced to now report on all mobile devices . The ID is the same as before (-11), but the name of the segment is now:
Mobile Traffic
.The sampling rate used by the API is now the same as the web interface. This brings the data for sampled reports inline with the web interface and increases consistency between the two.
The quota policy has been updated in an effort to ensure that all users receive equitable access to resources. Please refer to our quota policy documentation for more details. The new policy is:
- A single web property may make a maximum of 10,000 requests per 24 hours.
- An application can only make 10 requests in any given 1-second period.
- An application can only have 4 pending requests at any given time.
Some restrictions on dimension and metric combinations have been relaxed.
ga:nextPagePath
andga:previousPagePath
are now part of theD3. Content
group. TheD8. Custom Variable
group is now called theD6. Custom Variable
group. Please see the updated reference guide for these new combinations.
Исправление ошибок
We fixed a bug on how the API reports the
confidenceInterval
value for metrics. Previously confidence intervals could have a value of eitherINF
or a number from 0 to 1. Now all confidence intervals will have a value of eitherINF
or a number greater than or equal to 0.ga:itemQuantity
andga:uniquePurchases
were previously swapped and returned each other's value. They are now fixed to return the correct data.
Deprecation of Dimensions and Metrics Reminder
- If you haven't done so already, please stop using the previously deprecated dimensions and metrics
Core Reporting API - Release 2009-12 (December 14, 2009)
This release adds a number of new features:
This release increments the major version number to 2
Some features require the use of the latest client libraries. We officially support: Java & Javascript . 3rd party libraries might not be updated yet.
- Version 2 may be requested by adding the header
GData-Version: 2
to each account or data feed request Read the documentation for more details. - A new XML namespace has been added to both account and data feeds:
xmlns:ga='http://schemas.google.com/ga/2009'
- Version 2 may be requested by adding the header
The API now supports the Google Data protocol version 2 .
Advanced segmentation support
Dynamic segments query parameter:
-
...&segment=dynamic::
expression - allows creation of advanced segments “on the fly.”
- expression can be any dimension or metric and should follow the same syntax as filters.
-
Default and custom segments query parameter:
-
...&segment=gaid::
number - where number is an ID referencing an advanced segment defined in the Google Analytics Web Interface.
- ID can be found in the account feed.
-
The account feed describes segment data through the following XML elements and attributes:
-
<dxp:segment id="gaid::-3" name="Returning Visitors"></dxp:segment>
-
<dxp:definition>ga:visitorType==Returning Visitor</dxp:definition>
-
The data feed also provides an XML element indicating whether a segment was applied in the API request.
More details on advanced segments in our documentation .
New goal data available
Destination and engagement type goals available in the account feed:
-
<ga:goal active="true" name="Completing Order" number="1" value="10.0"></ga:goal>
-
<ga:destination expression="/purchaseComplete.html" matchtype="regex" step1required="false" casesensitive="false"></ga:destination>
-
<ga:step number="1" name="Login" path="/login.html"></ga:step>
-
<ga:engagement comparison=">" thresholdvalue="300" type="timeOnSite"></ga:engagement>
-
48 new goal metrics have been added for goals 5-20 which all follow the convention
goal(n)Completions
, where(n)
is a number between 1 and 20.-
ga:goal(n)Completions
-
ga:goal(n)Starts
-
ga:goal(n)Value
-
GoalCompletionAll
,GoalStartsAll
andGoalValueAll
have been updated to account for the new goal data.
New custom variable data
All custom variables ever collected by each profile have been added as a new XML element to the account feed:
-
<ga:customvariable index="1" name="category" scope="visitor"></ga:customvariable>
-
10 new dimensions have been added for custom variables. They follow the convention
customVar(n)
where(n)
can be a number between 1 and 5.-
ga:customVarName(n)
-
ga:customVarValue(n)
-
Deprecated dimensions & metrics to be removed!
If you haven't done so already, please stop using the previously deprecated dimensions and metrics. They will be removed soon and will return errors from our API if requested.
-
ga:countOfVisits
-
ga:countOfVisitsToATransaction
-
ga:sourceMedium
-
ga:percentNewVisits
-
The following dimensions have been renamed:
-
ga:countOfVisits
is nowga:visitCount
-
ga:countOfVisitsToATransaction
is nowga:visitsToTransaction
-
Web Tracking (ga.js) - Release 2009-12 (December 1, 2009)
This release contains updates to the default search engine list and new functions to control cookie timeouts. In addition, the asynchronous GA snippet is launched that reduces the ga.js latency impact on the page.
Updated the default search engine list
- Added Naver, Eniro and Daum search engines.
- Removed Looksmart, Gigablast, Club-internet, Netsprint, Intera, Nostrum and Ilse from the list.
Added functions to control cookie expiration times for all stored cookies. Deprecated existing cookie timeout functions. See the JS API documentation for more details.
-
_setVisitorCookieTimeout(cookieTimeoutMillis)
replaces the_setCookiePersistence
function. -
_setSessionCookieTimeout(cookieTimeoutMillis)
replaces the_setSessionTimeout
function. -
_setCampaignCookieTimeout(cookieTimeoutMillis)
replaces the_setCookieTimeout
function.
-
Launched asynchronous GA snippet. See documentation on how to try it out.
_setVar
function is now deprecated. Custom Variables feature replaces_setVar
. See documentation for more details.
Web Tracking (ga.js) - Release 2009-11 (November 4, 2009)
This release contains:
Added a new function to retrieve visitor level custom variables. See the function documentation for more details.
-
_getVisitorCustomVar(index)
-
Instead of waiting for window.onload, Site Overlay content is loaded as soon as ga.js is executed.
Web Tracking (ga.js) - Release 2009-10 (October 14, 2009)
This release contains a new feature:
Added an optional boolean parameter to
_addOrganic
function to specify if new organic sources are added to the beginning or the end of the organic source list. Более подробную информацию смотрите в документации .-
_addOrganic(newOrganicEngine, newOrganicKeyword, opt_prepend)
-
Web Tracking (ga.js) - Release 2009-09 (September 28, 2009)
This release contains regular maintenance for performance improvements and refactorings. There is no change to the public APIs or functionality.
Core Reporting API - Release 2009-09 (September 18, 2009)
This release adds new features and deprecates some old functionality:
The following dimensions and metrics are now deprecated. We'll be permanently removing them from our API in one month. Please make sure to update your code so your applications don't break:
- ga:countOfVisits
- ga:countOfVisitsToATransaction
- ga:sourceMedium
- ga:percentNewVisits
The following Dimensions have been renamed:
- ga:countOfVisits is now ga:visitCount
- ga:countOfVisitsToATransaction is now ga:visitsToTransaction
All Event Tracking data is now exposed as 2 new groups:
Д7. Events (Dimensions) * ga:eventCategory * ga:eventAction * ga:eventLabel
М7. Events (Metrics) * ga:eventValue * ga:totalEvents * ga:uniqueEvents
Overall site navigation data is is now exposed through the following dimensions:
D6. Navigation * ga:previousPagePath * ga:nextPagePath
Landing page navigation is now exposed through the following dimensions:
Д3. Content * ga:landingPagePath * ga:secondPagePath
The maximum length of regular expressions in the Data Feed's filter query parameter has been raised from 32 to 128 characters.
The Length of Visit report (found through the UI under Visitors -> Visitor Loyalty) is now exposed through the new dimension:
- ga:visitLength
Web Tracking (ga.js) - Release 2009-08 (August 31, 2009)
This release contains multiple bug fixes and performance improvements:
- Proper encoding for search terms for organic searches, web page path info for (utmp), and user defined values when used with the linker feature (ie:
_link
and_linkByPost
functions). - The search engine Rambler is added to the organic search list
- Organic search parsing is corrected for search engine http://kvasir.no
- New organic search engines defined by the user are now added to the top of the list
- Removed deprecated
_trackEvent(action, label, value)
function and replaced it with_trackEvent(category, action, label, value)
- Referrer URLs are now stored as case sensitive. For example: www.domain.com/PaGe.HtMl will be reported with case information.
- Added a 1200 character limitation to GASO token size.
- New function was added to allow overriding the default timeouts for cookies:
_setCookiePersistence(timeout)
Core Reporting API - Release 2009-06 (June 30, 2009)
This release updates the Google Analytics Data Export API as follows:
Some restrictions on dimension and metric combinations have been relaxed. You can now query most content and visitor level dimensions together, for example
ga:pagePath
andga:source
is now a valid combination. Please see the updated reference guide for these new combinations: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.htmlThe total number of rows that can be asked for in one request has been increased to 10,000. The default number of rows returned is still 1,000, but can now be increased by setting the
max-results
query parameter.The Account Feed now returns two new data elements for each Table ID (currency and timezone).
<dxp:property name="ga:currency" value="USD"></dxp:property>
<dxp:property name="ga:timezone" value="America/Los_Angeles"></dxp:property>
We're now enforcing that data queries must include at least one valid metric.
All previous deprecation changes have taken effect.
Базовый API отчетов — выпуск 2009–05 (22 мая 2009 г.)
This release removes deprecated features from our private beta:
The account feed requests will no longer support a username in them. Instead, it will only accept requests in the following format:
https://www.google.com/analytics/feeds/accounts/default
The following metrics are being removed and will no longer work. Instead, we have provided instructions on how to calculate these values here: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceCommonCalculations.html
- ga:avgPageDuration
- ga:avgPageviews
- ga:avgSessionTime
- ga:bounceRate
- ga:exitRate
- ga:costPerConversion
- ga:costPerGoalConversion
- ga:costPerTransaction
- ga:revenuePerClick
- ga:revenuePerTransaction
- ga:revenuePerVisit
- ga:abandonedFunnels1
- ga:abandonedFunnels2
- ga:abandonedFunnels3
- ga:abandonedFunnels4
- ga:goalConversionRate
- ga:goalConversionRate1
- ga:goalConversionRate2
- ga:goalConversionRate3
- ga:goalConversionRate4
- ga:goalValuePerVisit
The following dimensions and metrics have been renamed. The old names will no longer work. Please verify you are using the official names in our documentation here: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html
Dimensions * ga:subContinentRegion ⇒ ga:subContinent * ga:organization ⇒ ga:networkLocation * ga:domain ⇒ ga:networkDomain * ga:visitNumber ⇒ ga:countOfVisits * ga:platform ⇒ ga:operatingSystem * ga:platformVersion ⇒ ga:operatingSystemVersion * ga:content ⇒ ga:adContent * ga:requestUri ⇒ ga:pagePath * ga:requestUri1 ⇒ ga:landingPagePath * ga:requestUriLast ⇒ ga:exitPagePath * ga:internalSearchNext ⇒ ga:searchKeywordRefinement * ga:internalSearchKeyword ⇒ ga:searchKeyword * ga:internalSearchType ⇒ ga:searchCategory * ga:hasInternalSearch ⇒ ga:searchUsed * ga:requestUriFrom ⇒ ga:searchStartPage * ga:requestUriTo ⇒ ga:searchDestinationPage * ga:productCode ⇒ ga:productSku
Metrics * ga:newVisitors ⇒ ga:newVisits * ga:pageDuration ⇒ ga:timeOnPage * ga:visitDuration ⇒ ga:timeOnSite * ga:cost ⇒ ga:adCost * ga:clicks ⇒ ga:adClicks * ga:clickThroughRate ⇒ ga:CTR * ga:costPerClick ⇒ ga:CPC * ga:costPerMilleImpressions ⇒ ga:CPM * ga:searchTransitions ⇒ ga:searchRefinements * ga:uniqueInternalSearches ⇒ ga:searchUniques * ga:visitsWithSearches ⇒ ga:searchVisits * ga:productPurchases ⇒ ga:itemQuantity * ga:productRevenue ⇒ ga:itemRevenue * ga:products ⇒ ga:uniquePurchases * ga:revenue ⇒ ga:transactionRevenue * ga:shipping ⇒ ga:transactionShipping * ga:tax ⇒ ga:transactionTax * ga:goalCompletions1 ⇒ ga:goal1Completions * ga:goalCompletions2 ⇒ ga:goal2Completions * ga:goalCompletions3 ⇒ ga:goal3Completions * ga:goalCompletions4 ⇒ ga:goal4Completions * ga:goalStarts1 ⇒ ga:goal1Starts * ga:goalStarts2 ⇒ ga:goal2Starts * ga:goalStarts3 ⇒ ga:goal3Starts * ga:goalStarts4 ⇒ ga:goal4Starts * ga:goalValue1 ⇒ ga:goal1Value * ga:goalValue2 ⇒ ga:goal2Value * ga:goalValue3 ⇒ ga:goal3Value * ga:goalValue4 ⇒ ga:goal4Value