Google Analytics – все журналы изменений API отчетов

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

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

Все журналы изменений API Google Analytics

–

RSS

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

Все журналы изменений API отчетов

–

RSS

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

Core Reporting API — выпуск от 19 марта 2019 г. (19 марта 2019 г.)

Это первый выпуск API активности пользователей.

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

Вт 19 марта 2019 г.

Core Reporting API — выпуск от 23 января 2018 г. (23 января 2018 г.)

В этом выпуске система квот на основе ресурсов для Google Analytics Reporting API v4 доступна всем клиентам Analytics 360 (Премиум).

Вт, 23 января 2018 г.

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

Ср, 29 ноября 2017 г.

Core Reporting API — выпуск 29 ноября 2017 г. (29 ноября 2017 г.)

В этом выпуске увеличено максимальное количество строк, возвращаемых в наборе результатов Analytics Reporting API v4.

Максимальное количество строк, возвращаемых в объекте ReportData Analytics Reporting API v4, увеличено с 10 000 до 100 000.

Ср, 29 ноября 2017 г.

Core Reporting API — выпуск 31 октября 2017 г. (31 октября 2017 г.)

В этом выпуске добавлена ​​предварительная версия системы квот на основе ресурсов для Google Analytics Reporting API v4, которая позволяет использовать более высокие пороговые значения выборки для клиентов Analytics 360 (Премиум).

Вт, 31 октября 2017 г.

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

Пт, 2 июня 2017 г.

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

Вт, 11 апреля 2017 г.

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. Дополнительную информацию см. в справочной документации по уникальным событиям .

Ср, 8 марта 2017 г.

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, приведет к ошибке.

Вт, 14 февраля 2017 г.

Core Reporting API — выпуск от 11 января 2017 г. (11 января 2017 г.)

Это выпуск с исправлением ошибок, который устраняет проблему с параметрами и показателями AdSense и объявляет о предстоящих изменениях в этих параметрах и показателях.

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

В этом выпуске исправлена ​​проблема, возникшая 7 января 2017 г., из-за которой запрос параметров и показателей AdSense возвращал ошибку «Неизвестный показатель» для связанных представлений, не связанных с AdSense.

Грядущие изменения

С 31 января 2017 г. или после этой даты для связанных представлений, не связанных с AdSense, будет запрещено запрашивать параметры и показатели AdSense. Запрос этих параметров и показателей с помощью связанных представлений, не связанных с AdSense, приведет к ошибке.

Ср, 11 янв. 2017 г.

Core Reporting API — выпуск от 12 октября 2016 г. (12 октября 2016 г.)

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

Расчетные метрики

В этом выпуске добавлена ​​поддержка вычисляемых метрик .

• Метрика — ga:calcMetric_ - Значение запрошенной вычисляемой метрики, где относится к определяемому пользователем имени вычисляемой метрики. Обратите внимание, что тип данных ga:calcMetric_ может быть FLOAT, INTEGER, CURRENCY, TIME или PERCENT. Подробности см. в разделе О вычисляемых метриках .

Ср, 12 октября 2016 г.

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 . Вы можете использовать эту метрику, чтобы понять новое определение до внесения изменений. Обратите внимание, что этот показатель является частным и не будет отображаться в Справочнике по измерениям и метрикам .

Пн, 26 сентября 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).

Вт, 9 августа 2016 г.

API для создания отчетов по многоканальным последовательностям – выпуск от 14 июля 2016 г. (14 июля 2016 г.)

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

ID транзакции

• измерение — mcf:transactionId — идентификатор транзакции, предоставленный методом отслеживания электронной торговли, для покупки в корзине.

Чт, 14 июля 2016 г.

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

Чт, 14 июля 2016 г.

Core Reporting API — выпуск от 8 июля 2016 г. (8 июля 2016 г.)

В этом выпуске представлены новые ограничения и квоты. Подробности см. в документации по лимитам и квотам .

Отчеты об ошибках

В этом выпуске начинают действовать ограничения на неудачные запросы отчетов ( 5XX ).

• 10 неудачных запросов на проект на профиль в час.
• 50 неудачных запросов на проект на профиль в день.

Ограничения поворота

В этом выпуске начинают действовать ограничения на сводные запросы:

• Запрос отчета теперь может иметь максимум 2 сводных отчета .
• Поворотная точка может иметь максимум 4 измерения .
• Сводные измерения являются частью ограничения на общее количество измерений, разрешенных в запросе.
• Метрики сводной таблицы являются частью ограничения на общее количество метрик, разрешенных в запросе.

Пт, 8 июля 2016 г.

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 не включена).

Пт, 17 июня 2016 г.

Core Reporting API — выпуск от 18 мая 2016 г. (18 мая 2016 г.)

