Все журналы изменений в API Google Аналитики

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

Подписка на журналы изменений

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

Это первый выпуск User Activity API

  • С помощью User Activity API можно получать все данные, связанные с Client ID или User ID, за определенный период. Это дает возможность владельцу ресурса предоставлять пользователям автоматизированный доступ к их данным. Подробнее…

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

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

Это первый выпуск User Deletion API:

  • С помощью User Deletion API клиент Google Аналитики может удалить данные, связанные с определенным идентификатором пользователя, из проекта или веб-ресурса. Запросы на удаление отправляются через проекты Firebase или ресурсы Google Аналитики. Подробнее…

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

Операции записи в Management API (например, create, update, delete, patch) для веб-ресурсов, представлений (профилей) и целей стали общедоступными. Дневной лимит по умолчанию: 50 операций. Подробнее…

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

Раньше вызовы Analytics Real Time Reporting API учитывались для ограничения 10 000 вызовов в день на представление (профиль) вместе с запросами к другим API Google Аналитики. Теперь вызовы Analytics Real Time Reporting API учитываются отдельно, то есть вы можете выполнить 10 000 запросов в сутки на представление (профиль) с помощью этого API И ещё столько же – с помощью других. Подробнее…

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

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

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

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

Добавлен источник перехода android-app://.

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

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

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

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

В этот выпуске добавлена поддержка Google Оптимизации, OPTIMIZE – тип связанного аккаунта Google Рекламы. Подробная информация приведена в статьях Аудитории ремаркетинга и Руководство для разработчиков по аудиториям ремаркетинга.

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

Время

  • Добавлен новый параметр 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 – общее количество пользователей, проявлявших активность за последний день, для каждого дня в указанном периоде времени.
  • ga:7dayusers – общее количество пользователей, проявлявших активность за последние 7 дней, для каждого дня в указанном периоде времени.
  • ga:14dayusers – общее количество пользователей, проявлявших активность за последние 14 дней, для каждого дня в указанном периоде времени.
  • ga:30dayusers – общее количество пользователей, проявлявших активность за последние 30 дней, для каждого дня в указанном периоде времени.

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

Период прекращения поддержки ga:uniqueEvents почти завершен. 26 марта 2017 г. определение ga:uniqueEvents будет изменено, а личный показатель ga:uniqueEventsTemporary – удален из API. Подробнее…

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

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

  • Параметр ga:userBucket: определяет номер сегмента (от 1 до 100), к которому отнесен тот или иной пользователь. Подробнее…

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

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

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

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

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

В этом выпуске исправлена ошибка, при которой создание специального показателя типа TIME приводило к ошибке, если не было задано значение min_value. Теперь при отсутствии значения min_value создается специальный показатель с min_value = 0.

В этом выпуске исправлена ошибка параметров и показателей AdSense и анонсировано изменение этих параметров и показателей.

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

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

Запланированные изменения

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

В этой версии внесены следующие изменения:

Google Аналитика

  • Обеспечена совместимость с iOS 10, исправлены ошибки.

В этой версии внесены следующие изменения:

Google Аналитика

  • Устранены ошибки, вызывающие сбои.

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

