Описание

Yandex AppMetrica™ - платформа аналитики для мобильных приложений с возможностью отправки push уведомлений на устройства пользователей.

Сайт AppMetrica™: https://appmetrica.yandex.ru

Altcraft MP может захватывать события и установки в AppMetrica™ и использовать их для:

  • регистрации целевых действий и их ценности
  • импорта или обновления профилей подписчиков

Чтобы интегрировать данные AppMetrica в Altcraft, в главном меню перейдите в раздел Интеграции.

Подключение к API AppMetrica™

Создайте новую интеграцию, в основных настройках укажите произвольное название - и в выпадающем меню выберите Yandex AppMetrica eventsЗдесь же находится кнопка активации/деактивации захватов событий:

В настройках интеграции необходимо указать следующие параметры:

  • Application ID - уникальный числовой идентификатор приложения в AppMetrica™.
  • AppMetrica API token - токен для получения доступа к данным. Получить его можно в разделе Настройки приложения в AppMetrica™.

После внесения этих настроек вы сможете добавлять в интеграцию захваты событий и захваты установок приложения. Для каждого из них можно задать определённые условия срабатывания, основанные на значении полей AppMetrica™.

Доступна фильтрация по части значения поля, при этом изменяющаяся часть заменяется символом шаблона поиска * (wildcard). Например, значение *@mail.ru будет срабатывать на все адреса доменной группы mail.ru.

Поля события, получаемые из Yandex AppMetrica™

Интеграция поддерживает все поля, доступные в AppMetrica Logs API. Полный список передаваемых полей c описанием доступен по ссылке в документации AppMetrica™: 


Дополнительные параметры, передаваемые в event_json, необходимо вводить в Имя поля вручную, разделяя уровни вложенности данных точкой. Например: 

  • event_json.email - если поле email передаётся в AppMetrica в основной структуре "event_json": 

    "event_json" : 
    {"email" : "example@example.com"}
  • event_json.contacts.email - если поле включено в подструктуру "contacts":

    "event_json" : 
    {"contacts":
    {"email" : "example@example.com",
     "phone" : "+12345678910"}
    }

При передаче событий приложения в интерфейс платформы AppMetrica доступно 5 уровней вложенности, при передаче в API AppMetrica - 10. Altcraft поддерживает максимальное значение.

Документация по отправке собственных событий из приложения в AppMetrica: https://appmetrica.yandex.ru/docs/mobile-events/concepts/events.html

Регистрация цели

Событие, переданное в AppMetrica™ из мобильного приложения может регистрировать в Альткрафт достижение целевого действия и его ценность. Для этого выберите Тип действия: Регистрация цели.

Цели в Альткрафт организованы по Пикселям. Регистрируя одинаковые цели по нескольким пикселям, можно оценить эффективность разных вариантов интерфейса приложения или определённых последовательностей действий пользователей. Выберите пиксель в выпадающем меню.

Имя цели и её стоимость можно указать вручную, или записать значения из данных события.

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

Каждая регистрируемая цель может быть связана или не связана с определённым профилем клиента в Альткрафт:

  • Анонимные цели доступны только в отчётах по достижению целей, формируя статистику по неизвестным профилям.
  • Цели, связанные с профилем, могут использоваться для RFM и LTV сегментации пользователей, начисления баллов и управления лояльностью. Достижения целей отображаются в разделе История действий профиля клиента.

Чтобы записать цель определённому пользователю, включите опцию Привязать к профилю, выберите базу данных, в которой хранится его профиль и установите режим поиска:

  • По email адресу из профиля - адрес из полей профиля клиента в базе данных.
  • По email адресу из профиля или подписок - адрес из полей профиля или из контактных данных подписок клиента. 
  • По ID AppMetreica - по значению appmetrica_device_id. Должен быть заранее передан профилям. При импорте через события AppMetrica устанавливается автоматически.
  • По кастомному полю - по значению дополнительного поля профиля клиента в Альткрафт. Выберите название поля в базе данных и поле события для поиска значения. 

Импорт профиля

Второе применение событий из AppMetrica™ - импорт и обновление данных профилей пользователей в базах данных Altcraft. В захвате действий для этого нужно выбрать Тип действия: Импорт профилей. Доступно три режима импорта:

  • Добавить новых и обновить существующих
  • Только добавить новых, не обновлять существующих
  • Только обновлять существующих, не добавлять новых

Для поиска профиля укажите базу данных Альткрафт и установите режим поиска аналогично поиску профиля при регистрации цели (выше).

В рамках одной базы данных для импорта нежелательно менять режим поиска с email или кастом на appmetrica_device_id. Используйте этот режим сразу во избежание потери данных. 


Автоподписка

При импорте или обновлении профилей можно подписывать пользователей на Email, SMS или Push. Для этого необходимо:

  1. Создать ресурс и настроить в нём нужные каналы - или использовать существующие ресурсы.
  2. Добавить в настроенный ресурс Базу данных, в которую будут импортироваться данные пользователей. В рамках одного импорта можно передавать подписки на разные ресурсы. Базу данных при этом нужно добавить во все используемые ресурсы.

После этого в захвате событий станет доступна кнопка Добавить подписку:

Для каждой записи выберите Ресурс, Канал и Источник подписки. Для Push подписок из AppMetrica доступны стандартные поля события: 

Провайдер PushПоле события
Yandex AppMetrica with device idappmetrica_device_id
Yandex AppMetrica with iOS IFAios_ifa
Yandex AppMetrica with Google AIDgoogle_aid

Для других провайдеров Push, а также для Email и SMS подписок, данные необходимо передавать из приложения в дополнительных параметрах event_json. 

Для каждой подписки можно установить статус:

  • при импорте можно передавать статус "Подписан" для Single opt-in, или "Не подтверждён" для Double opt-in логики
  • при обновлении данных можно менять статус подписки в зависимости от действий пользователя, например приостановить, возобновить или отменить подписку

Соответствие данных AppMetrica и данных профиля Altcraft

Для каждого нового профиля будет создаваться уникальный идентификатор Altcraft и записываться поле, по которому происходит поиск (если по нему профиль не найден). Если режим поиска настроен на email, профилю будет также записываться системное поле appmetrica_device_id.

Для основных и дополнительных полей профилей Altcraft нужно установить соответствие с полями событий, получаемых от AppMetrica™:

Кастомные поля задаются в структуре Баз данных Altcraft. Кастомные поля события передаются из приложения в объекте event_json

Опция Игнорировать пустые запрещает запись пустого значения в поле профиля при обновлении или импорте.

  • No labels