Это выпуск с исправлением ошибок, который устраняет проблему с сегментами и выборкой.

Сегменты

В этом выпуске исправлена ​​проблема, из-за которой подмножество запросов с сегментом «Все пользователи» ( gaid::-1 ) не учитывалось в Core Reporting API версии 3 и разделялось на два сегмента в Analytics Reporting API версии 4 .

Выборка

В этом выпуске исправлена ​​проблема, из-за которой подмножество запросов из пользовательских таблиц возвращало выборочные данные .

Ср, 18 мая 2016 г.

Core Reporting API — выпуск от 29 апреля 2016 г. (29 апреля 2016 г.)

Это выпуск с исправлением ошибок, который устраняет проблему при выполнении когортных запросов Analytics Reporting API V4 .

Когортные запросы

Запросы на когорты теперь могут запрашивать все измерения когорты ; ранее API возвращал ошибку при запросе измерений ga:acquisition...

Общая ценность запроса на общую ценность

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

Пт, 29 апреля 2016 г.

API метаданных – выпуск от 8 апреля 2016 г. (8 апреля 2016 г.)

В этом выпуске добавлен новый атрибут addedInApiVersion .

Добавлено в версию API

• addedInApiVersion — это числовой атрибут, который можно использовать для проверки того, можно ли использовать столбец в API отчетов указанной версии; Подробности см. в Metadata API — Руководство разработчика .

Пт, 8 апреля 2016 г.

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:userAcquisitionSource и ga:acquisitionMedium.

• Измерение — ga:acquisitionCampaign Кампания, посредством которой был привлечен пользователь. Получено из первого сеанса пользователя.

• Метрика — ga:cohortActiveUsers — эта метрика актуальна в контексте измерений смещения, отсчитываемых от 0 ( ga:cohortNthDay , ga:cohortNthWeek или ga:cohortNthMonth ). Он указывает количество пользователей в когорте, которые активны во временном окне, соответствующем n-му дню/неделе/месяцу когорты. Например, для ga:cohortNthWeek = 1 — количество пользователей (в когорте), активных на второй неделе. Если в запросе нет ga:cohortNthDay , ga:cohortNthWeek или ga:cohortNthMonth , эта метрика будет иметь то же значение, что и ga:cohortTotalUsers .

• Метрика — ga:cohortTotalUsers — количество пользователей, принадлежащих к когорте, также известное как размер когорты.

• Метрика — ga:cohortAppviewsPerUser — количество просмотров приложения на пользователя для когорты.

• Метрика — ga:cohortGoalCompletionsPerUser — количество достигнутых целей на пользователя в когорте.

• Метрика — ga:cohortPageviewsPerUser — количество просмотров страниц на пользователя в когорте.

• Метрика — 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 — продолжительность сеанса на пользователя для параметра привлечения для когорты.

Пт, 8 апреля 2016 г.

Core Reporting API — выпуск от 30 марта 2016 г. (30 марта 2016 г.)

Параметры и показатели Social Data Hub устарели и будут отображать только исторические данные, начиная с 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 -адрес контента был обмен или упомянут в партнерской сети контента социальных данных.

Ср 30 марта 2016 г.

API Core Reporting-выпуск 2016-02-03 (3 февраля 2016 г.)

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

Платформа или устройство

• Размер - ga:browserSize - размер видового порта браузеров пользователей. Размер браузера - это размер сеанса, которая фиксирует начальные размеры видового тома в пикселях и отформатируется как ширина x высота. Например, 1920x960.

Ср. 03 февраля 2016 г.

Основная отчетность API-выпуск 2015-11-16 (16 ноября 2015 г.)

Этот выпуск добавляет новый параметр в API.

Включите пустые ряды

• Этот выпуск добавляет новый необязательный параметр include-empty-rows , которые при установке на false строки без данных будут опущены из ответа. Значение по умолчанию true , которое является неразрывным изменением, и, как таковое, не должно требовать обновления кода. См. Основную справочную документацию API отчетности для получения подробной информации.

Пн, 16 ноября 2015 г.

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 -дневный период, заканчивающийся на дату.

Вт 06 октября 2015 г.

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

Пт 11 сентября 2015 г.

Основная отчетность API-релиз 2015-07-23 (23 июля 2015 г.)

Этот релиз осуждает существующие измерения или метрики. Просмотрите ссылки на размеры и метрики для полного списка определений.

Устаревшие измерения

Эти измерения устарели. Просмотрите политику снижения данных для получения подробной информации об удалении данных:

• Размер - ga:adSlotPosition - Используйте ga:adSlot вместо этого.
• Размер - ga:nextPagePath - используйте ga:pagePath вместо этого.
• Dimension - ga:nextContentGroupXX - используйте ga:contentGroupXX вместо этого.

Чт 23 июля 2015 г.