DoubleClick Bid Manager

  • Показатель – ga:dbmClickAdvertiser – название рекламодателя DBM для клика DBM, соответствующего сеансу Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmClickAdvertiserId – идентификатор рекламодателя DBM для клика DBM, соответствующего сеансу Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmClickCreativeId – идентификатор объявления DBM для клика DBM, соответствующего сеансу Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmClickExchange – название аукциона DBM для клика DBM, соответствующего сеансу Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmClickExchangeId – идентификатор аукциона DBM для клика DBM, соответствующего сеансу Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmClickInsertionOrder – название заказа на размещение в DBM для клика DBM, соответствующего сеансу Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmClickInsertionOrderId – идентификатор заказа на размещение в DBM для клика DBM, соответствующего сеансу Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmClickLineItem – название позиции DBM для клика DBM, соответствующего сеансу Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmClickLineItemId – идентификатор позиции DBM для клика DBM, соответствующего сеансу Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmClickSite – название сайта в DBM, на котором пользователь увидел объявление DBM и нажал на него, для клика DBM, соответствующее сеансу Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmClickSiteId – идентификатор сайта в DBM, на котором пользователь увидел объявление DBM и нажал на него, для клика DBM, соответствующий сеансу Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmLastEventAdvertiser – название рекламодателя DBM для последнего события DBM (показа или клика в период ретроспективного анализа), связанного с сеансом Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmLastEventAdvertiserId – идентификатор рекламодателя DBM для последнего события DBM (показа или клика в период ретроспективного анализа), связанного с сеансом Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmLastEventCreativeId – идентификатор объявления DBM для последнего события DBM (показа или клика в период ретроспективного анализа), связанного с сеансом Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmLastEventExchange – название аукциона DBM для последнего события DBM (показа или клика в период ретроспективного анализа), связанного с сеансом Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmLastEventExchangeId – идентификатор аукциона DBM для последнего события DBM (показа или клика в период ретроспективного анализа), связанного с сеансом Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmLastEventInsertionOrder – название заказа на размещение в DBM для последнего события DBM (показа или клика в период ретроспективного анализа), связанного с сеансом Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmLastEventInsertionOrderId – идентификатор заказа на размещение в DBM для последнего события DBM (показа или клика в период ретроспективного анализа), связанного с сеансом Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmLastEventLineItem – название позиции DBM для последнего события DBM (показа или клика в период ретроспективного анализа), связанного с сеансом Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmLastEventLineItemId – идентификатор позиции DBM для последнего события DBM (показа или клика в период ретроспективного анализа), связанного с сеансом Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmLastEventSite – название сайта в DBM, на котором пользователь увидел объявление DBM и нажал на него, для последнего события DBM (показа или клика в период ретроспективного анализа), связанное с сеансом Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmLastEventSiteId – идентификатор сайта в DBM, на котором пользователь увидел объявление DBM и нажал на него, для последнего события DBM (показа или клика в период ретроспективного анализа), связанный с сеансом Google Аналитики (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmCPA – эффективная цена за конверсию на основе дохода в DBM (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmCPC – оптимизированная цена за клик на основе дохода в DBM (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmCPM – эффективная цена за тысячу показов на основе дохода в DBM (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmCTR – CTR в DBM (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmClicks – общее число кликов DBM (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmConversions – общее число конверсий DBM (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmCost – расходы в DBM (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmImpressions – общее число показов DBM (только для Аналитики 360, интегрированной с DBM).
  • Показатель – ga:dbmROAS – рентабельность инвестиций в рекламу для DBM (только для Аналитики 360, интегрированной с DBM).
  • Параметр – ga:dsAdGroup – группа объявлений DS (только для Аналитики 360, интегрированной с DBM).
  • Параметр – ga:dsAdGroupId – идентификатор группы объявлений DS (только для Аналитики 360, интегрированной с DBM).
  • Параметр – ga:dsAdvertiser – рекламодатель DS (только для Аналитики 360, интегрированной с DBM).
  • Параметр – ga:dsAdvertiserId – идентификатор рекламодателя DS (только для Аналитики 360, интегрированной с DBM).
  • Параметр – ga:dsAgency – агентство DS (только для Аналитики 360, интегрированной с DBM).
  • Параметр – ga:dsAgencyId – идентификатор агентства DS (только для Аналитики 360, интегрированной с DBM).
  • Параметр – ga:dsCampaign – кампания DS (только для Аналитики 360, интегрированной с DBM).
  • Параметр – ga:dsCampaignId – идентификатор кампании DS (только для Аналитики 360, интегрированной с DBM).
  • Параметр – ga:dsEngineAccount – системный аккаунт DS (только для Аналитики 360, интегрированной с DBM).
  • Параметр – ga:dsEngineAccountId – идентификатор системного аккаунта DS (только для Аналитики 360, интегрированной с DBM).
  • Параметр – ga:dsKeyword – ключевое слово DS (только для Аналитики 360, интегрированной с DBM).
  • Параметр – ga:dsKeywordId – идентификатор ключевого слова DS (только для Аналитики 360, интегрированной с DBM).
  • ga:dsCPC – расходы рекламодателя на клик DS (только для Аналитики 360, интегрированной с DBM).
  • ga:dsCTR – CTR в DS (только для Аналитики 360, интегрированной с DBM).
  • ga:dsClicks – клики DS (только для Аналитики 360, интегрированной с DBM).
  • ga:dsCost – расходы в DS (только для Аналитики 360, интегрированной с DBM).
  • ga:dsImpressions – показы DS (только для Аналитики 360, интегрированной с DBM).
  • ga:dsProfit – профиль DS (только для Аналитики 360, интегрированной с DBM).
  • ga:dsReturnOnAdSpend – рентабельность инвестиций в рекламу для DS (только для Аналитики 360, интегрированной с DBM).
  • ga:dsRevenuePerClick – доход от клика DS (только для Аналитики 360, интегрированной с DBM).

Валюты

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

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

Подробная информация приведена в справочных материалах по представлениям (профилям) и валютам.

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

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

Management API позволяет выполнять действия create, get, list, update и patch с аудиториями ремаркетинга для ресурса Google Аналитики. Подробную информацию об аудиториях ремаркетинга в Google Аналитике можно найти в этой статье Справочного центра.

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

Идентификатор транзакции

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

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

Местоположение/сеть

  • Параметр – ga:continentId – идентификатор континента пользователя. Определяется по IP-адресу или географическому идентификатору.

Ограничения

Приведенные ниже параметры указанных групп нельзя запрашивать вместе с параметрами из других групп.

  • Visit Shopping Info Group
    • ga:checkoutOptions
    • ga:shoppingStage
  • GWO Experiment Group
    • ga:experimentVariant
    • ga:experimentId
  • Interest Group
    • ga:interestOtherCategory
  • In Market Interest Group
    • ga:interestInMarketCategory
  • Internal Promotion Group
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • Branding Interest Group
    • ga:interestAffinityCategory

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

Ошибки в запросах отчетов

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

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

Ограничения для сводок

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

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

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

Местоположение/сеть

  • Параметр – ga:metroId – трехзначный код медиарынка, к которому относится посетитель. Определяется по IP-адресу или географическому идентификатору.

DoubleClick for Publishers

  • Показатель – ga:dfpImpressions – показ объявления DFP. Регистрируется при отображении отдельного объявления на сайте. Например, если страница с двумя рекламными блоками была просмотрена один раз, будет засчитано два показа (связь с DFP включена, скрытие данных о доходах DFP отключено).
  • Показатель – ga:dfpCoverage – покрытие (процент запросов, которые привели к показу хотя бы одного объявления). Позволяет выявить сайты, для которых аккаунт DFP не может подобрать подходящие объявления. Покрытие вычисляется по следующей формуле: (число показов / общее число запросов объявлений) * 100 (связь с DFP включена, скрытие данных о доходах DFP отключено).
  • Показатель – ga:dfpMonetizedPageviews – общее число просмотров страниц на ресурсе с объявлением из связанного аккаунта DFP. Обратите внимание, что на одной странице может быть несколько рекламных блоков (связь с DFP включена, скрытие данных о доходах DFP отключено).
  • Показатель – ga:dfpImpressionsPerSession – отношение числа показов объявлений DFP к числу сеансов Аналитики (связь с 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 сеансов Аналитики. Обратите внимание, что этот показатель основан на числе сеансов, а не показов объявлений (связь с DFP включена, скрытие данных о доходах DFP отключено).
  • Показатель – ga:dfpECPM – эффективная цена за тысячу просмотров страниц. Это доход DFP на 1000 просмотров страниц (связь с DFP включена, скрытие данных о доходах DFP отключено).
  • Показатель – ga:backfillImpressions – показы с заполнением (общее число показов AdSense или Ad Exchance, выполненных через DFP). Показ регистрируется при отображении отдельного объявления на сайте. Например, если страница с двумя рекламными блоками была просмотрена один раз, будет засчитано два показа (связь с DFP включена, скрытие данных о доходах DFP отключено).
  • Показатель – ga:backfillCoverage – покрытие объявлениями для заполнения (процент запросов объявлений для заполнения, которые привели к показу хотя бы одного объявления). Позволяет выявить сайты, для которых аккаунт издателя не может подобрать подходящие объявления. Вычисляется по следующей формуле: (число показов / общее число запросов объявлений) * 100. Если и AdSense, и Ad Exchange поставляют объявления для заполнения, то этот показатель рассчитывается как средневзвешенное значение для обоих аккаунтов (связь с DFP включена, скрытие данных о доходах DFP отключено).
  • Показатель – ga:backfillMonetizedPageviews – общее число просмотров страниц на ресурсе с показом хотя бы одного объявления из связанного аккаунта для заполнения. Обратите внимание, что один просмотр страницы может включать несколько показов объявлений (связь с DFP включена, скрытие данных о доходах DFP отключено).
  • Показатель – ga:backfillImpressionsPerSession – отношение числа показов объявлений для заполнения к числу сеансов Аналитики (число показов / число сеансов Аналитики). Если и 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 сеансов Аналитики. Обратите внимание, что этот показатель основан на числе сеансов, а не показов объявлений. Если и AdSense, и Ad Exchange поставляют объявления для заполнения, то этот показатель рассчитывается как суммарное значение для обоих аккаунтов (связь с DFP включена, скрытие данных о доходах DFP отключено).
  • Показатель – ga:backfillECPM – эффективная цена за тысячу просмотров страниц. Это доход от заполнения DFP на 1000 просмотров страниц. Если и AdSense, и Ad Exchange поставляют объявления для заполнения, то этот показатель рассчитывается как суммарное значение для обоих аккаунтов (связь с DFP включена, скрытие данных о доходах DFP отключено).

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

Сегменты

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

Выборка

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

В этом выпуске исправлена ошибка, возникавшая при отправке к Analytics Reporting API версии 4 когортного запроса.

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

С помощью когортных запросов теперь можно получать параметры когорты. Ранее запрос параметров ga:acquisition... завершался ошибкой.

Запросы общей ценности

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

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

Атрибут addedInApiVersion

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

В этом выпуске представлена новая, четвертая версия Analytics Reporting API. Это передовой программный способ доступа к данным в Google Аналитике.

Основные функции

В основе Google Аналитики лежит хорошо продуманная система сбора данных. API открывает разработчикам доступ к возможностям этой платформы. Основные функции Analytics Reporting API версии 4:

  • Выражения для показателей: API позволяет запрашивать не только стандартные показатели, но и их сочетания, выраженные с помощью математических операций. Например, количество достигнутых целей на сеанс можно выразить в запросе следующим образом: ga:goal1completions/ga:sessions.
  • Несколько диапазонов дат: если вам нужно сравнить данные за два периода, вы можете получить эти данные с помощью одного запроса.
  • Когорты и общая ценность: API предоставляет широкие возможности создания отчетов по когортам и общей ценности.
  • Несколько сегментов: теперь с помощью одного запроса можно получить сразу несколько сегментов.

Начало работы

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

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

Для Analytics Reporting API версии 4 установлены отдельные квоты и ограничения, которые в будущем могут измениться.

Переход

Мы подготовили для вас руководство по переходу, а также добавили на GitHub библотеку совместимости Python.

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

В этом выпуске также добавлены параметры и показатели – специально для Analytics Reporting API версии 4. Полный список определений приведен в Справке по параметрам и показателям.

  • Параметр – ga:cohort – название когорты, к которой принадлежит пользователь, на основе определения когорты. Пользователь может принадлежать к нескольким когортам – это зависит от их определения (так же, как пользователь может принадлежать к нескольким сегментам).

  • Параметр – ga:cohortNthDay – период в днях с даты определения когорты. Например, если в когортном запросе указана дата первого посещения 2015-09-01, то для даты 2015-09-04 параметр ga:cohortNthDay равен 3.

  • ga:cohortNthMonth – период в месяцах с даты определения когорты.

  • Параметр – ga:cohortNthWeek – период в неделях с даты определения когорты.

  • Параметр – ga:acquisitionTrafficChannel – канал трафика, по которому был привлечен пользователь. Определяется по его первому сеансу. Канал трафика определяется в момент привлечения пользователя на основе правил по умолчанию для группы каналов (на уровне представления, если оно имеется).

  • Параметр – ga:acquisitionSource – источник, с помощью которого был привлечен пользователь. Определяется по его первому сеансу.

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

  • Параметр – ga:acquisitionSourceMedium – комбинированное значение параметров ga:userAcquisitionSource и ga:acquisitionMedium.

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

  • Показатель – ga:cohortActiveUsers – используется с параметрами периода (ga:cohortNthDay, ga:cohortNthWeek или ga:cohortNthMonth). Это количество пользователей в когорте, проявлявших активность в течение соответствующего периода времени. Например, для 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 г.. Более новые данные будут недоступны. Параметры и показатели Social Data Hub будут удалены после 30 сентября 2016 г., согласно правилам прекращения поддержки.

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

Действия в социальных сетях

Указанные ниже параметры и показатели больше не поддерживаются и будут удалены после 30 сентября 2016 г. Подробнее об удалении данных

  • Параметр – ga:socialActivityEndorsingUrl – URL действия в социальной сети (например, публикации сообщения в Google+ или комментария в блоге).
  • Параметр – 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 контента в партнерской сети Social Data Hub.

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

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

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

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

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

  • Параметр – ga:browserSize – размер области просмотра в браузере пользователя. Размер браузера – это параметр, определяющий исходный размер области просмотра в формате "ширина X высота" (в пикселях), для отдельного сеанса. Пример: 1920 X 960.

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

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

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

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

Представления (профили)

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

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

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

Сегменты

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

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

include-empty-rows

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

В этой версии внесены следующие изменения:

Google Аналитика

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

Google Менеджер тегов

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

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

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

  • Показатель – ga:1dayUsers – общее количество пользователей, проявлявших активность за последний день, для каждого дня в указанном периоде времени. Чтобы получить такие данные, необходимо задать хотя бы одно из полей ga:nthDay, ga:date и ga:day. Возвращаемое значение будет равно общему количеству уникальных пользователей за однодневный период, заканчивающийся в указанную дату.
  • Показатель – ga:7dayUsers – общее количество пользователей, проявлявших активность за последние 7 дней, для каждого дня в указанном периоде времени. Чтобы получить такие данные, необходимо задать хотя бы одно из полей ga:nthDay, ga:date и ga:day. Возвращаемое значение будет равно общему количеству уникальных пользователей за семидневный период, заканчивающийся в указанную дату.
  • Показатель – ga:14dayUsers – общее количество пользователей, проявлявших активность за последние 14 дней, для каждого дня в указанном периоде времени. Чтобы получить такие данные, необходимо задать хотя бы одно из полей ga:nthDay, ga:date и ga:day. Возвращаемое значение будет равно общему количеству уникальных пользователей за 14-дневный период, заканчивающийся в указанную дату.
  • Показатель – ga:30dayUsers – общее количество пользователей, проявлявших активность за последние 30 дней, для каждого дня в указанном периоде времени. Чтобы получить такие данные, необходимо задать хотя бы одно из полей ga:nthDay, ga:date и ga:day. Возвращаемое значение будет равно общему количеству уникальных пользователей за 30-дневный период, заканчивающийся в указанную дату.

Сегменты

В этом выпуске исправлена ошибка, из-за которой для частных сегментов, связанных с несколькими представлениями (профилями), при вызове метода list возвращалась ошибка 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 к числу сеансов Аналитики (число показов / число сеансов Аналитики).
  • Показатель – ga:adxMonetizedPageviews – монетизированные просмотры страниц (общее число просмотров страниц на ресурсе с объявлением из связанного аккаунта AdX). Обратите внимание, что на одной странице может быть несколько рекламных блоков.
  • Показатель – ga:adxRevenue – общий расчетный доход от объявлений AdX.
  • Показатель – ga:adxRevenuePer1000Sessions – общий расчетный доход от объявлений AdX на 1000 сеансов Аналитики. Обратите внимание, что этот показатель основан на числе пользовательских сеансов, а не показов объявлений.
  • Показатель – ga:adxViewableImpressionsPercent – процент показов объявлений в видимой области экрана. при которых браузер получил объявление и пользователь мог увидеть его.

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

  • Этот параметр URL (provisioningSignup=false) позволил устранить ошибку, возникавшую при синхронизации аккаунта Google Аналитики для пользователя, у которого такого аккаунта нет. Разработчики должны добавить этот параметр в URL страницы с условиями использования.

Пакетирование запросов

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

Представления (профили)

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

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

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

Поддержка указанных ниже параметров прекращена. Подробнее об удалении данных

  • Параметр – ga:adSlotPosition – вместо него следует использовать ga:adSlot.
  • Параметр – ga:nextPagePath – вместо него следует использовать ga:pagePath.
  • Параметр – ga:nextContentGroupXX – вместо него следует использовать ga:contentGroupXX.

В этой версии внесены следующие изменения:

Google Аналитика

  • Исправлена ошибка, вызывающая сбои при использовании setCampaignParametersFromUrl (ошибка 636).

Google Менеджер тегов

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

Фильтры

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

В этой версии внесены следующие изменения:

Google Аналитика

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

Google Менеджер тегов

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

AdWords

  • Параметр – ga:adQueryWordCount – количество слов в поисковом запросе.

Фильтры

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

Цели

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

В этой версии внесены следующие изменения:

Google Аналитика

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

Google Менеджер тегов

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

В этой версии внесены следующие изменения:

Google Аналитика

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

Google Менеджер тегов

  • Исправлена ошибка нулевой строки, приводящая к сбоям в TAGDispatcher.

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

Транспортировка

  • В поле transport можно указать метод отправки обращений.

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

  • Прекращена поддержка параметра useBeacon.
  • Исправлены ошибки.

В этой версии внесены следующие изменения:

Google Аналитика

Google Менеджер тегов

  • Исправлены незначительные ошибки.

В этом выпуске выполнено окончательное отключение и удаление ресурса dailyUpload. Поддержка ресурса dailyUpload официально прекратилась 20 июня 2014 г. Данные о расходах теперь следует импортировать с помощью загрузок.

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

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

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

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

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

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

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

  • С помощью параметра ds (источника данных) можно указать источник данных для обращения.

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

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

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

Переопределение геоданных

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

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

Теперь можно выполнять команды create, list, get, patch и update для специальных параметров и показателей с помощью Management API.

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

Электронная торговля

  • Показатель – ga:transactionsPerUser – общее число транзакций, разделенное на общее число пользователей.
  • Показатель – ga:revenuePerUser – общий доход от продажи, указанный в транзакции (за исключением стоимости доставки и налогов), разделенный на общее число пользователей.

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

  • Показатель – ga:sessionsPerUser – общее число сеансов, разделенное на общее число пользователей.

Местоположение/сеть

  • Параметр – ga:cityId – идентификатор города, в котором находится пользователь. Определяется по IP-адресу или географическому идентификатору.
  • Параметр – ga:countryIsoCode – код ISO страны, в которой находится пользователь. Определяется по IP-адресу или географическому идентификатору. Значения указываются в формате ISO-3166-1 alpha-2.
  • Параметр – ga:regionId – идентификатор региона, в котором находится пользователь. Определяется по IP-адресу или географическому идентификатору. В США регионом является штат, например Нью-Йорк.
  • Параметр – ga:regionIsoCode – код ISO региона, в котором находится пользователь. Определяется по IP-адресу или географическому идентификатору. Значения указываются в формате ISO-3166-2.
  • Параметр – ga:subContinentCode – код субконтинента, на котором находится пользователь. Определяется по IP-адресу или географическому идентификатору. Например, Полинезия или Северная Европа. Значения указываются в формате UN M.49.

DoubleClick Campaign Manager

  • Показатель – ga:dcmROAS – рентабельность инвестиций в объявления DCM (только для премиум-аккаунтов).

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

Поддержка указанных показателей прекращена. Подробная информация об удалении данных приведена в этих правилах: показатель – ga:dcmROI – вместо него следует использовать ga:dcmROAS; показатель – ga:dcmMargen – вместо него следует использовать ga:dcmROAS.

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

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

Добавлено новое поле фильтров DEVICE_CATEGORY. Поддержка IS_MOBILE и IS_TABLET прекращена. Вместо них следует использовать DEVICE_CATEGORY=mobile и DEVICE_CATEGORY=tablet.

В этой версии внесены следующие изменения:

Google Аналитика

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

Google Менеджер тегов

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

Теперь ресурс Представление (профиль) содержит свойство enhancedECommerceTracking, показывающее, включена расширенная электронная торговля (true) или нет (false).

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

AdWords

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

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

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

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

Время

  • Параметр – rt:minutesAgo – время, прошедшее с момента обращения (в минутах).

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

AdSense

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

В этой версии внесены следующие изменения:

Google Аналитика

  • Исправлены незначительные ошибки.

Google Менеджер тегов

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

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

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

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

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

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

Сеанс

  • Показатель – ga:hits – общее число обращений, отправленных в Google Аналитику. Учитываются все типы обращений: просмотры страниц, события, данные о времени и т. д.

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

  • Параметр – ga:campaignCode – содержит значение параметра отслеживания utm_id для кампании, если отслеживание ведется вручную.

DoubleClick Campaign Manager

  • Параметр – ga:dcmClickAd – название объявления DCM для клика DCM, соответствующее сеансу Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmClickAdId – идентификатор объявления DCM для клика DCM, соответствующий сеансу Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmClickAdType – название типа объявления DCM для клика DCM, соответствующее сеансу Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmClickAdTypeId – идентификатор типа объявления DCM для клика DCM, соответствующий сеансу Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmClickAdvertiser – название рекламодателя DCM для клика DCM, соответствующее сеансу Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmClickAdvertiserId – идентификатор рекламодателя DCM для клика DCM, соответствующий сеансу Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmClickCampaign – название кампании DCM для клика DCM, соответствующее сеансу Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmClickCampaignId – идентификатор кампании DCM для клика DCM, соответствующий сеансу Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmClickCreative – название креатива DCM для клика DCM, соответствующее сеансу Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmClickCreativeId – идентификатор креатива DCM для клика DCM, соответствующий сеансу Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmClickCreativeType – название типа креатива DCM для клика DCM, соответствующее сеансу Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmClickCreativeTypeId – идентификатор типа креатива DCM для клика DCM, соответствующий сеансу Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmClickCreativeVersion – версия креатива DCM для клика DCM, соответствующая сеансу Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmClickRenderingId – идентификатор отображения DCM для клика DCM, соответствующий сеансу Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmClickSite – название сайта, на котором пользователь увидел объявление DCM и нажал на него, для клика DCM, соответствующее сеансу Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmClickSiteId – идентификатор сайта DCM, на котором пользователь увидел объявление DCM и нажал на него, для клика DCM, соответствующий сеансу Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmClickSitePlacement – название места размещения на сайте DCM для клика DCM, соответствующее сеансу Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmClickSitePlacementId – идентификатор места размещения на сайте DCM для клика DCM, соответствующий сеансу Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmClickSpotId – идентификатор конфигурации Floodlight DCM для клика DCM, соответствующий сеансу Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmFloodlightActivity – название действия Floodlight DCM, связанное с конверсией Floodlight (только для премиум-аккаунтов).
  • Параметр – ga:dcmFloodlightActivityAndGroup – названия действия и группы Floodlight DCM, связанные с конверсией Floodlight (только для премиум-аккаунтов).
  • Параметр – ga:dcmFloodlightActivityGroup – название группы действий Floodlight DCM, связанное с конверсией Floodlight (только для премиум-аккаунтов).
  • Параметр – ga:dcmFloodlightActivityGroupId – идентификатор группы действий Floodlight DCM, связанный с конверсией Floodlight (только для премиум-аккаунтов).
  • Параметр – ga:dcmFloodlightActivityId – идентификатор действия Floodlight DCM, связанный с конверсией Floodlight (только для премиум-аккаунтов).
  • Параметр – ga:dcmFloodlightAdvertiserId – идентификатор рекламодателя Floodlight DCM, связанный с конверсией Floodlight (только для премиум-аккаунтов).
  • Параметр – ga:dcmFloodlightSpotId – идентификатор конфигурации Floodlight DCM, связанный с конверсией Floodlight (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventAd – название объявления DCM для последнего события DCM (показа или клика в период ретроспективного анализа), связанное с сеансом Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventAdId – идентификатор объявления DCM для последнего события DCM (показа или клика в период ретроспективного анализа), связанный с сеансом Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventAdType – название типа объявления DCM для последнего события DCM (показа или клика в период ретроспективного анализа), связанное с сеансом Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventAdTypeId – идентификатор типа объявления DCM для последнего события DCM (показа или клика в период ретроспективного анализа), связанный с сеансом Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventAdvertiser – название рекламодателя DCM для последнего события DCM (показа или клика в период ретроспективного анализа), связанное с сеансом Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventAdvertiserId – идентификатор рекламодателя DCM для последнего события DCM (показа или клика в период ретроспективного анализа), связанный с сеансом Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventAttributionType – существуют два возможных значения (ClickThrough и ViewThrough). Если последним событием DCM, связанным с сеансом Google Аналитики, был клик, то будет использоваться значение ClickThrough, а если показ – ViewThrough (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventCampaign – название кампании DCM для последнего события DCM (показа или клика в период ретроспективного анализа), связанное с сеансом Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventCampaignId – идентификатор кампании DCM для последнего события DCM (показа или клика в период ретроспективного анализа), связанный с сеансом Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventCreative – название креатива DCM для последнего события DCM (показа или клика в период ретроспективного анализа), связанное с сеансом Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventCreativeId – идентификатор креатива DCM для последнего события DCM (показа или клика в период ретроспективного анализа), связанный с сеансом Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventCreativeType – название типа креатива DCM для последнего события DCM (показа или клика в период ретроспективного анализа), связанное с сеансом Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventCreativeTypeId – идентификатор типа креатива DCM для последнего события DCM (показа или клика в период ретроспективного анализа), связанный с сеансом Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventCreativeVersion – версия креатива DCM для последнего события DCM (показа или клика в период ретроспективного анализа), связанная с сеансом Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventRenderingId – идентификатор отображения DCM для последнего события DCM (показа или клика в период ретроспективного анализа), связанный с сеансом Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventSite – название сайта, на котором пользователь увидел объявление DCM и нажал на него, для последнего события DCM (показа или клика в период ретроспективного анализа), связанное с сеансом Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventSiteId – идентификатор сайта DCM, на котором пользователь увидел объявление DCM и нажал на него, для последнего события DCM (показа или клика в период ретроспективного анализа), связанный с сеансом Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventSitePlacement – название места размещения на сайте DCM для последнего события DCM (показа или клика в период ретроспективного анализа), связанное с сеансом Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventSitePlacementId – идентификатор места размещения на сайте DCM для последнего события DCM (показа или клика в период ретроспективного анализа), связанный с сеансом Google Аналитики (только для премиум-аккаунтов).
  • Параметр – ga:dcmLastEventSpotId – идентификатор конфигурации Floodlight DCM для последнего события DCM (показа или клика в период ретроспективного анализа), связанный с сеансом Google Аналитики (только для премиум-аккаунтов).
  • Показатель – ga:dcmFloodlightQuantity – количество конверсий Floodlight DCM (только для премиум-аккаунтов).
  • Показатель – dcmFloodlightRevenue – доход Floodlight DCM (только для премиум-аккаунтов).

В этой версии внесены следующие изменения:

Google Аналитика

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

Google Менеджер тегов

  • Добавлена поддержка расширенной электронной торговли для тега Google Universal Analytics.
  • В класс TAGManager добавлены методы dispatch и dispatchWithCompletionHandler.

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

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

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

Группы контента

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

В этой версии внесены следующие изменения:

Google Аналитика

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

Google Менеджер тегов

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

В этой версии внесены следующие изменения:

Google Аналитика

  • Теперь SDK будет собирать идентификатор IDFA и флаг включения отслеживания рекламодателя, если в приложении используется библиотека libAdIdAccess.a (как часть SDK), а в счетчике для свойства allowIDFACollection задано значение true.
  • Добавлена поддержка расширенной электронной торговли.
  • Тип обращения appview заменен типом screenview.
  • Для каждого обращения добавлен параметр id. Он меняется при каждой регистрации обращения appview, screenview или pageview.
  • Теперь параметр Client-ID сбрасывается при каждом изменении идентификатора IDFA (если идентификатор IDFA собирается в счетчике).
  • В класс GAI добавлен метод dispatchWithCompletionHandler.
  • Исправлена ошибка, из-за которой пиксель отслеживания мог отправляться с пустым значением Client-ID или вообще без него.

Google Менеджер тегов

  • Без изменений.
  • Настроено отбрасывание обращений без идентификатора отслеживания.

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

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

Подробная информация об импорте данных в аккаунт Google Аналитики с помощью Management API приведена в руководстве для разработчиков.

Загрузки

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

Прекращение поддержки ежедневных загрузок

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

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

Сегменты

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

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

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

Расширенная электронная торговля

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

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

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

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

Системные

  • Параметр – ga:sourcePropertyDisplayName – отображаемое название исходного ресурса для агрегированных ресурсов. Применимо только для агрегированных ресурсов.
  • Параметр – ga:sourcePropertyTrackingId – идентификатор отслеживания исходного ресурса для агрегированных ресурсов. Применимо только для агрегированных ресурсов.

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

  • Параметр – ga:channelGrouping – группа каналов по умолчанию, к которой открыт доступ в рамках представления (профиля).
  • Параметр – ga:correlationModelId – идентификатор модели соотношения для сопутствующих товаров.
  • Параметр – ga:queryProductId – идентификатор запрашиваемого товара.
  • Параметр – ga:queryProductName – название запрашиваемого товара.
  • Параметр – ga:queryProductVariation – разновидность запрашиваемого товара.
  • Параметр – ga:relatedProductId – идентификатор сопутствующего товара.
  • Параметр – ga:relatedProductName – название сопутствующего товара.
  • Параметр – ga:relatedProductVariation – разновидность сопутствующего товара.
  • Показатель – ga:correlationScore – показатель соотношения для сопутствующих товаров.
  • Показатель – ga:queryProductQuantity – количество запрашиваемого товара.
  • Показатель – ga:relatedProductQuantity – количество сопутствующего товара.

Корректировка заголовков столбцов

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

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

Изменение uiName

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

Это первый выпуск Embed API:

  • Google Analytics Embed API – это библиотека JavaScript, с помощью которой вы сможете буквально за несколько минут создать сводку и встроить ее в сторонний сайт. Подробная информация приведена в Обзоре Embed API.
  • Включенные компоненты: Auth, ViewSelector, Data и DataChart.

Это первый выпуск Provisioning API:

  • С помощью Provisioning API можно программно создавать аккаунты Google Аналитики. API доступен по приглашению и предназначен для сертифицированных поставщиков услуг и крупных партнеров. Подробная информация приведена в Обзоре Provisioning API.

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

Фильтры

Полные отчеты: Management API

В Management API добавлен новый ресурс – полные отчеты. Полные отчеты Google Аналитики формируются без выборки данныхи в настоящее время доступны только пользователям премиум-аккаунтов.

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

    • Удалены: 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 Аналитика

  • Добавлено поле User ID.

Google Менеджер тегов

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

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

Прекращение поддержки appUiName

  • Поддержка appUiName прекращена. Этот атрибут больше не требуется в Metadata API, поскольку названия представлений для сайтов и приложений (профилей) в интерфейсе были унифицированы. Удалите код с атрибутом appUiName и используйте только uiName.

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

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

Указанные ниже параметры и показатели были переименованы. Подробнее об переименовании данных

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

  • Параметр – rt:visitorType – вместо него следует использовать rt:userType.
  • Показатель – rt:activeVisitors – вместо него следует использовать rt:activeUsers.

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

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

В Core Reporting API добавлены следующие параметры:

AdWords

  • Параметр – ga:isTrueViewVideoAd (Yes или No) – показывает, является ли объявление видеообъявлением TrueView AdWords.

Время

  • Параметр – 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.

В этой версии заменен тип обращений appview, а также добавлены и переименованы некоторые параметры. Полный список параметров представлен в этом разделе.

Замена appview

  • Тип обращений appview заменен типом screenview. Как можно скорее внесите соответствующую корректировку в код отслеживания (укажите screenview вместо appview).

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

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

  • Параметр Описание контента переименован в Название экрана. Имя параметра в запросе осталось прежним (cd).

В этой версии заменен тип обращений appview, а также добавлены новые поля. Полный список полей представлен в этом разделе.

Замена appview

  • Тип обращений appview заменен типом screenview. Как можно скорее внесите соответствующую корректировку в код отслеживания (укажите screenview вместо appview).

Новые поля

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

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

Сегменты: Core Reporting API версий 2.4 и 3.0

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

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

Сегменты: Management API версий 2.4 и 3.0

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

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

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

Указанные ниже показатели AdSense теперь могут использоваться как цели оптимизации.

  • ga:adsenseAdsClicks – количество кликов по объявлениям AdSense на вашем сайте.
  • ga:adsenseAdsViewed – количество просмотров объявлений AdSense. В одном рекламном блоке может показываться несколько объявлений.
  • ga:adsenseRevenue – общий доход от объявлений AdSense.

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

  • В Management API добавлена коллекция AccountSummaries. Она позволяет легко получить сводку по любому аккаунту, ресурсу и представлению (профилю), доступному авторизованному пользователю. Подробная информация приведена в руководстве для разработчиков.

Google Аналитика и Google Менеджер тегов

Прекращение поддержки префикса ga:

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

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

В Real Time Reporting 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 – общее количество просмотров экрана.

В этой версии внесены следующие изменения:

Google Аналитика

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

Google Менеджер тегов

  • Добавлена поддержка макроса "Эксперименты со страницами в Google Аналитике".

В этой версии внесены следующие изменения:

Google Аналитика

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

Google Менеджер тегов

  • Добавлена поддержка макроса "Эксперименты со страницами в Google Аналитике".

В этой версии внесены следующие изменения:

Google Аналитика

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

Google Менеджер тегов

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

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

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

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

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

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

В этой версии отменена необходимость в AdSupport.framework и удален ненужный код.

* Добавлена поддержка 64-bit iOS 7.0 SDK. * Удалена библиотека libGoogleAnalytics_debug.a из библиотеки libGoogleAnalyticsServices.a. * Очищен файл сборки CuteAnimals для Google Аналитики.

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

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

  • Параметр – mcf:adwordsAdGroupIDPath – последовательность идентификаторов групп объявлений AdWords в путях конверсии.
  • Параметр – mcf:adwordsCampaignIDPath – последовательность идентификаторов кампаний AdWords в путях конверсии.
  • Параметр – mcf:adwordsCreativeIDPath – последовательность идентификаторов объявлений AdWords в путях конверсии.
  • Параметр – mcf:adwordsCriteriaIDPath – последовательность идентификаторов критериев AdWords в путях конверсии.

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

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

В этом выпуске добавлен новый формат ответа – объект таблицы данных, а также введены новые и упразднены старые параметры и показатели. Полный список определений приведен в Справке по параметрам и показателям.

Таблица данных: выходные данные

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

  • В API добавлен необязательный параметр запроса output. С помощью этого параметра можно выбрать формат выходных данных Аналитики в ответе (по умолчанию используется формат JSON). Если выбрано значение datatable, в ответ будет включено свойство dataTable с объектом таблицы данных. Этот объект можно использовать непосредственно в Google Charts. Подробная информация приведена в Справке по Core Reporting API.

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

В Core Reporting API добавлены следующие параметры и показатели:

Время

  • Параметр – ga:minute – возвращает минуту часа. Диапазон допустимых значений: от 00 до 59.
  • Параметр – ga:nthMinute – индекс каждой минуты в указанном диапазоне дат. Индекс первой минуты первого дня (даты начала) в диапазоне дат – 0, второго – 1 и т. д.

Аудитория

  • Параметр – ga:visitorAgeBracket – возрастная группа посетителя.
  • Параметр – ga:visitorGender – пол посетителя.
  • Параметр – ga:interestAffinityCategory – показывает, что пользователь с большей вероятностью заинтересуется товарами или услугами определенной категории.
  • Параметр – ga:interestInMarketCategory – показывает, что пользователь с большей вероятностью приобретет товары или услуги определенной категории.
  • Параметр – ga:interestOtherCategory – показывает, что пользователь с большей вероятностью заинтересуется товарами или услугами определенной категории и совершит покупку.

Параметры и показатели, которые можно использовать в сегментах

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

  • Параметр – ga:sourceMedium – объединяет значения ga:source и ga:medium.
  • Показатель – ga:localItemRevenue – доход от товара в местной валюте.

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

Поддержка указанных параметров и показателей прекращена. Подробнее об удалении данных

  • Параметр – ga:isMobile – вместо него следует использовать ga:deviceCategory (например, ga:deviceCategory==mobile).
  • Параметр – ga:isTablet – вместо него следует использовать ga:deviceCategory (например, ga:deviceCategory==tablet).
  • Показатель – ga:entranceBounceRate – вместо него следует использовать ga:visitBounceRate.

В связи с прекращением поддержки параметров ga:isMobile и ga:isTablet в сегменты по умолчанию внесены следующие изменения:

  • Название сегмента 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

  • Предоставлен доступ к следующим данным AdSense:

    • Показатель – ga:adsenseRevenue –общий доход от объявлений AdSense.
    • Показатель – ga:adsenseAdUnitsViewed – количество просмотров рекламных блоков AdSense. Рекламный блок – это набор объявлений, отображаемых с помощью одного фрагмента кода AdSense. Подробная информация приведена на странице https://support.google.com/adsense/answer/32715.
    • Показатель – ga:adsenseAdsViewed – количество просмотров объявлений AdSense. В одном рекламном блоке может показываться несколько объявлений.
    • Показатель – ga:adsenseAdsClicks – количество кликов по объявлениям AdSense на вашем сайте.
    • Показатель – ga:adsensePageImpressions – количество просмотров страниц с объявлениями AdSense. На одной странице может быть несколько рекламных блоков.
    • Показатель – ga:adsenseCTR – процент показов страниц, завершившихся кликом по объявлению AdSense (ga:adsenseAdsClicks/ga:adsensePageImpressions).
    • Показатель – ga:adsenseECPM – расчетная цена за тысячу показов страницы. Это ваш доход от AdSense (ga:adsenseRevenue/(ga:adsensePageImpressions/1000).
    • Показатель – ga:adsenseExits – количество сеансов, завершившихся из-за клика по объявлению AdSense.

Время

  • Параметр – ga:isoYear – год посещения в формате ISO. Подробная информация приведена на странице http://en.wikipedia.org/wiki/ISO_week_date. ga:isoYear необходимо использовать с ga:isoWeek, поскольку ga:week соответствует григорианскому календарю.
  • Параметр – ga:isoYearIsoWeek – объединяет значения ga:isoYear и ga:isoWeek.

AdWords

  • Это данные, получаемые из отчетов AdWords:

    • Параметр – ga:adKeywordMatchType – типы соответствия, используемые для ключевых слов (фразовое, точное, широкое). Подробная информация приведена в статье Отчет о поисковых запросах.

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

  • Устранена проблема с информацией о часовом поясе представления (профиля). Подробные сведения. Ранее при перечислении представлений (профилей) в Management API возвращалась неверная информация об их часовых поясах. Теперь она соответствует настройкам, заданным в интерфейсе администратора Google Аналитики.

* Устранен конфликт с Protocol Buffer SDK. * Исправлена ошибка связывания, возникающая при включенной очистке кода.

Новые возможности: относительные даты и управление размером выборки

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

Новые возможности: относительные даты и управление размером выборки

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

Это шестая бета-версия, в которой внесены изменения, позволяющие избежать исключений времени выполнения в приложениях с таргетингом на Android KitKat (API уровня 19).

Это второй выпуск версии 3.0, в котором внесены изменения, позволяющие избежать исключений времени выполнения в приложениях с таргетингом на Android KitKat (API уровня 19).

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

API настройки аккаунта и конфигурации

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

Разрешения пользователей в Management API

  • Благодаря новому ресурсу accountUserLinks появилась возможность управлять разрешениями пользователей для аккаунта.
  • Благодаря новому ресурсу webpropertyUserLinks появилась возможность управлять разрешениями пользователей для ресурса.
  • Благодаря новому ресурсу profileUserLinks появилась возможность управлять разрешениями пользователей для представления (профиля).
  • Для ресурсов Аккаунт, Веб-ресурс и Представление (профиль) теперь доступны разрешения авторизованного пользователя.
  • Представлена новая область действия. Она требуется для управления разрешениями пользователей. https://www.googleapis.com/auth/analytics.manage.users.
  • Подробная информация приведена в руководстве по разрешениям пользователей для разработчиков.

В этой версии внесены следующие изменения:

  • Исправлена ошибка связывания, возникающая при таргетинге на iOS 7.0.

Это первый выпуск Metadata API:

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

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

* Это первый выпуск версии 3.0. * Мы переписали SDK API для оптимизации поддержки analytics.js. Подробную информацию можно найти в Javadoc и на странице /analytics/devguides/collection/android/v3/. * Удалены все методы track и send. Вместо них для отправки обращений можно использовать метод send и соответствующие конструкторы из класса MapBuilder. Просмотрите класс Fields, чтобы узнать, с помощью каких констант можно создавать обращения, используя set и send. * Удалены многие свойства, в том числе useHttps и anonymizeIp. Теперь соответствующие значения можно задавать и сбрасывать с помощью команды set. * Возможности Tracker расширены с помощью EasyTracker. Для прямого отслеживания нет необходимости вызывать EasyTracker.getTracker. * В SDK больше не задается флаг управления сеансом для начала при запуске. Определять, нужен ли новый сеанс, теперь должны разработчики. Обратите внимание, что управление сеансами обрабатывается в EasyTracker, как и прежде. * В SDK теперь поддерживается пользовательский класс журналирования. Чтобы узнать больше, посмотрите Logger в Javadoc. * Добавлен режим dryRun. * clientId теперь считывается (через вызов tracker.get(Fields.CLIENT_ID)). Обратите внимание, что этот вызов блокирует работу до тех пор, пока из постоянного хранилища не будет получено значение clientId. * Теперь SDK не повторяет попытку отправить обращение на основании кода ответа HTTP.

Этот первый выпуск Real Time Reporting API (ограниченной бета-версии):

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

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

  • Теперь ga:adwordsCustomerID корректно возвращает 10-значный идентификатор клиента AdWords, соответствующий значению AccountInfo.customerId в AdWords API. Благодаря этому исправлению стало возможным подключать данные Аналитики к нескольким аккаунтам AdWords.

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

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

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

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

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

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

  • Это данные, получаемые из отчетов профиля приложения:
    • Параметр – ga:appId – идентификатор приложения.
    • Параметр – ga:appInstallerId – идентификатор установщика (например, Google Play Store), из которого было скачано приложение. По умолчанию идентификатор установщика приложения задается с помощью метода PackageManager#getInstallerPackageName.
    • Параметр – ga:appName – название приложения.
    • Параметр – ga:appVersion – версия приложения.
    • Параметр – ga:exitScreenName – название экрана, на котором находился пользователь в момент выхода из приложения.
    • Параметр – ga:landingScreenName – название первого просмотренного экрана.
    • Параметр – ga:screenDepth – количество просмотров экранов за сеанс в строковом формате. Может использоваться при построении диаграмм.
    • Параметр – ga:screenName – название экрана.
    • Показатель – ga:avgScreenviewDuration – среднее время, проведенное пользователем на экране, в секундах.
    • Показатель – ga:timeOnScreen – время просмотра текущего экрана.
    • Показатель – ga:screenviews – общее количество просмотров экрана. Следует использовать вместо ga:appviews.
    • Показатель – ga:uniqueScreenviews – количество уникальных ga:screenviews за сеанс. Следует использовать вместо ga:uniqueAppviews.
    • Показатель – ga:screenviewsPerSession – среднее количество ga:screenviews за сеанс. Следует использовать вместо ga:appviewsPerVisit.

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

Поддержка приведенных ниже показателей прекращена. Используйте вместо них новые показатели.

  • Показатель – ga:appviews – вместо него следует использовать ga:screenviews.
  • Показатель – ga:uniqueAppviews – вместо него следует использовать ga:uniqueScreenviews.
  • Показатель – ga:appviewsPerVisit – вместо него следует использовать ga:screenviewsPerSession.

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

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

    • Параметр – ga:dimensionXX – название запрашиваемого специального параметра с номером XX.
    • Показатель – ga:metricXX – название запрашиваемого специального показателя с номером XX.

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

Указанные ниже параметр и показатель пользовательской переменной были переименованы. Это затрагивает только документацию – нет необходимости менять запросы.

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

Электронная торговля

  • Параметр – ga:currencyCode – код местной валюты транзакции в соответствии со стандартом ISO 4217.
  • Показатель – ga:localItemRevenue – доход от товара в местной валюте.
  • Показатель – ga:localTransactionRevenue – доход от транзакции в местной валюте.
  • Показатель – ga:localTransactionShipping – стоимость доставки для транзакции в местной валюте.
  • Показатель – ga:localTransactionTax – налог для транзакции в местной валюте.

Исключения

  • Это данные, получаемые при отслеживании исключений:
  • Параметр – ga:exceptionDescription – описание исключения.
  • Показатель – ga:exceptionsPerScreenview – количество вызванных исключений, разделенное на количество просмотров экранов.
  • Показатель – ga:fatalExceptionsPerScreenview – количество вызванных неустранимых исключений, разделенное на количество просмотров экранов.

Достигнутые конверсии

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

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

  • Параметр – ga:pageValue – средняя ценность страницы или группы страниц. Рассчитывается следующим образом: (доход от транзакции + общая ценность цели) / количество уникальных просмотров страницы или группы страниц.

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

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

    • Параметр – ga:deviceCategory – тип устройства (компьютер, планшет или смартфон).
    • Параметр – ga:isTablet – указывает, выполнено ли посещение на планшете. Допустимые значения: Yes, No.
    • Параметр – ga:mobileDeviceMarketingName – торговое название мобильного устройства.

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

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

    • Параметр – ga:socialEngagementType – тип взаимодействия. Допустимые значения: Socially Engaged и Not Socially Engaged.

Время

  • Параметр – ga:dateHour – объединяет значения ga:date и ga:hour.
  • Параметр – ga:dayOfWeekName – название дня недели на английском языке.
  • Параметр – ga:isoWeek – неделя в формате ISO (начинается с понедельника). Подробная информация приведена на странице http://en.wikipedia.org/wiki/ISO_week_date.
  • Параметр – ga:yearMonth – объединяет значения ga:year и ga:month.
  • Параметр – ga:yearWeek – объединяет значения ga:year и ga:week.

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

  • Параметр – ga:fullReferrer – полный URL перехода, включающий имя хоста и путь.
  • Параметр – ga:sourceMedium – объединяет значения ga:source и ga:medium.

В этом выпуске в ресурс Webproperty добавлено два новых свойства:

  • profileCount – возвращает количество профилей в ресурсе. Это позволяет отфильтровывать пустые ресурсы. Пример: profileCount = 0.
  • industryVertical – возвращает тематику/категорию, выбранную для ресурса.

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

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

* Это пятый выпуск бета-версии. * Исправлена ошибка обработки исключений в EasyTracker. Раньше, если был установлен флаг ga_reportUncaughtExceptions, анализатор исключений не запускался и местоположение неперехваченного исключения не определялось. Теперь отчеты об исключениях и сбоях содержат информацию о местоположении неперехваченного исключения, когда для ga_reportUncaughtExceptions задано значение true.

  • В Management API версии 3 добавлена новая конечная точка для просмотра и изменения ресурсов Experiments.

Запущена общедоступная бета-версия новой платформы Measurement Protocol.

Запущена открытая бета-версия библиотеки analytics.js.

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

  • Добавлена возможность указывать местную валюту с помощью атрибута _set. Пример: gaq.push(['_set', 'currencyCode', 'EUR']).
  • В этом выпуске добавлены 5 новых показателей скорости загрузки сайта:
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
31 января 2013 г.
  • В этом выпуске добавлен новый сегмент по умолчанию для трафика с планшетов – gaid::-13.
  • Ресурс Profile теперь включает свойство type, указывающее, для какого ресурса создан профиль: WEB или APP.

В этой версии внесены следующие изменения:

  • По умолчанию для параметра appVersion теперь используется значение CFBundleShortVersionString, а не CFBundleVersionKey.
  • По умолчанию теперь используется протокол HTTPS, а не HTTP.
  • Методы track заменены методами send (например, trackView теперь называется sendView).
  • Исправлены мелкие ошибки.

* Это четвертый выпуск бета-версии. * В SDK теперь учитывается доля выборки. Если ранее вы установили значение этого параметра, отличное от 100 %, то показатели Google Аналитики соответственно снизятся по сравнению с третьим выпуском. * Методы track заменены методами send (например, trackView теперь называется sendView). * Добавлена возможность указывать местную валюту с помощью Transaction.setCurrencyCode. * По умолчанию теперь используется протокол HTTPS, а не HTTP. * SDK не будет пытаться отправить обращения, если нет подключения к сети. * Избегаются ошибки ANR при попытке обработать данные кампании, ориентированной на установки. * Из SDK удалены классы TrackedActivity. * Инициализация SDK вынесена из основного потока UI. * Улучшена способность SDK восстанавливаться после повреждения базы данных SQLite. * Исправлено несколько ошибок.

В этой версии внесены следующие изменения:

  • В libGoogleAnalytics.a добавлена архитектура armv7s.
  • Из libGoogleAnalytics.a удалена архитектура armv6.

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

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

  • Это данные, получаемые из отчетов SDK отслеживания мобильных приложений:
    • Показатель – ga:uniqueAppviews – количество просмотров приложения за сеанс.
    • Показатель – ga:appviews – общее количество просмотров приложения.
    • Показатель – ga:appviewsPerVisit – среднее количество просмотров приложения за сеанс.

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

  • Параметр – ga:socialNetwork – название социальной сети, которая является источником трафика или социального действия. Примеры: Google+, Blogger, reddit.
  • Параметр – ga:hasSocialSourceReferral – показывает, выполнен ли переход на сайт из источника социального действия, то есть социальной сети, такой как Google+, Facebook или Twitter. Допустимые значения: Yes и No (первая буква должна быть заглавной).

Действия в социальных сетях

  • Это данные, получаемые из статистики внешних действий, импортируемой из партнерских сетей Social Data Hub.
  • Параметр – ga:socialActivityDisplayName – заголовок публикации в социальной сети.
  • Параметр – ga:socialActivityEndorsingUrl – URL действия в социальной сети (например, публикации сообщения в Google+ или комментария в блоге).
  • Параметр – ga:socialActivityPost – контент публикации в социальной сети (например, содержание записи в Google+).
  • Параметр – ga:socialActivityTimestamp – время выполнения действия в социальной сети.
  • Параметр – ga:socialActivityUserPhotoUrl – URL фото, связанного с профилем пользователя в социальной сети.
  • Параметр – ga:socialActivityUserProfileUrl – URL связанного профиля пользователя в социальной сети.
  • Параметр – ga:socialActivityContentUrl – URL, которым поделился пользователь социальной сети.
  • Параметр – ga:socialActivityTagsSummary – набор перечисленных через запятую тегов, связанных с действием в социальной сети.
  • Параметр – ga:socialActivityUserHandle – имя пользователя социальной сети, выполнившего действие.
  • Параметр – ga:socialActivityAction – тип социального действия (например, голосование, комментарий, рекомендация +1).
  • Параметр – ga:socialActivityNetworkAction – тип социального действия и социальная сеть, где оно произошло.
  • Показатель – ga:socialActivities – количество публикаций или упоминаний URL контента в партнерской сети Social Data Hub.

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

  • Это данные, получаемые из данных местного отслеживания социальных взаимодействий.
  • Параметр – ga:socialInteractionAction – отслеживаемое социальное действие (например, "Добавить +1", "Нравится" или "Создать закладку").
  • Параметр – ga:socialInteractionNetwork – отслеживаемая социальная сеть (например, Google, Facebook, Твиттер или LinkedIn).
  • Параметр – ga:socialInteractionNetworkAction – объединяет отслеживаемые параметры ga:socialInteractionNetwork и ga:socialInteractionAction (например, Google: добавить +1, Facebook: нравится).
  • Параметр – ga:socialInteractionTarget – URL (или ресурс), с которым связано социальное действие.
  • Показатель – ga:socialInteractions – общее количество социальных взаимодействий на вашем сайте.
  • Показатель – ga:uniqueSocialInteractions – общее количество уникальных социальных взаимодействий на вашем сайте (на основе пары значений – ga:socialInteractionNetwork и ga:socialInteractionAction).
  • Параметр – ga:socialInteractionsPerVisit – ga:socialInteractions/ga:uniqueSocialInteractions. Среднее количество социальных взаимодействий за одно посещение вашего сайта.

Местоположение/сеть

  • Параметр – ga:metro – медиарынок, с которого поступает трафик.

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

  • Параметр – ga:pagePathLevel1 – объединяет все пути к страницам на первом иерархическом уровне pagePath.
  • Параметр – ga:pagePathLevel2 – объединяет все пути к страницам на втором иерархическом уровне pagePath.
  • Параметр – ga:pagePathLevel3 – объединяет все пути к страницам на третьем иерархическом уровне pagePath.
  • Параметр – ga:pagePathLevel4 – объединяет все пути к страницам на четвертом иерархическом уровне pagePath. Все остальные уровни также собираются в этом параметре.

Отслеживание исключений

  • Это данные, получаемые из данных отслеживания исключений.

    • Параметр – ga:exceptions – количество исключений, отправленных в Google Аналитику.
    • Параметр – ga:fatalExceptions – количество исключений с параметром isFatal, имеющим значение true.

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

  • Это данные, получаемые из данных о пользовательском времени.

    • Параметр – ga:userTimingCategory – строка, которая используется для разбивки всех переменных пользовательского времени на логические группы. Это упрощает работу с отчетами.
    • Параметр – ga:userTimingLabel – строка, содержащая название действия для отслеживаемого ресурса.
    • Параметр – ga:userTimingVariable – строка, которую можно использовать для более подробной визуализации пользовательского времени в отчетах.
    • Параметр – ga:userTimingValue – истекшее время в миллисекундах, которое регистрируется в Google Аналитике.
    • Показатель – ga:userTimingSample – количество отправленных образцов.
    • Показатель – ga:avgUserTimingValue – среднее значение пользовательского времени: ga:userTimiingValue/ga:userTimiingSample.

Устройство/платформа

  • Это данные, получаемые из агента пользователя собранных данных.
  • Параметр – ga:mobileDeviceBranding – производитель или бренд мобильного устройства, например Samsung, HTC, Verizon или T-Mobile.
  • Параметр – ga:mobileDeviceModel – модель мобильного устройства, например Nexus S.
  • Параметр – ga:mobileInputSelector – средство выбора, которое используется на мобильном устройстве, например сенсорный экран, джойстик, Click Wheel или стилус.
  • Dim - ga:mobileDeviceInfo – бренд, модель и торговое название мобильного устройства.

В этой версии внесены следующие изменения:

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

    • Удалена версия библиотеки NoThumb.
    • Прекращена поддержка armv6.
  • Новые функции

    • Добавлена поддержка armv7s (для iPhone5).

В этой версии внесены следующие изменения:

  • Исправленные ошибки
    • Устранены проблемы с переходом на пользовательские переменные новой версии.
    • Теперь учитываются пользовательские ограничения фоновой передачи данных.

В этой версии внесены следующие изменения:

  • Исправленные ошибки
    • Методы протокола GANTrackerDelegate теперь являются необязательными.
    • Данные события теперь содержат информацию о последнем зарегистрированном просмотре страницы (utmp).
  • Новые функции
    • Поддержка 50 пользовательских переменных (только для Google Analytics Премиум).
    • Обновлено приложение-образец BasicExample.

В этой версии внесены следующие изменения:

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

    • Устранена утечка памяти.
    • Данные события теперь содержат информацию о последнем зарегистрированном просмотре страницы (utmp).
  • Новые функции

    • Поддержка 50 пользовательских переменных (только для Google Analytics Премиум).

В этой версии внесены следующие изменения:

  • В GAITracker добавлен метод для отслеживания социальной активности:
    • trackSocial:withAction:withTarget:
  • Подпись метода timing изменена на следующую:
    • trackTiming:withValue:withName:withLabel:
  • В GAITracker добавлены методы для построения и отправки вручную:
    • set:value:
    • get:
    • send:params:
  • В GAITracker добавлены методы для установки специальных параметров:
    • setCustom:dimension:
    • setCustom:metric:
  • Изменена архитектура хранилища данных для устранения известных ошибок CoreData.

В этой версии внесены следующие изменения:

  • Добавлена поддержка специальных параметров и показателей.
  • Добавлена поддержка отслеживания действий в социальных сетях.
  • Класс StandardExceptionParser стал общедоступным.
  • Устранена проблема, которая периодически приводила к сбоям при инициализации SDK.
  • Устранена проблема игнорирования широковещательной передачи INSTALL_REFERRER на некоторых устройствах.
  • Устранено исключение ConcurrentModificationExceptions в классе GoogleTracker.
  • Внесены другие исправления и улучшения.

Это первый выпуск Multi-Channel Funnels Reporting API:

  • С помощью этого API можно запрашивать данные многоканальных последовательностей для авторизованных пользователей. Они демонстрируют, каким образом пользователь взаимодействовал с разными источниками данных в ходе нескольких посещений на пути к конверсии, и позволяют анализировать вклад различных маркетинговых каналов. Подробная информация о том, какие данные доступны и как работать с API, приведена в Обзоре Multi-Channel Funnels Reporting API.

В этой версии внесены следующие изменения:

  • Выполнено обновление до последнего формата подключения.
  • Для sampleRate установлено число с плавающей запятой двойной точности.
  • Добавлено ограничение чрезмерного отслеживания.
  • Неотправленные данные отслеживания будут удаляться, если эта функция включена.
  • Неотправленные данные отслеживания будут удаляться по истечении 30 дней.
  • Улучшен диспетчер обращений.
  • Вместо периодического повторения попыток диспетчер будет использовать Reachability API для получения уведомлений о восстановлении подключения.
  • Обновлено приложение-образец.
  • Внесены другие исправления и улучшения.

В этой версии внесены следующие изменения:

  • Упрощен интерфейс EasyTracker.
  • Управление отправкой перенесено в новый класс GAServiceManager.
  • Выполнено обновление до последнего формата подключения.
  • Для sampleRate установлено число двойной точности.
  • Добавлено ограничение чрезмерного отслеживания.
  • Неотправленные данные отслеживания будут удаляться, если эта функция включена.
  • Неотправленные данные отслеживания будут удаляться по истечении 30 дней.
  • Внесены другие исправления и улучшения.

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

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

В этой версии внесены следующие изменения:

  • Добавлено средство обработки неперехваченных исключений.
  • Из GAI удалено свойство dispatchEnabled.
  • В GAI добавлено свойство defaultTracker.
  • В GAITracker добавлен метод close.
  • В GAITracker добавлен метод для отслеживания времени.
  • В GAITracker добавлен метод trackView, не принимающий аргументов.
  • Обновлены названия полей для объектов транзакций.
  • Выполнено обновление до последнего формата подключения.
  • Ценность события интерпретируется как 64-битовое целое число.
  • Для создания кода ARMV6 теперь используется не THUMB, а ARM.

В этой версии внесены следующие изменения:

  • Удален метод startSession. Вместо него следует использовать setStartSession.
  • В EasyTracker добавлен параметр ga_sessionTimeout.
  • Добавлен режим энергосбережения.
  • В GAITracker добавлен метод trackView, не принимающий аргументов.
  • Исправлена ошибка, которая блокировала отправку параметров исключений для обращений.
  • Теперь вместо полного блокирования отправки обращений отбрасываются только те из них, данные которых не удалось получить из базы данных.
  • Выполнено обновление до последнего формата подключения.
  • Добавлен тип обращений timing.
  • Добавлены типы обращений ecommerce (transaction и item).

В этом выпуске добавлена возможность для премиум-аккаунтов Google Аналитики создавать до 50 пользовательских переменных.

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

  • Доля выборки данных о скорости загрузки сайта (_setSiteSpeedSampleRate) увеличена с 10 % до 100 %.
  • Теперь метод _setAccount удаляет конечные пробелы.

В этой версии исправлены 2 ошибки.

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

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

  • При объединении фильтра показателей с расширенным сегментом больше не возвращается ошибка.

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

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

  • Добавлены следующие показатели скорости загрузки сайта:
    • ga:speedMetricsSample
    • ga:domainLookupTime
    • ga:pageDownloadTime
    • ga:redirectionTime
    • ga:serverConnectionTime
    • ga:serverResponseTime
    • ga:avgDomainLookupTime
    • ga:avgPageDownloadTime
    • ga:avgRedirectionTime
    • ga:avgServerConnectionTime
    • ga:avgServerResponseTime

Определения приведены в Справке по параметрам и показателям.

Напоминание о прекращении поддержки API версии 2.3

  • В течение двух последних месяцев идет прекращение поддержки Data Export API версии 2.3. Оно завершится примерно через четыре месяца. После этого будет поддерживаться только Core Reporting API версий 3.0 и 2.4.

  • Настоятельно рекомендуем перевести приложения на версию 3.0.

  • Через четыре месяца запросы к XML-фиду данных устаревшей версии 2.3 будут перенаправляться в версию 2.4 и возвращать XML-ответ версии 2.4. Кроме того, все правила в отношении квот для версии 2.4 будут применяться к запросам версии 2.3.

  • Все запросы для версии 2.3 JSON и клиентские библиотеки Google Data JavaScript, использующие выходные данные версии 2.3 JSON, будут возвращать код статуса 404.

  • Чтобы получить полную квоту для версий 3.0 и 2.4 необходимо зарегистрировать приложение в Google API Console и использовать ключ API (или токен OAuth 2.0) для каждого запроса.

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

  • Обновлен список систем обычного поиска, определенных по умолчанию. Добавлено: startsiden.no, rakuten.co.jp, biglobe.ne.jp, goo.ne.jp. Удалено search и добавлено conduit.com, babylon.com, search-results.com, avg.com, comcast.net и incredimail.com (все эти системы ранее относились к категории search).

Исправлена незначительная ошибка с ga:visitLength. Теперь этот параметр возвращает корректные данные.

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

  • В тело ответа на ошибку API добавлены новые коды ошибок, причины и описания. Все коды зарегистрированы для обеих версий Management API – 2.4 и 3.0.

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

  • Ограничение на количество символов в пользовательской переменной увеличено с 64 до 128. Этот параметр теперь проверяется перед кодированием URL.
  • Ограничение частоты запросов для событий ослаблено. Теперь можно отправлять до 10 обращений в секунду (и ещё одно дополнительное). Прежнее ограничение: одно обращение за 5 секунд. Обратите внимание, что ограничение 500 обращений на сеанс по-прежнему действует.
  • В файлах cookie __utmv в качестве разделителя переменных теперь используется не запятая, а карет для обеспечения совместимости с RFC. Это должно устранить проблемы с кодировкой файлов cookie, замеченные клиентами.

Этот выпуск затрагивает всех разработчиков Google Analytics API. Мы анонсировали две новые версии API, установили требование о регистрации приложений, представили новые правила в отношении квот, изменили название API на Core Reporting API и объявили о прекращении поддержки Data Export API версии 2.3.

Версия 3.0

  • Core Reporting API 3.0 – это последняя основная версия API, она не является обратно совместимой. Вся дальнейшая разработка API будет выполняться на основе этой версии.

  • Новые функции

    • Использование формата JSON для выходных данных позволило уменьшить размер ответа примерно в 10 раз в сравнении с XML-форматом.
    • Добавлены новые клиентские библиотеки Google API с поддержкой Java, JavaScript, Python, PHP, Ruby и .Net.
    • Появилась поддержка Google Discovery API.
    • Реализован протокол OAuth 2.0 как рекомендованный способ авторизации пользователей.
  • Изменения

    • Новый URL для создания запросов: https://www.googleapis.com/analytics/v3/data/ga….
    • Теперь требуются регистрация и идентификатор разработчика.
    • Все запросы данных конфигурации необходимо выполнять через Management API.

Версия 2.4

  • Core Reporting API 2.4 – это обновленная неосновная версия, по большей части обратно совместимая с Data Export API версии 2.3.

  • Изменения

    • Новый URL для создания запросов: https://www.googleapis.com/analytics/v2.4/data….
    • Теперь требуются регистрация и идентификатор разработчика.
    • Версия 2.3 поддерживает XML-формат выходных данных, поэтому другие существующие клиентские библиотеки Google Data будут работать.
    • Код ошибок, связанных с квотами, изменен с 503 на 403.
    • Ответы в формате JSON больше не поддерживаются.
    • Клиентские библиотеки JavaScript Google Data больше не поддерживаются.
    • Фид аккаунтов больше не поддерживается. Все запросы данных конфигурации необходимо выполнять через Management API.

Регистрация

  • Все приложения, созданные с использованием Google Analytics API, необходимо зарегистрировать как проекты в Google API Console.

  • Каждый запрос к API должен содержать ключ API или идентификатор и секретный код клиента для OAuth 2.0.

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

  • К обоим API Google Аналитики (Management API и Data Export API) применяются следующие квоты:

    • 50 000 запросов в день на проект
    • 10 запросов в секунду на IP-адрес
  • К Data Export API применяются также следующие квоты:

    • 10 000 запросов в день на представление (профиль)
    • 10 параллельных запросов на профиль
  • Незарегистрированным приложениям предоставляется минимальная квота для тестирования.

Прекращение поддержки

  • В этом выпуске анонсировано прекращение поддержки версии 2.3, а также фида аккаунта в Data Export API. Через 6 месяцев:

    • Запросы к XML-фиду данных версии 2.3 будут перенаправляться в версию 2.4 и возвращать ответ версии 2.4. Кроме того, все правила в отношении квот для версии 2.4 будут применяться к запросам версии 2.3.

    • Запросы для получения данных в формате JSON версии 2.3 больше не будут поддерживаться в ответе версии 2.4. По таким запросам будет возвращаться код статуса 404 Not Found. Чтобы получать ответы в формате JSON, перейдите на версию 3.0.

    • Запросы к фиду аккаунта Data Export API будут возвращать код статуса 404 Not Found. Все запросы данных конфигурации необходимо выполнять через Management API.

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

Новые данные

  • В коллекцию расширенных сегментов добавлено поле segmentId, которое может использоваться в параметре segment Data Export API.

Изменения

  • Тип данных max-results изменен на integer.

  • Установлено новое максимальное значение max-results по умолчанию: 1000.

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

  • Аккаунты, веб-ресурсы и профили для экспериментов в Оптимизаторе веб-сайтов удалены из соответствующих коллекций.

В этой версии внесены следующие изменения:

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

    • В файл ReadMe.txt добавлены ссылки на ресурсы с документацией.

В этой версии внесены следующие изменения:

  • Исправленные ошибки
    • Устранены проблемы с автоматическим отслеживанием целевых URL в Google Play.
    • Параметр referrer в методе setReferrer теперь может кодироваться, как URL.

Изменения в сборе данных о скорости загрузки сайта:

  • Для всех веб-ресурсов доля выборки автоматически устанавливается на уровне 1 %. Прекращена поддержка функции _trackPageLoadTime, которая раньше требовалась для включения сбора данных о скорости загрузки сайта.
  • Долю выборки по умолчанию можно корректировать с помощью новой функции _setSiteSpeedSampleRate.
  • Если в вызове _trackPageview используется виртуальный путь, то этот путь теперь будет также связан со всеми собранными на странице данными о скорости загрузки сайта.

В этой версии внесены следующие изменения:

  • Исправленные ошибки
    • Каталог, в котором хранится база данных, изменен с Documents на Library.
    • SDK больше не генерирует NSAsserts для ошибок базы данных SQLite.
    • Исправлена ошибка, возникающая при вызове trackPageview с пустой строкой.
    • Исправлена ошибка, возникающая при вызове какого-либо метода GANTracker после stopTracker.
    • Устранено несколько утечек памяти, одна из которых возникала при вызове trackPageview с параметром pageURL, начинающимся с косой черты (/).
  • Новые функции
    • Добавлен метод dispatchSynchronously.
    • Добавлено несколько полезных констант (см. GANTracker.h).

В этой версии внесены следующие изменения:

  • Исправленные ошибки
    • Перехвачено и обработано несколько исключений SQLiteExceptions.
    • Устранено исключение NullPointerException, возникающее при вызове stopSession перед startNewSession.
    • Исправлены ошибки нехватки памяти на устройствах HTC Thunderbolt и Motorola Droid Bionic.
    • Закрыт ненужный доступ к базе данных в методе dispatch.

Добавлена новая функция:

  • Если событие не является взаимодействием, к нему можно добавить соответствующую пометку, присвоив параметру opt_noninteraction в методе _trackEvent() значение true. Такое событие не будет учитываться в показателе отказов. См. руководство по ga.js.

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

  • Исправлена ошибка распространения параметра URL gclid (AdWords) по внутренним ссылкам, приводящая к завышению числа оплачиваемых посещений.

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

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

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

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

В этой версии внесены следующие изменения:

  • Исправленные ошибки
    • Исправлена ошибка шины, возникающая при попытке установить флаг dryRun до запуска счетчика.
    • Исправлена ошибка шины, возникающая при попытке передать для ошибки значение NULL.
    • Теперь в заголовке HTTP используется правильный язык.
  • Новые функции
    • Добавлен флаг anonymizeIp.
    • Добавлен параметр sampleRate.
    • Добавлена поддержка для переходов кампаний.

В этой версии внесены следующие изменения:

  • Исправленные ошибки
    • Исправлена ошибка в отслеживании переходов кампаний.
    • Исправлен флаг anonymizeIp, мешающий отслеживанию кампаний.

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

Версия 3.0

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

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

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

Версия 2.4

  • Это обновленная неосновная версия, по большей части обратно совместимая с существующей версией 2.3.

  • Изменения

    • Новые правила в отношении квот.
    • Интеграция с Google API Console для управления доступом к API и увеличения квот.
    • Поддержка существующих способов авторизации и OAuth 2.0.
    • Новый URL для создания запросов: https://www.googleapis.com/analytics/v2.4/management/….
    • Ответы только в формате XML.
    • Клиентская библиотека Google Data JavaScript не поддерживается.
    • Версия 2.3 поддерживает XML-формат выходных данных, поэтому другие существующие клиентские библиотеки Google Data будут работать.

Прекращение поддержки

  • Мы анонсировали прекращение поддержки Management API версии 2.3. Эта версия будет работать ещё два месяца, а затем все запросы к ней будут возвращать ответ версии 2.4.

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

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

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

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

    • Параметры товара с показателями транзакции.
    • ga:adContent или ga:adGroup с ga:impressions.

    Теперь вместо пустого ответа API возвращает ошибку 400 для всех запросов с указанными комбинациями.

Изменения в подсчете сеансов:

  • Одна кампания на сеанс. Если во время текущего сеанса выполняется переход в рамках новой кампании, скрипт отслеживания создает ещё один сеанс. Это происходит при изменении любого из следующих параметров: campaign id, name, source, medium, term, content, gclid.
  • Скрипт отслеживания больше не создает сеанс, если пользователь закрывает браузер.

Изменения в междоменном отслеживании:

  • При настройке междоменного отслеживания больше не требуется вызывать метод _setAllowHash(false). Страницы с вызовом _setAllowHash(false) будут работать, но добавлять его на новые сайты не нужно.
  • Скрипт отслеживания будет пытаться восстановить параметры связывания, искаженные HTTP-перенаправителем или браузером. Около 85 % значений параметров связывания, которые до этого отбрасывались из-за изменения кодировки перенаправителями и браузерами, теперь могут быть успешно восстановлены и приняты скриптом отслеживания.

В этой версии внесены следующие изменения:

  • Исправленные ошибки
    • Исправлены ошибки, возникавшие при работе с базой данных.
    • Устранены исключения, возникавшие при использовании собственных переменных.
    • Настроено хранение контекста приложения, а не контекста, переданного в приложение.
    • Исключена возможность случайного создания фантомного сеанса.
  • Новые функции
    • Добавлена возможность в любое время задавать переходы кампаний.
    • Добавлен флаг sampleRate.
    • Добавлен флаг anonymizeIp.

Добавлена новая функция:

  • Теперь код отслеживания откладывает отправку обращения при предварительной визуализации, пока пользователь не увидит страницу. Если просмотр не состоится, обращение отправлено не будет. Эта функция доступна только на сайтах, использующих асинхронный код отслеживания. Подробная информация о предварительной визуализации приведена в блоге Центра веб-мастеров Google.

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

  • Добавлено отслеживание действий в социальных сетях (_trackSocial).

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

Прекращение поддержки доверительного интервала

  • Не используйте доверительные интервалы показателей. Теперь фид данных Data Export API будет возвращать нулевое значение доверительного интервала. Примерно через месяц мы удалим этот атрибут из всех элементов показателей.

    Узнать, выполнена ли выборка, можно с помощью поля containsSampledData в ответе.

В этой версии внесены следующие изменения:

  • Исправленные ошибки
    • Исправлена ошибка, приводившая к сбоям при использовании собственных переменных.
    • Устранена утечка памяти при использовании собственных переменных.
  • Новые функции
    • Добавлена поддержка обращений электронной торговли.
    • Добавлен флаг Debug.
    • Добавлен флаг DryRun.
    • Добавлены более информативные описания ошибок при сбоях в SQLite3.

В этой версии внесены следующие изменения:

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

    • Исправлен формат строки userAgent.
  • Новые функции

    • Добавлена поддержка отслеживания электронной торговли.
    • Добавлен флаг debug.
    • Добавлен флаг dryRun.

В этой версии добавлено 3 новых показателя и обновлены возвращаемые значения для еще 2 показателей.

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

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

Обновления показателей

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

  • ga:CTR теперь возвращает процентное значение (то есть 2 для 2 %).

В этой версии внесены следующие изменения:

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

В этой версии внесены следующие изменения:

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

    • Исправлена кодировка пробелов.
    • Исключения SQLiteExceptions больше не приводят к сбою приложений.
  • Новые функции

    • Добавлена поддержка пользовательских переменных.

В этой версии повышена производительность фида данных и добавлены новые данные.

Повышение производительности

  • Время реакции фида данных уменьшилось на 30–35 %.

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

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

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

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

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

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

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

  • Поддержка метода POST:

    • Код отслеживания теперь может отправлять за один раз гораздо больше информации. Раньше использовались только HTTP-запросы GET, для которых некоторые браузеры и прокси-серверы устанавливают ограничение 2048 символов. Запросы большего объема отклонялись, и данные не попадали в Google Аналитику. Начиная с этого выпуска, запросы длиной более 2048 символов будут передаваться с помощью метода POST, ограничение для которого составляет 8192 символа.

В этой версии в фид данных были добавлены дополнительные данные.

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

  • Добавлен новый параметр категории "Время": ga:dayOfWeek.

  • Добавлен новый показатель категории "Внутренний поиск": ga:percentVisitsWithSearch.

  • Добавлены новые показатели категории "Отслеживание событий":

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

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

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

В этой версии внесены следующие изменения:

  • Исправлена ошибка, которая мешала корректной работе _addIgnoredOrganic и _addIgnoredRef при первом посещении сайта.
  • Исправлена ошибка, связанная с выполнением кода отслеживания в нескольких окнах iframe.

В этой версии внесены следующие изменения:

  • Новые функции
    • Добавлена поддержка пользовательских переменных.
    • Добавлена версия библиотеки NoThumb.

В этой версии был значительно увеличен набор данных в фиде данных.

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

  • По запросу показателя ga:visitors теперь возвращается количество уникальных посетителей за выбранный диапазон дат. Данный показатель теперь можно использовать в большем количестве комбинаций с другими параметрами и показателями.

  • Добавлено 10 новых параметров AdWords: ga:adDistributionNetwork, ga:adMatchType, ga:adMatchedQuery, ga:adPlacementDomain, ga:adPlacementUrl, ga:adFormat, ga:adTargetingType, ga:adTargetingOption, ga:adDisplayUrl, ga:adDestinationUrl.

  • В группу "Кампания" добавлен новый показатель ga:organicSearches.

  • В группу "Внутренний поиск" добавлен новый показатель ga:searchResultViews.

  • Добавлено 3 новых параметра категории "Время": ga:nthDay, ga:nthWeek, ga:nthMonth.

  • Группировка параметров и показателей была изменена и теперь лучше отражает соответствующие функции.

Новые вычисляемые показатели

Указанные ниже показатели вычисляются на основе базовых показателей. В названии с (n) поддерживаются числовые значения от 1 до 20.

  • Для целей: ga:costPerConversion, ga:costPerGoalConversion, ga:costPerTransaction, ga:goal(n)AbandonRate, ga:goal(n)Abandons, ga:goal(n)ConversionRate, ga:goalAbandonRateAll, ga:goalAbandonsAll, ga:goalConversionRateAll, ga:goalValueAllPerSearch, ga:goalValuePerVisit.

  • Для контента: ga:entranceBounceRate, ga:visitBounceRate, ga:entranceRate, ga:exitRate, ga:pageviewsPerVisit, ga:avgTimeOnPage, ga:avgTimeOnSite, ga:avgEventValue.

  • Для внутреннего поиска: ga:avgSearchDepth, ga:avgSearchDuration, ga:avgSearchResultViews, ga:searchGoalConversionRateAll, ga:searchGoal(n)ConversionRate, ga:searchExitRate.

  • Для электронной торговли: ga:itemsPerPurchase, ga:margin, ga:percentNewVisits, ga:revenuePerItem, ga:revenuePerTransaction, ga:ROI, ga:RPC, ga:totalValue, ga:transactionRevenuePerVisit, ga:transactionsPerVisit.

В этом выпуске в фид данных добавлена новая функция.

Новые функции

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

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

В этой версии внесены следующие изменения:

  • Новые функции

    • Добавлена поддержка iOS4.

В этой версии исправлены 2 ошибки.

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

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

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

Выпущена бета-версия Google Analytics Management API.

Новые фиды

Обновленные клиентские библиотеки

  • Management API выходит в той же библиотеке, что и Google Analytics Data Export API. Обновлены библиотеки Google Data Java и JavaScript. Чтобы получить доступ к определенному фиду, укажите его URI в методе библиотек getManagementFeed().

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

  • В документацию по Google Аналитике для разработчиков добавлен раздел с описанием нового Management API.

В этой версии исправлены 3 ошибки.

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

  • Исправлена ошибка кодировки в клиентской библиотеке JavaScript. Система отслеживания ошибок

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

  • В параметре фильтра в запросе фида данных нельзя использовать оператор ИЛИ для параметра и показателя. Пример: ga:source==google,ga:visits>5. Изменено сообщение об ошибке для такого запроса. Теперь оно выглядит следующим образом: Cannot OR dimension filter(s) with metric filter.

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

Новые функции

  • В новую категорию D8. Adwords добавлено 5 параметров:

    • ga:adwordsAdGroupId – соответствует AdGroup.id в AdWords API
    • ga:adwordsCampaignId – соответствует Campaign.id в AdWords API
    • ga:adwordsCreativeId – соответствует Ad.id в AdWords API
    • ga:adwordsCriteriaId – соответствует Criterion.id в AdWords API
    • ga:adwordsCustomerId – соответствует AccountInfo.customerId в AdWords API

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

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

В этой версии исправлены ошибки и выполнена очистка API.

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

    • Исправлена ошибка отслеживания событий. Перед вызовом _trackEvent теперь не надо выполнять вызов _initData или _trackPageview.
    • Обновлен асинхронный код: теперь его можно разместить в теге head любой страницы. Это не вызовет проблем в Internet Explorer 6 и 7. См. руководство по работе с асинхронным кодом. Это изменение внесено 22 марта 2010 г.
    • Синтаксис фрагмента асинхронного кода расширен; теперь поддерживаются методы вызова для объекта _gat.
  • Обновлены API инициализации счетчика в соответствии с асинхронным синтаксисом. Прекращена поддержка устаревших функций.

    • Добавлена функция _gat._createTracker(opt_account, opt_name). Она позволяет присваивать имена объектам отслеживания и позже извлекать их по этим именам. Используйте ее вместо _gat._getTracker(account).
    • Добавлена функция _gat._getTrackerByName(name). Она получает объект отслеживания с заданным именем.
    • Добавлена функция tracker._getName(). Она возвращает имя, присвоенное объекту отслеживания при создании.
    • Прекращена поддержка функции _gaq._createAsyncTracker(account, opt_name). Вместо нее следует использовать _gat._createTracker.
    • Прекращена поддержка функции _gaq._getAsyncTracker(name). Вместо нее следует использовать _gat._getTrackerByName.
  • Подробная информация об этих изменениях в API приведена здесь.

В этой версии добавлено несколько новых функций и исправлена одна ошибка.

Новые функции

  • Сегмент по умолчанию "iPhone" (gaid::-11) теперь позволяет получить данные по всем мобильным устройствам. Его идентификатор остался прежним (-11), но название изменилось на Mobile Traffic.

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

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

    • Для каждого веб-ресурса допускается максимум 10 000 запросов в течение 24 часов.
    • Приложение может выполнять не более 10 запросов за 1 секунду.
    • В каждый момент времени у приложения может быть не более 4 ожидающих запросов.
  • Установлены менее строгие ограничения на комбинации параметров и показателей. ga:nextPagePath и ga:previousPagePath теперь входят в группу D3. Content. Группа D8. Custom Variable переименована в D6. Custom Variable. Новые комбинации приведены в справочном руководстве.

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

  • Мы исправили ошибку, связанную с представлением значения confidenceInterval для показателей. Ранее для доверительных интервалов использовалось значение INF или число от 0 до 1. Теперь все доверительные интервалы имеют значение INF, 0 или число больше 0.

  • Ранее для показателя ga:itemQuantity возвращалось значение показателя ga:uniquePurchases и наоборот. Теперь эта ошибка исправлена, и возвращаются правильные данные.

Напоминание об удалении параметров и показателей

  • Перестаньте использовать устаревшие параметры и показатели, если вы ещё этого не сделали.

В этой версии добавлено несколько новых функций.

В этом выпуске основной версии присвоен новый номер – 2.

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

    • Чтобы запросить версию 2, добавьте заголовок GData-Version: 2 в каждый аккаунт или запрос фида данных. Подробная информация приведена в документации.
    • В фиды аккаунтов и данных добавлено новое пространство имен XML:
      xmlns:ga='http://schemas.google.com/ga/2009'
  • API теперь поддерживает протокол Google Data версии 2.

Поддержка расширенного сегментирования

  • Параметр запроса динамических сегментов:

    • ...&segment=dynamic::выражение.
    • Позволяет оперативно создавать расширенные сегменты.
    • Выражением может быть любой параметр или показатель (необходимо использовать тот же синтаксис, что и в фильтрах).
  • Параметр запроса сегментов по умолчанию и пользовательских сегментов:

    • ...&segment=gaid::число.
    • Число – это идентификатор расширенного сегмента, определенного в веб-интерфейсе Google Аналитики.
    • Идентификатор представлен в фиде аккаунтов.
  • Фид аккаунтов описывает данные сегмента с помощью следующих атрибутов и элементов XML:

    • <dxp:segment id="gaid::-3" name="Returning Visitors"></dxp:segment>
    • <dxp:definition>ga:visitorType==Returning Visitor</dxp:definition>
  • В фиде данных также представлен элемент XML, указывающий, применен ли сегмент в запросе к API.

  • Подробная информация о расширенных сегментах приведена в документации.

Новые данные по целям

  • В фиде аккаунтов доступны цели типа "Переход по URL" и "Взаимодействие":

    • <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>
  • Для целей 5–20 добавлено 48 новых показателей, имеющих вид goal(n)Completions, где (n) – число от 1 до 20.

    • ga:goal(n)Completions
    • ga:goal(n)Starts
    • ga:goal(n)Value
  • Показатели GoalCompletionAll, GoalStartsAll и GoalValueAll обновлены и теперь учитывают новые данные по целям.

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

  • Все пользовательские переменные, когда-либо передаваемые в профили, добавлены в фид аккаунтов в виде нового элемента XML:

    • <ga:customvariable index="1" name="category" scope="visitor"></ga:customvariable>
  • Добавлено 10 новых параметров для пользовательских переменных. Все он имеют вид customVar(n), где (n) – число от 1 до 5.

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

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

  • Перестаньте использовать устаревшие параметры и показатели, если вы ещё этого не сделали. Эти параметры скоро будут удалены. Если вы будете запрашивать их, API будет возвращать ошибку.

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • Изменены названия следующих параметров:

    • ga:countOfVisits теперь называется ga:visitCount.
    • ga:countOfVisitsToATransaction теперь называется ga:visitsToTransaction.

В этой версии обновлен список поисковых систем по умолчанию и добавлены новые функции управления тайм-аутами файлов cookie. Кроме того, запущен фрагмент асинхронного кода отслеживания Google Аналитики, который минимизирует влияние ga.js на время загрузки страницы.

  • Обновлен список поисковых систем по умолчанию:

    • добавлены поисковые системы Naver, Eniro и Daum;
    • из списка удалены Looksmart, Gigablast, Club-internet, Netsprint, Intera, Nostrum и Ilse.
  • Добавлены функции, позволяющие управлять сроком действия всех сохраненных файлов cookie. Прекращена поддержка существующих функций управления тайм-аутом файлов cookie. Подробная информация приведена в документации по JS API.

    • Функция _setVisitorCookieTimeout(cookieTimeoutMillis) заменила функцию _setCookiePersistence.
    • Функция _setSessionCookieTimeout(cookieTimeoutMillis) заменила функцию _setSessionTimeout.
    • Функция _setCampaignCookieTimeout(cookieTimeoutMillis) заменила функцию _setCookieTimeout.
  • Запущен асинхронный код отслеживания Google Аналитики. О том, как начать с ним работу, читайте в документации.

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

В этой версии внесены следующие изменения:

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

    • _getVisitorCustomVar(index)
  • Теперь содержание отчета Site Overlay загружается сразу после выполнения ga.js, не дожидаясь выполнения window.onload.

В этой версии внесено следующее изменение:

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

    • _addOrganic(newOrganicEngine, newOrganicKeyword, opt_prepend)

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

В этой версии добавлено несколько новых и удалено несколько старых функций.

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

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • Были изменены названия следующих параметров:

    • ga:countOfVisits теперь называется ga:visitCount;
    • ga:countOfVisitsToATransaction теперь называется ga:visitsToTransaction.
  • Все данные отслеживания событий теперь представлены в 2 новых группах:

    D7. События (параметры) * ga:eventCategory * ga:eventAction * ga:eventLabel

    M7. События (показатели) * ga:eventValue * ga:totalEvents * ga:uniqueEvents

  • Данные относительно общей навигации по сайту теперь можно получить с помощью следующих параметров:

    D6. Навигация * ga:previousPagePath * ga:nextPagePath

  • Данные относительно навигации по целевой странице теперь можно получить с помощью следующих параметров:

    D3. Контент * ga:landingPagePath * ga:secondPagePath

  • Максимальная длина регулярных выражений в параметрах запроса фильтра фида данных увеличена с 32 до 128 символов.

  • Длительность посещения (отчет о ней можно найти в разделе "Посетители > Лояльность посетителей") теперь представлена новым параметром:

    • ga:visitLength

В этой версии исправлены ошибки и повышена производительность.

  • Следующие данные отображаются в правильной кодировке: запросы обычного поиска; информация о пути к веб-странице (utmp); пользовательские значения при использовании функции linker (например, функции _link и _linkByPost).
  • В список систем обычного поиска добавлена система Rambler.
  • Исправлен синтаксический анализ результатов поиска на http://kvasir.no.
  • Системы обычного поиска, добавляемые пользователем, помещаются в начало списка.
  • Прекращена поддержка удаленной функции _trackEvent(action, label, value); вместо нее используется функция _trackEvent(category, action, label, value).
  • URL переходов теперь сохраняются с учетом регистра. Например, URL страницы www.domain.com/PaGe.HtMl будет сохранен именно в таком виде.
  • Введено ограничение на количество символов в токене GASO – не более 1200.
  • Добавлена новая функция _setCookiePersistence(timeout), позволяющая переопределить значения тайм-аута по умолчанию для файлов cookie.

В этой версии Google Analytics Data Export API внесены следующие изменения:

  • Установлены менее строгие ограничения на комбинации параметров и показателей. Теперь можно одновременно запрашивать большинство параметров категорий "Контент" и "Посетители". Например, разрешено использовать комбинацию ga:pagePath и ga:source. Новые комбинации приведены в справочном руководстве на странице http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html

  • В рамках одного запроса теперь можно получить больше строк – до 10 000. По умолчанию по-прежнему возвращается 1000 строк, однако их количество можно увеличить, задав соответствующее значение параметра запроса max-results.

  • Фид аккаунтов теперь возвращает два новых элемента данных для всех идентификаторов таблиц (валюту и часовой пояс).
    <dxp:property name="ga:currency" value="USD"></dxp:property>
    <dxp:property name="ga:timezone" value="America/Los_Angeles"></dxp:property>

  • Теперь в запросах данных обязательно должен присутствовать по крайней мере один допустимый показатель.

  • Все предыдущие изменения, связанные с удалением параметров и показателей, вступили в силу.

В этой версии прекращается поддержка удаленных функций предыдущей бета-версии:

  • Использование имени пользователя в запросах фида аккаунтов больше не поддерживается. Теперь принимаются запросы лишь следующего формата:
    https://www.google.com/analytics/feeds/accounts/default

  • Указанные ниже показатели удаляются и больше поддерживаться не будут. Теперь вы можете рассчитать эти значения. Инструкции приведены на странице 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
  • Указанные ниже параметры и показатели были переименованы. Старые названия больше не поддерживаются. Проверить, правильные ли вы используете названия, можно на странице http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html.

    Параметры * 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

    Показатели * 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