Журнал изменений API отчетов Google Analytics в режиме реального времени

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

На этой странице описаны все изменения, внесенные в API отчетов в реальном времени Google Analytics, которые могут повлиять на ваше приложение. Мы рекомендуем разработчикам API периодически проверять этот список на наличие новых объявлений. Вы также можете подписаться на изменения через каналы, перечисленные в разделе «Подписка» ниже.

Подпишитесь на соответствующие журналы изменений

Все журналы изменений API Google Analytics
–
ПодписатьсяRSS

Включает все API сбора, настройки и отчетности.

Все журналы изменений API отчетов
–
ПодписатьсяRSS

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

Журнал изменений API отчетов в реальном времени
–
ПодписатьсяRSS

В этом выпуске внесены изменения в квоты и ограничения 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 аналитики на оставшуюся часть дня для отдельного профиля.

Это выпуск с исправлением ошибок:

  • В этом выпуске исправлена ​​проблема с соблюдением ограничений фильтрации в запросе API отчетов в реальном времени. Запросы с rt:activeUsers и фильтром на уровне события приведут к ошибке с причиной badRequest и сообщением о том, OR operator not supported for a hit level filter . Дополнительную информацию об ограничениях запросов см. в Руководстве разработчика API отчетов в реальном времени .

Этот выпуск включает в себя новое измерение. Полный список определений см. в Справочнике по измерениям и метрикам .

Время

  • Размерность — rt:minutesAgo — количество минут назад, когда произошло попадание.

В этом выпуске переименованы параметры и показатели. Полный список определений см. в Справочнике по измерениям и метрикам .

Переименованные параметры и показатели

Следующие параметры и показатели были переименованы. Подробную информацию о переименовании данных см. в Политике устаревания данных :

Пользователь

  • Измерение — rt:visitorType — вместо этого используйте rt:userType .
  • Метрика — rt:activeVisitors — вместо этого используйте rt:activeUsers .

ga: префикс устарел

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

Новые параметры и показатели

Это обновление добавляет новые измерения и показатели в API отчетов в реальном времени. Полный список см. в Справочнике по параметрам и метрикам .

Отслеживание событий

  • Размерность — rt:eventAction — действие события.
  • Размерность — rt:eventCategory — категория события.
  • Измерение — rt:eventLabel — метка события.
  • Измерение — rt:totalEvents — общее количество событий профиля по всем категориям.

Отслеживание целей

  • Измерение — rt:goalId — строка, соответствующая идентификатору цели.
  • Метрика — rt:goalXXValue — общее числовое значение для запрошенного номера цели, где XX — число от 1 до 20.
  • Метрика — rt:goalValueAll — общее числовое значение для всех целей, определенных для вашего профиля.
  • Метрика — rt:goalXXCompletions — общее количество выполнений для запрошенного номера цели, где XX — число от 1 до 20.
  • Метрика — rt:goalCompletionsAll — общее количество выполненных действий для всех целей, определенных для вашего профиля.

Отслеживание страниц

  • Метрика — rt:pageViews — общее количество просмотров страниц.

Отслеживание приложений

  • Метрика — rt:screenViews — общее количество просмотров экрана.

Это первоначальный выпуск API отчетов в реальном времени в ограниченной бета-версии:

  • API отчетов в реальном времени позволяет вам сообщать о действиях, происходящих на вашем объекте прямо сейчас. Вы можете использовать API отчетов в реальном времени для запроса параметров и показателей, чтобы создавать веб-виджеты и информационные панели, ориентированные на клиентов. Для получения более подробной информации посетите обзор API отчетов в реальном времени .