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

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

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

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

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

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

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

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

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

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

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

В этом выпуске прекращена поддержка функции «Сопутствующие товары» , а также связанных с ней параметров и показателей; Полный список определений см . в Справочнике по параметрам и показателям . Ознакомьтесь с Политикой устаревания данных для получения подробной информации об удалении данных:

В этом выпуске больше не поддерживаются следующие параметры и показатели:

  • ga:correlationModelId
  • ga:queryProductId
  • ga:queryProductName
  • ga:queryProductVariation
  • ga:relatedProductId
  • ga:relatedProductName
  • ga:relatedProductVariation
  • ga:correlationScore
  • ga:queryProductQuantity
  • ga:relatedProductQuantity

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

Время

  • Новое измерение ga:dateHourMinute , которое объединяет ga:date , ga:hour и ga:minute .

Удаление данных

В этом выпуске удалены следующие устаревшие параметры и показатели:

  • ga:socialactivities
  • ga:socialactivityaction
  • ga:socialactivitydisplayname
  • ga:socialactivityendorsingurl
  • ga:socialactivitynetworkaction
  • ga:socialactivitypost
  • ga:socialactivitytagssummary
  • ga:socialactivitytimestamp
  • ga:socialactivityuserhandle
  • ga:socialactivityuserphotourl
  • ga:socialactivityuserprofileurl
  • ga:socialinteractionspervisit

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

Пользовательские метрики

Расчет показателей «Пользователи» и «Активные пользователи» был обновлен для более эффективного подсчета пользователей. Вы можете увидеть небольшое изменение в своих показателях. Дополнительную информацию см. в разделе «Как пользователи идентифицируются по пользовательским метрикам» .

Пользовательские показатели, на которые влияет обновление расчета:

  • ga:users — общее количество пользователей за запрошенный период времени.
  • ga:1dayusers — общее количество активных пользователей за 1 день за каждый день запрошенного периода времени.
  • ga:7dayusers — общее количество активных пользователей за 7 дней за каждый день запрошенного периода времени.
  • ga:14dayusers — общее количество активных пользователей за 14 дней за каждый день запрошенного периода времени.
  • ga:30dayusers — общее количество активных пользователей за 30 дней за каждый день запрошенного периода времени.

Уникальные события

Срок прекращения поддержки ga:uniqueEvents приближается к концу. После 26 марта 2017 г. определение ga:uniqueEvents будет обновлено, а частная метрика ga:uniqueEventsTemporary будет удалена из API. Дополнительную информацию см. в справочной документации по уникальным событиям .

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

Размеры пользователя

Сообщения об ошибках

Если раньше API возвращал ошибочное сообщение об ошибке Unknown dimension(s): или Unknown metric(s): при запросе данных с условиями, которые не были выполнены, теперь API возвращает сообщение: Restricted metric(s): ... can only be queried under certain conditions.

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

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

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

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

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

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

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

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

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

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

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

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

В этом выпуске в 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).
  • Измерение – 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).

В этом выпуске 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

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

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

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

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

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

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

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

В этом выпуске в 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 не включена).

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

Сегменты

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

Выборка

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

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

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

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

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

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

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

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

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

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

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

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

Включить пустые строки

  • В этом выпуске добавлен новый необязательный параметр include-empty-rows , для которого при установке значения false строки без данных будут исключены из ответа. Значение по умолчанию — true , что является некритичным изменением и поэтому не требует обновления кода. Подробности см. в справочной документации по Core Reporting API .

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

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

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

Устаревшие размеры

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

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

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

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

  • Измерение — ga:dataSource — источник данных обращения. Обращения, отправленные с ga.js и Analytics.js, обозначаются как «web»; обращения, отправленные из мобильных SDK, регистрируются как «приложения». Эти значения можно переопределить.
  • Измерение — ga:searchAfterDestinationPage — страница, которую посетил пользователь после выполнения внутреннего поиска на вашем сайте.

В этом выпуске в 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 .

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

AdWords

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

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

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

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

АдСенс

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

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

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

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

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

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

  • Измерение — ga:landingContentGroupXX — первая совпадающая группа контента в сеансе пользователя.
  • Измерение — ga:nextContentGroupXX — относится к группе контента, которая была посещена после другой группы контента.
  • Измерение — ga:contentGroupXX — группа контента для свойства. Группа контента — это набор контента, имеющий логическую структуру, которую можно определить с помощью кода отслеживания, соответствия заголовка страницы/регулярного выражения или предопределенных правил.
  • Измерение — ga:previousContentGroupXX — относится к группе контента, которая была посещена перед другой группой контента.
  • Метрика — ga:contentGroupUniqueViewsXX — количество разных (уникальных) страниц в сеансе для указанной группы контента. При этом для определения уникальности учитываются как pagePath, так и pageTitle.