Основная отчетная API-релиз 2015-05-06 (6 мая 2015 г.)

Этот релиз добавляет новое измерение в API. Обзорные измерения и ссылки на метрики для полного списка измерений и метрик.

Adwords

• Размер - ga:adQueryWordCount - Количество слов в поисковом запросе.

Ср 6 мая 2015 г.

Основная отчетность API-релиз 2015-02-20 (20 февраля 2015 г.)

Этот релиз добавляет новые размеры в API. Обзорные измерения и ссылки на метрики для полного списка измерений и метрик.

Платформа или устройство

• Размер - ga:dataSource - источник данных HIT. Хиты, отправленные из GA.JS и Analytics.js, сообщаются как «Интернет»; Хиты, отправленные с мобильных SDK, сообщаются как «приложение». Эти значения могут быть переопределены.

Внутренний поиск

• Размер - ga:searchAfterDestinationPage - страница, которую пользователь посетил после выполнения внутреннего поиска на вашем сайте.

Пт 20 февраля 2015 г.

API отчетов в реальном времени – выпуск от 12 февраля 2015 г. (12 февраля 2015 г.)

Это релиз исправления ошибок:

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

Чт 12 февраля 2015 г.

Основная отчетность 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 вместо этого.

Ср 21 января 2015 г.

API Core Reporting-выпуск 2014-10-09 (9 октября 2014 г.)

Этот релиз добавляет новую метрику в API и осуществляет два существующих показателя. Проверьте ссылки на размеры и метрики для полного списка определений.

AdWords

• Метрика - ga:ROAS - Возвращение на рекламу (ROAS) - это общий доход от транзакций и стоимость цели, разделенная на производные затраты на рекламу.

Устаревшие параметры и показатели

Эти измерения и метрики устарели. Просмотрите политику снижения данных для получения подробной информации об удалении данных: + Метрика - ga:ROI - используйте вместо этого ga:ROAS . + Метрика - ga:margin - используйте ga:ROAS вместо этого.

Чт 09 октября 2014 г.

Репортаж в реальном времени-релиз 2014-10-01 (1 октября 2014 г.)

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

Время

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

Ср. 01 октября 2014 г.

API Core Reporting-выпуск 2014-10-01 (1 октября 2014 г.)

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

АдСенс

• Метрика - ga:adsenseCoverage - процент запросов на рекламу, которые вернули как минимум одно объявление.
• Метрика - ga:adsenseViewableImpressionPercent - процент от впечатлений, которые можно было просматривать.

Ср. 01 октября 2014 г.

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

Пн 25 августа 2014 г.

