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

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

• Braze
• OneSignal
• Pushwoosh
• Slack

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

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

Свойство	Тип	Описание
profile_id	uuid	ID пользователя в 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	ID продукта в Apple App Store, Google Play Store или Stripe.
base_plan_id	str	ID базового плана в Google Play Store или ID цены в 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	ID promotional offer, указанный в разделе Products дашборда 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	Уникальный ID события для дедупликации.
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	Уникальный ID пейвола, на котором совершена покупка.
access_level_id	str	ID уровня доступа.
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-адресом устройства. При каждом получении данных от SDK серверы Adapty обновляют IP, если он отличается от записанного ранее.