Для сбора основных событий о поведении пользователей в 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 КБ.
0 Комментарии