Основная отчетная 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 (только премиум).
• Размер - ga:dcmClickAdType - DCM Тип объявления Имя DCM Click Matching Сеанс Google Analytics (только премиум).
• Размер - ga:dcmClickAdTypeId - DCM -тип объявления идентификатор DCM Click Matching сеанс Google Analytics (только премиум).
• Размер - ga:dcmClickAdvertiser - DCM Рекламодатель имени DCM Click Matching сеанс Google Analytics (только премиум).
• Размер - ga:dcmClickAdvertiserId - DCM -идентификатор рекламодателя DCM Click Matching the Google Analytics (только премиум).
• Размер - ga:dcmClickCampaign - название кампании DCM Click Click, соответствующее сеансу Google Analytics (только премиум).
• Размер - ga:dcmClickCampaignId - идентификатор кампании DCM в DCM Click, соответствующий сеансу Google Analytics (только премиум).
• Размер - ga:dcmClickCreative - Creative DCM Имя DCM Click Matching the Google Analytics Session (только премиум).
• Размер - ga:dcmClickCreativeId - DCM Creative Id of DCM Click Matching сеанс Google Analytics (только премиум).
• Размер - ga:dcmClickCreativeType - DCM Creative Type Имя DCM Click Matching the Google Analytics Session (только премиум).
• Размер - ga:dcmClickCreativeTypeId - DCM Creative Type ID типа DCM Click Соответствие сеансу Google Analytics (только премиум).
• Размер - ga:dcmClickCreativeVersion - Creative Version DCM Click Matching the Google Analytics (только премиум).
• Размер - ga:dcmClickRenderingId - DCM рендеринг идентификатор рендеринга DCM Click Matching the Google Analytics (только премиум).
• Размер - ga:dcmClickSite - Имя сайта, где было показано Creative DCM, и нажало на DCM Click, соответствующий сеансу Google Analytics (только премиум).
• Размер - ga:dcmClickSiteId - идентификатор сайта DCM, где был показан Creative DCM и нажал на DCM Click, соответствующий сеансу Google Analytics (только премиум).
• Размер - ga:dcmClickSitePlacement - DCM размещение сайта Имя DCM Click Matching the Google Analytics Session (только премиум).
• Размер - ga:dcmClickSitePlacementId - DCM идентификатор размещения сайта DCM Click Matching the Google Analytics Session (только премиум).
• Размер - ga:dcmClickSpotId - DCM идентификатор конфигурации прожектора DCM Click Matching сеанс Google Analytics (только премиум).
• Размер - ga:dcmFloodlightActivity - DCM -запасное название, связанное с преобразованием прожектора (только премия).
• Размер - ga:dcmFloodlightActivityAndGroup - DCM Имя активности прожектора и название группы, связанные с преобразованием прожектора (только премиум).
• Размер - ga:dcmFloodlightActivityGroup - DCM Имя группы активности прожектора, связанное с преобразованием прожектора (только премиум).
• Размер - ga:dcmFloodlightActivityGroupId - DCM Группа Activity Group Group, связанная с конверсией прожектора (только премиум).
• Размер - ga:dcmFloodlightActivityId - DCM Идентификатор активности прожектора прожектора DCM, связанный с конверсией прожектора (только премиум).
• Размер - ga:dcmFloodlightAdvertiserId - DCM идентификатор рекламодателя DCM, связанный с преобразованием прожектора (только премиум).
• Размер - ga:dcmFloodlightSpotId - идентификатор конфигурации прожектора DCM, связанный с преобразования прожектора (только премиум).
• Размер - ga:dcmLastEventAd - DCM AD Имя последнего события DCM (впечатление или щелчок в окне Lekback DCM), связанного с сеансом Google Analytics (только премиум).
• Размер - ga:dcmLastEventAdId - DCM AD ID последнего события DCM (впечатление или щелчок в окне Lekback DCM), связанного с сеансом Google Analytics (только премиум).
• Размер - ga:dcmLastEventAdType - DCM Тип объявления Имя последнего события DCM (впечатление или щелчок в окне DCM Lookback), связанного с сеансом Google Analytics (только премиум).
• Размер - ga:dcmLastEventAdTypeId - DCM -тип AD ID последнего события DCM (впечатление или нажмите в окне DCM Lookback), связанного с сеансом Google Analytics (только премиум).
• Размер - ga:dcmLastEventAdvertiser - DCM Рекламоде такта
• Размер - ga:dcmLastEventAdvertiserId - идентификатор рекламодателя DCM последнего события DCM (впечатление или щелчок в окне DCM Lookback), связанного с сеансом Google Analytics (только премиум).
• Размер - ga:dcmLastEventAttributionType - Существует два возможных значения (щелчок и просмотр). Если последнее событие DCM, связанное с сеансом Google Analytics, было щелчком, то значение будет кликтро. Если последнее событие DCM, связанное с сеансом Google Analytics, было впечатлением от AD, то значение будет просмотром (только премиум).
• Размер - ga:dcmLastEventCampaign - название кампании DCM последнего события DCM (впечатление или щелкните в окне «Показ DCM»), связанное с сеансом Google Analytics (только премиум).
• Размер - ga:dcmLastEventCampaignId - идентификатор кампании DCM последнего события DCM (впечатление или щелкните в окне «Показ DCM»), связанный с сеансом Google Analytics (только премиум).
• Размер - ga:dcmLastEventCreative - Creative Dcm Имя последнего события DCM (впечатление или щелкните в окне «Показ DCM»), связанное с сеансом Google Analytics (только Premium).
• Размер - ga:dcmLastEventCreativeId - DCM Creative Id последнего события DCM (впечатление или щелкните в окне Lekback DCM), связанного с сеансом Google Analytics (только премиум).
• Размер - ga:dcmLastEventCreativeType - DCM Creative Type Имя последнего события DCM (впечатление или щелчок в окне Lekback DCM), связанного с сеансом Google Analytics (только премиум).
• Размер - ga:dcmLastEventCreativeTypeId - DCM Creative Type ID последнего события DCM (впечатление или щелкните в окне Lekback DCM), связанного с сеансом Google Analytics (только премиум).
• Размер - ga:dcmLastEventCreativeVersion - Creative Version DCM последнего события DCM (впечатление или щелчок в окне DCM Lookback), связанная с сеансом Google Analytics (только премиум).
• Размер - ga:dcmLastEventRenderingId - идентификатор рендеринга DCM последнего события DCM (впечатление или щелкните в окне DCM Lookback), связанном с сеансом Google Analytics (только премиум).
• Размер - ga:dcmLastEventSite - Имя сайта, где было показано Creative DCM, и нажало на последнее событие DCM (впечатление или щелкните в окне Lekback DCM), связанного с сеансом Google Analytics (только премиум).
• Размер - ga:dcmLastEventSiteId - идентификатор сайта DCM, где был показан Creative DCM, и нажал на последнее событие DCM (впечатление или щелкните в окне Lekback DCM), связанном с сеансом Google Analytics (только Premium).
• Размер - ga:dcmLastEventSitePlacement - DCM Размещение сайта Имя последнего события DCM (впечатление или щелкните в окне DCM Lookback), связанного с сеансом Google Analytics (только премиум).
• Размер - ga:dcmLastEventSitePlacementId - идентификатор размещения сайта DCM последнего события DCM (впечатление или щелкните в окне DCM Lookback), связанного с сеансом Google Analytics (только премиум).
• Размер - ga:dcmLastEventSpotId - идентификатор конфигурации прожектора DCM последнего события DCM (впечатление или щелкните в окне «Показ DCM»), связанного с сеансом Google Analytics (только премиум).
• Метрика - ga:dcmFloodlightQuantity - количество конверсий прожектора DCM (только премия).
• Метрика - dcmFloodlightRevenue - DCM доход от прожектора (только премия).

