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

В сервисе 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/UA-XXXXX-X?...

На месте [name] будет название вашего сервиса коллтрекинга. И 'UA-XXXXX-X' – это Google Analytics Web Property ID, с которым пользователь хочет интегрировать данные коллтрекинга. Пользователь должен указать правильные значения при настройке интеграции.

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

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

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

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