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

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

  1. application/x-www-form-urlencoded;
  2. application/octet-stream;
  3. 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
       

Checkout Step

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.
Хиты всегда попадут в таблицы с данными о хитах ('streaming_') в Google BigQuery вне зависимости от величины значения &qt.

Событие попадет в таблицы с данными о хитах за дату, рассчитанную с учетом разницы времени в параметре &qt и времени фактической отправки этого события.
Пример: Событие, отправленное 10 августа 2019 года с параметром &qt=86400000 (-24 часа), попадёт в хитовые таблицы, собранные 9-го августа 2019 года.

Есть ограничения по значению &qt.
Если значение параметра &qt превышает 4 часа, событие не будет обработано.

Сбор данных о сессиях

При сборе данных о сессиях на основе алгоритма OWOX BI, хиты автоматически попадут в правильную сессию в таблице данных о сессиях ('owoxbi_sessions_') в рамках 30 дней* с момента совершения события.
*После окончания суток, когда события были совершены, во временной зоне представления Google Analytics.
Если вы хотите добавить хиты в сессии старше 30 дней, напишите нам на bi@owox.com.

При сборе данных о сессиях на основе алгоритма Google Analytics, хиты будут отнесены к соответствующим сессиям в течение 48 часов* согласно clientId и timestamp, переданным в пользовательском параметре &cd.
*После окончания суток, когда события были совершены, во временной зоне представления Google Analytics.

Подробнее о том, как значение параметра 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/

 

Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 4 из 4
Еще есть вопросы? Отправить запрос

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

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