Пн 25 августа 2014 г.

API Core Reporting-выпуск 2014-07-14 (14 июля 2014 г.)

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

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

Просмотрите ссылки на размеры и метрики для полного списка определений.

Группировка контента

• Размер - ga:landingContentGroupXX - первая группа контента в сеансе пользователя.
• Размер - ga:nextContentGroupXX - относится к группе контента, которая была посещена после другой группы контента.
• Dimension - ga:contentGroupXX - Группа контента на свойство. Группа контента - это коллекция контента, обеспечивающая логическую структуру, которая может быть определена путем отслеживания кода или заголовка страницы/Match Regex или предопределенных правил.
• Dimension - ga:previousContentGroupXX - относится к группе контента, которая посещалась перед другой группой контента.
• Метрика - ga:contentGroupUniqueViewsXX - количество различных (уникальных) страниц в сеансе для указанной группы контента. Это учитывает как PagePath, так и Pagetitle для определения уникальности.

Мон 14 июля 2014 г.

API Core Reporting-выпуск 2014-06-12 (12 июня 2014 г.)

Этот релиз включает в себя новое условие dateOfSession для сегментов и добавление новых расширенных аспектов электронной коммерции и метрик.

Сегменты

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

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

Просмотрите ссылки на размеры и метрики для полного списка определений для расширенной электронной коммерции .

Улучшенная электронная коммерция

• Размер - ga:internalPromotionCreative - творческий контент, разработанный для продвижения по службе.
• Размер - ga:internalPromotionId - идентификатор, который вы используете для продвижения.
• Измерение - ga:internalPromotionName - имя продвижения.
• Размер - ga:internalPromotionPosition - позиция продвижения на веб -странице или экране приложения.
• Размер - ga:orderCouponCode - Код для купона на уровне заказов.
• Размер - ga:productBrand - торговая марка, по которой продается продукт.
• Размер - ga:productCategoryHierarchy - иерархическая категория, в которой продукт классифицируется (расширенная электронная коммерция).
• Размер - ga:productCategoryLevelXX - Уровень (1-5) в иерархии категории продукта, начиная с вершины.
• Размер - ga:productCouponCode - Код для купона на уровне продукта.
• Размер - ga:productListName - название списка продуктов, в котором появляется продукт.
• Размер - ga:productListPosition - положение продукта в списке продуктов.
• Размер - ga:productVariant - конкретное изменение продукта, например, XS, S, M, L для размера или красного, синего, зеленого, черного цвета.
• Размер - ga:checkoutOptions - Пользовательские опции, указанные в процессе оформления заказа, например, FedEx, DHL, UPS для вариантов доставки или визы, MasterCard, Amex для вариантов оплаты. Это измерение следует использовать вместе с этапом покупок.
• Размер - ga:shoppingStage - Различные этапы опыта покупок, которые пользователи завершили в сеансе, например, product_view, add_to_cart, заказа и т. Д.
• Метрика - ga:internalPromotionCTR - скорость, с которой пользователи просмотрели внутреннюю рекламную акцию (появилось количество кликов / количество раз промоушена).
• Метрика - ga:internalPromotionClicks - количество кликов по внутренней акции.
• Метрика - ga:internalPromotionViews - Количество мнений внутренней продвижения.
• Метрика - ga:localProductRefundAmount - Сумма возврата для данного продукта в местной валюте.
• Метрика - ga:localRefundAmount - Общая сумма возврата для транзакции в местной валюте.
• Метрика - ga:productAddsToCart - количество раз, когда продукт был добавлен в корзину.
• Метрика - ga:productCheckouts - количество раз, когда продукт был включен в процесс выезда.
• Метрика - ga:productDetailViews - количество раз, когда пользователи просмотрели страницу Detail.
• Метрика - ga:productListClicks - количество раз пользователи нажимали на продукт, когда он появился в списке продуктов.
• Метрика - ga:productListViews - количество раз, когда продукт появлялся в списке продуктов.
• Метрика - ga:productListCTR - скорость, с которой пользователи нажимали на продукт в списке продуктов.
• Метрика - ga:productRefunds - количество раз возврат средств был выдан для продукта.
• Метрика - ga:productRefundAmount - Общая сумма возврата, связанную с продуктом.
• Метрика - ga:productRemovesFromCart - количество раз, когда продукт был удален из корзин для покупок.
• Метрика - ga:productRevenuePerPurchase - Средний доход от продукта за покупку (обычно используется с кодом купона продукта).
• Метрика - ga:buyToDetailRate - Уникальные покупки, разделенные с видами деталей продукта.
• Метрика - ga:cartToDetailRate - Продукт добавляет, разделенные с видами деталей продукта.
• Метрика - ga:quantityAddedToCart - Количество единиц продукта, добавленных в корзину.
• Метрика - ga:quantityCheckedOut - количество единиц продукта, включенных в проверку.
• Метрика - ga:quantityRefunded - количество возвратных единиц.
• Метрика - ga:quantityRemovedFromCart - Количество единиц продукта, удаленных из корзины.
• Метрика - ga:refundAmount - сумма валюты, возвращенная для транзакции.
• Метрика - ga:totalRefunds - Количество возвратов, которые были выданы.

