Привлечение пользователей в растущем мобильном рынке — дело непростое и недешёвое. Поэтому грамотная работа с уже привлечёнными пользователями улучшает юнит-экономику, особенно в высококонкурентных нишах.

Adapty предоставляет информацию о ключевых платёжных действиях пользователей в режиме реального времени. Мы знаем, когда клиент начал пробный период, столкнулся ли он с проблемой оплаты, оформил ли подписку и решил ли отменить её позже. Все эти и другие события отражают изменения в статусе клиента. И это лучший момент для реакции — отправить предложение, персональный подарок или любой другой инструмент удержания.

Платформы push-уведомлений позволяют описывать пользователя с помощью стандартных и пользовательских тегов, чтобы выстроить эффективную автоматическую систему удержания. Для работы этой системы нужны тригерные события, которые сигнализируют ей о том, что пора отправить сообщение. Эти события будут поступать на платформу push-уведомлений из Adapty через настроенную интеграцию.

Выберите ниже нужный сервис и следуйте инструкциям:

• Braze
• OneSignal
• Pushwoosh
• Slack

Свойства событий

События вебхука отправляются в формате JSON. Все события следуют единой структуре, но их поля различаются в зависимости от типа события, стора и вашей конфигурации.

Свойство	Тип	Описание
profile_id	uuid	Идентификатор пользователя Adapty.
currency	str	Локальная валюта (по умолчанию USD).
price_usd	float	Цена продукта до вычета комиссии Apple/Google. Выручка.
proceeds_usd	float	Цена продукта после вычета комиссии Apple/Google. Чистая выручка.
net_revenue_usd	float	Чистый доход (доход после вычета комиссии Apple/Google и налогов) в USD. Может быть пустым.
price_local	float	Цена продукта до вычета комиссии Apple/Google в локальной валюте. Выручка.
proceeds_local	float	Цена продукта после вычета комиссии Apple/Google в локальной валюте. Чистая выручка.
transaction_id	str	Уникальный идентификатор транзакции, например покупки или продления.
original_transaction_id	str	Идентификатор транзакции исходной покупки.
purchase_date	ISO 8601 date	Дата и время покупки продукта.
original_purchase_date	ISO 8601 date	Дата и время исходной покупки.
environment	str	Может быть Sandbox или Production.
vendor_product_id	str	Идентификатор продукта в Apple App Store, Google Play Store или Stripe.
base_plan_id	str	Идентификатор базового плана в Google Play Store или идентификатор цены в Stripe.
event_datetime	ISO 8601 date	Дата и время события.
store	str	Может быть app_store или play_store.
trial_duration	str	Продолжительность пробного периода в днях. Отправляется в формате ” days”, например “7 days”.
cancellation_reason	str	Причина отмены подписки пользователем. Возможные значения: iOS и Android voluntarily_cancelled, billing_error, refund iOS price_increase, product_was_not_available, unknown Android new_subscription_replace, cancelled_by_developer
subscription_expires_at	ISO 8601 date	Дата истечения подписки. Обычно в будущем.
consecutive_payments	int	Количество периодов, в течение которых пользователь подписан без перерывов. Включает текущий период.
rate_after_first_year	bool	Булево значение, указывающее, что подписка соответствует условиям пониженной ставки комиссии (обычно 15%) после одного года непрерывного продления. Ставки комиссии зависят от условий программы и страны. Подробнее см. Комиссия стора и налоги.
promotional_offer_id	str	Идентификатор promotional offer, указанный в разделе продуктов дашборда Adapty.
store_offer_category	str	Может быть introductory или promotional.
store_offer_discount_type	str	Может быть free_trial, pay_as_you_go или pay_up_front.
paywall_name	str	Название пейвола, с которого совершена транзакция.
paywall_revision	int	Ревизия пейвола, с которого совершена транзакция. Значение равно 1.
developer_id	str	Developer (SDK) ID плейсмента, с которого совершена транзакция.
ab_test_name	str	Название A/B-теста, с которого совершена транзакция.
ab_test_revision	int	Ревизия A/B-теста, с которого совершена транзакция. Значение равно 1.
cohort_name	str	Название аудитории, к которой принадлежит профиль.
profile_event_id	uuid	Уникальный идентификатор события, который можно использовать для дедупликации.
store_country	str	Страна, переданная нам стором.
profile_ip_address	str	IP-адрес профиля (может быть IPv4 или IPv6, при наличии предпочтительнее IPv4). Обновляется каждый раз при изменении IP-адреса устройства.
profile_country	str	Определяется Adapty на основе IP-адреса профиля.
profile_total_revenue_usd	float	Общая выручка по профилю с учётом возвратов.
variation_id	uuid	Уникальный идентификатор пейвола, на котором была совершена покупка.
access_level_id	str	Идентификатор платного уровня доступа.
is_active	bool	Булево значение, указывающее, активен ли платный уровень доступа для профиля.
will_renew	bool	Булево значение, указывающее, будет ли платный уровень доступа продлён.
is_refund	bool	Булево значение, указывающее, является ли транзакция возвратом.
is_lifetime	bool	Булево значение, указывающее, является ли платный уровень доступа пожизненным.
is_in_grace_period	bool	Булево значение, указывающее, находится ли профиль в льготном периоде.
starts_at	ISO 8601 date	Дата и время начала платного уровня доступа для пользователя.
renewed_at	ISO 8601 date	Дата и время продления платного доступа.
expires_at	ISO 8601 date	Дата и время истечения платного доступа.
activated_at	ISO 8601 date	Дата и время активации платного доступа.
billing_issue_detected_at	ISO 8601 date	Дата и время обнаружения проблемы с оплатой.
profile_has_access_level	Bool	Булево значение, указывающее, есть ли у профиля активный уровень доступа (только для вебхуков).

