Партнёрам: технические требования к сервисам коллтрекинга для интеграции

В сервисе OWOX BI возможна интеграция с новыми сервисами коллтрекинга.

Процесс интеграции

1. Реализация технической задачи интеграции, которая включает в себя отправку событий Measurement Protocol на точку доступа OWOX BI.
2. Проверка интеграции путем сверки данных, собранных в Google BigQuery.
3. Договоренность о взаимной поддержке интеграции в процессе развития обоих сервисов.

Технические требования

Интеграция основывается на требованиях Google Analytics Measurement Protocol, все запросы должны соответствовать этому стандарту, если не указано иное. События и значения их параметров должны быть равны тем, которые отправляются в Universal Analytics.

Настройка интеграции с OWOX BI должна происходить только после активации интеграции с Universal Analytics и использовать тот же идентификатор ресурса. Для пользователя это может быть реализовано в виде активации галочкой.

Стандартные передаваемые параметры:

Все параметры Measurement Protocol, которые отправляются в Google Analytics. 

Мы стремимся предоставить максимально полные данные для пользователей, потому важно передавать все возможные параметры, доступные для описания событий в вашем сервисе коллтрекинга. Если у вас есть API, можно использовать те же значения полей, адаптируя под требования Measurement Protocol.

Для точности в собираемых данных через Measurement Protocol желательно передавать следующие параметры (дополнительно, если в Google Analytics они ещё не передавались):

• &uip (IP Override),
• &ua (User Agent Override)
• &ds=call%20center (Data Source)
• &dr (Document Referrer)
• &cs (Campaign Source)
• &cm (Campaign Medium)
• &cn (Campaign Name)
• &cc (Campaign Content)
• &ck (Campaign Keyword)
• &qt (Queue Time), если на стороне вашего сервиса возможны задержки в отправке запросов, рекомендуется указывать время задержки в этом параметре. Например: &qt=560

 Дополнительные параметры в хите OWOX BI:

• В Google BigQuery пользователь может собирать данные о номерах телефонов пользователей, в отличие от Google Analytics (где сбор данных PII запрещен). Номер телефона должен быть представлен в E.164 (Международный телекоммуникационный план нумерации) и URL закодирован для корректной передачи по протоколу HTTP. Пример: &tel=%2B12015550111

Таким образом, в хите OWOX BI должно содержаться всегда больше параметров, чем в хите Google Analytics.

Формирование запросов

Запросы отправляются из сервиса коллтрекинга в дополнение к существующим запросам в Google Analytics на точку доступа:

https://[name].bi.owox.com/collect?...

На месте [name] будет название вашего сервиса коллтрекинга. Мы создаем субдомен, выделяя точку доступа для данных, получаемых от вашего сервиса. Для получения выделенного субдомена обратитесь на bi@owox.com. 

Запрос должен выглядеть следующим образом:

https://[name].bi.owox.com/collect?v=1&tid=UA-12345-0&cid=1281044359.1435239978&t=event&...&tel=%2B12015550111&ds=call%20center

На месте троеточия подразумеваются любые дополнительные параметры, которые ваш сервис передает в Google Analytics.