Чт 12 июня 2014 года

Основная отчетная API-релиз 2014-06-04 (4 июня 2014 г.)

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

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

Просмотрите ссылки на размеры и метрики для полного списка определений.

Система

• Размер - ga:sourcePropertyDisplayName - Имя свойства Свойства источника. Это действительно только для свойств спины.
• Размер - ga:sourcePropertyTrackingId - Идентификатор отслеживания свойств источника. Это действительно только для свойств спины

Группировка канала

• Размер - ga:channelGrouping - группировка канала по умолчанию, которая используется в представлении (профиль).

сопутствующие товары

• Размер - ga:correlationModelId - идентификатор модели корреляции для связанных продуктов.
• Размер - ga:queryProductId - ID запрашиваемого продукта.
• Размер - ga:queryProductName - имя запрашивается продукт.
• Размер - ga:queryProductVariation - изменение запроса продукта.
• Размер - ga:relatedProductId , идентификатор связанного продукта.
• Размер - ga:relatedProductName - Имя связанного продукта.
• Измерение - ga:relatedProductVariation - изменение родственного продукта.
• Метрика - ga:correlationScore - Корреляционная оценка для связанных продуктов.
• Метрика - ga:queryProductQuantity - количество запрошенного продукта.
• Метрика - ga:relatedProductQuantity - количество связанного продукта.

Исправление названия столбца заголовка

• В выпуске 2014-04-16 была ошибка; Если вы запрашиваете устаревшее измерение или метрику, API вернет заголовки столбцов с размерной заменой или метрикой. Теперь он правильно возвращает то же измерение или метрическое имя, используемое в запросе.

Ср. 04 июня 2014

Metadata API-релиз 2014-06-03 (3 июня 2014 г.)

Этот релиз включает в себя изменение соглашения об именах для атрибута uiName .

uiname изменение

• Атрибут UINAME для температурных столбцов теперь использует XX для представления числового индекса вместо 1 . Например, Goal 1 Value теперь является Goal XX Value .

Вт, 03 июня 2014 г.

Embed API - релиз 2014-05 (28 мая 2014 г.)

Это первоначальный выпуск Embed API:

• API Google Analytics Embed - это библиотека JavaScript, которая позволяет легко создавать и внедрять панель на стороннем веб -сайте за считанные минуты. Посетите обзор API API для более подробной информации.
• Включает компоненты: AUTH, селектор просмотра, данные и диаграмму данных.

Ср 28 мая 2014 г.

Metadata API-релиз 2014-04-16 (16 апреля 2014 г.)

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

Appuiname УСТАНОВКА

• appUiName было устарели. Это больше не требуется в API метаданных, потому что имена пользовательского интерфейса для просмотров веб -и приложений (профили) были объединены. Вам следует удалить любой код, который использует атрибут appUiName , и использовать только атрибут uiName .

Ср 16 апреля 2014 года

Репортаж в реальном времени-релиз 2014-04-16 (16 апреля 2014 г.)

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

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

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

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

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

Ср 16 апреля 2014 года

Основной отчетность API-выпуск 2014-04-16 (16 апреля 2014 г.)

Этот релиз включает в себя добавление и переименование измерений и метрик. 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 or No - 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.

Renamed Dimensions and Metrics

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 - Use ga:userAgeBracket instead.
• Dimension - ga:visitorGender - Use ga:userGender instead.

Электронная коммерция