Каждое событие содержит следующие свойства:

transaction_id, original_transaction_id, purchase_date, original_purchase_date, environment, vendor_product_id, event_datetime, store.

Кроме того, некоторые события содержат дополнительные свойства. Для событий subscription_refunded и non_subscription_purchase_refunded обязательно указывать значения price_usd и proceeds_usd в качестве дополнительных свойств.

Название события	Свойства
subscription_initial_purchase	price_usd, proceeds_usd, subscription_expires_at, consecutive_payments, rate_after_first_year, trial_duration
subscription_renewed	price_usd, proceeds_usd, subscription_expires_at, consecutive_payments, rate_after_first_year, trial_duration
subscription_cancelled	cancellation_reason, trial_duration
trial_started	subscription_expires_at, trial_duration
trial_converted	price_usd, proceeds_usd, subscription_expires_at, consecutive_payments, rate_after_first_year, trial_duration
trial_cancelled	cancellation_reason, trial_duration
non_subscription_purchase	price_usd, proceeds_usd
billing_issue_detected	subscription_expires_at, trial_duration
entered_grace_period	subscription_expires_at, trial_duration

Пример события

{
    "price_usd": 9.99,
    "proceeds_usd": 6.99,
    "transaction_id": "1000000628581600",
    "original_transaction_id": "1000000628581600",
    "purchase_date": "2020-02-18T18:40:22.000000+0000",
    "original_purchase_date": "2020-02-18T18:40:22.000000+0000",
    "environment": "Sandbox",
    "vendor_product_id": "premium",
    "event_datetime": "2020-02-18T18:40:22.000000+0000",
    "store": "app_store"
}

Adapty отправляет события на ваш сервер и в сторонние аналитические системы.

Свойство profile_ip_address синхронизируется с текущим IP-адресом устройства. Каждый раз, когда серверы Adapty получают данные от SDK, IP-адрес обновляется, если он отличается от зафиксированного ранее.