Этот выпуск включает новое условие 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 — количество выданных возвратов.

В этом выпуске исправлена ​​ошибка с именами заголовков столбцов, а также добавлены новые параметры и показатели.

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

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

Система

  • Измерение — 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 вернет заголовки столбцов с заменяющим параметром или показателем. Теперь он правильно возвращает то же имя измерения или метрики, которое использовалось в запросе.

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

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

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

Сегменты: Core Reporting API v2.4 и v3.0

Поддержка новых сегментов в Core Reporting API.

  • Параметр segment теперь поддерживает сегменты пользователя и последовательности. Сегменты уровня пользователя и уровня сеанса , созданные в веб-интерфейсе, можно запросить с помощью параметра segment .
  • Новый синтаксис динамических сегментов доступен для использования с параметром segment . Подробности см. в Руководстве для разработчиков по сегментам.
  • Префикс dynamic:: устарел. Рекомендуется как можно скорее перейти на новый синтаксис.

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

Вывод таблицы данных

Чтобы упростить отображение данных 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 .

В этом выпуске в 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.

Время

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

Адвордс

Новые функции управления размером и относительными датами

Относительные даты
  • Поддержка относительных дат была добавлена ​​в основной API отчетности. today yesterday и NdaysAgo теперь являются допустимыми значениями для параметров start-date и end-date .
  • Использование этих значений автоматически определит диапазон дат на основе текущей даты на момент выполнения запроса, а также на часовом поясе представления (профиля), указанного в запросе. См. Ссылку API для получения дополнительной информации.
Уровень отбора проб
  • Был введен новый параметр, samplingLevel , который позволяет устанавливать уровень выборки (то есть количество посещений, используемых для расчета результата) для запроса отчетности. Разрешенные значения: DEFAULT , FASTER и HIGHER_PRECISION .
  • 2 новые поля были добавлены в ответ API: sampleSize и sampleSpace . Вы можете использовать эти значения для расчета процента посещений, которые использовались для отбегшего ответа.
  • См. Ссылку API и выборку для получения дополнительной информации.

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

  • ga:adwordsCustomerID теперь правильно возвращает 10-значный идентификатор клиента AdWords, соответствующий учетной записи ADWORDS APIINFO.Customerid . Это исправление позволяет присоединиться к аналитическим данным с несколькими учетными записями AdWords.

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

  • Параметр segment теперь поддерживает новый буквенно -цифровой идентификатор для пользовательских расширенных сегментов, который возвращается в коллекции сегментов Management API.
  • Текущие числовые идентификаторы для пользовательских сегментов в настоящее время находятся под управлением. Эти устаревшие идентификаторы будут по -прежнему поддерживать в течение 6 месяцев. Мы рекомендуем приложения, которые сохраняют идентификаторы сегмента пользователей, чтобы переключиться на новые буквенно -цифровые идентификаторы. После того, как период снижения закончится, любые запросы со старыми цифровыми идентификаторами вернут ошибку.
  • В настоящее время только сегменты уровня посещения , созданные в веб -интерфейсе, будут запрошены через параметр segment .
  • Существующие сегменты по умолчанию с отрицательными числовыми идентификаторами не будут затронуты. Тем не менее, новые сегменты по умолчанию в настоящее время не поддерживаются.

В этом выпуске в 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 .

Устарело

Следующие метрики устарели. Вместо этого используйте новое метрическое имя.

  • MET - ga:appviews - используйте ga:screenviews вместо этого.
  • MET - ga:uniqueAppviews - используйте ga:uniqueScreenviews вместо этого.
  • MET - ga:appviewsPerVisit - используйте ga:screenviewsPerSession .

Пользовательские переменные или столбцы

  • Доступ к пользовательским измерениям и метрикам:

    • DIM - ga:dimensionXX - Имя запрошенного пользовательского измерения, где XX относится к номеру/индексу пользовательского измерения.
    • MET - ga:metricXX - имя запрошенной пользовательской метрики, где XX относится к номеру/индексу пользовательской метрики.

КОМЕНТАЦИЯ ИЗМЕНЕНИЯ

Следующие пользовательские переменные измерения и метрика были переименованы в переименование. Это только изменение документации, не потребует от вас обновления ваших запросов.

  • 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 - ga:goalCompletionLocation - Путь страницы или имя экрана, которые соответствуют любому достижению целей назначения.
  • DIM - ga:goalPreviousStep1 - Путь страницы или имя экрана, которые соответствуют любой цели назначения, на один шаг до места завершения цели.
  • DIM - ga:goalPreviousStep2 - Путь страницы или имя экрана, которые соответствуют любой цели типа назначения, два шага до места завершения цели.
  • DIM - ga:goalPreviousStep3 - Путь страницы или имя экрана, которые соответствуют любой цели типа назначения, три шага до местоположения цели.