• Metric - ga:transactionRevenuePerVisit - Use ga:transactionRevenuePerSession instead.
• Metric - ga:transactionsPerVisit - Use ga:transactionsPerSession instead.

Event Tracking

• Metric - ga:eventsPerVisitWithEvent - Use ga:eventsPerSessionWithEvent instead.
• Metric - ga:visitsWithEvent - Use ga:sessionsWithEvent instead.

Goal Conversions

• Metric - ga:goalValuePerVisit - Use ga:goalValuePerSession instead.

Internal Search

• Metric - ga:percentVisitsWithSearch - Use ga:percentSessionsWithSearch instead.
• Metric - ga:searchVisits - Use ga:searchSessions instead.

Page Tracking

• Metric - ga:pageviewsPerVisit - Use ga:pageviewsPerSession instead.

Сессия

• Dimension - ga:visitLength - Use ga:sessionDurationBucket instead.
• Metric - ga:avgTimeOnSite - Use ga:avgSessionDuration instead.
• Metric - ga:timeOnSite - Use ga:sessionDuration instead.
• Metric - ga:visitBounceRate - Use ga:bounceRate instead.
• Metric - ga:visits - Use ga:sessions instead.

Социальные взаимодействия

• Dimension - ga:socialInteractionNetworkActionVisit - Use ga:socialInteractionNetworkActionSession instead.
• Metric - ga:socialInteractionsPerVisit - Use ga:socialInteractionsPerSession instead.

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

• Dimension - ga:daysSinceLastVisit - Use ga:daysSinceLastSession instead.
• Dimension - ga:visitCount - Use ga:sessionCount instead.
• Dimension - ga:visitorType - Use ga:userType instead.
• Dimension - ga:visitsToTransaction - Use ga:sessionsToTransaction instead.
• Metric - ga:newVisits - Use ga:newUsers instead.
• Metric - ga:percentNewVisits - Use ga:percentNewSessions instead.
• Metric - ga:visitors - Use ga:users instead.

Wed Apr 16 2014

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 the segment 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.

Fri Apr 11 2014

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.

Event Tracking

• 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.

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

• 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.

Thu Mar 20 2014

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.

Взаимодействия

• Dimension - mcf:adwordsCustomerID - Corresponds to AdWords API Customer.id .

Fri Feb 14 2014

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.

Взаимодействия

• Dimension - mcf:adwordsAdGroupID - Corresponds to AdWords API AdGroup.id .
• Dimension - mcf:adwordsCampaignID - Corresponds to AdWords API Campaign.id .
• Dimension - mcf:adwordsCreativeID - Corresponds to AdWords API Ad.id .
• Dimension - mcf:adwordsCriteriaID - Corresponds to AdWords API Criterion.id .

Thu Dec 12 2013

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 to datatable , a dataTable 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 between 00 and 59 .
• 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 is 0 , 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 of ga:source and ga:medium .
• Metric - ga:localItemRevenue - Product revenue in local currency.

Устаревшие параметры и показатели

These dimensions and metrics have been deprecated. Review the Data Deprecation Policy for details on data removal:

• Dimension - ga:isMobile - Use ga:deviceCategory instead (eg, ga:deviceCategory==mobile ).
• Dimension - ga:isTablet - Use ga:deviceCategory instead (eg, ga:deviceCategory==tablet ).
• Metric - ga:entranceBounceRate - Use ga:visitBounceRate instead.

Thu Dec 12 2013

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.

Время

• Dim - ga:isoYear - The ISO year of the visit. Details: http://en.wikipedia.org/wiki/ISO_week_date . ga:isoYear should only be used with ga:isoWeek since ga:week represents gregorian calendar.
• Dim - ga:isoYearIsoWeek - Combined values of ga:isoYear and ga: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 .

Mon Oct 28 2013

Multi-Channel Funnels 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 MCF Reporting API. today , yesterday , and NdaysAgo are now valid values for the start-date and end-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 , and HIGHER_PRECISION .
• 2 new fields have been added to the API Response: sampleSize and sampleSpace . 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.

Mon Oct 14 2013

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 , and NdaysAgo are now valid values for the start-date and end-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 , and HIGHER_PRECISION .
• 2 new fields have been added to the API Response: sampleSize and sampleSpace . 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.

Mon Oct 14 2013

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.

Tue Aug 20 2013

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.

Thu Aug 01 2013

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.

Tue Jul 23 2013

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.

Tue Jul 16 2013

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 the PackageManager#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 of ga:appviews .
  • Met - ga:uniqueScreenviews - The number of different (unique) ga:screenviews within a session. Use this instead of ga:uniqueAppviews .
  • Met - ga:screenviewsPerSession - The average number of ga:screenviews per session. Use this instead of ga:appviewsPerVisit .

Устарело

The following metrics have been deprecated. Use the new metric name instead.

