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

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

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

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

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

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

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

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

Вот пример payload-части:

v=1&tid=UA-12345-1&cid=555&t=pageview&dp=%2Fhome

Обратите внимание При отправке POST-запроса в нашу точку доступа, обязательно укажите GET-параметр tid — идентификатор отслеживания ресурса в Google Analytics, из которого OWOX BI передает данные в Google BigQuery.

Для GET-запроса набор передаваемых параметров нужно указать в самом теле запроса. для отправки данных в нашу точку доступа, мы рекомендуем использовать POST-запрос.

Обратите вниманиеДанные, отправленные на точку доступа https://google-analytics.bi.owox.com/collect?tid=UA-XXXXX-X отобразятся только в BigQuery.
Для отправки данных в Google Analytics вам по-прежнему необходимо отправлять запрос на https://www.google-analytics.com/collect.

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

При отправке данных о хитах через Measurement Protocol, бывают случаи, когда транзакция происходит после истечения времени сессии пользователя на сайте. Например, при онлайн-платеже должно произойти подтверждение банка, которое может занять до нескольких дней, и только после этого будет отправлено событие транзакции.

Чтобы для такого события не была создана отдельная сессия, укажите в запросе параметр &qt (queueTime) — это промежуток времени в милисекундах между совершением хита и его отправкой.

В таком случае время получения хита (поле time) будет рассчитано с учётом разницы времени, указанного в &qt.

При отправке ненулевого параметра &qt:

• Хиты всегда попадут в таблицы с данными о хитах (streaming) в BigQuery вне зависимости от величины значения &qt.
• При сборе данных о сессиях на основе алгоритма OWOX BI, максимальное значение &qt — 30 дней. Хиты попадут в правильную сессию в таблице данных о сессиях в течение 30 дней* с момента совершения события.
• При сборе данных о сессиях на основе алгоритма Google Analytics, хиты будут отнесены к соответствующим сессиям в течение 48 часов* согласно clientId и timestamp, переданным в пользовательском параметре (&cd).

*После окончания суток, когда события были совершены, во временной зоне представления Google Analytics.

Обратите вниманиеПри отправке параметра &qt со значением больше, чем 4 часа, событие не попадет в Google Analytcs, что приведет к расхождению между данными OWOX BI и Google Analytics — в OWOX BI попадет больше данных.
Указывайте значение &qt больше, чем 4 часа только в случае, если вам необходимо, чтобы события, отправленные через Measurement Protocol, попали в сессию, в которой они были совершены.

Ограничения

• В запросе обязательно должен быть передан clientId (параметр &cid) или userId (параметр &uid). Без отправки хотя бы одного из этих параметров, хит не будет обработан ни в OWOX BI, ни в Google Analytics.
• Для потока OWOX BI максимальный размер обрабатываемых в хите данных — 16 КБ. Хиты большего объема не будут обработаны и записаны в BigQuery.
• Лимит на размер тела хита в Google Analytics — 8 КБ.