КОМЕНТАЦИЯ ИЗМЕНЕНИЯ

Следующие измерения преобразования целей и метрики были переименованы в переименование. Это только изменение документации, не потребует от вас обновления ваших запросов.

  • ga:goal(n)AbandonRatega:goalXXAbandonRate
  • ga:goal(n)Abandonsga:goalXXAbandons
  • ga:goal(n)Completionsga:goalXXCompletions
  • ga:goal(n)ConversionRatega:goalXXConversionRate
  • ga:goal(n)Startsga:goalXXStarts
  • ga:goal(n)Valuega:goalXXValue
  • ga:searchGoal(n)ConversionRatega:searchGoalXXConversionRate
  • MET - ga:percentSearchRefinements - процент количества раз, когда утончение (то есть переход) происходит между ключевыми словами внутреннего поиска в течение сеанса.

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

  • MET - ga:pageValue - Среднее значение этой страницы или набора страниц. Значение страницы составляет ((доход от транзакций + общая цель цели), разделенная на уникальные просмотры страниц для страницы или набора страниц).

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

  • Эти данные получены из строки HTTP-пользователя-агента.

    • DIM - ga:deviceCategory - тип устройства: работник, планшет или мобильный.
    • DIM - ga:isTablet - Указывает посетителей планшетов. Возможные значения - Yes или No .
    • DIM - ga:mobileDeviceMarketingName - маркетинговое имя, используемое для мобильного устройства.

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

  • Эти данные поступают из отслеживания социального взаимодействия на месте.

    • DIM - ga:socialEngagementType - тип взаимодействия. Возможные ценности Socially Engaged или Not Socially Engaged .

Время

  • 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 .
  • Этот релиз добавляет 5 новых показателей скорости сайта:
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • Этот релиз добавляет новый сегмент по умолчанию для трафика планшетов, gaid::-13 .

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

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

  • Эти данные найдены в отслеживании мобильных приложений SDK Reports:
    • MET - ga:uniqueAppviews - количество просмотров приложений на сеанс.
    • MET - 'ga:appviews - общее количество просмотров приложений.
    • MET - ga:appviewsPerVisit - Среднее количество просмотров приложений на сеанс.

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

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

Пользовательское время

  • Эти данные поступают из данных пользователя.

    • 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 - ga:mobileDeviceBranding - мобильный производитель или фирменное название (Примеры: Samsung, HTC, Verizon, T -Mobile).
    • DIM - ga:mobileDeviceModel - Модель мобильного устройства (пример: Nexus s)
    • DIM - ga:mobileInputSelector - Селектор, используемый на мобильном устройстве (примеры: сенсорный экран, джойстик, Click -Wheel, Stylus)
    • Dim - ga:mobileDeviceInfo - Имя брендинга, модели и маркетинга, используемых для идентификации мобильного устройства.

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

  • API теперь правильно обрабатывает символы UTF-8 в фильтре или динамическом сегменте.

Этот релиз позволяет Google Analytics Premium Accounts доступа до 50 пользовательских переменных.

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

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

  • Фильтры запросов, которые содержат специальные символы внутри регулярных выражений, больше не возвращают ошибки сервера.

  • Комбинирование метрического фильтра с расширенным сегментом больше не возвращает ошибку.

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

Мы исправили небольшую ошибку с ga:visitLength . Это измерение теперь возвращает правильные данные.

Этот релиз влияет на все разработчики 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 управления .

Версия 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 управления .

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

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

Этот релиз добавляет более свежие данные AdWords и больше комбинаций для AdWords Amensions и Metrics.

  • Данные AdWords теперь обновляются в течение часа. До того, как данные были обновлены ежедневно.

  • Мы ослабили число действительных ограничений комбинаций с помощью данных AdWords.

Несколько недель назад мы внесли изменение в запрет API -запросов, которые попросили ga:adGroup или ga:adContent с ga:impressions , поскольку эта комбинация вернулась 0. С помощью этого изменения эта комбинация теперь вернулась и была исправлена, чтобы вернуть правильные данные .

Этот релиз исправляет некоторые неверные комбинации измерений и метрик

Фиксированные неверные метрики/комбинации размеров

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

    • Размеры продукта не могут быть объединены с метриками транзакций.
    • ga:adContent или ga:adGroup не может быть объединен с ga:impressions .

    Вместо возвращения ответа с 0 результатами API теперь возвращает 400 кода ошибки для всех запросов, которые запрашивают эти комбинации.

Этот релиз осуждает значение доверительного интервала в метрик.

Уничтожение доверительного интервала

  • Если вы еще этого не сделали, пожалуйста, прекратите использовать значения доверительного интервала для метрик. С помощью этого выпуска подача данных API экспорта данных возвращает 0,0 для всех значений доверительного интервала. Примерно через месяц мы будем полностью удалить этот атрибут из всех метрических элементов.

    Чтобы определить, был ли отбег ответа, пожалуйста, используйте поле «Содержит» в ответе.

Этот релиз добавляет 3 новых метрик и обновляет возвращаемое значение двух.

Новые обновления данных

  • Мы добавили 3 новых показателя, касающихся производительности скорости сайта в API:
    • ga:pageLoadSample
    • ga:pageLoadTime
    • ga:avgPageLoadTime

Метрические обновления

  • Чтобы указать значения валюты в фильтрах, необходимо указать фактическое значение, передаваемое из кода отслеживания (например, единица 1 теперь будет указана как 1).

  • ga:CTR теперь возвращает фактический процент (например, значение 2% возвращается как 2).

Этот выпуск улучшает производительность подачи данных и добавляет новые данные:

Улучшение производительности

  • Этот выпуск улучшает задержку подачи данных на 30-35%.

Новые обновления данных

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

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

  • В настоящее время вам необходимо указать значение валютного фильтра как микро -единицы (например, 1 единица валюты указана как 1000000). В ближайшем будущем вам необходимо будет указать фактическое значение, передаваемое из кода отслеживания (например, 1 единица теперь будет указана как 1).

  • В настоящее время ga:CTR составляет percent и возвращает значение 0,02. В ближайшем будущем это изменится, чтобы вернуть фактический процент (например, 2).

Этот выпуск добавляет больше данных в подачу данных:

Новые обновления данных

  • Следующее время было добавлено: ga:dayOfWeek

  • Следующий внутренний показатель поиска был добавлен: ga:percentVisitsWithSearch

  • Были добавлены следующие метрики отслеживания событий:

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

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

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

Этот выпуск добавляет значительно больше данных в подачу данных:

Новые обновления данных

  • Расчет 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 .

Этот выпуск добавляет новую функцию в подачу данных:

Новые возможности

  • Был добавлен новый элемент XML, позволяющий пользователям знать, были ли выборки данных. true . Этот элемент всегда будет возвращаться, были ли данные были отобраны или нет с true или false . Библиотеки Java и JavaScript также были обновлены с помощью вспомогательных методов для доступа к этому элементу.

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

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

  • Ранее добавление или оператора к выражению фильтра с измерением (то есть ga:keyword==store,ga:keyword==bar ) может привести к различным значениям, чем если бы каждый фильтр был применен индивидуально по нескольким запросам. Это было исправлено, и использование оператора или оператора теперь возвращает последовательные значения.

  • Некоторые из сообщений об ошибках API для недопустимых фильтров были обновлены, чтобы не включать, было ли это измерение или метрический фильтр, вызвавший ошибку (хотя фактическое выражение оскорбления фильтра будет оставаться возвращением).

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

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

  • Проблема кодирования в клиентской библиотеке JavaScript была исправлена. Аналитическая проблема выпуска

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

  • Он недействителен или измерение и метрику в параметре файла запроса подачи данных. Например: ga:source==google,ga:visits>5 . Сообщение об ошибке для этого недопустимого запроса было обновлено, чтобы сказать: Cannot OR dimension filter(s) with metric filter .

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

Новые возможности

  • Следующие 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

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

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

Этот релиз добавляет ряд новых функций и исправляет ошибку:

Новые возможности

  • Сегмент по умолчанию 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 были ранее поменялись и возвращали ценность друг друга. Теперь они фиксируются, чтобы вернуть правильные данные.

Университет измерений и напоминания о метриках

  • Если вы этого еще не сделали, пожалуйста, прекратите использовать ранее устаревшие измерения и метрики

Этот релиз добавляет ряд новых функций:

Этот выпуск увеличивает основной номер версии до 2

  • Некоторые функции требуют использования новейших клиентских библиотек. Мы официально поддерживаем: Java & JavaScript . Сторонние библиотеки еще не могут быть обновлены.

    • Версия 2 может быть запрошена путем добавления заголовка GData-Version: 2 в каждую учетную запись или запрос на подачу данных Прочитайте документацию для получения более подробной информации.
    • Новое пространство имен XML было добавлено как в каналы учетной записи, так и в данные данных:
      xmlns:ga='http://schemas.google.com/ga/2009'
  • 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 now ga:visitCount
    • ga:countOfVisitsToATransaction is now ga:visitsToTransaction

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

This release updates the Google Analytics Data Export API as follows:

  • Some restrictions on dimension and metric combinations have been relaxed. You can now query most content and visitor level dimensions together, for example ga:pagePath and ga:source is now a valid combination. Please see the updated reference guide for these new combinations: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html

  • The total number of rows that can be asked for in one request has been increased to 10,000. The default number of rows returned is still 1,000, but can now be increased by setting the max-results query parameter.

  • The Account Feed now returns two new data elements for each Table ID (currency and timezone).

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

  • All previous deprecation changes have taken effect.

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