Подключение FunnelFox к Adapty Mail

FunnelFox — одна из точек входа в Adapty Mail. Используйте её, если вы привлекаете и обрабатываете платежи пользователей через веб-воронки FunnelFox. FunnelFox уже хранит их адреса электронной почты, покупки и события подписок, поэтому подключение не требует ни работы с SDK, ни собственных запросов.

Соединение работает в одну сторону. FunnelFox передаёт данные в Adapty Mail и никогда не считывает ваши кампании обратно, а также не отправляет письма самостоятельно.

Что FunnelFox отправляет

• Профили и адреса электронной почты — когда флоу собирает email.
• Идентификаторы: ID профиля получателя в FunnelFox и пользовательский ID, который флоу хранит для него (если есть). На странице профиля они отображаются в разделе External Profile IDs — строки FunnelFox и Custom.
• История покупок: подписки, продления и разовые покупки. Возвраты поступают как отрицательные суммы.
• События подписки: отмены, повторные активации, проблемы с оплатой и истечение срока. Именно они помещают каждого пользователя в флоу.
• Атрибуты профиля: страна, устройство, ОС, платформа и локаль — все пять являются фильтрами сегмента. FunnelFox считывает последние четыре из user agent браузера. Также передаётся часовой пояс, который определяет время доставки письма, но не используется как фильтр. Версия приложения не передаётся, поэтому этот фильтр остаётся пустым для пользователей флоу.
• Контекст флоу, сохранённый как пользовательские атрибуты профиля со следующими ключами:
  • fnlfx_funnel_id: флоу, который собрал email.
  • fnlfx_session_id: сессия флоу.
  • fnlfx_experiment_id: эксперимент флоу, если пользователь в нём участвовал.
  • email_consent: согласие пользователя на получение писем во флоу. Значение — текст "true" или "false", поэтому фильтр сегмента по нему сравнивает текст.

Чтобы передать одно из этих значений на страницу оформления заказа, добавьте его плейсхолдер в ссылку — например, {custom_attribute.fnlfx_session_id}. См. плейсхолдеры.

Данные поступают в Adapty Mail примерно через минуту после события воронки.

Подключение FunnelFox

Сначала завершите настройку Adapty Mail — см. Начало работы с Adapty Mail. Пока не создан флоу, отправленные письма не дойдут.

1. В Adapty Mail перейдите в Settings > Project и скопируйте Secret key.
2. В FunnelFox перейдите в Integrations > Adapty Mail.
3. Вставьте ключ и сохраните.

Инструкции по настройке со стороны FunnelFox см. в руководстве по интеграции FunnelFox.

После подключения

На странице профиля в разделе External Profile IDs появится строка FunnelFox с идентификатором, который FunnelFox использует для этого пользователя. Если профиль поступил из нескольких источников, для каждого из них будет своя строка — так вы видите все источники, которым известен этот пользователь.

Когда вы формируете ссылку на чекаут вручную, {funnelfox.external_profile_id} заменяется на ID профиля получателя в FunnelFox. Полный список плейсхолдеров — в разделе Email-адресаты.

Используйте вместе с другой точкой входа

Можно одновременно запустить FunnelFox и другую точку входа. Adapty Mail сопоставляет пользователей по адресу электронной почты. Если два источника сообщают об одном и том же адресе, они попадают в один профиль; два разных адреса создают отдельные профили, даже если customer_user_id совпадает.