Yandex AppMetrica™

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™:

• Для захатов событий — https://appmetrica.yandex.ru/docs/mobile-api/logs/ref/events.html
• Для захватов установок — https://appmetrica.yandex.ru/docs/mobile-api/logs/ref/installations.html

к сведению

Дополнительные параметры, передаваемые в 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 id	appmetrica_device_id
Yandex AppMetrica with iOS IFA	ios_ifa
Yandex AppMetrica with Google AID	google_aid

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

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

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

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

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

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

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

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