Мы периодически обновляем API отчетов Google Analytics Google Analytics , чтобы предоставлять новые функции и устранять дефекты, обнаруженные в предыдущих версиях. В большинстве случаев эти изменения будут прозрачны для разработчиков API. Однако иногда нам необходимо внести изменения, которые требуют от разработчиков модификации существующих приложений.
На этой странице документируются любые изменения, внесенные в API отчетов Google Analytics, которые могут повлиять на ваше приложение. Мы рекомендуем разработчикам API периодически проверять этот список на наличие новых объявлений. Вы также можете подписаться на изменения через каналы, перечисленные в разделе «Подписка» ниже.
Подпишитесь на соответствующие журналы изменений
Включает все API сбора, настройки и отчетности.
Включает базовый API отчетов, API отчетов по многоканальным последовательностям и API отчетов в реальном времени.
Выпуск от 19 марта 2019 г. (19 марта 2019 г.)
Это первый выпуск API активности пользователей.
- API активности пользователей позволяет получать все данные, связанные с одним идентификатором клиента или идентификатором пользователя, за определенный диапазон дат. В первую очередь он предназначен для поддержки владельцев собственности, которые хотят предоставить автоматический доступ к данным пользователя непосредственно этому пользователю. Для получения более подробной информации посетите Руководство по API активности пользователей .
Выпуск 23 января 2018 г. (23 января 2018 г.)
В этом выпуске система квот на основе ресурсов для Google Analytics Reporting API v4 доступна всем клиентам Analytics 360 (Премиум).
Выпуск от 29 ноября 2017 г. (29 ноября 2017 г.)
В этом выпуске увеличено максимальное количество строк, возвращаемых в наборе результатов Analytics Reporting API v4.
Максимальное количество строк, возвращаемых в объекте ReportData Analytics Reporting API v4, увеличено с 10 000 до 100 000.
Выпуск от 31 октября 2017 г. (31 октября 2017 г.)
В этом выпуске добавлена предварительная версия системы квот на основе ресурсов для Google Analytics Reporting API v4, которая позволяет использовать более высокие пороговые значения выборки для клиентов Analytics 360 (Премиум).
Выпуск 02.06.2017 (2 июня 2017 г.)
В этом выпуске прекращена поддержка функции «Сопутствующие товары» , а также связанных с ней параметров и показателей; Полный список определений см . в Справочнике по параметрам и показателям . Ознакомьтесь с Политикой устаревания данных для получения подробной информации об удалении данных:
Сопутствующие товары
В этом выпуске больше не поддерживаются следующие параметры и показатели:
-
ga:correlationModelId
-
ga:queryProductId
-
ga:queryProductName
-
ga:queryProductVariation
-
ga:relatedProductId
-
ga:relatedProductName
-
ga:relatedProductVariation
-
ga:correlationScore
-
ga:queryProductQuantity
-
ga:relatedProductQuantity
Выпуск от 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
Выпуск от 08 марта 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. Дополнительную информацию см. в справочной документации по уникальным событиям .
Выпуск от 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, приведет к ошибке.
Выпуск от 11 января 2017 г. (11 января 2017 г.)
Это выпуск с исправлением ошибок, который устраняет проблему с параметрами и показателями AdSense и объявляет о предстоящих изменениях в этих параметрах и показателях.
Параметры и показатели AdSense
В этом выпуске исправлена проблема, возникшая 7 января 2017 г., из-за которой запрос параметров и показателей AdSense возвращал ошибку «Неизвестный показатель» для связанных представлений, не связанных с AdSense.
Грядущие изменения
С 31 января 2017 г. или после этой даты для связанных представлений, не связанных с AdSense, будет запрещено запрашивать параметры и показатели AdSense. Запрос этих параметров и показателей с помощью связанных представлений, не связанных с AdSense, приведет к ошибке.
Выпуск от 12 октября 2016 г. (12 октября 2016 г.)
В этом выпуске в API добавлена следующая новая метрика. Полный список определений см . в Справочнике по измерениям и метрикам .
Расчетные метрики
В этом выпуске добавлена поддержка вычисляемых метрик .
- Метрика —
ga:calcMetric_
- Значение запрошенной вычисляемой метрики, где относится к определяемому пользователем имени вычисляемой метрики. Обратите внимание, что тип данных ga:calcMetric_
может быть FLOAT, INTEGER, CURRENCY, TIME или PERCENT. Подробности см. в разделе О вычисляемых метриках .
Выпуск 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
. Вы можете использовать эту метрику, чтобы понять новое определение до внесения изменений. Обратите внимание, что этот показатель является частным и не будет отображаться в Справочнике по измерениям и метрикам .
Выпуск от 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).
Выпуск 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
-
Выпуск от 08 июля 2016 г. (8 июля 2016 г.)
В этом выпуске представлены новые ограничения и квоты. Подробности см. в документации по лимитам и квотам .
Отчеты об ошибках
В этом выпуске начинают действовать ограничения на неудачные запросы отчетов ( 5XX
).
- 10 неудачных запросов на проект на профиль в час.
- 50 неудачных запросов на проект на профиль в день.
Ограничения поворота
В этом выпуске начинают действовать ограничения на сводные запросы:
- Запрос отчета теперь может иметь максимум 2 сводных отчета .
- Поворотная точка может иметь максимум 4 измерения .
- Сводные измерения являются частью ограничения на общее количество измерений, разрешенных в запросе.
- Метрики сводной таблицы являются частью ограничения на общее количество метрик, разрешенных в запросе.
Выпуск 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 к сеансам Google Analytics (показы объявлений/сеансы Google 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 не включена).
Выпуск от 18 мая 2016 г. (18 мая 2016 г.)
Это выпуск с исправлением ошибок, который устраняет проблему с сегментами и выборкой.
Сегменты
В этом выпуске исправлена проблема, из-за которой подмножество запросов с сегментом «Все пользователи» ( gaid::-1
) не учитывалось в Core Reporting API V3 и разделялось на два сегмента в Analytics Reporting API V4 .
Выборка
В этом выпуске исправлена проблема, из-за которой подмножество запросов из пользовательских таблиц возвращало выборочные данные .
Выпуск 29 апреля 2016 г. (29 апреля 2016 г.)
Это выпуск с исправлением ошибок, который устраняет проблему при выполнении когортных запросов Analytics Reporting API V4 .
Когортные запросы
Запросы на когорты теперь могут запрашивать все измерения когорты ; ранее API возвращал ошибку при запросе измерений ga:acquisition...
Общая ценность запроса на общую ценность
Обратите внимание, что запросы общей ценности могут создавать отчеты о общей ценности только для просмотров приложения .
Выпуск от 08 апреля 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
— продолжительность сеанса на пользователя для параметра привлечения для когорты.
Выпуск от 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-адрес контента был опубликован или упомянут в партнерской сети центра социальных данных.
Выпуск от 03 февраля 2016 г. (3 февраля 2016 г.)
В этом выпуске API добавлено новое измерение. Полный список определений см . в Справочнике по измерениям и метрикам .
Платформа или устройство
- Размерность —
ga:browserSize
— размер области просмотра браузеров пользователей. Размер браузера — это измерение области сеанса, которое фиксирует начальные размеры области просмотра в пикселях и форматируется как ширина X высота. Например, 1920х960.
Выпуск от 16 ноября 2015 г. (16 ноября 2015 г.)
В этом выпуске в API добавлен новый параметр.
Включить пустые строки
- В этом выпуске добавлен новый необязательный параметр
include-empty-rows
, для которого при установке значенияfalse
строки без данных будут исключены из ответа. Значение по умолчанию —true
, что является некритичным изменением и поэтому не требует обновления кода. Подробности см. в справочной документации по Core Reporting API .
Выпуск от 06 октября 2015 г. (6 октября 2015 г.)
В этом выпуске в API добавлены новые метрики. Полный список определений см . в Справочнике по измерениям и метрикам .
Пользователь
- Метрика —
ga:1dayUsers
— общее количество активных пользователей за 1 день за каждый день за запрошенный период времени. Для запроса этой метрики в качестве измерения необходимо указать хотя бы одно из значений ga:nthDay, ga:date или ga:day. Для данной даты возвращаемым значением будет общее количество уникальных пользователей за 1-дневный период, заканчивающийся в данную дату. - Метрика —
ga:7dayUsers
— общее количество активных пользователей за 7 дней за каждый день за запрошенный период времени. Для запроса этой метрики в качестве измерения необходимо указать хотя бы одно из значений ga:nthDay, ga:date или ga:day. Для данной даты возвращаемым значением будет общее количество уникальных пользователей за 7-дневный период, заканчивающийся в данную дату. - Метрика —
ga:14dayUsers
— общее количество активных пользователей за 14 дней за каждый день за запрошенный период времени. Для запроса этой метрики в качестве измерения необходимо указать хотя бы одно из значений ga:nthDay, ga:date или ga:day. Для данной даты возвращаемым значением будет общее количество уникальных пользователей за 14-дневный период, заканчивающийся в данную дату. - Метрика —
ga:30dayUsers
— общее количество активных пользователей за 30 дней за каждый день за запрошенный период времени. Для запроса этой метрики в качестве измерения необходимо указать хотя бы одно из значений ga:nthDay, ga:date или ga:day. Для данной даты возвращаемым значением будет общее количество уникальных пользователей за 30-дневный период, заканчивающийся в данную дату.
Выпуск 11 сентября 2015 г. (11 сентября 2015 г.)
В этом выпуске в API добавлены новые метрики. Полный список определений см . в Справочнике по измерениям и метрикам .
DoubleClick Ad Exchange (AdX)
- Метрика –
ga:adxCTR
– процент просмотров страниц, приведших к клику по объявлению AdX. - Метрика –
ga:adxClicks
– количество кликов по объявлениям AdX на вашем сайте. - Метрика –
ga:adxCoverage
. Охват – это процент запросов объявлений, по которым было возвращено хотя бы одно объявление. Как правило, охват может помочь вам определить сайты, на которых ваша учетная запись AdX не может предоставлять таргетированную рекламу. (Показы рекламы / Общее количество запросов объявлений) * 100 - Метрика –
ga:adxECPM
– эффективная цена за тысячу просмотров страниц. Это ваш доход от AdX на 1000 просмотров страниц. - Метрика –
ga:adxImpressions
– показ объявления AdX регистрируется каждый раз, когда на вашем веб-сайте отображается отдельное объявление. Например, если страница с двумя рекламными блоками будет просмотрена один раз, мы отобразим два показа. - Метрика —
ga:adxImpressionsPerSession
— соотношение показов объявлений AdX к сеансам Google Analytics (Ad Impressions / Analytics Sessions). - Метрика –
ga:adxMonetizedPageviews
– Монетизированные просмотры страниц измеряет общее количество просмотров страниц вашего ресурса, которые были показаны с рекламой из связанного аккаунта AdX. Примечание. На одной странице может быть несколько рекламных блоков. - Метрика –
ga:adxRevenue
– общий расчетный доход от рекламы AdX. - Метрика –
ga:adxRevenuePer1000Sessions
– общий расчетный доход от рекламы AdX за 1000 сеансов Google Analytics. Обратите внимание, что этот показатель основан на сеансах вашего сайта, а не на показах рекламы. - Метрика —
ga:adxViewableImpressionsPercent
— процент показов объявления, которые были видны. Показ считается видимым показом, если он появился в браузере пользователя и имел возможность быть увиденным.
Выпуск 23 июля 2015 г. (23 июля 2015 г.)
В этом выпуске существующие параметры и показатели устарели. Полный список определений см . в Справочнике по измерениям и метрикам .
Устаревшие размеры
Эти размеры устарели. Ознакомьтесь с Политикой устаревания данных для получения подробной информации об удалении данных:
- Измерение —
ga:adSlotPosition
— вместо этого используйтеga:adSlot
. - Измерение —
ga:nextPagePath
— вместо этого используйтеga:pagePath
. - Измерение —
ga:nextContentGroupXX
— вместо этого используйтеga:contentGroupXX
.
Выпуск от 06 мая 2015 г. (6 мая 2015 г.)
В этом выпуске API добавлено новое измерение. Полный список параметров и показателей см. в Справочнике по параметрам и метрикам.
Адвордс
- Размерность —
ga:adQueryWordCount
— количество слов в поисковом запросе.
Выпуск от 20 февраля 2015 г. (20 февраля 2015 г.)
В этом выпуске API добавлены новые возможности. Полный список параметров и показателей см. в Справочнике по параметрам и метрикам.
Платформа или устройство
- Измерение —
ga:dataSource
— источник данных обращения. Обращения, отправленные с ga.js и Analytics.js, обозначаются как «web»; обращения, отправленные из мобильных SDK, регистрируются как «приложения». Эти значения можно переопределить.
Внутренний поиск
- Измерение —
ga:searchAfterDestinationPage
— страница, которую посетил пользователь после выполнения внутреннего поиска на вашем сайте.
Выпуск 21 января 2015 г. (21 января 2015 г.)
В этом выпуске в API добавлены новые параметры и показатели, а также объявлены устаревшими два существующих показателя. Полный список определений см . в Справочнике по измерениям и метрикам .
Электронная коммерция
- Метрика —
ga:transactionsPerUser
— общее количество транзакций, разделенное на общее количество пользователей. - Метрика —
ga:revenuePerUser
— общий доход от продаж, предоставленный в транзакции, без учета доставки и налогов, разделенный на общее количество пользователей.
Пользователь
- Метрика —
ga:sessionsPerUser
— общее количество сеансов, разделенное на общее количество пользователей.
Геосеть
- Измерение —
ga:cityId
— идентификаторы городов пользователей, полученные на основе IP-адресов или географических идентификаторов. - Измерение —
ga:countryIsoCode
— ISO-код страны пользователей, полученный на основе IP-адресов или географических идентификаторов. Значения даны в виде кода ISO-3166-1 альфа-2. - Измерение —
ga:regionId
— идентификатор региона пользователей, полученный на основе IP-адресов или географических идентификаторов. В США регионом является штат, например Нью-Йорк. - Измерение —
ga:regionIsoCode
— ISO-код региона пользователей, полученный на основе IP-адресов или географических идентификаторов. Значения даны в виде кода ISO-3166-2. - Измерение —
ga:subContinentCode
— код пользователей субконтинента, полученный на основе IP-адресов или географических идентификаторов. Например, Полинезия или Северная Европа. Значения указаны в виде кода ООН M.49.
Менеджер кампаний DoubleClick
- Показатель –
ga:dcmROAS
– рентабельность инвестиций в рекламу DCM (только для премиум-версий).
Устаревшие метрики
Эти показатели устарели. Подробную информацию об удалении данных см. в Политике устаревания данных : + Метрика – ga:dcmROI
– Вместо этого используйте ga:dcmROAS
. + Метрика – ga:dcmMargen
– вместо этого используйте ga:dcmROAS
.
Выпуск от 9 октября 2014 г. (9 октября 2014 г.)
В этом выпуске в API добавлена новая метрика, а две существующие метрики признаны устаревшими. Полный список определений можно найти в Справочнике по измерениям и метрикам .
AdWords
- Метрика –
ga:ROAS
– рентабельность инвестиций в рекламу (ROAS) – это общий доход от транзакций и целевая стоимость, разделенная на производные затраты на рекламу.
Устаревшие параметры и показатели
Эти параметры и показатели устарели. Подробную информацию об удалении данных см. в Политике устаревания данных : + Метрика – ga:ROI
– Вместо этого используйте ga:ROAS
. + Метрика – ga:margin
– Вместо этого используйте ga:ROAS
.
Выпуск от 01 октября 2014 г. (1 октября 2014 г.)
В этом выпуске в API добавлены новые метрики. Полный список определений можно найти в Справочнике по измерениям и метрикам .
АдСенс
- Метрика –
ga:adsenseCoverage
– процент запросов объявлений, по которым вернулось хотя бы одно объявление. - Метрика –
ga:adsenseViewableImpressionPercent
– процент показов, которые были доступны для просмотра.
Выпуск 25 августа 2014 г. (25 августа 2014 г.)
В этот выпуск добавлен новый показатель сеанса, новый параметр «Источники трафика», а также новые параметры и показатели DoubleClick Campaign Manager.
Размеры и показатели
Полный список определений см . в Справочнике по измерениям и метрикам .
Сессия
- Метрика –
ga:hits
– общее количество обращений, отправленных в Google Analytics. Эта метрика суммирует все типы обращений (например, просмотр страницы, событие, время и т. д.).
Источники трафика
- Измерение –
ga:campaignCode
– при использовании отслеживания кампании вручную значение параметра отслеживания кампании utm_id.
Менеджер кампаний DoubleClick
- Параметр –
ga:dcmClickAd
– название объявления DCM для клика DCM, соответствующего сеансу Google Analytics (только для премиум-версий). - Параметр –
ga:dcmClickAdId
– идентификатор объявления DCM для клика DCM, соответствующего сеансу Google Analytics (только для премиум-версий). - Параметр –
ga:dcmClickAdType
– название типа объявления DCM для клика DCM, соответствующего сеансу Google Analytics (только для премиум-версии). - Параметр –
ga:dcmClickAdTypeId
– идентификатор типа объявления DCM для клика DCM, соответствующего сеансу Google Analytics (только для премиум-версии). - Параметр –
ga:dcmClickAdvertiser
– название рекламодателя DCM для клика DCM, соответствующего сеансу Google Analytics (только для премиум-версий). - Параметр –
ga:dcmClickAdvertiserId
– идентификатор рекламодателя DCM для клика DCM, соответствующего сеансу Google Analytics (только для премиум-версий). - Параметр –
ga:dcmClickCampaign
– название кампании DCM для клика DCM, соответствующего сеансу Google Analytics (только для премиум-версии). - Параметр –
ga:dcmClickCampaignId
– идентификатор кампании DCM для клика DCM, соответствующего сеансу Google Analytics (только для премиум-версии). - Параметр –
ga:dcmClickCreative
– название объявления DCM для клика DCM, соответствующего сеансу Google Analytics (только для премиум-класса). - Измерение –
ga:dcmClickCreativeId
– идентификатор объявления DCM для клика DCM, соответствующего сеансу Google Analytics (только для премиум-версии). - Параметр –
ga:dcmClickCreativeType
– название типа объявления DCM для клика DCM, соответствующего сеансу Google Analytics (только для премиум-класса). - Параметр –
ga:dcmClickCreativeTypeId
– идентификатор типа объявления DCM для клика DCM, соответствующего сеансу Google Analytics (только для премиум-версии). - Параметр –
ga:dcmClickCreativeVersion
– версия объявления DCM для клика DCM, соответствующая сеансу Google Analytics (только для премиум-версии). - Измерение –
ga:dcmClickRenderingId
– идентификатор отображения DCM клика DCM, соответствующего сеансу Google Analytics (только для премиум-версии). - Параметр –
ga:dcmClickSite
– название сайта, на котором было показано объявление DCM и на который был сделан клик DCM, соответствующий сеансу Google Analytics (только для премиум-версий). - Измерение –
ga:dcmClickSiteId
– идентификатор сайта DCM, на котором было показано объявление DCM и на который был сделан клик для клика DCM, соответствующего сеансу Google Analytics (только для премиум-версии). - Параметр –
ga:dcmClickSitePlacement
– название места размещения на сайте DCM, соответствующее клику DCM, соответствующему сеансу Google Analytics (только для премиум-класса). - Параметр –
ga:dcmClickSitePlacementId
– идентификатор места размещения на сайте DCM для клика DCM, соответствующего сеансу Google Analytics (только для премиум-версии). - Параметр –
ga:dcmClickSpotId
– идентификатор конфигурации Floodlight DCM для клика DCM, соответствующего сеансу Google Analytics (только для премиум-версии). - Измерение –
ga:dcmFloodlightActivity
– название действия Floodlight в DCM, связанное с конверсией Floodlight (только для премиум-версии). - Измерение –
ga:dcmFloodlightActivityAndGroup
– название действия DCM Floodlight и имя группы, связанное с преобразованием Floodlight (только для премиум-версии). - Измерение –
ga:dcmFloodlightActivityGroup
– название группы действий Floodlight в DCM, связанное с преобразованием Floodlight (только для премиум-версии). - Измерение –
ga:dcmFloodlightActivityGroupId
– идентификатор группы действий Floodlight в DCM, связанный с конверсией Floodlight (только для премиум-версии). - Измерение –
ga:dcmFloodlightActivityId
– идентификатор действия Floodlight в DCM, связанный с конверсией Floodlight (только для премиум-версии). - Параметр –
ga:dcmFloodlightAdvertiserId
– идентификатор рекламодателя Floodlight DCM, связанный с конверсией Floodlight (только для премиум-версий). - Измерение –
ga:dcmFloodlightSpotId
– идентификатор конфигурации Floodlight DCM, связанный с преобразованием Floodlight (только для премиум-версии). - Параметр –
ga:dcmLastEventAd
– название объявления DCM последнего события DCM (показа или клика в окне ретроспективного анализа DCM), связанного с сеансом Google Analytics (только для Премиум-версий). - Параметр –
ga:dcmLastEventAdId
– идентификатор объявления DCM последнего события DCM (показа или клика в окне ретроспективного анализа DCM), связанного с сеансом Google Analytics (только для премиум-версии). - Параметр –
ga:dcmLastEventAdType
– название типа объявления DCM последнего события DCM (показа или клика в окне ретроспективного анализа DCM), связанного с сеансом Google Analytics (только для премиум-версий). - Параметр –
ga:dcmLastEventAdTypeId
– идентификатор типа объявления DCM последнего события DCM (показа или клика в окне ретроспективного анализа DCM), связанного с сеансом Google Analytics (только для премиум-версии). - Параметр –
ga:dcmLastEventAdvertiser
– имя рекламодателя DCM для последнего события DCM (показа или клика в окне ретроспективного анализа DCM), связанного с сеансом Google Analytics (только для премиум-версии). - Параметр –
ga:dcmLastEventAdvertiserId
– идентификатор рекламодателя DCM последнего события DCM (показа или клика в окне ретроспективного анализа DCM), связанного с сеансом Google Analytics (только для премиум-версии). - Измерение —
ga:dcmLastEventAttributionType
— существует два возможных значения (ClickThrough и ViewThrough). Если последним событием DCM, связанным с сеансом Google Analytics, был клик, то значением будет ClickThrough. Если последним событием DCM, связанным с сеансом Google Analytics, был показ объявления, то значением будет ViewThrough (только для премиум-версии). - Параметр –
ga:dcmLastEventCampaign
– название кампании DCM последнего события DCM (показа или клика в окне ретроспективного анализа DCM), связанного с сеансом Google Analytics (только для премиум-версии). - Параметр –
ga:dcmLastEventCampaignId
– идентификатор кампании DCM последнего события DCM (показа или клика в окне ретроспективного анализа DCM), связанного с сеансом Google Analytics (только для премиум-версии). - Параметр –
ga:dcmLastEventCreative
– название объявления DCM последнего события DCM (показа или клика в окне ретроспективного анализа DCM), связанного с сеансом Google Analytics (только для премиум-версии). - Параметр –
ga:dcmLastEventCreativeId
– идентификатор объявления DCM последнего события DCM (показа или клика в окне ретроспективного анализа DCM), связанного с сеансом Google Analytics (только для премиум-версии). - Параметр –
ga:dcmLastEventCreativeType
– название типа объявления DCM последнего события DCM (показа или клика в окне ретроспективного анализа DCM), связанного с сеансом Google Analytics (только для Премиум-версий). - Параметр –
ga:dcmLastEventCreativeTypeId
– идентификатор типа объявления DCM последнего события DCM (показа или клика в окне ретроспективного анализа DCM), связанного с сеансом Google Analytics (только для премиум-версии). - Параметр –
ga:dcmLastEventCreativeVersion
– версия объявления DCM последнего события DCM (показа или клика в окне ретроспективного анализа DCM), связанного с сеансом Google Analytics (только для премиум-версии). - Измерение –
ga:dcmLastEventRenderingId
– идентификатор отображения DCM последнего события DCM (показа или клика в окне ретроспективного анализа DCM), связанного с сеансом Google Analytics (только для премиум-версии). - Параметр –
ga:dcmLastEventSite
– название сайта, на котором было показано объявление DCM и на который был сделан клик для последнего события DCM (показа или клика в окне ретроспективного анализа DCM), связанного с сеансом Google Analytics (только для Премиум-версий). - Параметр –
ga:dcmLastEventSiteId
– идентификатор сайта DCM, на котором было показано объявление DCM и на который был сделан клик для последнего события DCM (показа или клика в окне ретроспективного анализа DCM), связанного с сеансом Google Analytics (только для премиум-версии). - Параметр –
ga:dcmLastEventSitePlacement
– название места размещения на сайте DCM последнего события DCM (показа или клика в окне ретроспективного анализа DCM), связанного с сеансом Google Analytics (только для премиум-версии). - Измерение –
ga:dcmLastEventSitePlacementId
– идентификатор места размещения на сайте DCM последнего события DCM (показа или клика в окне ретроспективного анализа DCM), связанного с сеансом Google Analytics (только для премиум-версии). - Параметр –
ga:dcmLastEventSpotId
– идентификатор конфигурации Floodlight DCM последнего события DCM (показа или клика в окне ретроспективного анализа DCM), связанного с сеансом Google Analytics (только для премиум-версии). - Метрика –
ga:dcmFloodlightQuantity
– количество конверсий Floodlight в DCM (только для премиум-версий). - Метрика –
dcmFloodlightRevenue
– доход DCM Floodlight (только для премиум-версий).
Выпуск 14 июля 2014 г. (14 июля 2014 г.)
В этом выпуске добавлены новые параметры и показатели группировки контента.
Размеры и показатели
Полный список определений см . в Справочнике по измерениям и метрикам .
Группировка контента
- Измерение —
ga:landingContentGroupXX
— первая совпадающая группа контента в сеансе пользователя. - Измерение —
ga:nextContentGroupXX
— относится к группе контента, которая была посещена после другой группы контента. - Измерение —
ga:contentGroupXX
— группа контента для свойства. Группа контента — это набор контента, имеющий логическую структуру, которую можно определить с помощью кода отслеживания, соответствия заголовка страницы/регулярного выражения или предопределенных правил. - Измерение —
ga:previousContentGroupXX
— относится к группе контента, которая была посещена перед другой группой контента. - Метрика —
ga:contentGroupUniqueViewsXX
— количество разных (уникальных) страниц в сеансе для указанной группы контента. При этом для определения уникальности учитываются как pagePath, так и pageTitle.
Выпуск 12 июня 2014 г. (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 для вариантов доставки или Visa, MasterCard, AmEx для вариантов оплаты. Этот параметр следует использовать вместе с этапом покупок. - Измерение –
ga:shoppingStage
– различные этапы процесса совершения покупок, которые пользователи завершили за сеанс, например PRODUCT_VIEW, ADD_TO_CART, CHECKOUT и т. д. - Метрика —
ga:internalPromotionCTR
— частота, с которой пользователи переходили по ссылкам для просмотра внутренней рекламной акции (количество кликов / количество показов рекламной акции). - Метрика —
ga:internalPromotionClicks
— количество кликов по внутренней рекламной акции. - Метрика —
ga:internalPromotionViews
— количество просмотров внутренней акции. - Метрика —
ga:localProductRefundAmount
— сумма возврата для данного продукта в местной валюте. - Метрика —
ga:localRefundAmount
— общая сумма возврата по транзакции в местной валюте. - Метрика —
ga:productAddsToCart
— количество раз, когда товар был добавлен в корзину. - Метрика —
ga:productCheckouts
— количество раз, когда товар был включен в процесс оформления заказа. - Метрика —
ga:productDetailViews
— количество раз, когда пользователи просматривали страницу с подробными сведениями о продукте. - Метрика —
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
— количество выданных возвратов.
Выпуск 04.06.2014 (4 июня 2014 г.)
В этом выпуске исправлена ошибка с именами заголовков столбцов, а также добавлены новые параметры и показатели.
Размеры и показатели
Полный список определений см . в Справочнике по измерениям и метрикам .
Система
- Измерение —
ga:sourcePropertyDisplayName
— отображаемое имя исходного свойства агрегированных свойств. Это справедливо только для агрегированных объектов. - Измерение –
ga:sourcePropertyTrackingId
– идентификатор отслеживания исходного ресурса для агрегированных ресурсов. Это действительно только для агрегированных объектов.
Группировка каналов
- Измерение —
ga:channelGrouping
— группа каналов по умолчанию, которая используется в представлении (профиле).
сопутствующие товары
- Измерение —
ga:correlationModelId
— идентификатор модели корреляции для связанных продуктов. - Измерение —
ga:queryProductId
— идентификатор запрашиваемого продукта. - Измерение —
ga:queryProductName
— название запрашиваемого продукта. - Измерение —
ga:queryProductVariation
— вариант запрашиваемого продукта. - Измерение —
ga:relatedProductId
— идентификатор связанного продукта. - Измерение —
ga:relatedProductName
— название связанного продукта. - Измерение —
ga:relatedProductVariation
— вариант соответствующего продукта. - Метрика —
ga:correlationScore
— показатель корреляции для связанных продуктов. - Метрика —
ga:queryProductQuantity
— количество запрашиваемого продукта. - Метрика —
ga:relatedProductQuantity
— количество соответствующего товара.
Исправление названия столбца заголовка
- В выпуске от 16 апреля 2014 г. была ошибка; если вы запросили устаревший параметр или показатель, API вернет заголовки столбцов с заменяющим параметром или показателем. Теперь он правильно возвращает то же имя измерения или метрики, которое использовалось в запросе.
Выпуск 16 апреля 2014 г. (16 апреля 2014 г.)
В этом выпуске добавлены и переименованы параметры и показатели. Полный список определений см . в Справочнике по измерениям и метрикам .
Новые параметры и показатели
В Core Reporting API были добавлены следующие параметры:
AdWords
- Параметр –
ga:isTrueViewVideoAd
–Yes
илиNo
– указывает, является ли объявление видеообъявлением AdWords TrueView.
Время
- Измерение —
ga:nthHour
— индекс для каждого часа в указанном диапазоне дат. Индекс первого часа первого дня (т. е. даты начала) в диапазоне дат равен 0, 1 для следующего часа и т. д.
Переименованные параметры и показатели
Все параметры и показатели, основанные на посетителях и посещениях , были переименованы, чтобы вместо них использовались пользователь и сеанс соответственно.
Следующие параметры и показатели были переименованы. Подробную информацию о переименовании данных см. в Политике устаревания данных :
Аудитория
- Измерение —
ga:visitorAgeBracket
— вместо этого используйтеga:userAgeBracket
. - Измерение —
ga:visitorGender
— вместо этого используйтеga:userGender
.
Электронная коммерция
- Метрика —
ga:transactionRevenuePerVisit
— вместо этого используйтеga:transactionRevenuePerSession
. - Метрика —
ga:transactionsPerVisit
— вместо этого используйтеga:transactionsPerSession
.
Отслеживание событий
- Метрика —
ga:eventsPerVisitWithEvent
— вместо этого используйтеga:eventsPerSessionWithEvent
. - Метрика —
ga:visitsWithEvent
— вместо этого используйтеga:sessionsWithEvent
.
Целевые конверсии
- Метрика —
ga:goalValuePerVisit
— вместо этого используйтеga:goalValuePerSession
.
Внутренний поиск
- Метрика —
ga:percentVisitsWithSearch
— вместо этого используйтеga:percentSessionsWithSearch
. - Метрика —
ga:searchVisits
— вместо этого используйтеga:searchSessions
.
Отслеживание страниц
- Метрика —
ga:pageviewsPerVisit
— вместо этого используйтеga:pageviewsPerSession
.
Сессия
- Dimension —
ga:visitLength
— вместо этого используйтеga:sessionDurationBucket
. - Метрика —
ga:avgTimeOnSite
— вместо этого используйтеga:avgSessionDuration
. - Метрика —
ga:timeOnSite
— вместо этого используйтеga:sessionDuration
. - Метрика —
ga:visitBounceRate
— вместо этого используйтеga:bounceRate
. - Метрика –
ga:visits
– вместо этого используйтеga:sessions
.
Социальные взаимодействия
- Измерение —
ga:socialInteractionNetworkActionVisit
— вместо этого используйтеga:socialInteractionNetworkActionSession
. - Метрика —
ga:socialInteractionsPerVisit
— вместо этого используйтеga:socialInteractionsPerSession
.
Пользователь
- Измерение —
ga:daysSinceLastVisit
— вместо этого используйтеga:daysSinceLastSession
. - Измерение —
ga:visitCount
— вместо этого используйтеga:sessionCount
. - Измерение —
ga:visitorType
— вместо этого используйтеga:userType
. - Измерение —
ga:visitsToTransaction
— вместо этого используйтеga:sessionsToTransaction
. - Метрика —
ga:newVisits
— вместо этого используйтеga:newUsers
. - Метрика —
ga:percentNewVisits
— вместо этого используйтеga:percentNewSessions
. - Метрика —
ga:visitors
— вместо этого используйтеga:users
.
Выпуск от 11 апреля 2014 г. (11 апреля 2014 г.)
Сегменты: Core Reporting API v2.4 и v3.0
Поддержка новых сегментов в Core Reporting API.
- Параметр
segment
теперь поддерживает сегменты пользователя и последовательности. Сегменты уровня пользователя и уровня сеанса , созданные в веб-интерфейсе, можно запросить с помощью параметраsegment
. - Новый синтаксис динамических сегментов доступен для использования с параметром
segment
. Подробности см. в Руководстве для разработчиков по сегментам. - Префикс
dynamic::
устарел. Рекомендуется как можно скорее перейти на новый синтаксис.
Выпуск от 12 декабря 2013 г. (12 декабря 2013 г.)
Этот выпуск включает новый формат ответа таблицы данных , а также добавление и прекращение поддержки параметров и показателей (полный список определений см. в Справочнике по измерениям и метрикам ).
Вывод таблицы данных
Чтобы упростить отображение данных Google Analytics с помощью визуализаций Google Charts, API может дополнительно возвращать в ответе объект таблицы данных.
- В API добавлен необязательный параметр
output
запроса. Его можно использовать для выбора формата вывода данных Analytics в ответе (по умолчанию это JSON). Если установлено значениеdatatable
, в ответ включается свойствоdataTable
, содержащее объект таблицы данных . Этот объект можно использовать непосредственно с Google Charts . Подробности см. в справочнике по Core Reporting API .
Новые параметры и показатели
В Core Reporting API были добавлены следующие параметры и показатели:
Время
- Размерность -
ga:minute
- Возвращает минуты в часе. Возможные значения: от00
до59
. - Измерение —
ga:nthMinute
— индекс каждой минуты в указанном диапазоне дат. Индекс первой минуты первого дня (т. е. даты начала) в диапазоне дат равен0
,1
для следующей минуты и т. д.
Аудитория
- Размерность —
ga:visitorAgeBracket
— возрастная группа посетителя. - Размерность —
ga:visitorGender
— пол посетителя. - Измерение —
ga:interestAffinityCategory
— указывает, что пользователи с большей вероятностью будут заинтересованы в изучении указанной категории. - Измерение —
ga:interestInMarketCategory
— указывает, что пользователи с большей вероятностью будут готовы приобрести продукты или услуги в указанной категории. - Измерение —
ga:interestOtherCategory
— указывает, что пользователи с большей вероятностью будут заинтересованы в изучении указанной категории и с большей вероятностью будут готовы к покупке.
Параметры и показатели, разрешенные в сегментах
Эти параметры и показатели теперь можно использовать в сегментах:
- Измерение –
ga:sourceMedium
– объединенные значенияga:source
иga:medium
. - Метрика —
ga:localItemRevenue
— доход от продукта в местной валюте.
Устаревшие параметры и показатели
Эти параметры и показатели устарели. Ознакомьтесь с Политикой устаревания данных для получения подробной информации об удалении данных:
- Dimension –
ga:isMobile
– вместо этого используйтеga:deviceCategory
(например,ga:deviceCategory==mobile
). - Dimension –
ga:isTablet
– вместо этого используйтеga:deviceCategory
(например,ga:deviceCategory==tablet
). - Метрика —
ga:entranceBounceRate
— вместо этого используйтеga:visitBounceRate
.
Выпуск 28 октября 2013 г. (28 октября 2013 г.)
В этом выпуске в API добавлены новые параметры и показатели. Полный список определений можно найти в Справочнике по измерениям и метрикам .
Адсенс
Добавлен доступ к данным AdSense:
- Met —
ga:adsenseRevenue
— общий доход от рекламы AdSense. - Met –
ga:adsenseAdUnitsViewed
– количество просмотренных рекламных блоков AdSense. Блок рекламы - это набор рекламных объявлений, отображаемых в результате одной части AdSense AD. Подробности: https://support.google.com/adsense/answer/32715 . - Met -
ga:adsenseAdsViewed
- количество просмотренных рекламных объявлений AdSense. Несколько рекламных объявлений могут отображаться в рекламном блоке. - MET -
ga:adsenseAdsClicks
- количество раз, когда реклама Adsense на вашем сайте была нажата. - MET -
ga:adsensePageImpressions
- количество просмотров страниц, в течение которых была отображена реклама AdSense. Впечатление страницы может иметь несколько рекламных единиц. - MET -
ga:adsenseCTR
- процент впечатлений от страниц, которые привели к щелчке ADSENSE AD. (ga:adsenseAdsClicks/ga:adsensePageImpressions
) - MET -
ga:adsenseECPM
- расчетная стоимость за тысячу впечатлений. Это ваш доход AdSense на 1000 страничных впечатлений. (GA: AdsenseRevenue/(GA: AdSensePageImpressions/1000). - MET -
ga:adsenseExits
- количество сеансов, которые закончились из -за того, что пользователь щелкнул по объявлению AdSense.
- Met —
Время
- DIM -
ga:isoYear
- ISO год визита. Подробности: http://en.wikipedia.org/wiki/iso_week_date .ga:isoYear
следует использовать только сga:isoWeek
так какga:week
представляет григорианский календарь. - DIM -
ga:isoYearIsoWeek
- Комбинированные значенияga:isoYear
иga:isoWeek
.
Адвордс
Эти данные найдены в отчетах AdWords:
- DIM -
ga:adKeywordMatchType
- типы совпадений, применяемые к вашим ключевым словам (фраза, точная, широкая). Подробности: Понимание отчета об поисковых терминах .
- DIM -
Выпуск 2013-10-14 (14 октября 2013 г.)
Новые функции управления размером и относительными датами
Относительные даты
- Поддержка относительных дат была добавлена в основной API отчетности.
today
yesterday
иNdaysAgo
теперь являются допустимыми значениями для параметровstart-date
иend-date
. - Использование этих значений автоматически определит диапазон дат на основе текущей даты на момент выполнения запроса, а также на часовом поясе представления (профиля), указанного в запросе. См. Ссылку API для получения дополнительной информации.
Уровень отбора проб
- Был введен новый параметр,
samplingLevel
, который позволяет устанавливать уровень выборки (то есть количество посещений, используемых для расчета результата) для запроса отчетности. Разрешенные значения:DEFAULT
,FASTER
иHIGHER_PRECISION
. - 2 новые поля были добавлены в ответ API:
sampleSize
иsampleSpace
. Вы можете использовать эти значения для расчета процента посещений, которые использовались для отбегшего ответа. - См. Ссылку API и выборку для получения дополнительной информации.
Выпуск 2013-07-22 (23 июля 2013 г.)
Исправление ошибок
-
ga:adwordsCustomerID
теперь правильно возвращает 10-значный идентификатор клиента AdWords, соответствующий учетной записи ADWORDS APIINFO.Customerid . Это исправление позволяет присоединиться к аналитическим данным с несколькими учетными записями AdWords.
Выпуск 2013-07-15 (16 июля 2013 г.)
В рамках запуска новых сегментов мы будем развернуть следующие изменения в основном API отчетности.
- Параметр
segment
теперь поддерживает новый буквенно -цифровой идентификатор для пользовательских расширенных сегментов, который возвращается в коллекции сегментов Management API. - Текущие числовые идентификаторы для пользовательских сегментов в настоящее время находятся под управлением. Эти устаревшие идентификаторы будут по -прежнему поддерживать в течение 6 месяцев. Мы рекомендуем приложения, которые сохраняют идентификаторы сегмента пользователей, чтобы переключиться на новые буквенно -цифровые идентификаторы. После того, как период снижения закончится, любые запросы со старыми цифровыми идентификаторами вернут ошибку.
- В настоящее время только сегменты уровня посещения , созданные в веб -интерфейсе, будут запрошены через параметр
segment
. - Существующие сегменты по умолчанию с отрицательными числовыми идентификаторами не будут затронуты. Тем не менее, новые сегменты по умолчанию в настоящее время не поддерживаются.
Выпуск 2013-07-09 (9 июля 2013 г.)
В этом выпуске в API добавлены новые параметры и показатели. Проверьте ссылки на размеры и метрики для полного списка определений.
Отслеживание приложений
- Эти данные найдены в отчетах профиля приложения:
- DIM -
ga:appId
- идентификатор приложения. - DIM -
ga:appInstallerId
- ID установщика (например, Google Play Store), из которого было загружено приложение. По умолчанию идентификатор установщика приложения устанавливается на основе методаPackageManager#getInstallerPackageName
. - Dim -
ga:appName
- имя приложения. - DIM -
ga:appVersion
- версия приложения. - DIM -
ga:exitScreenName
- имя экрана, когда пользователь вышел из приложения. - DIM -
ga:landingScreenName
- имя первого просмотренного экрана. - DIM -
ga:screenDepth
- количество экранов на сеанс, о котором сообщается как строка. Может быть полезен для исторических плат. - DIM -
ga:screenName
- имя экрана. - MET -
ga:avgScreenviewDuration
- Среднее количество времени, потраченных на экран за считанные секунды. - MET -
ga:timeOnScreen
- время, потраченное на просмотр текущего экрана. - Met -
ga:screenviews
- общее количество видов экрана. Используйте это вместоga:appviews
. - MET -
ga:uniqueScreenviews
- количество различных (уникальных)ga:screenviews
в сеансе. Используйте это вместоga:uniqueAppviews
. - MET -
ga:screenviewsPerSession
- Среднее количествоga:screenviews
за сеанс. Используйте это вместоga:appviewsPerVisit
.
- DIM -
Устарело
Следующие метрики устарели. Вместо этого используйте новое метрическое имя.
- MET -
ga:appviews
- используйтеga:screenviews
вместо этого. - MET -
ga:uniqueAppviews
- используйтеga:uniqueScreenviews
вместо этого. - MET -
ga:appviewsPerVisit
- используйтеga:screenviewsPerSession
.
Пользовательские переменные или столбцы
Доступ к пользовательским измерениям и метрикам:
- DIM -
ga:dimensionXX
- Имя запрошенного пользовательского измерения, гдеXX
относится к номеру/индексу пользовательского измерения. - MET -
ga:metricXX
- имя запрошенной пользовательской метрики, гдеXX
относится к номеру/индексу пользовательской метрики.
- DIM -
КОМЕНТАЦИЯ ИЗМЕНЕНИЯ
Следующие пользовательские переменные измерения и метрика были переименованы в переименование. Это только изменение документации, не потребует от вас обновления ваших запросов.
-
ga:customVarName(n)
→ga:customVarNameXX
-
ga:customVarValue(n)
→ga:customVarValueXX
Электронная коммерция
- DIM -
ga:currencyCode
- код локальной валюты транзакции на основе стандарта ISO 4217. - MET -
ga:localItemRevenue
- Доход от продукта в местной валюте. - MET -
ga:localTransactionRevenue
- Доходы от транзакций в местной валюте. - MET -
ga:localTransactionShipping
- Стоимость транзакционного доставки в местной валюте. - MET -
ga:localTransactionTax
- налог на транзакцию в местной валюте.
Исключения
- Эти данные поступают из отслеживания исключений.
- DIM -
ga:exceptionDescription
- описание для исключения. - MET -
ga:exceptionsPerScreenview
- Количество брошенных исключений, разделенных на количество экранов. - MET -
ga:fatalExceptionsPerScreenview
- Количество отложенных фатальных исключений, разделенных на количество экранов.
- DIM -
Преобразование целей
- DIM -
ga:goalCompletionLocation
- Путь страницы или имя экрана, которые соответствуют любому достижению целей назначения. - DIM -
ga:goalPreviousStep1
- Путь страницы или имя экрана, которые соответствуют любой цели назначения, на один шаг до места завершения цели. - DIM -
ga:goalPreviousStep2
- Путь страницы или имя экрана, которые соответствуют любой цели типа назначения, два шага до места завершения цели. - DIM -
ga:goalPreviousStep3
- Путь страницы или имя экрана, которые соответствуют любой цели типа назначения, три шага до местоположения цели.
КОМЕНТАЦИЯ ИЗМЕНЕНИЯ
Следующие измерения преобразования целей и метрики были переименованы в переименование. Это только изменение документации, не потребует от вас обновления ваших запросов.
-
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
Внутренний поиск
- MET -
ga:percentSearchRefinements
- процент количества раз, когда утончение (то есть переход) происходит между ключевыми словами внутреннего поиска в течение сеанса.
Отслеживание страниц
- MET -
ga:pageValue
- Среднее значение этой страницы или набора страниц. Значение страницы составляет ((доход от транзакций + общая цель цели), разделенная на уникальные просмотры страниц для страницы или набора страниц).
Платформа или устройство
Эти данные получены из строки HTTP-пользователя-агента.
- DIM -
ga:deviceCategory
- тип устройства: работник, планшет или мобильный. - DIM -
ga:isTablet
- Указывает посетителей планшетов. Возможные значения -Yes
илиNo
. - DIM -
ga:mobileDeviceMarketingName
- маркетинговое имя, используемое для мобильного устройства.
- DIM -
Социальные взаимодействия
Эти данные поступают из отслеживания социального взаимодействия на месте.
- DIM -
ga:socialEngagementType
- тип взаимодействия. Возможные ценностиSocially Engaged
илиNot Socially Engaged
.
- DIM -
Время
- DIM -
ga:dateHour
- Комбинированные значенияga:date
иga:hour
. - DIM -
ga:dayOfWeekName
- имя дня недели (на английском языке). - DIM -
ga:isoWeek
- номер недельной недели ISO, где каждую неделю начинается с понедельника. Подробности: http://en.wikipedia.org/wiki/iso_week_date . - DIM -
ga:yearMonth
- Комбинированные значенияga:year
иga:month
. - DIM -
ga:yearWeek
- комбинированные значенияga:year
иga:week
.
Источники трафика
- DIM -
ga:fullReferrer
- Полный ссылочный URL, включающий имя хоста и путь. - DIM -
ga:sourceMedium
- комбинированные значенияga:source
иga:medium
.
Выпуск 2013-04-04 (4 апреля 2013 г.)
- Этот релиз добавляет 2 новых метрик экспериментов : -
ga:experimentId
-ga:experimentVariant
Выпуск 2013-01-31 (31 января 2013 г.)
- Этот релиз добавляет 5 новых показателей скорости сайта:
-
ga:domInteractiveTime
-
ga:avgDomInteractiveTime
-
ga:domContentLoadedTime
-
ga:avgDomContentLoadedTime
-
ga:domLatencyMetricsSample
-
Выпуск 2013-01-14 (14 января 2013 г.)
- Этот релиз добавляет новый сегмент по умолчанию для трафика планшетов,
gaid::-13
.
Выпуск 2012-09 (18 сентября 2012 г.)
В этом выпуске в API добавлены новые параметры и показатели. Проверьте измерения и ссылки на метрики для определений.
Отслеживание приложений
- Эти данные найдены в отслеживании мобильных приложений SDK Reports:
- MET -
ga:uniqueAppviews
- количество просмотров приложений на сеанс. - MET -
'ga:appviews
- общее количество просмотров приложений. - MET -
ga:appviewsPerVisit
- Среднее количество просмотров приложений на сеанс.
- MET -
Источники трафика
- DIM -
ga:socialNetwork
- строка, представляющая имя социальной сети. Это может быть связано с рекомендацией социальной сети для источников трафика или социальной сетью для деятельности в центре социальных данных. Например, Google+, блоггер, Reddit и т. Д. - DIM -
ga:hasSocialSourceReferral
- указывает на посещения, которые прибыли на сайт из социального источника (то есть социальная сеть, такая как Google+, Facebook, Twitter и т. Д.). Возможные значения - «да» или «нет», где первая буква должна быть загладной измерения.
Культурно-просветительные мероприятия
- Эти данные поступают из активности вне места, импортируемой из партнеров по социальным данным.
- DIM -
ga:socialActivityDisplayName
- Для деятельности в центре социальных данных эта строка представляет название социальной деятельности, размещенной пользователем социальной сети. - DIM -
ga:socialActivityEndorsingUrl
- Для деятельности в центре социальных данных эта строка представляет URL социальной деятельности (например, URL -адрес Google+, URL Комментария блога и т. Д.) - DIM -
ga:socialActivityPost
- Для деятельности в центре социальных данных эта строка представляет содержание социальной деятельности, опубликованной пользователем социальной сети (например, содержимое сообщения в сообщении Google+) - DIM -
ga:socialActivityTimestamp
- Для деятельности в центре социальных данных эта строка представляет, когда социальная деятельность произошла в социальной сети. - DIM -
ga:socialActivityUserPhotoUrl
- Для деятельности в центре социальных данных эта строка представляет URL -адрес фотографии, связанной с профилем социальной сети пользователя. - DIM -
ga:socialActivityUserProfileUrl
- Для деятельности в центре социальных данных эта строка представляет URL -адрес ассоциированного профиля социальной сети ассоциированного пользователя. - DIM -
ga:socialActivityContentUrl
- Для активности в центре социальных данных эта строка представляет URL -адрес, общий ассоциированным пользователем социальной сети. - DIM -
ga:socialActivityTagsSummary
- Для деятельности в центре социальных данных это, разделяемый запятой, набор тегов, связанных с социальной деятельностью. - DIM -
ga:socialActivityUserHandle
- Для деятельности в центре социальных данных эта строка представляет собой рукоятку социальной сети (IE имени) пользователя, который инициировал социальную деятельность. - DIM -
ga:socialActivityAction
- Для деятельности в центре социальных данных эта строка представляет тип социальных действий, связанных с деятельностью (например, голосование, комментарий, +1 и т. Д.). - DIM -
ga:socialActivityNetworkAction
- Для деятельности в центре социальных данных эта строка представляет тип социальных действий и социальную сеть, где возникла деятельность. - MET -
ga:socialActivities
- подсчет действий, в которых URL -адрес контента был обмен/упомянут в партнерской сети Hub Social Data.
- DIM -
Социальные взаимодействия
- Эти данные поступают из отслеживания социального взаимодействия на месте.
- Dim -
ga:socialInteractionAction
- для социальных взаимодействий, строка, представляющая отслеживаемой социальной деятельности (например, +1, как, закладка) - DIM -
ga:socialInteractionNetwork
- для социальных взаимодействий, строка, представляющая отслеживаемой социальной сети (например, Google, Facebook, Twitter, LinkedIn) - Dim -
ga:socialInteractionNetworkAction
- для социальных взаимодействий, строка, представляющая конкатенациюga:socialInteractionNetwork
иga:socialInteractionAction
отслеживается (например, Google: +1, Facebook: как) - DIM -
ga:socialInteractionTarget
- Для социальных взаимодействий, строка, представляющая URL (или ресурс), которая получает действие социальной сети. - Met -
ga:socialInteractions
- общее количество социальных взаимодействий на вашем сайте. - MET -
ga:uniqueSocialInteractions
- общее количество уникальных социальных взаимодействий на вашем сайте. На основе пары ценностейga:socialInteractionNetwork
иga:socialInteractionAction
- MET -
ga:socialInteractionsPerVisit
-ga:socialInteractions
/ga:uniqueSocialInteractions
. Среднее количество социальных взаимодействий за посещение вашего сайта.
- Dim -
Гео / сеть
- DIM -
ga:metro
- Указанная площадь рынка (DMA), откуда произошел трафик.
Отслеживание страниц
- DIM -
ga:pagePathLevel1
- Это измерение заворачивает все плавания на первом иерархическом уровне в PagePath. - DIM -
ga:pagePathLevel2
- Это измерение заворачивает все плавания на втором иерархическом уровне в PagePath. - DIM -
ga:pagePathLevel3
- Это измерение заворачивает все плавания на третьем иерархическом уровне в PagePath. - DIM -
ga:pagePathLevel4
- Это измерение заворачивает все плавания на четвертом иерархическом уровне в PagePath. Все дополнительные уровни в иерархии PagePath также развернуты в этом измерении.
Отслеживание исключений
Эти данные поступают из данных отслеживания исключений.
- MET -
ga:exceptions
- количество исключений, которые были отправлены в Google Analytics. - MET -
ga:fatalExceptions
- количество исключений, где isfatal установлено на True.
- MET -
Пользовательское время
Эти данные поступают из данных пользователя.
- DIM -
ga:userTimingCategory
- Строка для классификации всех переменных времени пользователя в логические группы для облегчения отчетности. - DIM -
ga:userTimingLabel
- строка, чтобы указать имя действия отслеживаемого ресурса. - DIM -
ga:userTimingVariable
- строка, которую можно использовать для добавления гибкости при визуализации времени пользователей в отчетах. - DIM -
ga:userTimingValue
Количество миллисекундов в исходящее время, отправленное в Google Analytics. - MET -
ga:userTimingSample
- количество отправленных образцов. - MET -
ga:avgUserTimingValue
- Среднее значение времени пользователя.ga:userTimiingValue
/ga:userTimiingSample
.
- DIM -
Устройство / платформа
- Эти данные поступают от пользовательского агента собранных данных.
- DIM -
ga:mobileDeviceBranding
- мобильный производитель или фирменное название (Примеры: Samsung, HTC, Verizon, T -Mobile). - DIM -
ga:mobileDeviceModel
- Модель мобильного устройства (пример: Nexus s) - DIM -
ga:mobileInputSelector
- Селектор, используемый на мобильном устройстве (примеры: сенсорный экран, джойстик, Click -Wheel, Stylus) -
Dim - ga:mobileDeviceInfo
- Имя брендинга, модели и маркетинга, используемых для идентификации мобильного устройства.
- DIM -
Выпуск 2012-05 (31 мая 2012 г.)
Исправление ошибок
- API теперь правильно обрабатывает символы UTF-8 в фильтре или динамическом сегменте.
Выпуск 2012-05 (24 мая 2012 г.)
Этот релиз позволяет Google Analytics Premium Accounts доступа до 50 пользовательских переменных.
Выпуск 2012-02 (14 февраля 2012 г.)
Этот релиз исправляет 2 ошибки:
Исправление ошибок
Фильтры запросов, которые содержат специальные символы внутри регулярных выражений, больше не возвращают ошибки сервера.
Комбинирование метрического фильтра с расширенным сегментом больше не возвращает ошибку.
Выпуск 2012-02 (8 февраля 2012 г.)
Этот релиз добавляет новые метрики скорости сайта в API.
Новые метрики
- Были добавлены следующие показатели скорости сайта:
-
ga:speedMetricsSample
-
ga:domainLookupTime
-
ga:pageDownloadTime
-
ga:redirectionTime
-
ga:serverConnectionTime
-
ga:serverResponseTime
-
ga:avgDomainLookupTime
-
ga:avgPageDownloadTime
-
ga:avgRedirectionTime
-
ga:avgServerConnectionTime
-
ga:avgServerResponseTime
-
Проверьте измерения и ссылки на метрики для определений.
API версия 2.3 напоминание об ископении
Версия 2.3 API экспорта данных была ухудшена в течение 2 месяцев. Примерно через 4 месяца мы отключим эту услугу и поддержим только новую API -версию API отчетности 3.0 и версии 2.4 .
Мы настоятельно рекомендуем вам перенести ваши приложения на версию 3.0.
Через 4 месяца запросы на устаревшую версию 2.3 XML -канал будет пересылана в версию 2.4 и вернет ответ версии 2.4 XML. На этом этапе все политики квот версии 2.4 будут применяться к запросам версии 2.3.
Все запросы на версию 2.3 JSON или клиентская библиотека Google Data JavaScript, в которой используется версия 2.3 json, вернет
404
кодов состояния.Чтобы получить полную квоту, версия 3.0 и версии 2.4 требуют, чтобы вы зарегистрировали ваше приложение в консоли API Google и использовали ключ API (или токен OAuth 2.0) в каждом запросе.
Выпуск 2012-01 (26 января 2012 г.)
Мы исправили небольшую ошибку с ga:visitLength
. Это измерение теперь возвращает правильные данные.
Выпуск 2011-12 (5 декабря 2011 г.)
Этот релиз влияет на все разработчики API Google Analytics. Он объявляет о двух новых версиях API, требует регистрации заявок, вводит новую политику квот и изменяет имя API на основную API отчетности. Наконец, он определяет существующую API экспорта данных API версии 2.3.
Версия 3.0
Основная отчетная версия API Version 3.0 является последней основной версией нашего API и не совместима с обратной задачей. Все будущее развитие API будет сделано в этой версии.
Новые возможности
- Новый вывод на основе JSON уменьшает размер ответа ~ 10x из предыдущего выхода XML.
- Новые клиентские библиотеки Google API , которые поддерживают Java, JavaScript, Python, PHP, Ruby и .net.
- Поддержка Google Discovery API .
- Поддержка OAuth 2.0 в качестве нового, рекомендуемого способа авторизации пользователей.
Обновления
- Новый URL -адрес для выполнения запросов:
https://www.googleapis.com/analytics/v3/data/ga…
. - Требуются регистрация и токены разработчиков.
- Все запросы на данные конфигурации должны быть выполнены через API управления .
- Новый URL -адрес для выполнения запросов:
Версия 2.4
Основной отчетной API версии 2.4 - это незначительное обновление версии, которое в основном обратно совместимо с существующей версией API экспорта данных 2.3.
Обновления
- Новый URL для выполнения запросов:
https://www.googleapis.com/analytics/v2.4/data…
- Требуются регистрация и токены разработчиков.
- Вывод XML в соответствии с версией 2.3, поэтому другие существующие клиентские библиотеки Google будут продолжать работать.
- Код ошибки для ошибок квот изменился с
503
до403
- Ответы JSON не поддерживаются.
- Google Data Javascript Client Library не поддерживается.
- Нет корма для аккаунта. Все запросы на данные конфигурации должны быть выполнены через API управления .
- Новый URL для выполнения запросов:
Постановка на учет
Все приложения, созданные с использованием API Google Analytics, должны быть зарегистрированы в качестве проекта через консоль API Google .
Каждый запрос в API должен включать либо ключ API, либо для OAuth 2.0, идентификатор клиента и секрет клиента.
Политика квот
Следующая квота применяется как к API API Anlaytics (API управления, так и API экспорта данных)
- 50 000 запросов на проект в день
- 10 запросов в секунду (QP) на IP -адрес
Следующая квота применима к API экспорта данных
- 10 000 запросов на профиль в день
- 10 одновременных запросов на профиль
Для незарегистрированных приложений мы предоставляем очень низкую квоту изящества для размещения небольшого количества испытаний.
Устаревания
Этот релиз также объявляет о том, как версия 2.3 и предстоящий выключение канала учетной записи в API экспорта данных. Через 6 месяцев:
Запросы на версию 2.3 XML -канал данных будет пересылаться в версию 2.4 и вернуть ответ версии 2.4. На этом этапе все политики квот версии 2.4 будут применяться к запросам версии 2.3.
Запросы на вывод версии 2.3 JSON не будут поддерживаться ответом версии 2.4 и вернуть
404 Not Found
коды состояния. Если вам нужен ответ JSON, обновите до версии 3.0.Запросы на подачу учетной записи в API экспорта данных вернет
404 Not Found
коды состояния. Все запросы на данные конфигурации должны быть выполнены через API управления .
Выпуск 2011-09 (7 сентября 2011 г.)
Этот релиз добавляет более свежие данные AdWords и больше комбинаций для AdWords Amensions и Metrics.
Данные AdWords теперь обновляются в течение часа. До того, как данные были обновлены ежедневно.
Мы ослабили число действительных ограничений комбинаций с помощью данных AdWords.
Несколько недель назад мы внесли изменение в запрет API -запросов, которые попросили ga:adGroup
или ga:adContent
с ga:impressions
, поскольку эта комбинация вернулась 0. С помощью этого изменения эта комбинация теперь вернулась и была исправлена, чтобы вернуть правильные данные .
Выпуск 2011-08 (11 августа 2011 г.)
Этот релиз исправляет некоторые неверные комбинации измерений и метрик
Фиксированные неверные метрики/комбинации размеров
В прошлом месяце мы объявили о некоторых предстоящих изменениях в API, чтобы запретить некоторые недопустимые запросы в канале данных, которые не возвращают никаких данных. Теперь мы внесли эти изменения в API, и следующие комбинации теперь недействительны:
- Размеры продукта не могут быть объединены с метриками транзакций.
-
ga:adContent
илиga:adGroup
не может быть объединен сga:impressions
.
Вместо возвращения ответа с 0 результатами API теперь возвращает 400 кода ошибки для всех запросов, которые запрашивают эти комбинации.
Выпуск 2011-07 (11 июля 2011 г.)
Этот релиз осуждает значение доверительного интервала в метрик.
Уничтожение доверительного интервала
Если вы еще этого не сделали, пожалуйста, прекратите использовать значения доверительного интервала для метрик. С помощью этого выпуска подача данных API экспорта данных возвращает 0,0 для всех значений доверительного интервала. Примерно через месяц мы будем полностью удалить этот атрибут из всех метрических элементов.
Чтобы определить, был ли отбег ответа, пожалуйста, используйте поле «Содержит» в ответе.
Выпуск 2011-05 (31 мая 2011 г.)
Этот релиз добавляет 3 новых метрик и обновляет возвращаемое значение двух.
Новые обновления данных
- Мы добавили 3 новых показателя, касающихся производительности скорости сайта в API:
-
ga:pageLoadSample
-
ga:pageLoadTime
-
ga:avgPageLoadTime
-
Метрические обновления
Чтобы указать значения валюты в фильтрах, необходимо указать фактическое значение, передаваемое из кода отслеживания (например, единица 1 теперь будет указана как 1).
ga:CTR
теперь возвращает фактический процент (например, значение 2% возвращается как 2).
Выпуск 2011-04 (19 апреля 2011 г.)
Этот выпуск улучшает производительность подачи данных и добавляет новые данные:
Улучшение производительности
- Этот выпуск улучшает задержку подачи данных на 30-35%.
Новые обновления данных
- Мы обновили список измерений и метрик, которые разрешены в передовых сегментах. Пожалуйста, обратитесь к обновлению списка , чтобы убедиться, что ваши запросы действительны.
Предстоящие изменения
В настоящее время вам необходимо указать значение валютного фильтра как микро -единицы (например, 1 единица валюты указана как 1000000). В ближайшем будущем вам необходимо будет указать фактическое значение, передаваемое из кода отслеживания (например, 1 единица теперь будет указана как 1).
В настоящее время
ga:CTR
составляетpercent
и возвращает значение 0,02. В ближайшем будущем это изменится, чтобы вернуть фактический процент (например, 2).
Выпуск 2011-03 (9 марта 2011 г.)
Этот выпуск добавляет больше данных в подачу данных:
Новые обновления данных
Следующее время было добавлено:
ga:dayOfWeek
Следующий внутренний показатель поиска был добавлен:
ga:percentVisitsWithSearch
Были добавлены следующие метрики отслеживания событий:
-
ga:visitsWithEvent
-
ga:eventsPerVisitWithEvent
-
Предстоящие изменения
В настоящее время API возвращает 401
кода статуса для различных вопросов авторизации. В течение следующих нескольких недель статус 401
будет использоваться исключительно для недействительных токенов, что дает разработчикам способ обработки ошибки этого конкретного исключения.
Выпуск 2011-01 (24 января 2011 г.)
Этот выпуск добавляет значительно больше данных в подачу данных:
Новые обновления данных
Расчет
ga:visitors
был изменен, чтобы вернуть количество уникальных посетителей в диапазоне дат, а теперь поддерживает больше измерений и метрических комбинаций.10 новых размеров AdWords были добавлены:
ga:adDistributionNetwork
,ga:adMatchType
,ga:adPlacementDomain
ga:adMatchedQuery
,ga:adPlacementUrl
,ga:adFormat
,ga:adTargetingType
,ga:adTargetingOption
,ga:adDisplayUrl
,ga:adDestinationUrl
.Metric
ga:organicSearches
была добавлена в группу кампании.Metric
ga:searchResultViews
была добавлена во внутреннюю группу поиска сайта.3 Новые измерения, основанные на времени, были добавлены:
ga:nthDay
,ga:nthWeek
,ga:nthMonth
.Группы измерений и метриков были изменены, чтобы лучше отражать функции, которые они представляют.
Новые расчетные метрики
Следующие рассчитанные метрики получены из расчетов с использованием базовых метрик. Примечание. Каждое имя с (n)
поддерживает значения 1-20.
Основанная на цели:
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
.Содержание:
ga:entranceBounceRate
,ga:visitBounceRate
,ga:entranceRate
,ga:exitRate
,ga:pageviewsPerVisit
,ga:avgTimeOnPage
,ga:avgTimeOnSite
,ga:avgEventValue
.Внутренний поиск на основе сайта:
ga:avgSearchDepth
,ga:avgSearchDuration
,ga:avgSearchResultViews
,ga:searchGoalConversionRateAll
,ga:searchGoal(n)ConversionRate
,ga:searchExitRate
.Электронная коммерция:
ga:itemsPerPurchase
,ga:margin
,ga:percentNewVisits
,ga:revenuePerItem
,ga:revenuePerTransaction
,ga:ROI
,ga:RPC
,ga:totalValue
,ga:transactionRevenuePerVisit
,ga:transactionsPerVisit
.
Выпуск 2010-11 (1 ноября 2010 г.)
Этот выпуск добавляет новую функцию в подачу данных:
Новые возможности
- Был добавлен новый элемент XML, позволяющий пользователям знать, были ли выборки данных.
true
true
илиfalse
. Библиотеки Java и JavaScript также были обновлены с помощью вспомогательных методов для доступа к этому элементу.
Выпуск 2010-08 (23 августа 2010 г.)
Этот релиз исправляет 2 ошибки:
Исправление ошибок
Ранее добавление или оператора к выражению фильтра с измерением (то есть
ga:keyword==store,ga:keyword==bar
) может привести к различным значениям, чем если бы каждый фильтр был применен индивидуально по нескольким запросам. Это было исправлено, и использование оператора или оператора теперь возвращает последовательные значения.Некоторые из сообщений об ошибках API для недопустимых фильтров были обновлены, чтобы не включать, было ли это измерение или метрический фильтр, вызвавший ошибку (хотя фактическое выражение оскорбления фильтра будет оставаться возвращением).
Выпуск 2010-07 (26 июля 2010 г.)
Этот релиз исправляет 3 ошибки:
Исправление ошибок
Проблема кодирования в клиентской библиотеке JavaScript была исправлена. Аналитическая проблема выпуска
Ошибка, которая предотвращала подачу учетной записи не возвращаться, когда имя цели, путь целей, значение сравнения целей или тип сравнения целей был неправильно установлен, теперь исправлено.
Он недействителен или измерение и метрику в параметре файла запроса подачи данных. Например:
ga:source==google,ga:visits>5
. Сообщение об ошибке для этого недопустимого запроса было обновлено, чтобы сказать:Cannot OR dimension filter(s) with metric filter
.
Выпуск 2010-05 (4 мая 2010 г.)
Этот выпуск добавляет новые данные и исправляет ошибку:
Новые возможности
Следующие 5 измерений были добавлены в новой категории
D8. Adwords
:-
ga:adwordsAdGroupId
: соответствует Api Api adgroup.id Api Api. -
ga:adwordsCampaignId
: соответствует кампании ADWORDS API.id -
ga:adwordsCreativeId
: соответствует AdWords Api Ad.id -
ga:adwordsCriteriaId
: соответствует критерию API ADWORDS.ID. -
ga:adwordsCustomerId
: совместно с AdWords API AccountInfo.customerid
-
Исправление ошибок
- Мы исправили проблему, в которой канал учетной записи не будет возвращать данные, если у одного из профилей была неправильная цель или шаг.
Выпуск 2010-03 (22 марта 2010 г.)
Этот релиз добавляет ряд новых функций и исправляет ошибку:
Новые возможности
Сегмент по умолчанию iPhone (Gaid ::-11) был расширен до того, как теперь сообщают обо всех мобильных устройствах . Идентификатор такой же, как и раньше (-11), но название сегмента сейчас:
Mobile Traffic
.Скорость выборки, используемая API, теперь такая же, как веб -интерфейс. Это приносит данные для отчетов о выбранных отчетах в соответствии с веб -интерфейсом и увеличивает согласованность между ними.
Политика квот была обновлена, чтобы гарантировать, что все пользователи получают справедливый доступ к ресурсам. Пожалуйста, обратитесь к нашей документации по политике квот для получения более подробной информации. Новая политика:
- Одно веб -свойство может составить максимум 10 000 запросов за 24 часа.
- Приложение может сделать только 10 запросов только в любой 1-секундный период.
- Приложение может иметь только 4 ожидания запросов в любой момент времени.
Некоторые ограничения на размеры и метрические комбинации были расслаблены.
ga:nextPagePath
иga:previousPagePath
теперь является частьюD3. Content
группа.D8. Custom Variable
теперь называетсяD6. Custom Variable
. Пожалуйста, смотрите обновленное справочное руководство для этих новых комбинаций.
Исправление ошибок
Мы исправили ошибку о том, как API сообщает о значении
confidenceInterval
для метрик. Ранее доверительные интервалы могут иметь значение либоINF
, либо от 0 до 1. Теперь все доверительные интервалы будут иметь значениеINF
или число, больше, чем или равно 0.ga:itemQuantity
иga:uniquePurchases
были ранее поменялись и возвращали ценность друг друга. Теперь они фиксируются, чтобы вернуть правильные данные.
Университет измерений и напоминания о метриках
- Если вы этого еще не сделали, пожалуйста, прекратите использовать ранее устаревшие измерения и метрики
Выпуск 2009-12 (14 декабря 2009 г.)
Этот релиз добавляет ряд новых функций:
Этот выпуск увеличивает основной номер версии до 2
Некоторые функции требуют использования новейших клиентских библиотек. Мы официально поддерживаем: Java & JavaScript . Сторонние библиотеки еще не могут быть обновлены.
- Версия 2 может быть запрошена путем добавления заголовка
GData-Version: 2
в каждую учетную запись или запрос на подачу данных Прочитайте документацию для получения более подробной информации. - Новое пространство имен XML было добавлено как в каналы учетной записи, так и в данные данных:
xmlns:ga='http://schemas.google.com/ga/2009'
- Версия 2 может быть запрошена путем добавления заголовка
API теперь поддерживает версию 2 -го протокола данных Google.
Усовершенствованная поддержка сегментации
Динамические сегменты Параметр запроса:
-
...&segment=dynamic::
Expression - позволяет создавать передовые сегменты «на лету».
- Выражение может быть любым измерением или метрикой и должно следовать тому же синтаксису, что и фильтры.
-
Параметр запроса по умолчанию и пользовательским сегментам:
-
...&segment=gaid::
номер - где номер является идентификатором, ссылающимся на расширенный сегмент, определенный в веб -интерфейсе Google Analytics.
- Идентификатор можно найти в подаче учетной записи.
-
Справка учетной записи описывает данные сегмента через следующие элементы и атрибуты XML:
ga:visitorType==Returning Visitor
Справочный канал также предоставляет элемент XML, указывающий, был ли сегмент применен в запросе API.
Более подробная информация о передовых сегментах в нашей документации .
Доступны новые данные о целях
Цели назначения и типа взаимодействия, доступные в ленте учетной записи:
48 Новые показатели целей были добавлены для целей 5-20, которые все следуют за завершением
goal(n)Completions
, где(n)
составляет число от 1 до 20.-
ga:goal(n)Completions
-
ga:goal(n)Starts
-
ga:goal(n)Value
-
GoalCompletionAll
,GoalStartsAll
иGoalValueAll
были обновлены, чтобы учесть новые данные цели.
Новые пользовательские данные переменной
Все пользовательские переменные, когда -либо собранные каждым профилем, были добавлены в виде нового элемента XML в подачу учетной записи:
10 новых размеров были добавлены для пользовательских переменных. Они следуют за соглашением
customVar(n)
, где(n)
может быть число от 1 до 5.-
ga:customVarName(n)
-
ga:customVarValue(n)
-
Установленные измерения и метрики для удаления!
Если вы еще этого не сделали, пожалуйста, прекратите использовать ранее устаревшие измерения и метрики. They will be removed soon and will return errors from our API if requested.
-
ga:countOfVisits
-
ga:countOfVisitsToATransaction
-
ga:sourceMedium
-
ga:percentNewVisits
-
The following dimensions have been renamed:
-
ga:countOfVisits
is nowga:visitCount
-
ga:countOfVisitsToATransaction
is nowga:visitsToTransaction
-
Release 2009-09 (September 18, 2009)
This release adds new features and deprecates some old functionality:
The following dimensions and metrics are now deprecated. We'll be permanently removing them from our API in one month. Please make sure to update your code so your applications don't break:
- ga:countOfVisits
- ga:countOfVisitsToATransaction
- ga:sourceMedium
- ga:percentNewVisits
The following Dimensions have been renamed:
- ga:countOfVisits is now ga:visitCount
- ga:countOfVisitsToATransaction is now ga:visitsToTransaction
All Event Tracking data is now exposed as 2 new groups:
Д7. Events (Dimensions) * ga:eventCategory * ga:eventAction * ga:eventLabel
М7. Events (Metrics) * ga:eventValue * ga:totalEvents * ga:uniqueEvents
Overall site navigation data is is now exposed through the following dimensions:
Д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
Release 2009-06 (June 30, 2009)
This release updates the Google Analytics Data Export API as follows:
Some restrictions on dimension and metric combinations have been relaxed. You can now query most content and visitor level dimensions together, for example
ga:pagePath
andga:source
is now a valid combination. Please see the updated reference guide for these new combinations: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.htmlThe total number of rows that can be asked for in one request has been increased to 10,000. The default number of rows returned is still 1,000, but can now be increased by setting the
max-results
query parameter.The Account Feed now returns two new data elements for each Table ID (currency and timezone).
We're now enforcing that data queries must include at least one valid metric.
All previous deprecation changes have taken effect.
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 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