Как добавить форму «Секретный подарок» в мобильное приложение

Форма «Секретный подарок» — это In-App, в котором пользователь открывает коробку и получает случайный приз за подписку. Механика помогает деанонимизировать пользователей приложения, активировать новых пользователей и мотивировать повторные заказы.

Как настроить игровые формы с настройкой случайности — «Колесо фортуны», «Билет удачи» или «Лента удачи», — читайте в статье про игровые механики.

Чтобы запустить форму, нужно:

  1. Убедиться, что в приложении установлена подходящая версия Mindbox SDK.
  2. Создать In-App из шаблона «Секретный подарок».
  3. Создать дополнительное поле, в которое запишется выигрыш.
  4. Настроить сценарий, выдающий и отправляющий подарок.
  5. Добавить рассылку с выводом выигрыша.

Требования к версии Mindbox SDK

Игровые механики работают только при наличии актуального мобильного SDK:

  • Минимальная версия SDK: 2.15.0+ (для Android — 2.15.1+).
  • Поддерживаемые платформы: iOS, Android, Flutter, React Native.
  • В проекте должен быть подключен модуль In-App.

Пользователи со старыми версиями SDK не увидят механику. Это снижает охват механики и может искажать результаты АБ-тестов. Заранее проверьте долю аудитории на актуальной версии приложения и запустите In-App для мотивации к обновлению.

Создание In-App

Создайте новый In-App. В окне выбора шаблона перейдите в категорию «Игровые механики» и выберите шаблон «Секретный подарок».

secret-present-inapp-template.png

Настройки In-App

Перейдите в редактирование шаблона и скорректируйте дизайн под стиль приложения.

Форма состоит из трех экранов:

  1. Экран механики и сбора контактов — заголовок, выбор подарка и поля для контактов.
  2. Дополнительный экран (опционально).
  3. Экран «Спасибо» — сообщение о выпавшем призе и инструкция, как его применить.

Подарки

Откройте настройки игрового элемента, чтобы задать список призов и их дизайн.

secret-present-inapp-settings.png

  1. На вкладке «Контент» отредактируйте, какие призы может получить клиент:

    • количество призов (от 1 до 3),
    • сам подарок в виде текста или картинки.

    secret-present-inapp-prize.png

  2. На вкладке «Дизайн» настройте внешний вид подарков:

    • расположение (в 1 или 2 ряда),
    • внешний дизайн коробок (цвет элементов или свое изображение).

    secret-present-inapp-prize-outer.png

Поля сбора контактов

По умолчанию поля для сбора контактов указаны на первом экране. Нажмите «Добавить элемент» и выберите поля (email, телефон, имя), которые нужно запросить у клиента для отправки подарка.

secret-present-inapp-data-fields.png

Что нельзя сделать в форме In-App

  • Подставить персональные данные (имя, баланс бонусов, персональный промокод) в тексты механики — содержимое экранов статичное. Персонализация можно использовать в рассылке после участия;
  • Учесть содержимое списка клиента или историю заказов в реальном времени — форма «не знает», что у пользователя в корзине;
  • Динамически менять набор призов в реальном времени.

Таргетинг

Ограничьте показ In-App по сегменту, событию в приложении, частоте и датам акции, чтобы он показывался только нужной аудитории. Базовые настройки In-App — в общей инструкции.

Настройка передачи данных на проект

  1. Создайте дополнительное поле с типом «Перечисление» для хранения выигрыша.

  2. Добавьте подарки в «Перечисление»:

    • Имя — сам подарок, который будет отображаться в рассылке;
    • Внешний идентификатор — порядковый номер подарка из настройки формы Подарки → Контент.
    secret-present-inapp-action-customfield.png
    Пример дополнительного поля по сущности «Действие клиента»
  3. В настройках In-App «Действия после заполнения In-App’а клиентом» задайте создание клиента с контактом и выдачу действия с созданным дополнительным полем, по которому будет запускаться сценарий.

    • Поле в Mindbox — созданное поле.
    • Поле In-App’а — «Подарок (1-3)».
      secret-present-inapp-action-mapping.png
      Пример для формы, которая собирает email клиента и передает подарок в действие выдачи

Выдача и отправка подарка в сценарии

Форма In-App отвечает только за игровую часть. Выдача призов и рассылка настраиваются отдельным сценарием.

Заранее создайте:

  • Автоматическую рассылку(email, SMS или мобильный пуш) для отправки подарка;
  • Пулы с промокодами. Подарки будут выдаваться в виде промокодов, которые можно использовать в качестве бенефита к следующей покупке. Для каждого типа подарка нужен отдельный пул.

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

  1. Запускающее событие — выдача подарка. Выберите шаблон из In-App.

    game-mechanics-inapp-workflow-event.png

  2. Проверьте значение выигрыша через режим «Мультиветки». Добавьте все варианты так, как они указаны в поле «Имя» во варианте перечисления дополнительного поля.

    secret-present-inapp-multibranch-action.png

  3. В каждой ветке выдайте промокод из соответствующего пула и отправьте рассылку.

    game-mechanics-inapp-workflow-branch.png

  4. Настройте выдачу для каждого приза и запустите сценарий.

    secret-present-inapp-workflow-done.png

Вывод подарка в рассылке

В рассылке проверьте идентификатор выигрыша и подставьте соответствующий промокод.

Пример верстки:

  • CustomerAction.CustomField.{Системное_имя_дополнительного_поля_действия}.Name - полученный в форме подарок из дополнительного поля действия;
  • Recipient.LastReceivedPromoCode.{Системное_имя_пула_промокодов}.Value - промокод клиента, полученный из определенного пула промокодов.
Ваш подарок:
        
        @{if CustomerAction.CustomField.SecretPresent.Name = "Скидка 5%"}
            промокод ${Recipient.LastReceivedPromoCode.WithTypeDiscount5.Value} — скидка 5% на следующую покупку.
        
        @{else if CustomerAction.CustomField.SecretPresent.Name = "100 баллов"}
            промокод ${Recipient.LastReceivedPromoCode.WithTypeBonus500.Value} — 100 бонусных баллов.
        
        @{else if CustomerAction.CustomField.SecretPresent.Name = "Бесплатная доставка"}
            промокод ${Recipient.LastReceivedPromoCode.WithTypeBonus200.Value} — бесплатная доставка на следующий заказ.
        
        @{end if}
        

Если клиент выиграл скидку, в письме подставится:

Ваш подарок: промокод PROMO — скидка 5% на следующую покупку.