Для сбора основных событий о поведении пользователей в BigQuery, OWOX BI с помощью методов customTask или analytics.js дублирует на точку доступа OWOX BI все данные, которые Google Analytics собирает с сайта.
Для отправки оффлайн-событий, или событий, произошедших позже основной сессии пользователя на сайте, Google Analytics предлагает использовать Measurement Protocol, который отправляет любые данные о поведении пользователей напрямую в Google Analytics с помощью HTTP-запросов.
Точка доступа OWOX BI
Если вы отправляете определенные события в 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 вам по-прежнему необходимо отправлять запрос на https://www.google-analytics.com/collect
.
Отправка запросов
Отправка запросов в нашу точку доступа не отличается от отправки в Google Analytics — вы точно так же отправляете данные в виде POST- или GET-запроса. Как должны выглядеть запросы — описано в справке Google.
POST-запросы (рекомендуемый нами способ)
Для POST-запроса необходимо указать payload-часть, идентичную той, что вы передаете в Google Analytics. Вот пример payload-части:
v=1&cid=555&t=pageview&dp=%2Fhome
Для POST-запросов используйте один из этих заголовков Content-type:
- application/x-www-form-urlencoded;
- application/octet-stream;
- text/plain.
GET-запросы
Для GET-запроса набор передаваемых параметров нужно указать в самой ссылке. Например:
https://google-analytics.bi.owox.com/UA-XXXXX-X?v=1&cid=555&t=pageview&dp=%2Fhome
Требования к формату значений полей
Формат значения для каждого из полей должен соответствовать документации Measurement Protocol.
Однако к некоторым полям OWOX BI предъявляет дополнительные требования, связанные с особенностями их обработки. В таблице ниже вы увидите список таких полей и допустимый формат значений к ним.
Обратите внимание Данные, не соответствующие указанному формату, не могут быть обработаны OWOX BI и будут записаны в таблицы Google BigQuery как NULL.
Полное название | Сокращенное название | Тип значения | Допустимый формат значения |
---|---|---|---|
Transaction Revenue | tr |
currency |
Пример значения: 1234,56 1,234.56 1.234,56 1 234,56 |
Transaction Tax | tt | currency | |
Transaction Shipping | ts | currency | |
Product Price | pr<productIndex>pr | currency | |
Custom Metric | cm<metricIndex> | number | |
cos | integer |
Пример значения: 1 1.00 1.0000 |
|
Queue Time | qt | integer | |
Page Load Time | plt | integer | |
DNS Time | dns | integer | |
Page Download Time | pdt | integer | |
Redirect Response Time | rrt | integer | |
TCP Connect Time | tcp | integer | |
Server Response Time | srt | integer | |
DOM Interactive Time | dit | integer | |
Content Load Time | clt | integer | |
Product Position | pr<productIndex>ps | integer | |
User timing time | utt | integer | |
Content Group | cg<groupIndex> | text |
Пример значения: Hello World |
Custom Dimension | cd<dimensionIndex> | text | |
Exception Description | exd | text | |
Document Referrer |
dr |
text | |
Product Name | pr<productIndex>nm | text |
Использование параметра queueTime (&qt)
По умолчанию, время отправки события считается временем его происхождения. Однако для некоторых событий уведомления через Measurement Protocol происходят с отсрочкой во времени. Например, при онлайн-оплате подтверждение от банка происходит значительно позже фактического действия пользователя. Чтобы соотнести такое событие со временем, когда оно случилось, используется параметр queueTime (&qt).
Значение параметра &qt показывает сколько времени прошло с момента события до его отправки в миллисекундах. Благодаря установке этого параметра, время получения хита (поле time) будет рассчитано корректно.
Обратите вниманиеЗначение &qt должно иметь тип integer и быть больше или равно 0.
В ином случае параметру &qt будет автоматически присвоено значение NULL, а хиту — значение времени на момент отправки этого события.
Ниже описана логика обработки данных при отправке ненулевого параметра &qt.
OWOX BI | Google Analytics |
---|---|
Сбор данных о хитах | |
Нет ограничений по значению &qt. Событие попадет в таблицы с данными о хитах за дату, рассчитанную с учетом разницы времени в параметре &qt и времени фактической отправки этого события. |
Есть ограничения по значению &qt. |
Сбор данных о сессиях | |
При сборе данных о сессиях на основе алгоритма OWOX BI, хиты автоматически попадут в правильную сессию в таблице данных о сессиях ('owoxbi_sessions_') в рамках 30 дней* с момента совершения события. |
При сборе данных о сессиях на основе алгоритма Google Analytics, хиты будут отнесены к соответствующим сессиям в течение 48 часов* согласно clientId и timestamp, переданным в пользовательском параметре &cd. |
Подробнее о том, как значение параметра qt влияет на присвоение транзакции к сессии, читайте в этой статье.
Ограничения
- В запросе обязательно должен быть передан параметр 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 КБ.
В любое время вы можете проверить количество транзакций, записанных в таблицы BigQuery. Подробнее
Пример запроса
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 Комментарии