Для сбора основных событий о поведении пользователей в BigQuery, OWOX BI с помощью методов customTask или 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/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/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 и времени фактического отправления хита.
Пример: Сегодня — 10-е августа 2019 года. Хит отправленный сегодня с параметром &qt=86400000 (-24 часа) попадёт в хитовые таблицы собранные 9-го августа 2019 года.
Обратите внимание:При отправке параметра &qt
со значением больше, чем 4 часа, событие не попадет в Google Analytcs, что приведет к расхождению между данными OWOX BI и Google Analytics — в OWOX BI попадет больше данных.
Указывайте значение &qt
больше, чем 4 часа только в случае, если вам необходимо, чтобы события, отправленные через Measurement Protocol, попали в сессию, в которой они были совершены.
Ограничения
- В запросе обязательно должен быть передан
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 КБ.
Пример запроса
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
Пример разбивки по параметрам:
hitid | 4a44b2ce-be1b-41f3-8153-50b65461911e |
trackingId | UA-XXXXX-X |
clientId | 111111111.111111111 |
type | event |
eventInfo.eventCategory | Call |
eventInfo.eventAction |
Request |
eventInfo.eventLabel |
Form №1 |
eventInfo.eventValue | 0 |
page.hostname | example.com |
dataSource | call-center |
device.ip | server ip |
device.userAgent | Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html) |
referrer | https://www.google.com/ |
0 Комментарии