Ожидаемые данные отчетов

В этом руководстве приведена важная информация о данных, которые вы видите в отчетах, созданных с помощью Google Analytics Data API. Пользователи часто сталкиваются с расхождениями между данными, возвращаемыми API (в частности, методом runReport), и данными, которые показываются в интерфейсе Google Аналитики.

Выборка и агрегирование

Метод Data API Google Аналитики runReport может возвращать выборку данных, особенно для больших наборов данных или сложных запросов. Хотя в интерфейсе Google Аналитики также применяется выборка, пороговые значения и алгоритмы могут отличаться, что приводит к небольшим расхождениям в данных.

Чтобы узнать, основаны ли результаты отчета на подмножестве доступных данных, проверьте поле samplingMetadatas объекта ResponseMetaData. Если в отчете используются данные выборки, в этом поле указывается процент событий, использованных в отчете.

Некоторые методы создания отчетов в Google Analytics Data API позволяют указать нужный уровень выборки. Чтобы задать уровень выборки для отчета, используйте поле samplingLevel метода properties.reportTasks.create.

Эта функция позволяет ресурсам Google Аналитики 360 использовать выборку до 1 млрд событий. Кроме того, можно задать ограничения на выборку UNSAMPLED, чтобы использовать результаты без выборки для большого количества событий.

Подробнее о выборке данных…

Приблизительный расчет уникальных значений

В Google Аналитике Data API используется алгоритм HyperLogLog++ (HLL++), чтобы оценивать количество уникальных значений для таких показателей, как "Активные пользователи" и "Сеансы". Этот подход используется в API и интерфейсе Google Аналитики, чтобы повысить производительность и эффективно управлять большими наборами данных. Это означает, что результаты являются приблизительными, а не точными.

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

Пороговые значения

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

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

Чтобы узнать, применяется ли к отчету пороговое значение, проверьте поле subjectToThresholding объекта ResponseMetaData.

Подробнее о пороговых значениях…

Строка (other)

Если у параметра большое количество уникальных значений, Google Аналитика может сгруппировать менее распространенные значения в строку с названием (other). Это чаще происходит в отчетах, в которых есть параметры с более чем 500 уникальными значениями в день.

При использовании фильтров с Data API учитывайте, что фильтры не просматривают данные в строке (other) и применяются после агрегирования данных и создания строки (other).

Чтобы узнать, содержит ли отчет данные, объединенные в строку (other), проверьте поле dataLossFromOtherRow объекта ResponseMetaData.

Подробнее о строке "(Прочие)" в Google Аналитике…

Способы идентификации

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

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

Специфичность запроса

Чтобы свести расхождения к минимуму, убедитесь, что следующие параметры в запросе API точно соответствуют настройкам в отчете интерфейса Google Аналитики:

  • Диапазоны дат. Убедитесь, что даты начала и окончания совпадают.
  • Параметры и показатели. Убедитесь, что параметры и показатели в запросе к API совпадают с параметрами и показателями в отчете интерфейса Google Аналитики.
  • Фильтры. Убедитесь, что фильтры параметров и показателей, примененные в запросе к API, совпадают с фильтрами, используемыми в интерфейсе.

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

Актуальность данных

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

Подробнее об актуальности данных…

Альтернативные варианты для полных данных

Если вам нужны полные данные на уровне событий без выборки, попробуйте следующие альтернативные варианты:

  • BigQuery Export: BigQuery Export для Google Аналитики

    рекомендуется для расширенного анализа необработанных данных о событиях.

  • Аналитика 360. В ресурсах с лицензией Аналитики 360 действуют более высокие лимиты на выборку и доступны более подробные отчеты.