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

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

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