Настройка интеграции проводится в два этапа - формирование шаблона трекинговой ссылки и настройка postback (так же встречаются названия callback, pingback, далее по тексту - postback). Принцип работы выглядит следующим образом:
- Мы размещаем рекламу и приводим посетителей с одобренных источников трафика
- Пользователь переходит по трекинговой ссылке Qmobi, откуда, путем редиректа (302 Moved Temporarily или 307 Temporary Redirect), его перенаправляет на трекинговую ссылку клиента
- Трекинговая ссылка клиента направляет пользователя на Google Play Market или App Store
- Пользователь устанавливает приложение
- Клиент передает информацию об установке в Qmobi (postback)
- При наступлении, вызванных пользователем, зарегистрированных действий или событий в приложении, информация о них передаётся в Qmobi
Этап 1. Формирование трекинговой ссылки.
Необходимо передать нам ссылку, на которую будет направляться трафик и сообщить информацию (или предоставить документацию) по поддерживаемым параметрам, таким как:
- Название / идентификатор рекламной кампании
- Название / идентификатор группы рекламных объявлений
- Название / идентификатор рекламного объявления
- Sub-id
- Прочие параметры для отслеживания эффективности рекламных кампаний
Данные параметры, обычно, передаются для удобства отслеживания результатов в панели управления клиента.
Кроме информации о рекламной кампании выше, так же необходимо 2 параметра, которые будут сохранены при переходе пользователя и доступны для использования в postback (passthrough - параметры).
- Click ID - уникальный инденфикатор клика. Всегда динамический, при каждом клике пользователя генерируется новое, уникальное значение.
Для подстановки используется макрос {clickid} - Tracker - внутренний идентификатор трекера, который использует qmobi. Необходим для корректного приёма postback и отслеживания событий. Может принимать несколько значений, например voluum, qmobi или быть пустым.
Для подстановки используется макрос {tracker}
Все перечисленные параметры могут быть подставлены в любое место ссылки, по требованию клиента.
Пример:
http://youtracker.com/click/app5337823/?partner=qmobi&tracker={tracker}&transaction_id={clickid}&campaign={campaign}&adset={adset}&ad={ad}
Все указанные в { } скобках значения будут заменены при переходе на соответствующую информацию. Например:
http://youtracker.com/click/app5337823/?partner=qmobi&tracker=voluum&transaction_id=1020910306a7b8e9fcd410591cb184&campaign=203518&adset=177565423&ad=72142384720
Этап 2. Настройка postback
Postback (pingback, callback, s2s pixel) — механизм передачи данных от стороннего трекера, партнерской программы (или от адверта) в трекинговое решение.
Qmobi поддерживает 2 вида postback - об установке и о наступлении события.
Технические требования:
Метод запроса: GET
Максимальный размер ответа: 5000
Успешные коды ответа: 200
Коды ошибок: 404, 500
2.1 Install Postback
Является обязательным для работы. Передает информацию о том, что по трекинговой ссылке была произведена установка приложения. Имеет следующий вид:
http://tracking.qmobi.com/postback/{network_name}?tracker={tracker}&cid={clickid}&event_name=install&install_time={install-ts}&aid={android-id}&gaid={adid}&idfa={idfa}&connection={connection}&carrier={carrier}&device_id={device-id}
Имя макроса | Тип | Описание |
network_name | required | название(или идентификатор) внешнего трекера, рекламной сети или клиента, выдается сотрудником Qmobi |
tracker | required | внутренний идентификатор Qmobi, переданный в трекинговой ссылке при переходе пользователя |
clickid | required | идентификатор клика, переданный в трекинговой ссылке при переходе пользователя |
install-ts | optional | время установки в unix-timestamp (желательно). При необходимости возможна пользовательская настройка |
android-id | optional | идентификатор устройства на платформе android (если имеется, в ином случае - пропустить) |
gaid | optional | уникальный рекламный идентификатор устройства на платформе android (если имеется, в ином случае - пропустить) |
idfa | optional | уникальный рекламный идентификатор устройства на платформе iOS (если имеется, в ином случае - пропустить) |
connection | optional | указание соединения пользователя (3G/4G, WIFI) |
carrier | optional | оператор сотовой связи или ISP для wifi-соединения |
device-id |
optional | идентификатор устройства во внешнем ресурсе (ваш внутренний id) |
Пример:
http://tracking.qmobi.com/postback/apsalar?tracker=qmobi&cid=0e3d564a-44e3-4a60-9070-071b92b6c475&event_name=install&event_time=1484578543&device_id=4ab4f6ca48ac6bd4f3a2f28b3d6540e4b38b97ea&ip=93.187.189.254&country=RU&aid=&gaid=245ed11d-2c86-43e6-9bf6-6739af30edc8
2.2 Event Postback
Передает информацию о событиях в приложении, например: регистрация, покупка, достижение уровня и др.
Имеет следующий вид:
http://tracking.qmobi.com/postback/{network_name}?tracker={tracker}&cid={clickid}&event_name={event-name}&event_time={event-time}&event_value={event-value}
Имя макроса | Тип | Описание |
network_name | required | название(или идентификатор) внешнего трекера, рекламной сети или клиента, выдается сотрудником Qmobi |
tracker | required | внутренний идентификатор Qmobi, переданный в трекинговой ссылке при переходе пользователя |
clickid | required | идентификатор клика, переданный в трекинговой ссылке при переходе пользователя |
event-name | required | имя события |
event-time | optional | время наступления события (желательно unix-timestamp) |
event-value | optional | Любые данные по событию строкой или json |
Пример:
http://tracking.qmobi.com/postback/apsalar?tracker=qmobi&cid=0e3d564a-44e3-4a60-9070-071b92b6c475&event_name=register&event_time=1484578648&event_value={"user_id":1238326, "is_first_registration":1}