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

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

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

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

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

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

Настройки хранения пользовательских данных в Management API

Теперь можно программно настроить параметры хранения пользовательских данных, используя новые поля dataRetentionTtl и dataRetentionResetOnNewActivity, добавленные в ресурс WebProperty .

Это первоначальная версия API удаления пользователей:

  • API удаления пользователей позволяет клиенту Google Analytics удалять данные определенного конечного пользователя из проекта или веб-ресурса. Запросы на удаление пользователей можно отправлять с помощью проектов Firebase или свойств Google Analytics. Посетите обзор API удаления пользователей для получения более подробной информации.

Операции записи в Management API

Операции записи в Management API (например, создание, обновление, удаление, исправление) для ресурсов веб-ресурса, представления (профиля) и цели больше не требуют внесения в белый список. Дневной лимит по умолчанию для всех операций записи в Management API составляет 50 операций записи в день. Дополнительную информацию см. на странице «Лимиты и квоты» .

В этом выпуске внесены изменения в квоты и ограничения API Analytics Real Time .

Вызовы API отчетов Analytics в реальном времени используются для достижения лимита в 10 000 вызовов на представление (профиль) в день наравне с другими вызовами API Analytics. Теперь вызовы Analytics Real Time Reporting API учитываются отдельно, что означает, что можно совершать 10 000 вызовов в день для каждого представления (профиля) с помощью Analytics Real Time Reporting API И делать еще 10 000 вызовов в день для каждого представления (профиля) с помощью любого другого Аналитические API. Дополнительную информацию см. на странице «Лимиты и квоты» .

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

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

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

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

Добавлены URL-адреса «android-app://» в качестве допустимого источника перехода.

В этом выпуске добавлена ​​новая задача customTask .

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

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

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

Аудитория ремаркетинга – поддержка оптимизации

В этом выпуске добавлена ​​поддержка Google Optimize и OPTIMIZE в качестве типа связанного рекламного аккаунта. Подробную информацию см. в справочной документации по Аудитории ремаркетинга и в руководстве разработчика по Аудитории ремаркетинга .

В этом выпуске к 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, приведет к ошибке.

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

Это выпуск с исправлением ошибок; он устраняет проблему, из-за которой не удавалось создать специальную метрику типа TIME , если min_value не было установлено. Запросы без min_value теперь создают пользовательскую метрику с min_value по умолчанию, равным 0 .

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

Этот выпуск содержит:

Гугл Аналитика

  • Совместимость с iOS 10 и исправления ошибок.

Этот выпуск содержит:

Гугл Аналитика

  • Исправления сбоев.

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

Валюты

Это выпуск с исправлением ошибок; исправлена ​​проблема, из-за которой подмножество валют поддерживалось в веб-интерфейсе Analytics, но не поддерживалось в API . В этом выпуске добавлена ​​поддержка следующих валют:

  • UAH, AED, BOB, CLP, COP, EGP, HRK, ILS, MAD, MYR, PEN, PKR, RON, RSD, SAR, SGD, VEF, LVL

Для получения дополнительной информации см.: - Справочник по представлениям (профилям) . – Статья Справочного центра «Справочник валют» .

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

Аудитории ремаркетинга

API управления позволяет create , get , list , update и patch аудитории ремаркетинга для ресурса Google Analytics. Дополнительную информацию о том, как работают аудитории ремаркетинга, можно найти в статье Справочного центра «Об аудиториях ремаркетинга в Analytics» .

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

ID транзакции

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

В этом выпуске 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 к сеансам Analytics (показы объявлений/сеансы Analytics) (связывание с DFP ​​включено, а скрытие дохода от DFP не включено).“
  • Метрика — ga:dfpViewableImpressionsPercent — процент показов объявления в видимой области экрана. Показ считается показом в видимой области экрана, если он появился в браузерах пользователей и его можно увидеть (связь с DFP ​​включена, а скрыть доход от DFP не включена).»
  • Метрика – ga:dfpClicks – количество кликов по объявлениям DFP на сайте (связывание с DFP ​​включено, а скрытие дохода от DFP не включено).“
  • Метрика – ga:dfpCTR – процент просмотров страниц, которые привели к клику по объявлению DFP (связь с DFP ​​включена, а скрыть доход от DFP не включена).“
  • Метрика – ga:dfpRevenue – доход от DFP – это оценка общего дохода от рекламы на основе выполненных показов (связывание с DFP ​​включено, а скрытие дохода от DFP не включено).“
  • Метрика – ga:dfpRevenuePer1000Sessions – общий расчетный доход от объявлений DFP за 1000 сеансов Google Analytics. Обратите внимание, что этот показатель основан на сеансах сайта, а не на показах рекламы (связь с DFP ​​включена, а скрыть доход от DFP не включена).»
  • Метрика — ga:dfpECPM — эффективная цена за тысячу просмотров страниц. Это доход DFP на 1000 просмотров страниц (связь с DFP ​​включена, а скрыть доход от DFP не включена).“
  • Метрика – ga:backfillImpressions – Показы для заполнения – это сумма всех показов объявлений AdSense или Ad Exchange, выполненных в качестве заполнения через DFP. О показе объявления сообщается каждый раз, когда на веб-сайте отображается отдельное объявление. Например, если страница с двумя рекламными блоками просматривается один раз, мы отобразим два показа (связь с DFP ​​включена, а скрыть доход от DFP не включена).»
  • Метрика – ga:backfillCoverage . Покрытие заполнения – это процент запросов объявлений для заполнения, по которым вернулось хотя бы одно объявление. Как правило, охват может помочь выявить сайты, на которых учетная запись издателя не может предоставлять таргетированную рекламу. (Показы объявлений / Общее количество запросов объявлений) * 100. Если и AdSense, и Ad Exchange предоставляют рекламу для заполнения, этот показатель представляет собой средневзвешенное значение двух аккаунтов для заполнения (связывание с DFP ​​включено, а скрытие дохода от DFP не включено)».
  • Метрика – ga:backfillMonetizedPageviews – измеряет общее количество просмотров страниц ресурса, которые были показаны хотя бы с одним объявлением из связанных аккаунтов резервного заполнения. Обратите внимание, что один монетизированный просмотр страницы может включать в себя несколько показов рекламы (связь с DFP ​​включена, а скрытие дохода от DFP не включена).»
  • Метрика — ga:backfillImpressionsPerSession — соотношение показов объявлений для заполнения и сеансов аналитики (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...

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

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

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

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

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

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

Ограничение частоты ошибок

Наша политика всегда заключалась в том, что разработчики должны реализовывать экспоненциальную задержку при обработке ответов 500 или 503 . Сегодня мы вводим ограничение на количество ошибок 500 и 503, чтобы обеспечить соблюдение этой политики.

  • 50 неудачных запросов на запись в час.

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

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

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

Полные отчеты

API полных отчетов больше не имеет ограничения в 100 отчетов в день. API использует ту же систему токенов по каждому ресурсу и за день, что и при создании полного отчета через веб-интерфейс.

Полные отчеты

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

Просмотры (профили)

В этом выпуске к ресурсу представления (профиля) добавлено свойство botFilteringEnabled . Это свойство указывает, включена ли фильтрация ботов для представления (профиля). Подробности см. в справочной документации по представлениям (профилям) .

Полные отчеты

В этом выпуске к полным отчетам добавлен метод delete . Подробности см. в справочной документации по удалению полных отчетов .

Этот выпуск содержит:

Гугл Аналитика

  • Без изменений.

Диспетчер тегов Google

  • Исправлена ​​проблема , приводившая к сбою при запуске модульных тестов.

Сегменты

Это релиз с исправлением ошибок. В этом выпуске исправлена ​​проблема, из-за которой сегменты со значениями валют в определении отображались неправильно при вызове метода списка сегментов .

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

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

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

Этот выпуск содержит:

Гугл Аналитика

  • Добавлена ​​поддержка биткода.

Диспетчер тегов Google

  • Добавлена ​​поддержка биткода.

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

Сегменты

Это релиз с исправлением ошибок. В этом выпуске исправлена ​​проблема, из-за которой пользователи с частными сегментами, закрепленными за несколькими представлениями (профилями), получали ответ об ошибке 500 при вызове метода списка сегментов .

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

В этом выпуске в URL-адрес TOS Provisioning API добавлен дополнительный параметр:

  • Добавление параметра URL- provisioningSignup=false устраняет проблему, возникающую при предоставлении учетной записи Google Analytics для пользователя без каких-либо учетных записей Google Analytics. Разработчикам следует обновить свой код, добавив этот параметр в URL-адрес TOS.

Пакетирование

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

Просмотры (профили)

В этом выпуске свойство currency представления (профиля) по умолчанию будет установлено в долларах США , если оно не было установлено во время операции вставки . Также операции get и list будут возвращать доллары США для представлений (профилей), которые ранее были созданы без свойства currency .

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

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

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

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

Этот выпуск содержит:

Гугл Аналитика

  • Исправлена ​​проблема, приводившая к сбою при использовании setCampaignParametersFromUrl. Выпуск 636 .

Диспетчер тегов Google

  • Без изменений.

Фильтры

В этом выпуске окончательно удаляются устаревшие поля фильтра IS_MOBILE и IS_TABLET , которые следует заменить на DEVICE_CATEGORY=mobile и DEVICE_CATEGORY=tablet . Запросы на вставку, обновление и исправление, которые устанавливают в полях фильтра использование IS_MOBILE и IS_TABLET вернут ошибку.

Этот выпуск содержит:

Гугл Аналитика

  • Без изменений.

Диспетчер тегов Google

  • Исправлен конфликт имен классов. Выпуск 631 .

Фильтры

В этом выпуске добавлена ​​поддержка использования специального измерения для поля фильтра путем добавления свойства fieldIndex во все разделы сведений о фильтре. Например, теперь можно установить выражение фильтра с помощью "field": "CUSTOM_DIMENSION" и "fieldIndex": "1" чтобы фильтр работал по первому пользовательскому измерению.

Цели

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

Этот выпуск содержит:

Гугл Аналитика

  • Добавлена ​​поддержка фоновой диспетчеризации на устройствах, отличных от Google Play.
  • Устаревший Analytics Logger/LogLevel. Вместо этого Analytics теперь использует ведение журналов Android. Чтобы включить ведение журнала отладки, запустите adb shell setprop log.tag.GAv4 DEBUG .
  • Рефакторинг для улучшения доставки данных и установки атрибуции кампании.
  • Исправлена ​​ошибка анализа кампании. Выпуск 596 .
  • Необработанные исключения приложения в течение первых секунд инициализации Analytics сообщаются правильно. Выпуск 443 .

Диспетчер тегов Google

  • Без изменений.

Этот выпуск содержит:

Гугл Аналитика

  • Сообщите о разрешении экрана с помощью NativeBounds на iOS 8.0 и новее. Это касается проблемы 504 .
  • Добавлена ​​поддержка параметров кампании, связанных с кликами.
  • Сообщите модель оборудования iOS в дополнение к версии ОС устройства. Это касается проблемы 408 .
  • Сообщите об атрибуции установки iAd на iOS 7.1 и более поздних версиях. Для этого требуется платформа iAd.
  • Добавлено предупреждение об устаревании для типа обращения appview.
  • sqlite3 теперь является обязательной библиотекой.

Диспетчер тегов Google

  • Исправлен сбой нулевой строки в TAGDispatcher.

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

Транспорт

  • Поле транспорта позволяет вам установить механизм отправки обращений.

Другие изменения

  • Опция useBeacon устарела.
  • Исправление ошибок

Этот выпуск содержит:

Гугл Аналитика

Диспетчер тегов Google

  • Мелкие исправления.

Этот выпуск знаменует собой окончательное отключение и удаление ресурса dailyUpload . Ресурс dailyUpload был официально признан устаревшим 20 июня 2014 г.; весь импорт данных о расходах теперь должен выполняться с использованием ресурса загрузки .

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

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

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

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

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

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

Источник данных

  • Параметр ds Data Source позволяет указать источник данных обращения.

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

Специальные параметры и показатели

Теперь можно создавать, перечислять, получать, исправлять и обновлять специальные параметры и показатели с помощью Management API.

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

Ответ метода list для всех коллекций теперь включает пустой список для свойства items , если коллекция не содержит ресурсов. Раньше свойство items в ответе опускалось. См. Справочник по API для получения полной информации о запросах и ответах на данные конфигурации Google Analytics.

В этом выпуске представлена ​​новая область применения API управления Google Analytics . analytics.manage.users.readonly — просмотр разрешений пользователей Google Analytics.

Было добавлено новое поле фильтров DEVICE_CATEGORY , а IS_MOBILE и IS_TABLET больше не поддерживаются. Используйте DEVICE_CATEGORY=mobile и DEVICE_CATEGORY=tablet .

Этот выпуск содержит:

Гугл Аналитика

  • Исправлена ​​ошибка, из-за которой при отправке маяков не отправлялись все маяки.
  • Обновлен пример приложения CuteAnimals, чтобы продемонстрировать, как выполнять диспетчеризацию, когда приложение переходит в фоновый режим.
  • Добавлена ​​поддержка дополнительных полей расширенной электронной торговли.
  • Удалены предупреждающие сообщения об отсутствии классов GAIHit и GAIProperty при компиляции с iOS SDK 8.0; эти классы были удалены.
  • Отправка маяков теперь стала более эффективной: несколько маяков отправляются в одном HTTPS-запросе.
  • Запросы будут сжаты, чтобы сэкономить на использовании тарифного плана при определенных обстоятельствах.

Диспетчер тегов Google

  • Устаревший openContainerWithId на основе TAGContainerFuture. Использование этого API в iOS8 приводит к ошибкам, если метод get вызывается на некоторых этапах жизненного цикла UIAppDelegate.
  • В расширенную электронную торговлю добавлена ​​поддержка специальных показателей и параметров для тега Google Universal Analytics.
  • Исправлена ​​ошибка, из-за которой для действий расширенной электронной торговли требовались продукты, у которых есть дополнительные продукты.
  • Поддержка функций рекламного идентификатора для тега Google Universal Analytics.
  • Обновлен пример приложения CuteAnimals, чтобы продемонстрировать, как отправлять данные, когда приложение переходит в фоновый режим.

Ресурс View (Profile) теперь включает свойство enhancedECommerceTracking , которое указывает, включена ли расширенная электронная торговля ( true ) или отключена ( false ).

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

AdWords

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

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

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

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

Время

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

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

АдСенс

  • Метрика – ga:adsenseCoverage – процент запросов объявлений, по которым вернулось хотя бы одно объявление.
  • Метрика – ga:adsenseViewableImpressionPercent – процент показов, которые были доступны для просмотра.
  • Обращения теперь можно отправлять с помощью navigator.sendBeacon (в поддерживаемых браузерах), передав параметр useBeacon .
  • Файл cookie, установленный плагином функций отображения , был переименован с _dc на _gat .

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

Пути конверсии

  • Параметр – mcf:dcmAd – название объявления DCM для события DCM (показа или клика), соответствующего конверсии Google Analytics.
  • измерение – mcf:dcmAdPath – путь к конверсии, где взаимодействия на пути представлены объявлениями DCM.
  • измерение – mcf:dcmAdType – название типа объявления DCM для события DCM (показа или клика), соответствующего конверсии Google Analytics.
  • параметр – mcf:dcmAdvertiser – название рекламодателя DCM для события DCM (показа или клика), соответствующего конверсии Google Analytics.
  • измерение – mcf:dcmAdvertiserPath – путь к конверсии, где взаимодействия на пути представлены рекламодателями DCM.
  • параметр – mcf:dcmCampaign – название кампании DCM для события DCM (показа или клика), соответствующего конверсии Google Analytics.
  • измерение – mcf:dcmCampaignPath – путь к конверсии, где взаимодействия на пути представлены кампаниями DCM.
  • измерение – mcf:dcmCreative – название объявления DCM для события DCM (показа или клика), соответствующего конверсии Google Analytics.
  • измерение – mcf:dcmCreativePath – путь к конверсии, где взаимодействия на пути представлены объявлениями DCM.
  • измерение – mcf:dcmCreativeVersion – версия объявления DCM для события DCM (показ или клик), соответствующая конверсии Google Analytics.
  • измерение – mcf:dcmCreativeVersionPath – путь к конверсии, где взаимодействия на пути представлены версиями объявлений DCM.
  • измерение — mcf:dcmNetwork — используемая сеть.
  • измерение – mcf:dcmPlacement – название места размещения на сайте DCM для события DCM (показа или клика), соответствующего конверсии Google Analytics.
  • измерение – mcf:dcmPlacementPath – путь к конверсии, где взаимодействия на пути представлены местами размещения DCM.
  • измерение – mcf:dcmSite – название сайта DCM, на котором было показано объявление DCM для события DCM (показа или клика), соответствующего конверсии Google Analytics.
  • измерение – mcf:dcmSitePath – путь к конверсии, где взаимодействия на пути представлены сайтами DCM.
  • метрика – mcf:firstImpressionConversions – количество конверсий, для которых показ кампании DCM был первым взаимодействием-конверсией за 30-дневный период ретроспективного анализа. Это измерение включает в себя как достижение целей, так и транзакции.
  • метрика – mcf:firstImpressionValue – ценность конверсий, для которых показ кампании DCM был первым взаимодействием-конверсией за 30-дневный период ретроспективного анализа. Это измерение включает в себя как достижение целей, так и транзакции.
  • метрика – mcf:impressionAssistedConversions – количество конверсий, в которых показ кампании DCM появлялся на пути конверсии, но не был конечным взаимодействием конверсии. Это измерение включает в себя как достижение целей, так и транзакции.
  • метрика – mcf:impressionAssistedValue – ценность конверсий, для которых показ кампании DCM появлялся на пути конверсии, но не был конечным взаимодействием конверсии. Это измерение включает в себя как достижение целей, так и транзакции.

В этот выпуск добавлен новый показатель сеанса, новый параметр «Источники трафика», а также новые параметры и показатели DoubleClick Campaign Manager.

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

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

Сессия

  • Метрика – ga:hits – общее количество обращений, отправленных в Google Analytics. Эта метрика суммирует все типы обращений (например, просмотр страницы, событие, время и т. д.).

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

  • Размер - ga:campaignCode - При использовании ручного отслеживания кампании значение параметра отслеживания кампании UTM_ID.

Менеджер кампании DoubleClick

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

Этот релиз содержит:

Гугл Аналитика

  • Без изменений.

Диспетчер тегов Google

  • Усовершенствованная поддержка электронной коммерции была добавлена ​​в тег Google Universal Analytics.
  • Новые методы dispatch и dispatchWithCompletionHandler в классе Tagmanager, были добавлены.

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

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

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

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

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

Этот релиз содержит:

Гугл Аналитика

  • Поддержка расширенной электронной коммерции была добавлена. Для получения подробной информации см. Усовершенствованное руководство по разработчике электронной коммерции .
  • Идентификатор клиента теперь будет сбрасываться каждый раз, когда меняется идентификатор рекламы.
  • Коллекция идентификации рекламы выключена по умолчанию.
  • Добавлены программные API для отчетности об исключении.
  • Исправление ошибок в документации.
  • Мелкие исправления.

Диспетчер тегов Google

  • Нет изменений в Google Tag Manager.

Этот релиз содержит:

Гугл Аналитика

  • Теперь SDK будет собирать IDFA, а флаг для отслеживания рекламодателей, если в приложение включена библиотека Libadidaccess.A (предоставленная как часть SDK), а свойство allowIDFACollection установлено на TRUE на трекере.
  • Усовершенствованная поддержка электронной коммерции была добавлена.
  • Добавлен тип Screenview Hit Type, чтобы заменить тип Hit Appview.
  • Параметр HIT ID теперь добавляется в каждый удар. Он изменяется каждый раз, когда генерируется Hit Appview, Screenview или PageView.
  • ClientId теперь будет сброшен каждый раз, когда значение IDFA будет изменено. Это происходит только тогда, когда IDFA собирается в трекере.
  • Новый метод dispatchWithCompletionHandler был добавлен в класс GAI.
  • Исправлена ​​проблема, в которой SDK может отправить маяк без клиента или с пустым клиентом.

Диспетчер тегов Google

  • Без изменений
  • Хиты, которые не содержат действительного идентификатора отслеживания, теперь отброшены.

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

Импорт данных

См. Руководство разработчика импорта данных для получения подробной информации, как использовать API управления для импорта данных в свою учетную запись Google Analytics.

Загрузки

  • Ресурс upload теперь поддерживает следующие типы загрузки:
    • Данные кампании
    • Данные контента
    • Стоимость данных
    • Данные продукта
    • Возврат данных
    • Данные пользователя
  • Ресурс upload имеет новый метод migrateDataImport для миграции существующих данных о customDataSources .

Ежедневная загружает детектирование

  • Ресурс dailyUpload теперь устарел! См. Руководство по миграции для получения подробной информации о миграции для использования функции импорта данных .
  • Ресурс dailyUpload будет продолжать работать еще на шесть месяцев, после чего любой оставшиеся customDataSources с свойствами uploadType , установленными на analytics#dailyUploads будут автоматически перенесены и работают только с ресурсом upload .
  • Текущие пользователи ресурса dailyUpload должны обновить свой код и перенести, чтобы как можно скорее использовать ресурс загрузки.

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

Сегменты

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

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

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

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

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

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

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

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

Система

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

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

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

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

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

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

uiname изменение

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

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

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

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

  • API обеспечения может использоваться для программного создания новых учетных записей Google Analytics. Этот API предназначен только для приглашения и предназначен для квалифицированных поставщиков услуг и крупных партнеров. Посетите обзор API Sevisioning для получения более подробной информации.

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

  • Ссылки AdWords в API Management позволяют создавать, списки, получать, обновлять, исправлять и удалять ссылки между учетными записями Google AdWords и свойствами Google Analytics и управлению, какие представления (профили) связаны с данными AdWords.

Фильтры

Unsampled Reports: API управления

Новый ресурс добавляется в API управления, называемые Unsampled Reports . Отчеты о безрассудных отчетах - это отчеты Google Analytics (GA), которые были сгенерированы с использованием Unsampled Data. Unsampled отчеты в настоящее время доступны только для пользователей GA Premium.

  • Обновил список поддерживаемых органических источников.

    • Удалено : Netscape, About, Mamma, Voila, Live, Wirtulana Polska, Yam, Ozu.
    • Добавлен/обновлен : Baidu, Docomo, Onet, Centrum, Sogou, Tut.by, Globo, Ukr.net, SO.com, AU One.
  • Обновил список поддерживаемых органических источников.

    • Удалено : Netscape, About, Mamma, Voila, Live, Wirtulana Polska, Yam, Ozu.
    • Добавлен/обновлен : Baidu, Docomo, Onet, Centrum, Sogou, Tut.by, Globo, Ukr.net, SO.com, AU One.

Этот релиз содержит:

Гугл Аналитика

  • Добавлено поле идентификатора пользователя.

Диспетчер тегов Google

  • Исправлена ​​ошибка в идентификаторе для рекламного макроса, чтобы он мог правильно вернуть идентификатор для рекламодателя (IDFA), если таковые имеются.
  • Исправлена ​​проблема, чтобы пользователи могли использовать NSNumber для данных электронной коммерции.

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

Appuiname УСТАНОВКА

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

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

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

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

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

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

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

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

Следующие измерения были добавлены в основной API отчетности:

AdWords

  • Размер - ga:isTrueViewVideoAd - Yes или No - указывает, является ли объявление AdWords TrueView Video Ad.

Время

  • Размер - 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 .

Сессия

  • Размер - 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 вместо этого.

Этот выпуск содержит замену типа Hit appview и добавление и переименование параметров. Просмотрите ссылку на параметр для полного списка параметров.

Замена Appview

  • Тип Hit appview был заменен на screenview . Обновите код отслеживания приложения как можно скорее, чтобы использовать screenview вместо appview .

Новые параметры

Переименование параметра

  • Описание контента было переименовано в имя экрана . Имя параметра запроса, cd , останется прежним.

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

Замена Appview

  • Тип Hit appview был заменен на screenview . Обновите код отслеживания приложения как можно скорее, чтобы использовать screenview вместо appview .

Новые поля

Другие изменения

  • Улучшенный вывод отладки.
  • Исправлены различные ошибки презрендерирования.
  • Добавлена ​​поддержка непреодолимых API -интерфейсов. Презендеринг теперь работает в IE11 в дополнение к Chrome.
  • Другие мелкие исправления ошибок в поддержке линкера.
  • Зрелый поиск Yahoo теперь правильно классифицируется как органический источник.
  • Добавлена ​​поддержка непреодолимых API -интерфейсов. Презендеринг теперь работает в IE11 в дополнение к Chrome.

Сегменты: основная отчетность API v2.4 & v3.0

Новые сегменты поддерживают в основном API отчетности.

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

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

Следующие изменения были внесены в коллекцию сегментов :

  • Сегменты пользователей и последовательности теперь поддерживаются в API.
  • Коллекция сегментов теперь возвращает все встроенные и пользовательские сегменты сеанса и пользовательский уровень .
  • Свойство definition для сегментов теперь будет использовать новый синтаксис сегментов. Это включает определения для существующих сегментов уровня сеанса , которые будут изменяться от definition: " " definition: " " к definition: "sessions::condition:: " definition: "sessions::condition:: " .
  • Новое свойство type было добавлено в ресурс сегмента , чтобы указать, является ли сегмент CUSTOM (т.е. создан пользователем в веб -интерфейсе) или BUILT_IN (т.е. предоставлен Google Analytics).

Эксперименты

Следующие метрики AdSense теперь можно использовать в качестве целей оптимизации:

  • ga:adsenseAdsClicks - количество раз, когда реклама Adsense на вашем сайте была нажата.
  • ga:adsenseAdsViewed - количество просмотренных рекламных объявлений Adsense. Несколько рекламных объявлений могут отображаться в рекламном блоке.
  • ga:adsenseRevenue - общий доход от Adsense Ads.

Новая коллекция учетных записей

  • Коллекция учетных записей была добавлена ​​в API управления. Он предоставляет сводную информацию для каждой учетной записи, свойства и просмотра (профиль), к которому авторизованный пользователь имеет доступ в одном и быстром запросе. См. Руководство по разработке учетной записи для получения подробной информации.

Google Analytics и Google Tag Manager

  • Google Analytics и Google Tag Manager SDK теперь являются частью служб Google Play SDK 4.3 .
  • Это не требует, чтобы устройства были установлены службы Google Play. Когда Google Play Services недоступен, SDK автоматически вернется к локальной отправке.
  • Для получения подробной информации о том, как начать, см. Google Tag Manager SDK V4 для Android и Google Analytics SDK V4 для Android

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

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

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

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

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

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

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

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

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

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

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

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

Этот релиз содержит:

Гугл Аналитика

  • SDK теперь заполнит параметр идентификатора приложения ( &aid ) по умолчанию.

Диспетчер тегов Google

  • Добавлена ​​поддержка для Google Analytics Content Experiments Macro.

Этот релиз содержит:

Гугл Аналитика

  • Нет изменений в Google Analytics.

Диспетчер тегов Google

  • Добавлена ​​поддержка для Google Analytics Content Experiments Macro.

Этот релиз содержит:

Гугл Аналитика

  • Нет изменений в Google Analytics напрямую. Пользователи GA должны отметить, что Google Tag Manager больше не зависит от AdSupport.framework по умолчанию. Это может помочь решить проблему 387 .

Диспетчер тегов Google

  • Функции, которые называют AdSupport.framework api, разбиты в отдельную библиотеку, libAdIdAccess.a . Приложения должны ссылаться на эту библиотеку, чтобы иметь доступ к строке рекламного идентификатора (IDFA) и флаг отслеживания рекламодателей.

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

Пути конверсии

  • Размер - mcf:adwordsCustomerIDPath - Последовательность идентификатора клиента AdWords по пути конверсии.

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

  • Размер - mcf:adwordsCustomerID - соответствует AdWords API Customer.id .
  • Параметры линкера больше не игнорируются при навигации по доменам на разных уровнях масштабирования в Firefox.
  • Исправлена ​​проблема, в которой аналитика на странице не будет загружаться для определенных URL-адресов.
  • Улучшения к выводу режима отладки.
  • Выпуск обслуживания.

Этот релиз содержит: * Удалил потребность в AdSupport.framework . * Удален неиспользованный код.

Этот релиз содержит: * Добавлена ​​поддержка 64-битной iOS 7.0 SDK. * Удаленная libGoogleAnalytics_debug.a , это часть библиотеки libGoogleAnalyticsServices.a . * Очистить файл сборки Cuteanimals для Google Analytics.

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

Пути конверсии

  • Размер - mcf:adwordsAdGroupIDPath - Последовательность идентификатора группы AD AD AD по пути преобразования.
  • Размер - mcf:adwordsCampaignIDPath - Последовательность идентификатора кампании AdWords по пути конверсии.
  • Размер - mcf:adwordsCreativeIDPath - Последовательность AdWords Creative ID по пути преобразования.
  • Размер - mcf:adwordsCriteriaIDPath - Последовательность критериев AdWords ID по пути конверсии.

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

  • Размер - mcf:adwordsAdGroupID - соответствует AdWords api AdGroup.id .
  • Размер - mcf:adwordsCampaignID - соответствует AdWords API Campaign.id .
  • Размер - mcf:adwordsCreativeID - соответствует AdWords API Ad.id
  • Размер - mcf:adwordsCriteriaID - соответствует API API Criterion.id .

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

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

Чтобы облегчить визуализацию ваших данных Google Analytics с использованием визуализаций Google диаграмм, API может при желании вернуть объект таблицы данных в ответе.

  • Дополнительный параметр запроса output был добавлен в API. Его можно использовать для выбора выходного формата аналитических данных в ответе, который по умолчанию является JSON. Если установить datatable , в ответ включен свойство dataTable , которое содержит объект таблицы данных . Этот объект можно использовать непосредственно с диаграммами Google . См. Основную ссылку на API отчетности для получения подробной информации.

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

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

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

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

  • Размер - ga:isMobile - Используйте ga:deviceCategory (например, ga:deviceCategory==mobile ).
  • Размер - ga:isTablet - используйте ga:deviceCategory (например, ga:deviceCategory==tablet ).
  • Метрика - ga:entranceBounceRate - Используйте ga:visitBounceRate .

Были внесены следующие изменения в сегментах по умолчанию из -за снижения ga:isMobile и ga:isTablet Dimensions:

  • Сегмент gaid::-11 был переименован из мобильного трафика до мобильного и планшетного трафика . Определение для этого сегмента было изменено с ga:isMobile==Yes на ga:deviceCategory==mobile,ga:deviceCategory==tablet . Обратите внимание, что ga:isMobile включал трафик планшетов, который отражается в новом определении. Если вам нужен только мобильный трафик, исключая планшет, переключитесь на новый сегмент мобильного трафика ( gaid::-14 ).
  • Сегмент gaid::-13 Определение изменилось с ga:isTablet==Yes на ga:deviceCategory==tablet . Это продолжает представлять трафик планшетов .
  • Сегмент gaid::-14 был добавлен. Название сегмента - мобильный трафик , а определение - ga:deviceCategory==mobile .
  • Выпуск обслуживания.

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

Адсенс

  • Доступ к данным AdSense был добавлен:

    • Met - ga:adsenseRevenue - Общий доход от AdSense Ads.
    • MET - ga:adsenseAdUnitsViewed - Количество просмотренных AdSense AD -единиц. Блок рекламы - это набор рекламных объявлений, отображаемых в результате одной части 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 управления была возвращена неправильная информация о часовом поясе для представления (профиль). Теперь информация о часовом поясе для просмотров (профили) соответствует тому, что установлено в интерфейсе Andultics Analytics.

Этот релиз содержит: * Исправлен конфликт с буфером протокола SDK. * Исправлена ​​ошибка линкера, когда была включена разделение кода.

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

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

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

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

Этот релиз содержит: * Шестой бета -релиз. * Внесенные изменения, необходимые для того, чтобы избежать исключения времени выполнения, когда приложение, нацеленное на KitKat (API -уровни 19), использует SDK.

Этот релиз содержит: * Второй выпуск версии 3.0. * Внесенные изменения, необходимые для того, чтобы избежать исключения времени выполнения, когда приложение, нацеленное на KitKat (API -уровни 19), использует SDK.

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

API настройки и настройки учетной записи

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

Пользовательские разрешения в API управления

  • Новый ресурс AccountUserLinks позволяет управлять разрешениями учетной записи для пользователей.
  • Новый ресурс WebPropertyUserLinks позволяет управлять разрешениями свойств для пользователей.
  • Новый ресурс ProfileUserLinks позволяет разрешения управления представлением (профиль) для пользователей.
  • Разрешения для авторизованного пользователя теперь доступны как часть учетной записи , веб -свойства и ресурсов View (профиль) .
  • Был введена новая область применения и необходим для управления разрешениями пользователей. https://www.googleapis.com/auth/analytics.manage.users .
  • См. Руководство DEV Пользовательского разрешения для получения дополнительной информации.

Этот релиз содержит:

  • Фиксированная ошибка ссылки при нацеливании на iOS 7.0.

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

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

Этот релиз содержит: * Первый выпуск версии 3.0 * SDK API -изменения в соответствии с Analytics.js. track и send Методы были удалены. Вместо этого используйте методы send и GAIDictionaryBuilder . * Большинство свойств по протоколу GAITracker были удалены. Вместо этого используйте set на различных полях. * Все параметры, установленные с использованием метода set , будут сохраняться. Ранее несколько параметров были бы установлены только для следующего вызова отправки/трека. * Протокол GAILogger доступен для тех, кто хочет реализовать свои собственные индивидуальные журналы для SDK. * Требования к системе минимума изменились. Смотрите readme.txt для деталей. * Вся активность SDK (база данных и доступ к сети) теперь выполняется в отдельном потоке. * clientId теперь можно прочитать. Позвоните [tracker get:kGAIClientId] . Обратите внимание, что этот вызов будет блокироваться до тех пор, пока clientId не будет прочитана из базы данных. * SDK больше не использует POST , если удар не превышает 2000 байтов. Вместо GET он будет использовать. * SDK больше не будет повторять отправку хитов на основе кода ответа HTTP.

Этот релиз содержит: * Первый выпуск версии 3.0 * SDK API, переписанный, чтобы более тесно выровнять с Analytics.js. См. Javadoc и/Analytics/Devguides/Collection/Android/V3//для деталей. * Все track и send методы удалены. Вместо этого вы можете использовать метод отправки и соответствующие методы конструкции в классе MapBuilder для отправки хитов. См. Fields классов для списка констант, которые вы можете использовать для создания хитов, используя set и send . * Многие из различных свойств также были удалены, включая useHttps , anonymizeIp и т. Д. Вы можете установить/сбросить эти свойства, используя команду set . * EasyTracker теперь расширяет Tracker . Нет необходимости звонить EasyTracker.getTracker чтобы напрямую совершать вызовы отслеживания. * SDK больше не устанавливает флаг управления сеансом для запуска. Разработчики теперь несут ответственность за определение того, требуется ли новая сессия. Обратите внимание, что EasyTracker по -прежнему обрабатывает управление сеансами, как и раньше. * SDK теперь поддерживает пользовательский класс журнала. Смотрите Logger в Javadoc для деталей. * dryRun Mode был добавлен. * clientId теперь можно прочитать. Просто вызовите tracker.get(Fields.CLIENT_ID) . Этот вызов будет блокироваться до тех пор, пока clientId не будет загружен из постоянного магазина. * SDK больше не будет повторять хиты на основе кода ответа HTTP.

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

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

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

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

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

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

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

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

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

Этот выпуск добавляет 2 новых свойства в ресурс WebProperty :

  • profileCount - Возвращает количество профилей для недвижимости. Это позволяет вам фильтровать свойства, которые не имеют никаких профилей (т.е. profilecount = 0).
  • industryVertical - возвращает отрасль вертикальной/категории, выбранной для недвижимости.

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

  • Свойство eCommerceTracking ресурса профиля в настоящее время согласуется с настройками электронной коммерции в разделе администратора веб -интерфейса. Возвращает true когда отслеживание электронной коммерции включено, и false если нет.
  • Ресурс WebProperty теперь включает в себя level , чтобы указать, является ли веб -свойство PREMIUM или STANDARD .

Этот релиз содержит: * Пятый бета -релиз. * EasyTracker Исключение Исключения ошибки. Когда установлен флаг ga_reportUncaughtExceptions , мы не инициализировали анализатор исключений, и в результате не анализировало местоположение необработанного исключения. С этим исправлением отчеты о сбоях и исключениях сообщают о местонахождении исключений, когда ga_reportUncaughtExceptions будет установлено TRUE.

  • A new endpoint has been added to the Management API v3 to access and modify Experiments resources.

The following changes have been pushed to the latest version of the tracking code:

  • Added support for specifying local currencies with _set , eg gaq.push(['_set', 'currencyCode', 'EUR'])
  • This release adds 5 new site speed metrics:
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • This release adds a new default segment for Tablet Traffic, gaid::-13 .
  • The Profile resource now includes a type property to identify whether a profile is configured for a Web site or App. The two possible values are: WEB or APP .

This release contains:

  • Change default appVersion to the value in CFBundleShortVersionString instead of CFBundleVersionKey .
  • Use HTTPS as the default protocol instead of HTTP.
  • Track methods changed to Send (eg trackView now called sendView ).
  • Some minor bug fixes.

This release contains: * Fourth beta release. * The SDK will now respect the sample rate setting. If you previously set the sample rate to other than 100% you will now see a corresponding decrease in some of your Analytics metrics compared with beta 3. * Changed track methods to send (eg trackView now called sendView ). * Added local currency support via Transaction.setCurrencyCode * Use HTTPS by default instead of HTTP. * SDK will not attempt to dispatch hits if there is no network connectivity. * Avoid ANRs while attempting to handle install campaign data. * Removed TrackedActivity classes from the SDK. * Move SDK initialization off the main UI Thread. * Improve the SDK's ability to recover from a corrupted SQLite database. * Several other crashes and bugs fixed.

This release contains:

  • Added armv7s architecture to libGoogleAnalytics.a.
  • Removed armv6 architecture from libGoogleAnalytics.a.

В этом выпуске в API добавлены новые параметры и показатели. Check the Dimensions and Metrics Reference for definitions.

App Tracking

  • This data is found in Mobile App tracking SDK reports:
    • Met - ga:uniqueAppviews - The number of app views per session.
    • Met - ga:appviews - The total number of app views.
    • Met - ga:appviewsPerVisit - The average number of app views per session.

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

  • Dim - ga:socialNetwork - A string representing the social network name. This can be related to the referring social network for traffic sources, or to the social network for social data hub activities. Eg Google+, Blogger, reddit, etc.
  • Dim - ga:hasSocialSourceReferral - Indicates visits that arrived to the site from a social source (ie A social network such as Google+, Facebook, Twitter, etc.). The possible values are Yes or No, where the first letter must be capitalized.

Культурно-просветительные мероприятия

  • This data comes from offsite activity imported from Social Data Hub partners.
    • Dim - ga:socialActivityDisplayName - For a social data hub activity, this string represents the title of the social activity posted by the social network user.
    • Dim - ga:socialActivityEndorsingUrl - For a social data hub activity, this string represents the URL of the social activity (eg the Google+ post URL, the blog comment URL, etc.)
    • Dim - ga:socialActivityPost - For a social data hub activity, this string represents the content of the social activity posted by the social network user (eg The message content of a Google+ post)
    • Dim - ga:socialActivityTimestamp - For a social data hub activity, this string represents when the social activity occurred on the social network.
    • Dim - ga:socialActivityUserPhotoUrl - For a social data hub activity, this string represents the URL of the photo associated with the user's social network profile.
    • Dim - ga:socialActivityUserProfileUrl - For a social data hub activity, this string represents the URL of the associated user's social network profile.
    • Dim - ga:socialActivityContentUrl - For a social data hub activity, this string represents the URL shared by the associated social network user.
    • Dim - ga:socialActivityTagsSummary - For a social data hub activity, this is a comma-separated set of tags associated with the social activity.
    • Dim - ga:socialActivityUserHandle - For a social data hub activity, this string represents the social network handle (ie name) of the user who initiated the social activity.
    • Dim - ga:socialActivityAction - For a social data hub activity, this string represents the type of social action associated with the activity (eg vote, comment, +1, etc.).
    • Dim - ga:socialActivityNetworkAction - For a social data hub activity, this string represents the type of social action and the social network where the activity originated.
    • Met - ga:socialActivities - The count of activities where a content URL was shared/mentioned on a social data hub partner network.

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

  • This data comes from onsite social interaction tracking.
    • Dim - ga:socialInteractionAction - For social interactions, a string representing the social action being tracked (eg +1, like, bookmark)
    • Dim - ga:socialInteractionNetwork - For social interactions, a string representing the social network being tracked (eg Google, Facebook, Twitter, LinkedIn)
    • Dim - ga:socialInteractionNetworkAction - For social interactions, a string representing the concatenation of the ga:socialInteractionNetwork and ga:socialInteractionAction being tracked (eg Google: +1, Facebook: like)
    • Dim - ga:socialInteractionTarget - For social interactions, a string representing the URL (or resource) which receives the social network action.
    • Met - ga:socialInteractions - The total number of social interactions on your site.
    • Met - ga:uniqueSocialInteractions - The total number of unique social interactions on your site. Based on the value pair ga:socialInteractionNetwork and ga:socialInteractionAction
    • Met - ga:socialInteractionsPerVisit - ga:socialInteractions / ga:uniqueSocialInteractions . The average number of social interactions per visit to your site.

Гео/Сеть

  • Dim - ga:metro - The Designated Market Area (DMA) from where traffic originated.

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

  • Dim - ga:pagePathLevel1 - This dimension rolls up all the pagePaths in the first hierarchical level in pagePath.
  • Dim - ga:pagePathLevel2 - This dimension rolls up all the pagePaths in the second hierarchical level in pagePath.
  • Dim - ga:pagePathLevel3 - This dimension rolls up all the pagePaths in the third hierarchical level in pagePath.
  • Dim - ga:pagePathLevel4 - This dimension rolls up all the pagePaths in the fourth hierarchical level in pagePath. All the additional levels in the pagePath hierarchy are also rolled up in this dimension.

Exception Tracking

  • This data come from exception tracking data.

    • Met - ga:exceptions - The number of exceptions that were sent to Google Analytics.
    • Met - ga:fatalExceptions - The number of exceptions where isFatal is set to true.

User Timings

  • This data comes from user timing data.

    • Dim - ga:userTimingCategory - A string for categorizing all user timing variables into logical groups for easier reporting purposes.
    • Dim - ga:userTimingLabel - A string to indicate the name of the action of the resource being tracked.
    • Dim - ga:userTimingVariable - A string that can be used to add flexibility in visualizing user timings in the reports.
    • Dim - ga:userTimingValue The number of milliseconds in elapsed time sent to Google Analytics.
    • Met - ga:userTimingSample - The number of samples that were sent.
    • Met - ga:avgUserTimingValue - The average user timing value. ga:userTimiingValue / ga:userTimiingSample .

Device / Platform

  • This data comes from the user agent of the collected data.
    • Dim - ga:mobileDeviceBranding - Mobile manufacturer or branded name (examples: Samsung, HTC, Verizon, T-Mobile).
    • Dim - ga:mobileDeviceModel - Mobile device model (example: Nexus S)
    • Dim - ga:mobileInputSelector - Selector used on the mobile device (examples: touchscreen, joystick, click-wheel, stylus)
    • Dim - ga:mobileDeviceInfo - The branding, model, and marketing name used to identify the mobile device.

This release contains:

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

    • Remove NoThumb version of library.
    • Drop support for armv6.
  • Новые возможности:

    • Add support for armv7s (for iPhone5).

This release contains:

  • Исправление ошибок:
    • Fix migration from pre-1.5 SDK CVs to 1.5 SDK custom variables.
    • Honor user's background data restrictions setting.

This release contains:

  • Исправление ошибок:
    • GANTrackerDelegate protocol methods are now optional.
    • Events now include the last tracked page view (utmp).
  • Новые возможности:
    • Support for up to 50 custom variables (Note: this feature is available for Google Analytics Premium users only).
    • Updated BasicExample example app.

This release contains:

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

    • Fix memory leak.
    • Events now include the last tracked page view ( utmp ).
  • Новые возможности:

    • Support 50 custom variables (Note: this feature is available to Google Analytics Premium users only).

This release contains:

  • Added social tracking method to GAITracker :
    • trackSocial:withAction:withTarget:
  • Timing method signature changed to:
    • trackTiming:withValue:withName:withLabel:
  • Manual construction and dispatch methods added to GAITracker:
    • set:value:
    • get:
    • send:params:
  • Custom dimension setter methods added to GAITracker:
    • setCustom:dimension:
    • setCustom:metric:
  • Architecture of data store refactored to prevent reported CoreData issues.

This release contains:

  • Added support for custom dimensions and metrics.
  • Added support for social interaction tracking.
  • Made StandardExceptionParser class public
  • Fixed occasional crashes during initialization of the SDK.
  • Fixed INSTALL_REFERRER broadcasts being ignored on some devices.
  • Fixed ConcurrentModificationExceptions in GoogleTracker class.
  • Other bugfixes and enhancements

This is the initial release of the Multi-Channel Funnels Reporting API:

  • This new API enables you to request Multi-Channel Funnels data for an authenticated user. Data is derived from conversion path data, which shows user interactions with various traffic sources over multiple visits prior to converting. This allows you to analyze how multiple marketing channels influence conversions over time. For more details on what data is available and how to use the API see Multi-Channel Funnels Reporting API .

This release contains:

  • Updated to latest wire format.
  • sampleRate changed to double-precision float.
  • Excessive tracking is throttled.
  • Undispatched tracking information is deleted when opt-out is enabled.
  • Undispatched tracking information older than 30 days will be deleted.
  • Enhancements to hit dispatcher.
  • Rather than periodically retry, the dispatcher will use the Reachability API when connectivity is lost to get notified when connectivity is reestablished.
  • Updated example app.
  • Other bugfixes and enhancements.

This release contains:

  • Simplified EasyTracker interface.
  • Control of dispatching moved to a new class, GAServiceManager .
  • Updated to latest wire format.
  • sampleRate changed to double.
  • Excessive tracking is throttled.
  • Undispatched tracking information is deleted when opt-out is enabled.
  • Undispatched tracking information older than 30 days will be deleted.
  • Other bugfixes and enhancements.

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

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

This release contains:

  • Added uncaught exception handling facility.
  • Removed dispatchEnabled property from GAI .
  • Added defaultTracker property to GAI .
  • Added close method to GAITracker .
  • Added timing tracking method to GAITracker .
  • Added trackView method to GAITracker which takes no argument.
  • Transaction item field names updated.
  • Updated to latest wire format.
  • Event value is interpreted as a 64-bit integer.
  • ARMV6 code generation switched from THUMB to ARM.

This release contains:

  • startSession method has been removed. Use setStartSession instead.
  • Added ga_sessionTimeout parameter to EasyTracker.
  • Implemented power save mode.
  • Added trackView method to GAITracker which takes no argument.
  • Fixed a bug that prevented exception parameters from being sent on hits.
  • Hits that can't be read from the database are discarded instead of permanently blocking all hits from being dispatched.
  • Updated to latest wire format.
  • Implemented timing hit type.
  • Implemented Ecommerce hit types (transaction and item).

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

The following changes have been pushed to the latest version of the tracking code:

  • The maximum allowed site speed sample rate ( _setSiteSpeedSampleRate ) has been increased from 10% to 100%.
  • The _setAccount method now trims any leading and trailing spaces.

This release fixes 2 bugs:

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

  • Query filters that contain special characters inside regular expressions no longer return server errors.

  • Combining a metric filter with an advanced segment no longer returns an error.

This release add new site speed metrics to the API.

Новые метрики

  • The following site speed metrics have been added:
    • ga:speedMetricsSample
    • ga:domainLookupTime
    • ga:pageDownloadTime
    • ga:redirectionTime
    • ga:serverConnectionTime
    • ga:serverResponseTime
    • ga:avgDomainLookupTime
    • ga:avgPageDownloadTime
    • ga:avgRedirectionTime
    • ga:avgServerConnectionTime
    • ga:avgServerResponseTime

Check the Dimensions and Metrics Reference for definitions.

API Version 2.3 Deprecation Reminder

  • Version 2.3 of the Data Export API has been depreacted for 2 months. In roughly 4 more months we will shut down this service and only support the new Core Reporting API version 3.0 and version 2.4 .

  • We highly recommend you migrate your applications to version 3.0.

  • In 4 months requests to the legacy version 2.3 XML data feed will be forwarded to version 2.4 and return a version 2.4 XML response. At that point, all version 2.4 quota policies will apply to the version 2.3 requests.

  • All requests for version 2.3 JSON or the Google Data JavaScript client library that uses version 2.3 JSON output, will return 404 status codes.

  • To get full quota, both version 3.0 and version 2.4 require you to register your application in the Google APIs Console and use an API key (or OAuth 2.0 token) in each request.

The following changes have been pushed to the latest version of the tracking code:

  • Updated the list of organic search engines detected by default. Added 'startsiden.no', 'rakuten.co.jp', 'biglobe.ne.jp', and 'goo.ne.jp'. Removed 'search' and added 'conduit.com', 'babylon.com', 'search-results.com', 'avg.com', 'comcast.net', and 'incredimail.com' all of which were previously attributed together as 'search'.

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

This release adds helpful error responses to the Management API.

  • New error codes, reasons, and descriptions have been added to the body of API error responses. All the codes have been documented for both the versions - Version 2.4 and Version 3.0 - of the Management API.

The following changes have been pushed to the latest version of the tracking code:

  • The limit on custom variable length has been increased from 64 to 128 characters. Additionally, the length is now checked before URL encoding.
  • The rate limit for event hits has been relaxed. You can now send 10 hits with 1 additional hit per second (previously this was limited to 1 hit every 5 seconds). Note that the 500 hits per session limit still applies.
  • __utmv cookies are now written with a different variable separator (caret instead of comma) to be compatible with RFCs. This should fix some of the issues related to cookie encoding issues seen by customers.

This release effects all Google Analytics API developers. It announces two new versions of the API, requires applications to register, introduces a new quota policy, and it changes the API name to the Core Reporting API. Finally it deprecates the existing Data Export API version 2.3.

Версия 3.0

  • The Core Reporting API version 3.0 is the latest major version of our API and is not backwards compatible. All future development of the API will be done on this version.

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

    • New JSON based output reduces the size of the response ~10x from the previous XML output.
    • New Google API client libraries that support Java, JavaScript, Python, PHP, Ruby, and .Net.
    • Support for the Google Discovery API .
    • Support for OAuth 2.0 as the new, recommended way to authorize users.
  • Обновления

    • New URL to make requests: https://www.googleapis.com/analytics/v3/data/ga… .
    • Registration and developers tokens required.
    • All requests for configuration data should be done through the Management API .

Версия 2.4

  • The Core Reporting API version 2.4 is a minor version upgrade that is mostly backwards compatible with the existing Data Export API version 2.3.

  • Обновления

    • New URL to make requests: https://www.googleapis.com/analytics/v2.4/data…
    • Registration and developers tokens required.
    • XML output consistent with version 2.3, so the other existing Google Data client libraries will continue to work.
    • Error code for quota errors have changed from 503 to 403
    • JSON responses are not supported.
    • Google Data JavaScript client library not supported.
    • No Account Feed. All requests for configuration data should be done through the Management API .

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

  • All applications built using the Google Analytics API must be registered as a project through the Google APIs Console .

  • Each request to the API must include either a API key or for OAuth 2.0, a Client Id and Client Secret.

Политика квот

  • The following quota applies to both Anlaytics APIs (Management API and Data Export API)

    • 50,000 requests per project per day
    • 10 queries per second (QPS) per IP address
  • The following quota applies to the Data Export API

    • 10,000 requests per profile per day
    • 10 concurrent requests per profile
  • For unregistered applications, we provide a very low grace quota to accommodate a small amount of testing.

Устаревания

  • This release also announces the deprecation of Version 2.3 and the upcoming shut down of the Account Feed in the Data Export API. In 6 months:

    • Requests to the version 2.3 XML data feed will be forwarded to version 2.4 and return a version 2.4 response. At that point, all version 2.4 quota policies will apply to the version 2.3 requests.

    • Requests to the version 2.3 JSON output will not be supported by the version 2.4 response and will return 404 Not Found status codes. If you need a JSON response, upgrade to Version 3.0.

    • Requests to the Account Feed in the Data Export API will return 404 Not Found status codes. All requests for configuration data should be done through the Management API .

This release adds data, changes existing functionality and fixes a bug.

Новые данные

  • The Advanced Segment collection now contains a segmentId field that can be used in the Data Export API segment parameter.

Изменения

  • The data type for max-results has been changed to integer .

  • The default and maximum value for max-results has been changed to 1000.

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

  • Accounts, web properties, and profiles for Google Website Optimizer experiments are no longer included in their corresponding collections.

This release contains:

  • Документация:

    • The ReadMe.txt has been updated to point to the website for documentation.

This release contains:

  • Исправление ошибок:
    • Fixed handling of Destination URL Autotracking from Google Play.
    • Allow the referrer parameter to setReferrer to be url-encoded.

Changes to Site Speed data collection:

  • Site speed data is now automatically collected for all web properties at a 1% sample rate. The _trackPageLoadTime function, previously required to opt-in to site speed data collection, is now deprecated.
  • The default sample rate may be adjusted using the new _setSiteSpeedSampleRate function.
  • If a virtual path is used in the _trackPageview call, that path will now also be associated with any site speed data collected from that page.

This release contains:

  • Исправление ошибок:
    • Changed location of the database to from the Documents directory to the Library directory.
    • The SDK no longer throws NSAsserts for SQLite database errors.
    • Fixed crash when calling trackPageview with an empty string.
    • Fixed crashes when calling various GANTracker methods after stopTracker was called.
    • Fixed several memory leaks, including one calling trackPageview with a pageURL that begins with '/'.
  • Новые возможности:
    • Added dispatchSynchronously method.
    • Exposed several useful constants (see GANTracker.h).

This release contains:

  • Исправление ошибок:
    • Trapped and handled several SQLiteExceptions .
    • Fixed NullPointerException in stopSession if called prior to calling startNewSession .
    • Fixed Out Of Memory errors on HTC Thunderbolt and Motorola Droid Bionic devices.
    • Eliminated unnecessary database access in the dispatch method.

This release contains the following new feature:

  • Events can be marked as non-interaction by setting the new opt_noninteraction parameter of the _trackEvent() method to true . Marking an event as non-interaction indicates that hits from the tagged event will not impact bounce rate. For more information, see the ga.js reference .

This release contains the following bug fix:

  • Fixed an issue where propagating the AdWords gclid URL parameter on internal site links could result in inflated paid visit counts.

This release adds fresher AdWords data and more combinations for AdWords dimensions and metrics.

  • AdWords data is now updated within an hour. Before the data was updated daily.

  • We've relaxed a number valid combinations restrictions with AdWords data.

A few weeks ago we made a change to disallow API queries that asked for ga:adGroup or ga:adContent with ga:impressions , since this combination returned 0. With this change, this combination is now back and has been fixed to return correct data .

This release contains:

  • Исправление ошибок:
    • Fixed bus error when attempting to set dryRun flag prior to starting the tracker.
    • Fixed bus error when attempting to pass NULL for error.
    • Use correct language in HTTP header.
  • Новые возможности:
    • Added anonymizeIp flag.
    • Added sampleRate parameter.
    • Added support for campaign referrals.

This release contains:

  • Исправление ошибок:
    • Fixed bug in general campaign referral tracking.
    • Fixed anonymizeIp flag interfering with campaign tracking.

This release adds two new versions of the API with many new features, and it deprecates the old version. The changes impact the way you request and handle data from the API.

Версия 3.0

  • This is the latest major version of our API and is not backwards compatible. All future development of the API will be done on this version.

  • Новые данные

    • Full representation of event goals
    • An internal web property ID that can be used to deep link into the GA user interface
    • Profile configurations for the default page and site search query parameters
  • Изменения

Версия 2.4

  • This is a minor version upgrade that is mostly backwards compatible with the existing Version 2.3.

  • Изменения

    • A new quota policy
    • Integration with the Google APIs Console to manage API access and request more quota
    • Continued support for existing authorization mechanisms and OAuth 2.0
    • New URL to make requests: https://www.googleapis.com/analytics/v2.4/management/…
    • Responses in XML only
    • No support for the Google Data JavaScript client library
    • XML output consistent with version 2.3, so the other existing Google Data client libraries will continue to work.

Устаревание

  • We are announcing the deprecation of the legacy version 2.3 of the Management API. It will continue to work for two months, after which all v2.3 requests will return a v2.4 response.

This release fixes a bug which caused inflated numbers of visits and/or a decrease in the number of new visitors for some sites. The first effect primarily affected sites with organic traffic coupled with specific user behavior. The second effect was only on sites using an unsupported tracking configuration with multiple trackers.

This release fixes some invalid combinations of dimensions and metrics

Fixed invalid metrics/dimensions combinations

  • Last month we announced some upcoming changes to the API to disallow some invalid queries in the data feed that do not return any data. We have now made those changes to the API, and the following combinations are now invalid:

    • Product dimensions cannot be combined with transaction metrics.
    • ga:adContent or ga:adGroup cannot be combined with ga:impressions .

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

Changes to session calculations:

  • One campaign per session: If a new campaign is started during an existing session, the tracking script will now automatically start a new session. A new campaign will be triggered by a change to any of the following fields: campaign id, name, source, medium, term, content, or gclid.
  • The tracking script no longer starts a new session in the event that a user closes the browser.

Changes to cross-domain tracking:

  • The call to _setAllowHash(false) is no longer required when configuring cross-domain tracking. Pages that already include a call to _setAllowHash(false) will continue to work, but it is no longer required when setting up a new site.
  • The tracking script will now attempt to repair linker parameters that have been mangled by HTTP redirectors and browsers. Approximately 85% of linker values that are currently discarded due to encoding changes introduced by redirectors and browsers should now be successfully restored and accepted by the tracking script.

This release contains:

  • Исправление ошибок:
    • Fixed several issues in database handling.
    • Fixed exceptions while using custom variables.
    • Hold the application context instead of the context passed into it.
    • Removed the ability to accidently create phantom sessions.
  • Новые возможности:
    • Added the ability to set campaign referrals at any time
    • Added sampleRate flag
    • Added anonymizeIp flag

This release contains one new feature:

  • The tracking code now postpones hits for prerendered pages until those pages are viewed by the user. If a prerendered page is never viewed, no hits are sent. This feature is only available to sites using the async tracking script. You can learn more about prerendering in Google Webmaster Central Blog .

This release contains a variety of bug fixes and refactorings, and one new feature:

This release deprecates the confidence interval value in metrics.

Deprecation of Confidence Interval

  • If you haven't already done so, please stop using confidence interval values for metrics. With this release, the Data Export API Data Feed returns 0.0 for all the confidence interval values. In a month or so, we will we will completely remove this attribute from all metric elements.

    To determine if a response has been sampled, please use the containsSampledData field in the response.

This release contains:

  • Исправление ошибок:
    • Fixed crash when using custom variables.
    • Fixed memory leaks when using custom variables.
  • Новые возможности:
    • Added support for Ecommerce hits.
    • Added Debug flag.
    • Added DryRun flag.
    • More descriptive error information on SQLite3 failures

This release contains:

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

    • Fixed badly formatted userAgent String.
  • Новые возможности:

    • Added support for Ecommerce tracking
    • Added debug flag
    • Added dryRun flag

This release adds 3 new metrics and updates the return value of two.

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

  • We added 3 new metrics dealing with site speed performance to the API:
    • ga:pageLoadSample
    • ga:pageLoadTime
    • ga:avgPageLoadTime

Metric Updates

  • To specify currency values in filters, you must specify the actual value passed in from the tracking code, (eg 1 unit will now be specified as 1).

  • ga:CTR now returns the actual percent (eg a value of 2% is returned as 2).

This release contains the following bug fixes.

  • Fixed a bug in cross domain tracking that caused incorrect encoding of campaign data in some cases.
  • Fixed a bug in cross domain tracking that caused cookies to be loaded from the URL more than once, causing incorrect cookies in some cases.
  • Fixed a bug in Custom Variables that caused some values to be encoded in reports.

This release contains:

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

    • Fixed improper encoding of spaces.
    • SQLiteExceptions no longer cause apps to crash.
  • Новые возможности:

    • Added support for custom variables

This release improves improves Data Feed performance and adds new data:

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

  • This release improves data feed latency by 30 to 35%.

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

  • We have updated the list of dimensions and metrics that are allowed in Advanced Segments. Please refer to the updated list to make sure that your requests are valid.

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

  • Currently, you need to specify a currency filter value as micro units, (eg 1 unit of currency is specified as 1000000). In the near future, you will need to specify the actual value passed in from the tracking code, (eg 1 unit will now be specified as 1).

  • Currently, ga:CTR is a percent and returns the value 0.02. In the near future this will change to return the actual percent (eg 2).

This release contains regular maintenance including bug fixes and refactorings. There is no change to the public APIs or functionality.

This release contains updates and one new feature.

  • POST support:

    • The tracking code can now send much larger tracking beacons. Traditionally, beacons have been sent via HTTP GET requests, which are limited to 2048 characters by some browsers and proxies. Requests over this limit were dropped and the data never reached Google Analytics. Starting with this release, requests longer than 2048 characters will be sent via HTTP POST , which has no such limit. The tracking code will now support beacons up to 8192 characters.

This release adds more data to the Data Feed:

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

  • The following Time dimension has been added: ga:dayOfWeek

  • The following Internal Search metric has been added: ga:percentVisitsWithSearch

  • The following Event Tracking metrics have been added:

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

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

Currently the API returns 401 status codes for for various authorization issues. Within the next couple of weeks, the 401 status will be used exclusively for invalid tokens, giving developers a way to error handle this particular exception.

This release contains the following bug fixes.

  • Fixed a bug that prevented _addIgnoredOrganic and _addIgnoredRef from working properly on the first visit to a site.
  • Fixed an issue related to tracking code running across multiple iframes.

This release contains:

  • Новые возможности:
    • Added support for custom variables.
    • Added NoThumb version of the library.

This release adds significantly more data to the Data Feed:

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

  • The calculation of ga:visitors has been changed to return the number of unique visitors across the date range and now supports more dimension and metric combinations.

  • 10 new AdWords dimensions have been added: ga:adDistributionNetwork , ga:adMatchType , ga:adMatchedQuery , ga:adPlacementDomain , ga:adPlacementUrl , ga:adFormat , ga:adTargetingType , ga:adTargetingOption , ga:adDisplayUrl , ga:adDestinationUrl .

  • The metric ga:organicSearches has been added to the campaign group.

  • The metric ga:searchResultViews has been added to the internal site search group.

  • 3 new time-based dimensions have been added: ga:nthDay , ga:nthWeek , ga:nthMonth .

  • The groupings of dimensions and metrics have been changed to better reflect the features they represent.

New Calculated Metrics

The following calculated metrics are derived from calculations using the base metrics. Note: Each name with (n) supports values 1-20.

  • Goal Based: ga:costPerConversion , ga:costPerGoalConversion , ga:costPerTransaction , ga:goal(n)AbandonRate , ga:goal(n)Abandons , ga:goal(n)ConversionRate , ga:goalAbandonRateAll , ga:goalAbandonsAll , ga:goalConversionRateAll , ga:goalValueAllPerSearch , ga:goalValuePerVisit .

  • Content Based: ga:entranceBounceRate , ga:visitBounceRate , ga:entranceRate , ga:exitRate , ga:pageviewsPerVisit , ga:avgTimeOnPage , ga:avgTimeOnSite , ga:avgEventValue .

  • Internal Site Search Based: ga:avgSearchDepth , ga:avgSearchDuration , ga:avgSearchResultViews , ga:searchGoalConversionRateAll , ga:searchGoal(n)ConversionRate , ga:searchExitRate .

  • Ecommerce Based: ga:itemsPerPurchase , ga:margin , ga:percentNewVisits , ga:revenuePerItem , ga:revenuePerTransaction , ga:ROI , ga:RPC , ga:totalValue , ga:transactionRevenuePerVisit , ga:transactionsPerVisit .

This release adds a new feature to the Data Feed:

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

  • A new XML element has been added lets users know if the data has been sampled. true . This element will always return whether the data was sampled or not with either true or false . The Java and JavaScript libraries have also been updated with helper methods to access this element.

This release contains regular maintenance including bug fixes and refactorings. There is no change to the public APIs or functionality.

This release contains:

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

    • Added iOS4 support

This release fixes 2 bugs:

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

  • Previously adding an OR operator to a filter expression with a dimension (ie, ga:keyword==store,ga:keyword==bar ) could result in different values than if each filter was applied individually across multiple queries. This has been fixed and using the OR operator now returns consistent values.

  • Some of the API error messages for invalid filters have been updated to NOT include whether it was a dimension or metric filter that caused the error (though the actual offending filter expression will continue to be returned).

This is the beta release of the Google Analytics Management API!

Новые каналы

Updated Client Libraries

  • The Management API is being released in the same library as the Google Analytics Data Export API. Both Google Data Java and JavaScript libraries have been updated. Each feed can be accessed by specifying the appropriate feed URI to the libraries getManagementFeed() method.

Новая документация

  • A new section of the Google Analytics developer docs has been created to describe how the new Management API works.

This release fixes 3 bugs:

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

  • An encoding issue in the JavaScript Client Library has been fixed. Analytics issue tracker

  • A bug that prevented the Account Feed to not return when a goal name, goal path, goal comparison value, or goal comparison type had been incorrectly set, has now been fixed.

  • It is invalid to OR a dimension and metric in the Data Feed query filter parameter. For example: ga:source==google,ga:visits>5 . The error message for this invalid query has been updated to say: Cannot OR dimension filter(s) with metric filter .

This release adds new data and fixes a bug:

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

  • The following 5 dimensions have been added in the new category D8. Adwords :

    • ga:adwordsAdGroupId : corresponds to the AdWords API AdGroup.id
    • ga:adwordsCampaignId : corresponds to the AdWords API Campaign.id
    • ga:adwordsCreativeId : corresponds to the AdWords API Ad.id
    • ga:adwordsCriteriaId : corresponds to the AdWords API Criterion.id
    • ga:adwordsCustomerId : cooresponds to the AdWords API AccountInfo.customerId

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

  • We fixed an issue where the Account Feed would not return data if one of the profiles had a misconfigured goal or step.

This release contains bug fixes and API cleanup.

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

    • Fixed event tracking bug. Calling _trackEvent no longer requires calling _initData or _trackPageview first.
    • Updated async snippet so that it can be placed in the head on any page without causing problems in IE 6 and 7. See the Asynchronous Tracking Guide for the new snippet. This update occurred on 3/22/2010.
    • Expanded async syntax to support calling methods on the _gat object.
  • Updated tracker initialization APIs to be consistent with async syntax. Also deprecated old functions.

    • Added _gat._createTracker(opt_account, opt_name) function. Allows trackers to be named and later retrieved by their name.Use this instead of _gat._getTracker(account) .
    • Added _gat._getTrackerByName(name) . Retrieves the tracker with the given name.
    • Added tracker._getName() . Returns the name given to the tracker when it was created.
    • Deprecated _gaq._createAsyncTracker(account, opt_name) . Use _gat._createTracker instead.
    • Deprecated _gaq._getAsyncTracker(name) . Use _gat._getTrackerByName instead.
  • See the Tracker Reference for details on these API changes.

This release adds a number of new features and fixes a bug:

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

  • The iPhone Default Segment (gaid::-11) has been enhanced to now report on all mobile devices . The ID is the same as before (-11), but the name of the segment is now: Mobile Traffic .

  • The sampling rate used by the API is now the same as the web interface. This brings the data for sampled reports inline with the web interface and increases consistency between the two.

  • The quota policy has been updated in an effort to ensure that all users receive equitable access to resources. Please refer to our quota policy documentation for more details. The new policy is:

    • A single web property may make a maximum of 10,000 requests per 24 hours.
    • An application can only make 10 requests in any given 1-second period.
    • An application can only have 4 pending requests at any given time.
  • Some restrictions on dimension and metric combinations have been relaxed. ga:nextPagePath and ga:previousPagePath are now part of the D3. Content group. The D8. Custom Variable group is now called the D6. Custom Variable group. Please see the updated reference guide for these new combinations.

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

  • We fixed a bug on how the API reports the confidenceInterval value for metrics. Previously confidence intervals could have a value of either INF or a number from 0 to 1. Now all confidence intervals will have a value of either INF or a number greater than or equal to 0.

  • ga:itemQuantity and ga:uniquePurchases were previously swapped and returned each other's value. They are now fixed to return the correct data.

Deprecation of Dimensions and Metrics Reminder

  • If you haven't done so already, please stop using the previously deprecated dimensions and metrics

This release adds a number of new features:

This release increments the major version number to 2

  • Some features require the use of the latest client libraries. We officially support: Java & Javascript . 3rd party libraries might not be updated yet.

    • Version 2 may be requested by adding the header GData-Version: 2 to each account or data feed request Read the documentation for more details.
    • A new XML namespace has been added to both account and data feeds:
      xmlns:ga='http://schemas.google.com/ga/2009'
  • The API now supports the Google Data protocol version 2 .

Расширенная поддержка сегментации

  • Dynamic segments query parameter:

    • ...&segment=dynamic:: expression
    • allows creation of advanced segments “on the fly.”
    • expression can be any dimension or metric and should follow the same syntax as filters.
  • Default and custom segments query parameter:

    • ...&segment=gaid:: number
    • where number is an ID referencing an advanced segment defined in the Google Analytics Web Interface.
    • ID can be found in the account feed.
  • The account feed describes segment data through the following XML elements and attributes:

    • <dxp:segment id="gaid::-3" name="Returning Visitors"></dxp:segment>
    • <dxp:definition>ga:visitorType==Returning Visitor</dxp:definition>
  • The data feed also provides an XML element indicating whether a segment was applied in the API request.

  • More details on advanced segments in our documentation .

New goal data available

  • Destination and engagement type goals available in the account feed:

    • <ga:goal active="true" name="Completing Order" number="1" value="10.0"></ga:goal>
    • <ga:destination expression="/purchaseComplete.html" matchtype="regex" step1required="false" casesensitive="false"></ga:destination>
    • <ga:step number="1" name="Login" path="/login.html"></ga:step>
    • <ga:engagement comparison=">" thresholdvalue="300" type="timeOnSite"></ga:engagement>
  • 48 new goal metrics have been added for goals 5-20 which all follow the convention goal(n)Completions , where (n) is a number between 1 and 20.

    • ga:goal(n)Completions
    • ga:goal(n)Starts
    • ga:goal(n)Value
  • GoalCompletionAll , GoalStartsAll and GoalValueAll have been updated to account for the new goal data.

Новые данные пользовательской переменной

  • All custom variables ever collected by each profile have been added as a new XML element to the account feed:

    • <ga:customvariable index="1" name="category" scope="visitor"></ga:customvariable>
  • 10 new dimensions have been added for custom variables. They follow the convention customVar(n) where (n) can be a number between 1 and 5.

    • ga:customVarName(n)
    • ga:customVarValue(n)

Deprecated dimensions & metrics to be removed!

  • If you haven't done so already, please stop using the previously deprecated dimensions and metrics. They will be removed soon and will return errors from our API if requested.

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • The following dimensions have been renamed:

    • ga:countOfVisits is now ga:visitCount
    • ga:countOfVisitsToATransaction is now ga:visitsToTransaction

This release contains updates to the default search engine list and new functions to control cookie timeouts. In addition, the asynchronous GA snippet is launched that reduces the ga.js latency impact on the page.

  • Updated the default search engine list

    • Added Naver, Eniro and Daum search engines.
    • Removed Looksmart, Gigablast, Club-internet, Netsprint, Intera, Nostrum and Ilse from the list.
  • Added functions to control cookie expiration times for all stored cookies. Deprecated existing cookie timeout functions. See the JS API documentation for more details.

    • _setVisitorCookieTimeout(cookieTimeoutMillis) replaces the _setCookiePersistence function.
    • _setSessionCookieTimeout(cookieTimeoutMillis) replaces the _setSessionTimeout function.
    • _setCampaignCookieTimeout(cookieTimeoutMillis) replaces the _setCookieTimeout function.
  • Launched asynchronous GA snippet. See documentation on how to try it out.

  • _setVar function is now deprecated. Custom Variables feature replaces _setVar . See documentation for more details.

This release contains:

  • Added a new function to retrieve visitor level custom variables. See the function documentation for more details.

    • _getVisitorCustomVar(index)
  • Instead of waiting for window.onload, Site Overlay content is loaded as soon as ga.js is executed.

This release contains a new feature:

  • Added an optional boolean parameter to _addOrganic function to specify if new organic sources are added to the beginning or the end of the organic source list. See the documentation for more details.

    • _addOrganic(newOrganicEngine, newOrganicKeyword, opt_prepend)

This release contains regular maintenance for performance improvements and refactorings. There is no change to the public APIs or functionality.

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 contains multiple bug fixes and performance improvements:

  • Proper encoding for search terms for organic searches, web page path info for (utmp), and user defined values when used with the linker feature (ie: _link and _linkByPost functions).
  • The search engine Rambler is added to the organic search list
  • Organic search parsing is corrected for search engine http://kvasir.no
  • New organic search engines defined by the user are now added to the top of the list
  • Removed deprecated _trackEvent(action, label, value) function and replaced it with _trackEvent(category, action, label, value)
  • Referrer URLs are now stored as case sensitive. For example: www.domain.com/PaGe.HtMl will be reported with case information.
  • Added a 1200 character limitation to GASO token size.
  • New function was added to allow overriding the default timeouts for cookies: _setCookiePersistence(timeout)

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).
    <dxp:property name="ga:currency" value="USD"></dxp:property>
    <dxp:property name="ga:timezone" value="America/Los_Angeles"></dxp:property>

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

  • All previous deprecation changes have taken effect.

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