Перейти к основному содержимому

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

к сведению

Дополнительные параметры, передаваемые в 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.

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

Последнее обновление