Профили в Adapty Mail
Профиль — это один пользователь в вашем проекте. Страница Profiles отображает всех, кого знает Adapty Mail, а также статус покупок каждого пользователя, его активность по email и полную историю действий.
Профили поступают автоматически через точки входа, которые вы настроили. Обязательное условие — наличие email-адреса: Adapty Mail не создаёт профиль для пользователя, который его не предоставил.
Чтобы объединить профили в переиспользуемые аудитории для флоу и A/B-тестов, см. раздел Сегменты.
Если вы хотите выяснить, почему конкретный пользователь не получил письмо, спросите у ИИ-ассистента, подключённого к MCP-серверу Adapty Mail. Он изучит профиль и историю его активности. Скилл Adapty Mail поочерёдно проверяет все возможные причины.
Как профили попадают в Adapty Mail
Adapty Mail создаёт профили автоматически из трёх источников:
- Adapty: SDK собирает email-адреса и покупки из вашего приложения. См. Подключение Adapty к Adapty Mail.
- Adapty Mail API: Ваш бэкенд отправляет профили и транзакции через server-to-server. См. Отправка данных через API.
- FunnelFox: Ваши веб-воронки передают email-адреса, покупки и события подписок. См. Подключение FunnelFox к Adapty Mail.
Adapty Mail сопоставляет людей по адресу электронной почты. Два источника с одинаковым адресом попадают в один профиль; два разных адреса создают отдельные профили, даже если customer_user_id совпадает. Каждый источник хранит собственный идентификатор пользователя, и на странице профиля все они перечислены в разделе External Profile IDs.
Если вы также используете Adapty, профиль здесь — это не ваш профиль в Adapty. Adapty Mail ведёт собственные записи и хранит ID профиля Adapty как один из внешних идентификаторов. Профилей здесь будет меньше, чем в Adapty, потому что профили Adapty без адреса электронной почты сюда не попадают.
Создавать и редактировать профили здесь нельзя — данные принадлежат источнику, который их передал, — но можно отписаться от рассылки и удалить их.
Список профилей
Список отображает профили по одному в строке, начиная с новейших. Используйте строку поиска, чтобы найти профиль по email, ID профиля или внешнему ID профиля.
| Столбец | Содержимое |
|---|---|
| Profile | Email клиента и кампания, связанная с его последним email-событием. |
| Status | Статус покупки профиля. См. Статус профиля. |
| Country | Страна клиента. |
| Open rate | Отношение открытых писем к отправленным. Прочерк означает, что письма ещё не отправлялись. |
| LTV | Lifetime value — суммарный доход от этого профиля по всем источникам. |
| Joined | Когда профиль впервые появился в Adapty Mail. |
| Last activity | Когда произошло последнее email-событие профиля. Учитывается отправка, а не только открытие или клик. |
Joined — это дата, когда профиль впервые появился в Adapty Mail; она используется как дата начала отношений с клиентом. Это время попадания в систему, а не исходная дата регистрации в вашем приложении.
Статус профиля
Столбец Status отображает статус покупок профиля — что именно приобрёл пользователь и активна ли эта покупка. Этот статус не имеет отношения к тому, получает ли пользователь ваши письма.
| Статус | Значение |
|---|---|
| Never purchased | Пользователь ничего не купил. |
| Purchased | Пользователь совершил разовую покупку. |
| Active subscriber | Пользователь оформил платную подписку с автопродлением. |
| Renewal cancelled | Автопродление отключено; доступ сохраняется до конца текущего периода. |
| Billing issue | Платёж при продлении не прошёл. |
| Grace period | Платёж не прошёл, но доступ сохраняется в течение льготного периода стора. |
| Churned | Подписка истекла и доступ закрыт. |
| Refunded | Покупка возвращена. |
Профиль может быть активным подписчиком и при этом отписанным от ваших email-рассылок, или отточившим (churned) и при этом подписанным. Статус email отображается на странице профиля и определяет, может ли Adapty Mail отправлять письма этому профилю.
Детали профиля
Нажмите на профиль, чтобы открыть страницу с его деталями.
Заголовок профиля
Заголовок идентифицирует пользователя: email, страна, пол, возраст, платформа и дата «первой покупки». Он также содержит три бейджа:
- Purchase status: Статус покупки профиля, с использованием значений, перечисленных в разделе Статус профиля.
- Open rate: Доля открытий писем этим профилем относительно отправленных ему писем. Аналитика учитывает получателей, открывших хотя бы одно письмо, а не количество самих писем — поэтому эти цифры различаются.
- Email status: Subscribed (подписан) или причина остановки отправки — например, Unsubscribed (отписался), Bounced (письмо отклонено) или Reported spam (жалоба на спам). Consent denied означает, что источник зафиксировал отказ этого пользователя от маркетинговых писем; см. Email consent в разделе карточка профиля. Этот статус не связан с платной подпиской в поле Status.
Subscribed означает, что отправке ничего не мешает — но не то, что что-то запланировано. Профиль всё равно должен соответствовать сегменту во флоу, а двойное подтверждение удерживает маркетинговые письма до тех пор, пока пользователь не подтвердит адрес. Причины остановки писем охватывают все причины подавления, которые заменяют Subscribed.
Метрики вовлечённости
Пять метрик отображаются в верхней части страницы:
- Sent: Письма, отправленные профилю.
- Delivered: Письма, принятые почтовым провайдером.
- Opened: Количество открытий письма получателем, включая повторные.
- Clicked: Количество кликов по ссылкам.
- Revenue: Два показателя — атрибутированный доход и пожизненная ценность.
Атрибутированная выручка — это выручка, полученная благодаря вашим письмам: покупки, совершённые пользователем после перехода по ссылке из письма. Пожизненная ценность (LTV) — это общая выручка профиля из всех источников, независимо от того, участвовала ли почта в её формировании. В заголовке сначала отображается атрибутированная выручка, затем LTV.
Карточка профиля
Карточка Profile отображает атрибуты пользователя:
- Platform: Платформа последнего устройства пользователя, например iOS или Android.
- Email provider: Кто обслуживает почтовый ящик — Google, iCloud, Proton и т. д. — определяется по MX-записям домена. Disposable означает сервис временных адресов, который не проходит верификацию и сразу попадает в список подавленных.
- Country: Страна пользователя.
- Store country: Страна аккаунта App Store или Google Play пользователя.
- Gender: Пол пользователя, если известен.
- Age: Возраст пользователя и дата рождения, полученная из источника.
- Email consent: Ответ пользователя на маркетинговые письма, как он был передан источником: Granted, Denied или Not provided. Adapty Mail не отправляет маркетинговые письма профилю со статусом Denied. Транзакционные письма по-прежнему доставляются, кроме запроса подтверждения double opt-in.
- Profile ID: Внутренний идентификатор профиля в Adapty Mail.
External Profile IDs содержит по одной записи для каждого источника — Adapty, FunnelFox или Custom — с идентификатором, который этот источник использует для данного пользователя, и временем первого появления. Custom attributes содержит пары ключ-значение, отправленные источником.
Состояние покупки
Карточка Purchase state показывает доход от профиля и историю покупок. Вверху отображается пожизненная ценность клиента, ниже — повторяющийся доход, а затем до двух разделов:
- Subscription: цена, стор, дата начала, ID продукта и дата, помеченная Renews — пока доступ активен, или Expired — после его окончания.
- One-time purchase: цена, стор, дата покупки и ID продукта для последней разовой покупки.
Если у клиента есть и то, и другое, каждый раздел имеет собственный значок статуса. Если покупок ещё не было, карточка показывает No purchase yet.
Сегменты
Карточка Segments показывает, скольким сегментам соответствует профиль, и перечисляет их; нажмите на любой, чтобы открыть его. Если ни один не совпадает, карточка отображает Not in any segment. Adapty Mail заново применяет фильтры при каждом запросе, поэтому список всегда отражает актуальные данные профиля. В разделе Сегменты описано, как их создавать.
История активности
Раздел Journey — это хронология всего, что происходило с профилем, начиная с события Profile created. События по email и транзакциям отображаются в одном общем списке.
События электронной почты
Каждая запись — одно письмо, отправленное Adapty Mail. Раскройте её, чтобы увидеть ссылки, по которым перешёл получатель, и покупки, совершённые благодаря этому письму. Цветная метка показывает, на каком этапе находится письмо:
| Чип | Что означает |
|---|---|
| Scheduled | У письма задано время отправки, и Adapty Mail ещё не отправил его. |
| Sent | Adapty Mail отправил письмо, подтверждение доставки ещё не получено. |
| Delivered | Принимающий почтовый сервер принял письмо. Этот чип заменяет Sent. |
| Opened | Пиксель отслеживания загрузился. |
| Clicked | Получатель перешёл по ссылке. Разверните письмо, чтобы увидеть, по каким ссылкам кликали и какая покупка была совершена. |
| Confirmed | Получатель подтвердил свой адрес из письма с двойным подтверждением. |
| Bounced | Принимающий почтовый сервер отклонил письмо и вернул его обратно. |
| Spam report | Получатель пометил письмо как спам. |
| Unsubscribed | Получатель отписался. |
| Delayed | Принимающий почтовый сервер попросил Adapty Mail повторить попытку позже. |
| Throttled | Все отправляющие домены превысили почасовой или суточный лимит, и письмо ждёт в очереди. |
| Cancelled | Письмо не будет отправлено. Покупка, отписка, отклонение, жалоба на спам, удаление, отказ от согласия на получение писем, задержка отправки дольше трёх дней или маркетинговая кампания, которую получатель ни разу не открыл и не кликнул, — всё это отменяет оставшиеся письма в последовательности. Подробнее см. в разделе Причины остановки отправки писем. |
События транзакций
Каждая запись — это веха подписки или разовой покупки. В путешествии вместо сырого значения event_type отображается понятная метка:
event_type | Метка Journey |
|---|---|
subscription_started | Subscription started |
subscription_renewed | Subscription renewed |
subscription_renewal_cancelled | Renewal cancelled |
subscription_renewal_reactivated | Renewal resumed |
billing_issue_detected | Billing issue |
entered_grace_period | Entered grace period |
subscription_expired | Subscription expired |
subscription_refunded | Subscription refunded |
non_subscription_purchase | One-time purchase |
non_subscription_purchase_refunded | Purchase refunded |
Эти события автоматически поступают в Adapty Mail через SDK Adapty, либо вы можете отправлять их самостоятельно через API.
Отписать профиль
Чтобы прекратить отправку писем профилю, откройте его страницу, нажмите … и выберите Unsubscribe. Adapty Mail помечает профиль как отписанный и добавляет его в список подавления — маркетинговые кампании и флоу его пропускают. Транзакционные письма всё равно доходят до него.
Если профиль уже в списке подавления — по любой причине — кнопка Unsubscribe остаётся неактивной. В разделе «Причины остановки писем» описаны два способа, которыми получатели могут отписаться самостоятельно.
Удаление профиля
Удалите профиль, чтобы стереть все данные о пользователе, хранящиеся в Adapty Mail, — например, в ответ на запрос об удалении данных.
Чтобы удалить профиль, откройте его страницу, нажмите …, выберите Delete и подтвердите действие. Adapty Mail при этом:
- Удалит email-адрес и все личные атрибуты: имя, пол, дату рождения, страну, страну стора, данные об устройстве и пользовательские атрибуты.
- Отменит все письма, запланированные для этого профиля.
- Удалит профиль со страницы Profiles.
Это действие необратимо. Записи о покупках сохраняются без каких-либо персональных данных, поэтому общие показатели выручки не изменятся.
Удаление не блокирует адрес. Если источник отправит его снова, Adapty Mail создаст новый профиль, не связанный с удалённым. Чтобы навсегда исключить пользователя, нужно остановить передачу его данных на стороне источника.
Ваш бэкенд также может удалять профили через эндпоинт Delete profile.