Отслеживание с помощью Measurement Protocol

Для сбора основных событий о поведении пользователей в BigQuery, OWOX BI с помощью методов customTask или analytics.js дублирует на точку доступа OWOX BI все данные, которые Google Analytics собирает с сайта.

Для отправки оффлайн-событий, или событий, произошедших позже основной сессии пользователя на сайте, Google Analytics предлагает использовать Measurement Protocol, который отправляет любые данные о поведении пользователей напрямую в Google Analytics с помощью HTTP-запросов.

Точка доступа OWOX BI

Если вы отправляете определенные события в Google Analytics с помощью Measurement Protocol, их также необходимо дублировать на точку доступа OWOX BI — https://google-analytics.bi.owox.com/UA-XXXXX-X, где UA-XXXXX-X — ваш идентификатор отслеживания (tracking ID) в Google Analytics.

Без этого, события не попадут в BigQuery, и вы будете видеть расхождения данных с Google Analytics.

Напомним, что для отправки данных в Google Analytics вам по-прежнему необходимо отправлять запрос на https://www.google-analytics.com/collect.

Отправка запросов

Отправка запросов в нашу точку доступа не отличается от отправки в Google Analytics — вы точно так же отправляете данные в виде POST- или GET-запроса. Как должны выглядеть запросы — описано в справке Google.

POST-запросы (рекомендуемый нами способ)

Для POST-запроса необходимо указать payload-часть, идентичную той, что вы передаете в Google Analytics. Вот пример payload-части:

v=1&cid=555&t=pageview&dp=%2Fhome

Для POST-запросов используйте один из этих заголовков Content-type:

1. application/x-www-form-urlencoded;
2. application/octet-stream;
3. text/plain.

GET-запросы

Для GET-запроса набор передаваемых параметров нужно указать в самой ссылке. Например:

https://google-analytics.bi.owox.com/UA-XXXXX-X?v=1&cid=555&t=pageview&dp=%2Fhome

Требования к формату значений полей

Формат значения для каждого из полей должен соответствовать документации Measurement Protocol. 

Однако к некоторым полям OWOX BI предъявляет дополнительные требования, связанные с особенностями их обработки. В таблице ниже вы увидите список таких полей и допустимый формат значений к ним.

Обратите внимание Данные, не соответствующие указанному формату, не могут быть обработаны OWOX BI и будут записаны в таблицы Google BigQuery как NULL.

Использование параметра queueTime (&qt)

По умолчанию, время отправки события считается временем его происхождения. Однако для некоторых событий уведомления через Measurement Protocol происходят с отсрочкой во времени. Например, при онлайн-оплате подтверждение от банка происходит значительно позже фактического действия пользователя. Чтобы соотнести такое событие со временем, когда оно случилось, используется параметр queueTime (&qt).

Значение параметра &qt показывает сколько времени прошло с момента события до его отправки в миллисекундах. Благодаря установке этого параметра, время получения хита (поле time) будет рассчитано корректно.

Обратите вниманиеЗначение &qt должно иметь тип integer и быть больше или равно 0.
В ином случае параметру &qt будет автоматически присвоено значение NULL, а хиту — значение времени на момент отправки этого события.

Ниже описана логика обработки данных при отправке ненулевого параметра &qt.

Подробнее о том, как значение параметра qt влияет на присвоение транзакции к сессии, читайте в этой статье.

Ограничения

• В запросе обязательно должен быть передан параметр clientId (&cid) или userId (&uid). Без отправки хотя бы одного из этих параметров, хит не будет обработан ни в OWOX BI, ни в Google Analytics.

• При передаче параметров транзакции с помощью нескольких хитов через Measurement Protocol, стоит учесть следующую особенность: Google Analytics фиксирует хиты только с уникальным объектом actionField. То есть если передать несколько хитов с одинаковыми значениями параметров в объекте actionField, в Google Analytics будет учтен только один из этих хитов. OWOX BI при этом зафиксирует все полученные хиты. 

  Чтобы избежать расхождений в подсчетах количества транзакций в GA и OWOX BI, обеспечьте уникальность объектов actionField, например, указывая различные значения параметра Revenue, Tax или Affiliation в объекте actionField каждого хита транзакции.
• Для потока OWOX BI максимальный размер обрабатываемых в хите данных — 16 КБ. Хиты большего объема не будут обработаны и записаны в BigQuery.
• Лимит на размер тела хита в Google Analytics — 8 КБ.

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

Пример запроса

HOST:
https://google-analytics.bi.owox.com/UA-XXXXX-X

PAYLOAD:

 "v": 1,
 "tid": "UA-XXXXX-X",
 "cid": "111111111.111111111",
 "t": "event",
 "ec": "Call",
 "ea": "Request",
 "el": "Form №1",
 "ev": 0,
 "dh": "example.com",
 "ds": "call-center",
 "uip": "11.111.11.11",
 "ua": "Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)",
 "dr": "https://www.google.com/",
 "qt": 0

Пример разбивки по параметрам: