Узнайте, как работает сквозная аналитика OWOX BI — запишитесь на демо

Для сбора основных событий о поведении пользователей в 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 и времени фактического отправления хита.
    Пример: Сегодня — 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.
  • Для потока OWOX BI максимальный размер обрабатываемых в хите данных — 16 КБ. Хиты большего объема не будут обработаны и записаны в BigQuery.
  • Лимит на размер тела хита в Google Analytics — 8 КБ.

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

HOST:
https://google-analytics.bi.owox.com/collect?tid=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/
Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 2 из 2
Еще есть вопросы? Отправить запрос

0 Комментарии

Войдите в службу, чтобы оставить комментарий.