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

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

Введение

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

С помощью API отчетности по многоканальным последовательностям вы можете:

  • Создавайте собственные отчеты, используя данные многоканальных последовательностей. Например, вы можете использовать данные «Основные пути конверсии» для составления отчетов по таким атрибутам, как относительное положение взаимодействий на пути конверсии.
  • Интегрируйте данные многоканальных последовательностей с вашими бизнес-данными. Например, вы можете сопоставить данные онлайн-конверсий с данными офлайн-продаж и данными о стоимости рекламы, чтобы получить более полную картину рентабельности инвестиций в маркетинг.
  • Отображение многоканальных последовательностей в новых средах. Например, вы можете создавать визуализации и другие представления данных, которые отражают ценность различных маркетинговых каналов для увеличения конверсий.

Концептуальный обзор

Фундаментальными концепциями, лежащими в основе API отчетности по многоканальным последовательностям, являются:

  • Как отчеты связаны с пользователями и представлениями (профилями).
  • Структура отчета и способы построения запросов.
  • Данные о пути конверсии и концепции атрибуции.
  • Работа с ответом API.

Отчеты, пользователи и представления (профили)

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

Запрос параметров и показателей

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

Используйте Справочное руководство по параметрам и метрикам , чтобы изучить все параметры и метрики, предоставляемые через API. Также прочтите Справочное руководство по API отчетности по многоканальным последовательностям, чтобы узнать, как указывать параметры и показатели в запросе API.

Данные о пути конверсии и концепции атрибуции

Отчеты по многоканальным последовательностям создаются на основе путей конверсии: последовательностей взаимодействий (например, кликов/переходов из каналов), которые привели к каждой конверсии и транзакции. Пути конверсии собираются с помощью файла cookie Google Analytics, который записывает взаимодействия с одним и тем же браузером и компьютером. Данные многоканальных последовательностей объединяют данные о конверсиях Google Analytics с последовательностью взаимодействий, зафиксированной в файле cookie.

Запросы отчетов по многоканальным последовательностям возвращают данные на основе выборки из 1 миллиона путей конверсии. Если диапазон дат включает общее количество конверсий не более 1 миллиона, отчет будет полным. В противном случае для генерации результатов будет использоваться выборка из 1 миллиона. Это контрастирует с функцией базовой отчетности, которая осуществляет выборку на основе сеансов. Дополнительную информацию о данных и связанных с ними концепциях можно найти в статье «О данных многоканальных последовательностей» . Вам также может быть полезно прочитать статью «Анализ вклада канала» , в которой определяются основные понятия, такие как вспомогательные конверсии.

Работа с отчетами

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

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

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

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

Следующие шаги

Теперь, когда вы понимаете, как работает API, у нас есть несколько ресурсов, которые помогут вам начать работу: