Перейти к содержанию

Сквозная аналитика мобильных приложений

Roistat помогает связать рекламный источник, с которого пользователь пришёл на сайт, с его действиями и заказами в мобильном приложении. Приложение получает номер визита Roistat, сохраняет его и передаёт вместе с событиями и сделками. Так в Аналитике можно увидеть заявки и события из приложения с рекламным источником.

Как устроен сценарий

Схема сквозной аналитики мобильного приложения

  1. Пользователь переходит из рекламы на сайт со счётчиком Roistat. Счётчик фиксирует рекламный источник и параметры устройства.
  2. Пользователь переходит с сайта в приложение или устанавливает его.
  3. Приложение получает номер визита и сохраняет его.
  4. При целевых действиях приложение или CRM передаёт номер визита вместе с данными о событии или сделке.
  5. Roistat связывает данные о визите с действиями и сделками пользователя. Это позволяет анализировать эффективность рекламы, ведущей в приложение.

Как получить номер визита

Android: передача номера визита через referrer

В Android можно передать номер визита в параметре referrer ссылки на приложение в Google Play. Приложение получает этот параметр средствами Android и сохраняет номер визита. Такой способ позволяет передать номер визита напрямую, без матчинга по параметрам устройства.

Схема работы:

  1. На сайте со счётчиком Roistat сформируйте ссылку на приложение в Google Play и добавьте в referrer номер визита.
  2. Пользователь переходит по ссылке и устанавливает приложение.
  3. Приложение получает номер визита из referrer и сохраняет его.
  4. Передавайте сохранённый номер визита с событиями и сделками.

Например, параметр ссылки может выглядеть так:

https://play.google.com/store/apps/details?id=test.app&referrer=visit_id={roistat_visit}

iOS: получение номера визита по параметрам устройства

Для iOS номер визита можно получить через матчинг по параметрам устройства. Приложение передаёт параметры устройства в Roistat, а Roistat возвращает найденный номер визита. Этот способ использует доступные параметры устройства и может давать небольшую погрешность.

Сценарий работы:

  1. Реклама ведёт пользователя на сайт со счётчиком Roistat. Счётчик фиксирует визит, рекламный источник и параметры устройства.
  2. Пользователь переходит с сайта в App Store и устанавливает приложение.
  3. При запуске приложение отправляет в Roistat запрос с параметрами устройства. API ищет подходящий визит и возвращает его номер. Если совпадение не найдено, Roistat создаёт новый визит; приложение сохраняет полученный номер.
  4. Когда пользователь совершает целевое действие, приложение передаёт номер визита вместе с событием или сделкой. Сделку можно отправить напрямую в CRM или в Roistat через API, событие — в Roistat через API.

В стадии открытого бета-тестирования

Матчинг iOS по параметрам устройства и метод API для получения номера визита находятся в стадии открытого бета-тестирования. Если у вас появятся вопросы или пожелания по доработке функциональности, обратитесь в службу поддержки.

Получение номера визита через API для iOS

Этот метод используется для iOS-матчинга по параметрам устройства. Для Android используйте номер визита из referrer — отправлять этот API-запрос не нужно.

Перед использованием метода ознакомьтесь с общими сведениями о REST API Roistat: там описаны авторизация и особенности запросов.

GET /api/site/1.0/[projectID]/get-visit-by-device-params

[projectID] — номер проекта Roistat. Метод ищет совпадение среди визитов в буфере проекта, созданных в течение 15 минут до запроса. Если визит найден, Roistat возвращает его номер. Если совпадение не найдено, Roistat создаёт новый визит и возвращает его номер.

Передайте все параметры устройства. Все они обязательны:

Параметр Описание
screen_width Ширина экрана устройства
screen_height Высота экрана устройства
os Операционная система, например ios
os_version Версия операционной системы
device_brand Модель или тип устройства, например iphone или ipad
ip IP-адрес. Обычно определяется из HTTP-запроса; при необходимости его можно передать вручную
marker Текстовая метка длиной до 255 символов. Если визит не найден, метка используется при создании нового визита

Как хранить и использовать номер визита

Для iOS отправляйте запрос в Roistat при каждом запуске приложения. Храните номер визита в приложении не более 14 дней. Сравнивайте номер из ответа с сохранённым и действуйте по правилам:

  1. Если в ответе есть номер визита, а действующего сохранённого номера нет, сохраните полученный номер на 14 дней.
  2. Если в ответе есть номер, отличный от сохранённого, замените сохранённый номер и начните новый 14-дневный срок хранения.
  3. Если номер в ответе совпадает с сохранённым, продолжайте использовать его до окончания текущего срока хранения.
  4. Если в ответе нет номера, но в приложении есть действующий сохранённый номер, используйте его.
  5. Если номера нет ни в ответе, ни в действующем кэше, передайте в поле roistat значение приложение. В Аналитике источником заявки будет отображаться «приложение».

События и сделки можно отправлять напрямую в CRM или в Roistat через API. В обоих случаях передавайте сохранённый номер визита; для прямого входа без номера используйте метку из последнего пункта.

На Android сохраняйте номер визита, полученный из referrer, и передавайте его вместе с событиями и сделками. Запрашивать номер через API-метод из этой статьи для Android не нужно.