• Met - ga:appviews - Use ga:screenviews instead.
• Met - ga:uniqueAppviews - Use ga:uniqueScreenviews instead.
• Met - ga:appviewsPerVisit - Use ga:screenviewsPerSession instead.

Custom Variables or Columns

• Access to custom dimension and metrics:

  • Dim - ga:dimensionXX - The name of the requested custom dimension, where XX refers the number/index of the custom dimension.
  • Met - ga:metricXX - The name of the requested custom metric, where XX refers the number/index of the custom metric.

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.

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 are Yes or No .
  • Dim - ga:mobileDeviceMarketingName - Marketing name used for mobile device.

Социальные взаимодействия

• This data comes from onsite social interaction tracking.

  • Dim - ga:socialEngagementType - Engagement type. Possible values are Socially Engaged or Not Socially Engaged .

Время

• Dim - ga:dateHour - Combined values of ga:date and ga: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 of ga:year and ga:month .
• Dim - ga:yearWeek - Combined values of ga:year and ga:week .

Источники трафика

• Dim - ga:fullReferrer - The full referring URL including the hostname and path.
• Dim - ga:sourceMedium - The combined values of ga:source and ga:medium .

Tue Jul 09 2013

Core Reporting API - Release 2013-04-04 (April 4, 2013)

• This release adds 2 new experiments metrics : - ga:experimentId - ga:experimentVariant

Чт, 4 апреля 2013 г.

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

Thu Jan 31 2013

Core Reporting API - Release 2013-01-14 (January 14, 2013)

• This release adds a new default segment for Tablet Traffic, gaid::-13 .

Mon Jan 14 2013

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.

Источники трафика

• 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.

Социальные взаимодействия

• 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 the ga:socialInteractionNetwork and ga: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 pair ga:socialInteractionNetwork and ga:socialInteractionAction
  • Met - ga:socialInteractionsPerVisit - ga:socialInteractions / ga:uniqueSocialInteractions . The average number of social interactions per visit to your site.

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.

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 .

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.

Tue Sep 18 2012

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 .

Wed Aug 01 2012

Core Reporting API - Release 2012-05 (May 31, 2012)

Исправление ошибок

• The API now correctly handles UTF-8 characters in a filter or dynamic segment.

Thu May 31 2012

Core Reporting API - Release 2012-05 (May 24, 2012)

This release enables Google Analytics premium accounts to access up to 50 custom variables.

Thu May 24 2012

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.

Tue Feb 14 2012

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.

Wed Feb 08 2012

Core Reporting API - Release 2012-01 (January 26, 2012)

We fixed a small bug with ga:visitLength . This dimension now returns correct data.

Thu Jan 26 2012

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.

Версия 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 .

Версия 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 to 403
  • 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 .

Постановка на учет

• 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 .

Mon Dec 05 2011

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 .

Wed Sep 07 2011

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 or ga:adGroup cannot be combined with ga:impressions .

  Instead of returning a response with 0 results, the API now returns 400 error code for all queries that ask for these combinations.

Thu Aug 11 2011

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.

Mon Jul 11 2011

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).

Tue May 31 2011

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.

Предстоящие изменения

• 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 a percent and returns the value 0.02. In the near future this will change to return the actual percent (eg 2).

Tue Apr 19 2011

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

Предстоящие изменения

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.

Wed Mar 09 2011

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 .

Mon Jan 24 2011

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 . This element will always return whether the data was sampled or not with either true or false . The Java and JavaScript libraries have also been updated with helper methods to access this element.

Mon Nov 01 2010

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).

Mon Aug 23 2010

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 .

Mon Jul 26 2010

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.

Tue May 04 2010

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 and ga:previousPagePath are now part of the D3. Content group. The D8. Custom Variable group is now called the D6. 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 either INF or a number from 0 to 1. Now all confidence intervals will have a value of either INF or a number greater than or equal to 0.

• ga:itemQuantity and ga: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

Mon Mar 22 2010

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'

• 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:

  • ga:visitorType==Returning Visitor

• 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:

• 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 and GoalValueAll 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:

• 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 now ga:visitCount
  • ga:countOfVisitsToATransaction is now ga:visitsToTransaction

Mon Dec 14 2009

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:

  D7. Events (Dimensions) * ga:eventCategory * ga:eventAction * ga:eventLabel

  M7. Events (Metrics) * ga:eventValue * ga:totalEvents * ga:uniqueEvents

• Overall site navigation data is is now exposed through the following dimensions:

  Д6. 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

Fri Sep 18 2009

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 and ga: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.html

• The 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).
  
  

• We're now enforcing that data queries must include at least one valid metric.

• All previous deprecation changes have taken effect.

Tue Jun 30 2009

Core Reporting API - Release 2009-05 (May 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

Fri May 22 2009