Типы и поля событий вебхука
Adapty отправляет вебхуки в ответ на события подписки. В этом разделе описаны типы событий и данные, которые содержатся в каждом вебхуке.
Типы событий вебхука
Вы можете отправлять в вебхук все типы событий или выбрать только нужные. Ознакомьтесь с нашими потоками событий, чтобы понять, какие данные ожидать и как выстроить вокруг них бизнес-логику. Ненужные типы событий можно отключить при настройке интеграции с вебхуком. Там же можно заменить стандартные идентификаторы событий Adapty на собственные, если это необходимо.
| Event name | Description |
|---|---|
| subscription_started | Срабатывает, когда пользователь активирует платную подписку без пробного периода, то есть оплата списывается сразу. |
| subscription_active | Подтверждает, что подписка всё ещё активна после события subscription_started. Вы задаёте количество дней между началом подписки и этой проверкой. Событие приходит, если подписка по-прежнему активна, в том числе когда пользователь вошёл в льготный период. Если подписка к тому моменту завершилась или пользователь отключил автопродление — событие не придёт, и Adapty больше не проверяет. Это событие относится только к подпискам, оформленным без пробного периода. Конвертированный триал отправляет trial_converted, который проверку не запускает. |
| subscription_renewed | Срабатывает при продлении подписки и списании оплаты. Начиная со второго расчётного периода — как для триальных, так и для обычных подписок. |
| subscription_renewal_cancelled | Пользователь отключил автопродление подписки. Доступ к премиум-функциям сохраняется до конца оплаченного периода. |
| subscription_renewal_reactivated | Срабатывает, когда пользователь повторно включает автопродление подписки. |
| subscription_expired | Срабатывает, когда подписка полностью заканчивается после отмены. Например, если пользователь отменил подписку 12 декабря, но она оставалась активной до 31 декабря — событие фиксируется 31 декабря. |
| subscription_paused | Срабатывает, когда пользователь активирует паузу подписки (только Android). |
| subscription_deferred | Срабатывает, когда покупка подписки откладывается: пользователь сохраняет доступ к премиум-функциям, но оплата переносится на более поздний срок. Функция доступна через Google Play Developer API и может использоваться для бесплатных пробных периодов или в поддержку пользователей в сложной финансовой ситуации. |
| non_subscription_purchase | Любая разовая покупка: пожизненный доступ или расходуемая покупка, например внутриигровая валюта. |
| trial_started | Срабатывает, когда пользователь активирует пробную подписку. |
| trial_active | Подтверждает, что пробный период всё ещё активен после события trial_started. Вы задаёте количество дней между началом триала и этой проверкой. Событие приходит, если триал ещё идёт. Если триал завершился или конвертировался, либо пользователь отключил автопродление — событие не придёт, и Adapty больше не проверяет. |
| trial_converted | Срабатывает, когда пробный период заканчивается и с пользователя списывается первая оплата. Например, если триал действует до 14 января, но оплата проходит 7 января — событие фиксируется 7 января. |
| trial_renewal_cancelled | Пользователь отключил автопродление во время пробного периода. Доступ к премиум-функциям сохраняется до конца триала, но оплата не спишется и подписка не оформится. |
| trial_renewal_reactivated | Срабатывает, когда пользователь повторно включает автопродление во время пробного периода. |
| trial_expired | Срабатывает, когда пробный период заканчивается без конвертации в подписку. |
| entered_grace_period | Срабатывает, когда попытка списания оплаты не удаётся и пользователь входит в льготный период (если он включён). В течение этого времени доступ к премиум-функциям сохраняется. |
| billing_issue_detected | Срабатывает при ошибке оплаты во время попытки списания (например, недостаточно средств на карте). |
| subscription_refunded | Срабатывает при возврате средств за подписку (например, по решению службы поддержки Apple). |
| non_subscription_purchase_refunded | Срабатывает при возврате средств за разовую покупку. |
| access_level_updated | Срабатывает при обновлении уровня доступа пользователя. |
subscription_renewal_reactivated содержит предыдущий идентификатор продукта — тот, который был активен на момент отмены, — даже если пользователь впоследствии реактивировал подписку, купив другой продукт. Apple сохраняет один и тот же original_transaction_id на протяжении всей цепочки «отмена → реактивация», поэтому событие отражает исходный продукт. Новый продукт появится в следующем событии subscription_renewed, когда начнётся списание за новый продукт.
В Google Play Adapty может отправить событие subscription_started со всеми денежными полями, равными нулю — например, когда Google заменяет одну подписку другой или когда подписка начинается с бесплатного периода. Не учитывайте такие события как доход. При замене подписки Google выдаёт новый токен покупки, поэтому Adapty фиксирует оплаченную транзакцию с другим store_transaction_id.
Структура события вебхука
Adapty будет отправлять только те события, которые вы выбрали в разделе Events names на странице Integrations -> Webhooks.
События webhook сериализуются в JSON. Тело POST-запроса к вашему серверу будет содержать сериализованное событие, обёрнутое в структуру ниже. Все события следуют одной и той же структуре, но их поля различаются в зависимости от типа события, стора и вашей конкретной конфигурации. Атрибуты пользователя — это пользовательские атрибуты, которые вы настроили, поэтому они содержат именно те данные, которые вы задали. Поля данных атрибуции одинаковы для всех типов событий, однако список атрибуций зависит от того, какие источники атрибуции вы используете в мобильном приложении. Ниже приведён пример события:
{
"profile_id": "00000000-0000-0000-0000-000000000000",
"customer_user_id": "UserIdInYourSystem",
"idfv": "00000000-0000-0000-0000-000000000000",
"idfa": "00000000-0000-0000-0000-000000000000",
"advertising_id": "00000000-0000-0000-0000-000000000000",
"profile_install_datetime": "2000-01-31T00:00:00.000000+0000",
"user_agent": "ExampleUserAgent/1.0 (Device; OS Version) Browser/Engine",
"email": "john.doe@company.com",
"event_type": "subscription_started",
"event_datetime": "2000-01-31T00:00:00.000000+0000",
"event_properties": {
"store": "play_store",
"currency": "USD",
"price_usd": 4.99,
"profile_id": "00000000-0000-0000-0000-000000000000",
"cohort_name": "All Users",
"environment": "Production",
"price_local": 4.99,
"original_price_usd": 4.99,
"original_price_local": 4.99,
"discount_amount_usd": 0,
"discount_amount_local": 0,
"base_plan_id": "b1",
"developer_id": "onboarding_placement",
"ab_test_name": "onboarding_ab_test",
"ab_test_revision": 1,
"paywall_name": "UsedPaywall",
"proceeds_usd": 4.2315,
"variation_id": "00000000-0000-0000-0000-000000000000",
"purchase_date": "2024-11-15T10:45:36.181000+0000",
"store_country": "AR",
"event_datetime": "2000-01-31T00:00:00.000000+0000",
"proceeds_local": 4.2415,
"tax_amount_usd": 0,
"transaction_id": "0000000000000000",
"net_revenue_usd": 4.2415,
"profile_country": "AR",
"paywall_revision": "1",
"profile_event_id": "00000000-0000-0000-0000-000000000000",
"tax_amount_local": 0,
"net_revenue_local": 4.2415,
"vendor_product_id": "onemonth_no_trial",
"profile_ip_address": "10.10.1.1",
"consecutive_payments": 1,
"rate_after_first_year": false,
"original_purchase_date": "2000-01-31T00:00:00.000000+0000",
"original_transaction_id": "0000000000000000",
"subscription_expires_at": "2000-01-31T00:00:00.000000+0000",
"profile_has_access_level": true,
"profile_total_revenue_usd": 4.99,
"promotional_offer_id": null,
"store_offer_category": null,
"store_offer_discount_type": null
},
"event_api_version": 1,
"profiles_sharing_access_level": [{"profile_id": "00000000-0000-0000-0000-000000000000", "customer_user_id": "UserIdInYourSystem"}],
"attributions": {
"appsflyer": {
"ad_set": "Keywords 1.12",
"status": "non_organic",
"channel": "Google Ads",
"ad_group": null,
"campaign": "Social media influencers - Rest of the world",
"creative": null,
"created_at": "2000-01-31T00:00:00.000000+0000"
}
},
"user_attributes": {"Favourite_color": "Violet", "Pet_name": "Fluffy"},
"integration_ids": {"firebase_app_instance_id": "val1", "branch_id": "val2", "one_signal_player_id": "val3"},
"play_store_purchase_token": {
"product_id": "product_123",
"purchase_token": "token_abc_123",
"is_subscription": true
}
}Поля события
Параметры события одинаковы для всех типов событий.
| Поле | Тип | Описание |
|---|---|---|
| advertising_id | UUID | Advertising ID (только Android). |
| attributions | JSON | Данные атрибуции. Включается, если в настройках вебхука включён параметр Send Attribution. |
| customer_user_id | String | ID пользователя из вашего приложения (UUID, email или другой идентификатор), если вы задаёте его в коде приложения при идентификации пользователей. Если пользователи не идентифицируются или конкретный пользователь анонимен (не вошёл в систему), поле равно null. |
| String | Email пользователя, если вы задаёте его с помощью метода updateProfile в SDK Adapty или при создании/обновлении профилей через серверный API. Если значение email не передаётся в метод SDK или API, поле равно null. | |
| event_api_version | Integer | Версия API Adapty (текущая: 1). |
| event_datetime | ISO 8601 | Фактическое (бизнес-) время события: например, дата покупки для события покупки или дата истечения для события истечения — не момент получения или отправки события в Adapty. Формат ISO 8601 (например, 2020-07-10T15:00:00.000000+0000). Подробнее о порядке событий см. примечание ниже. |
| event_properties | JSON | Свойства события. |
| event_type | String | Название события в формате Adapty. Полный список см. в разделе Типы событий вебхука. |
| idfa | UUID | Advertising ID (только Apple). IDFA в профиле в дашборде Adapty. Может быть null, если недоступен из-за ограничений отслеживания, детского режима или настроек конфиденциальности. |
| idfv | UUID | Identifier for Vendors (IDFV), уникальный для каждого разработчика. IDFV в профиле в дашборде Adapty. |
| integration_ids | JSON | Идентификаторы интеграций пользователя, если вы задаёте их с помощью метода setIntegrationIdentifier в SDK Adapty или при создании/обновлении профилей через серверный API. null, если недоступно или интеграции отключены. |
| play_store_purchase_token | JSON | Токен покупки Play Store. Включается, если в настройках вебхука включён параметр Send Play Store purchase token. |
| profile_id | UUID | ID профиля, автоматически генерируемый Adapty для каждого профиля. Один Apple/Google ID может быть связан с разными profile ID, если пользователи не идентифицируются или совершают покупки до входа в систему. Подробнее о том, как Adapty работает с родительскими и производными профилями. |
| profile_install_datetime | ISO 8601 | Временная метка установки в формате ISO 8601 (например, 2020-07-10T15:00:00.000000+0000). |
| profiles_sharing_access_level | JSON | Список пользователей, совместно использующих уровень доступа, за исключением текущего профиля. Если совместное использование уровней доступа включено для вашего приложения, список содержит другие профили, привязанные к тому же Apple/Google ID. Формат:
|
| user_agent | String | User-agent браузера устройства. |
| user_attributes | JSON | Пользовательские данные для обогащения профилей информацией, специфичной для приложения. Обычно используются для отслеживания предпочтений пользователя (например, тема, язык) или поведенческих флагов (завершение онбординга, использование функций). Задаются в формате ключ-значение, где ключи — строки, а значения — строки или числа (например, {"Favourite_color": "Violet", "Pet_name": "Fluffy"}). Пользовательские атрибуты можно задавать вручную в дашборде Adapty для отдельных профилей, программно через метод updateProfile в SDK Adapty или через серверный API при создании/обновлении профилей. Включается, если в настройках вебхука включён параметр Send User Attributes. Хотя в коде мобильного приложения значения пользовательских атрибутов могут задаваться как float или строки, атрибуты, полученные через серверный API или исторический импорт, могут иметь другие форматы. В этом случае булевы и целочисленные значения будут преобразованы в float. |
event_datetime отражает момент, когда событие произошло в жизненном цикле подписки, а не когда Adapty его обработал или доставил. Из-за этого события могут иметь одинаковое значение event_datetime или поступать не в хронологическом порядке. Например, событие subscription_expired может иметь более раннее значение event_datetime, чем событие subscription_renewal_cancelled, которое Adapty доставит раньше него. Не используйте event_datetime для упорядочивания событий. Вместо этого сортируйте события по времени получения на своей стороне и дедуплицируйте их с помощью profile_event_id или идентификаторов транзакций.
Атрибуции
Чтобы отправлять данные атрибуции, включите опцию Send Attribution на странице Integrations -> Webhooks. Если вы включили отправку данных атрибуции и настроили интеграции атрибуции, данные ниже будут отправляться вместе с событием для каждого источника. Одни и те же данные атрибуции отправляются для всех типов событий.
{
"attributions": {
"appsflyer": {
"ad_set": "sample_ad_set_123",
"status": "non_organic",
"channel": "sample_channel",
"ad_group": "sample_ad_group_456",
"campaign": "sample_ios_campaign",
"creative": "sample_creative_789",
"created_at": "2000-01-31T00:00:00.000000+0000",
"network_user_id": "0000000000000-0000000"
}
}
}
| Название поля | Тип поля | Описание |
|---|---|---|
| ad_set | String | Рекламный набор атрибуции. |
| status | String | Может быть organic, non_organic, или unknown. |
| channel | String | Название маркетингового канала. |
| ad_group | String | Рекламная группа атрибуции. |
| campaign | String | Название маркетинговой кампании. |
| creative | String | Ключевое слово креатива атрибуции. |
| created_at | ISO 8601 date | Дата и время создания записи атрибуции. |
| network_user_id | String | ID, присвоенный пользователю источником атрибуции. |
Integration IDs
В событиях сейчас используются следующие integration ID:
adjust_device_idairbridge_device_idamplitude_device_idamplitude_user_idappmetrica_device_idappmetrica_profile_idappsflyer_idbranch_idfacebook_anonymous_idfirebase_app_instance_idmixpanel_user_idpushwoosh_hwidone_signal_player_idone_signal_subscription_idtenjin_analytics_installation_idposthog_distinct_user_idsingular_sdid
Токен покупки Play Store
Это поле содержит все данные, необходимые для повторной валидации покупки при необходимости. Оно отправляется только если включена опция Send Play Store purchase token в настройках интеграции с Webhook.
| Field | Type | Description |
|---|---|---|
| product_id | String | Уникальный идентификатор продукта (SKU), приобретённого в Play Store. |
| purchase_token | String | Токен, сгенерированный Google Play для уникальной идентификации транзакции покупки. |
| is_subscription | Boolean | Указывает, является ли приобретённый продукт подпиской (true) или разовой покупкой (false). |
Свойства событий
Свойства событий могут различаться в зависимости от типа события и даже между событиями одного типа. Например, событие из App Store не будет содержать Android-специфичные свойства, такие как base_plan_id.
У события Access Level Updated есть особые свойства, поэтому мы выделили для него отдельный раздел. Аналогично, мы вынесли Дополнительные свойства событий налогов и выручки в отдельный раздел, поскольку они характерны лишь для отдельных типов событий.
Для большинства типов событий
Свойства событий для большинства типов событий одинаковы (кроме события Access Level Updated, которое описано в отдельном разделе). Ниже представлена подробная таблица свойств с указанием, к каким событиям они относятся.
Adapty конвертирует другие валюты в USD по курсу currencylayer.com (обновляется каждые 8 часов). Курс фиксируется на момент транзакции — последующие изменения не влияют на результат конвертации.
| Поле | Тип | Описание |
|---|---|---|
| ab_test_name | String | Название A/B-теста Adapty, в рамках которого совершена транзакция. |
| ab_test_revision | Integer | Ревизия A/B-теста, в рамках которого совершена транзакция. |
| base_plan_id | String | ID базового плана в Google Play Store или ID цены в Stripe. |
| cancellation_reason | String | Возможные причины отмены: Присутствует в следующих типах событий: subscription_cancelled, subscription_refunded и trial_cancelled. |
| cohort_name | String | Название аудитории, которая определила, какой пейвол был показан пользователю. |
| consecutive_payments | Integer | Количество периодов, в течение которых пользователь непрерывно оформлял подписку. Включает текущий период. |
| currency | String | Локальная валюта. null в trial_started, если не включена опция Send trial price. См. Дополнительные свойства событий налогов и выручки. |
| developer_id | String | ID плейсмента, в котором совершена транзакция. |
| discount_amount_local | Float | Скидка, применённая к транзакции: стандартная цена минус фактически списанная сумма до вычета комиссии Apple/Google, в локальной валюте. 0 при покупке по полной цене. Для бесплатного пробного периода равно полной стандартной цене (original_price_local), поскольку ничего не списывается. null, если скидка применялась, но стандартная цена неизвестна (см. original_price_local). Всегда null для офферов App Store с единовременной оплатой: единый платёж охватывает несколько расчётных периодов, поэтому сравнение с ценой за период невозможно. |
| discount_amount_usd | Float | Значение discount_amount_local в USD. |
| environment | String | Возможные значения: Sandbox или Production. |
| event_datetime | ISO 8601 date | Дата и время события. Совпадает со значением на корневом уровне события. |
| original_price_local | Float | Стандартная цена продукта без скидки до вычета комиссии Apple/Google, в локальной валюте. Для подписок — это цена продления. Равно price_local при покупке по полной цене и всегда равно price_local для разовых покупок, поскольку сторы не сообщают отдельную стандартную цену для них. null при покупке со скидкой, если стор не предоставляет достоверную стандартную цену (например, автопродление отключено, продление всё ещё содержит оффер или ожидается смена продукта). |
| original_price_usd | Float | То же, что original_price_local, в USD. |
| original_purchase_date | ISO 8601 date | Для возобновляемых подписок первая транзакция в цепочке является исходной покупкой; её ID (original transaction ID) связывает всю цепочку продлений, а последующие транзакции являются её расширениями. Дата исходной покупки — это дата и время этой первой транзакции. |
| original_transaction_id | String | Для возобновляемых подписок это ID исходной транзакции, который связывает всю цепочку продлений. Исходная транзакция — первая в цепочке; последующие транзакции являются её расширениями. Если расширений нет, |
| paywall_name | String | Название пейвола, в котором совершена транзакция. |
| paywall_revision | String | Ревизия пейвола, в котором совершена транзакция. Значение по умолчанию — 1. |
| price_local | Float | Сумма, списанная за транзакцию до вычета комиссии Apple/Google, в локальной валюте. null в trial_started, поскольку ничего не списывается, если не включена опция Send trial price. |
| price_usd | Float | Сумма, списанная за транзакцию до вычета комиссии Apple/Google, в USD. null в trial_started, поскольку ничего не списывается, если не включена опция Send trial price. |
| profile_country | String | Определяется Adapty на основе IP-адреса профиля. |
| profile_event_id | UUID | Уникальный ID события, который можно использовать для дедупликации. |
| profile_has_access_level | Boolean | Булево значение, указывающее, есть ли у профиля активный уровень доступа. |
| profile_id | UUID | ID профиля, сгенерированный Adapty. Совпадает со значением на корневом уровне события. |
| profile_ip_address | String | IP-адрес профиля (может быть IPv4 или IPv6; IPv4 имеет приоритет, если доступен). null, если в настройках приложения отключена опция Collect users’ IP addresses. |
| profile_total_revenue_usd | Float | Общая выручка по профилю с учётом вычета возвратов. |
| promotional_offer_id | String | Adapty ID promotional offer, который использовался. Вы задаёте этот ID при создании оффера в дашборде. |
| purchase_date | ISO 8601 date | Дата и время покупки продукта. |
| rate_after_first_year | Boolean | Булево значение, указывающее, что подписка соответствует условиям сниженной комиссии (обычно 15%) после одного года непрерывного продления. Размер комиссии зависит от участия в программе и страны. Подробнее см. в разделе Комиссии стора и налоги. |
| store | String | Стор, в котором был куплен продукт. Стандартные значения: app_store, play_store, stripe, paddle. Если вы настроили пользовательские транзакции стора через серверный API, используется значение из параметра store. |
| store_country | String | Страна, переданная нам сторами приложения. |
| store_offer_category | String | Категория применённого оффера. Возможные значения: introductory, promotional, winback. |
| store_offer_discount_type | String | Тип применённого оффера. Возможные значения: free_trial, pay_as_you_go и pay_up_front. |
| store_offer_number_of_periods | Integer | Количество базовых расчётных периодов, на которые распространяется скидка оффера (1 и более). Присутствует только при наличии оффера. null для офферов App Store с единовременной оплатой и в случаях, когда стор не сообщает длительность оффера. |
| subscription_expires_at | ISO 8601 date | Дата истечения срока подписки. В событиях возврата, проблем с оплатой, льготного периода и уровня доступа содержит дату отмены или дату окончания льготного периода, если он применяется. В событиях покупки и продления содержит обычную дату истечения срока подписки. |
| transaction_id | String | Уникальный идентификатор транзакции. |
| trial_duration | String | Длительность пробного периода в днях. Передаётся в формате « days», например «7 days». Присутствует только в типах событий, связанных с пробным периодом: trial_started, trial_converted, trial_cancelled. |
| variation_id | UUID | Уникальный ID пейвола, в котором была совершена покупка. |
| vendor_product_id | String | ID продукта в Apple App Store, Google Play Store или Stripe. Для 12-месячного тарифного плана с обязательством значение имеет вид Если доступ был предоставлен без реальной транзакции в сторе,
|
Дополнительные свойства событий для налогов и выручки
Перечисленные ниже свойства событий, связанные с налогами и выручкой, — это дополнительные поля, которые применяются только к определённым типам событий. Это означает, что перечисленные типы событий включают Свойства событий для большинства типов событий, а также дополнительные поля, указанные ниже.
Типы событий, имеющие свойства событий для налогов и выручки:
subscription_renewedsubscription_initial_purchase(также называетсяsubscription_started— одно и то же событие)subscription_refundednon_subscription_purchasenon_subscription_purchase_refundedtrial_startedtrial_converted
| Поле | Тип | Описание |
|---|---|---|
| net_revenue_local | Float | Чистая выручка (доход после вычета комиссии Apple/Google и налогов) в местной валюте. |
| net_revenue_usd | Float | Чистая выручка (доход после вычета комиссии Apple/Google и налогов) в USD. |
| proceeds_local | Float | price_local после вычета комиссии Apple/Google. |
| proceeds_usd | Float | price_usd после вычета комиссии Apple/Google. |
| tax_amount_local | Float | Расчётный налог, включённый в price_local. 0 для Stripe и Paddle, даже если пользователь платил налог. |
| tax_amount_usd | Float | Расчётный налог, включённый в price_usd. 0 для Stripe и Paddle, даже если пользователь платил налог. |
Для чистой выручки используйте net_revenue_* напрямую. Если tax_amount_* не равно 0, то proceeds_* минус tax_amount_* даёт меньшую сумму. Например, при цене 12, комиссии 30% и ставке налога 20% Adapty вычисляет:
proceeds_*=price_*× (1 − комиссия) = 12 × 0.7 = 8.40tax_amount_*=price_*× ставка налога ÷ (1 + ставка налога) = 12 × 0.2 ÷ 1.2 = 2.00net_revenue_*=proceeds_*÷ (1 + ставка налога) = 8.40 ÷ 1.2 = 7.00
Бесплатный пробный период не предполагает списания средств, поэтому в trial_started поля с ценой (price_*, proceeds_*, net_revenue_*, tax_amount_*) и currency по умолчанию равны null. Чтобы получать их, включите Send trial price в настройках вебхука. Adapty рассчитает их на основе цены подписки, умноженной на Trial price percentage, и передаст currency. Эти значения описывают подписку, а не фактическое списание, поэтому не включайте trial_started в итоги по выручке.
Пример полезной нагрузки non_subscription_purchase
non_subscription_purchase следует той же структуре, что и события подписки, но отражает разовую или расходуемую покупку. Поля, применимые только к подпискам, отсутствуют: cancellation_reason, will_renew, is_in_grace_period, is_refund, is_lifetime и trial_duration. Поле subscription_expires_at присутствует, но имеет значение null. Поля налогов и выручки (net_revenue_*, proceeds_*, tax_amount_*) включены.
Пример payload (нажмите, чтобы раскрыть)
{
"profile_id": "00000000-0000-0000-0000-000000000000",
"customer_user_id": "UserIdInYourSystem",
"event_type": "non_subscription_purchase",
"event_datetime": "2000-01-31T00:00:00.000000+0000",
"event_properties": {
"store": "app_store",
"currency": "USD",
"price_usd": 4.99,
"price_local": 4.99,
"original_price_usd": 4.99,
"original_price_local": 4.99,
"discount_amount_usd": 0,
"discount_amount_local": 0,
"proceeds_usd": 4.2415,
"proceeds_local": 4.2415,
"net_revenue_usd": 4.2415,
"net_revenue_local": 4.2415,
"tax_amount_usd": 0,
"tax_amount_local": 0,
"profile_id": "00000000-0000-0000-0000-000000000000",
"environment": "Production",
"vendor_product_id": "100coins",
"transaction_id": "0000000000000000",
"original_transaction_id": "0000000000000000",
"purchase_date": "2024-11-15T10:45:36.181000+0000",
"original_purchase_date": "2024-11-15T10:45:36.181000+0000",
"subscription_expires_at": null,
"store_country": "US",
"profile_country": "US",
"profile_ip_address": "10.10.1.1",
"profile_has_access_level": false,
"profile_total_revenue_usd": 4.99,
"consecutive_payments": 1,
"rate_after_first_year": false,
"profile_event_id": "00000000-0000-0000-0000-000000000000"
},
"event_api_version": 1
}Для события Access Level Updated
Событие Access Level Updated — это специфическое webhook-событие, которое генерируется только при активной интеграции Webhook и включённом типе этого события. Если оно включено, оно отправляется на настроенный Webhook и отображается в Event Feed. Если не включено, событие не создаётся.
Если вы включили общий доступ к уровням доступа, событие access level updated будет отправлено для всех профилей, имеющих доступ к данному уровню доступа.
Используйте это событие для обновления уровня доступа пользователя в вашей базе данных, предоставления или отзыва премиум-функций на бэкенде и синхронизации доступа между устройствами или платформами.
| Свойство | Тип | Описание |
|---|---|---|
| ab_test_name | String | Название A/B-теста, в котором совершена транзакция. |
| access_level_id | String | Идентификатор уровня доступа. |
| activated_at | ISO 8601 date | Дата и время последней активации доступа. |
| active_introductory_offer_type | String | Тип применённого introductory offer. Возможные значения: free_trial, pay_as_you_go, pay_up_front. |
| active_promotional_offer_id | String | Идентификатор promotional offer, указанный в разделе Product дашборда Adapty. |
| active_promotional_offer_type | String | Тип применённого promotional offer. Возможные значения: free_trial, pay_as_you_go, pay_up_front. |
| base_plan_id | String | Идентификатор базового плана в Google Play Store или идентификатор цены в Stripe. |
| billing_issue_detected_at | ISO 8601 date | Дата и время возникновения проблемы с оплатой. |
| cancellation_reason | String | Возможные причины отмены: voluntarily_cancelled, billing_error, price_increase, product_was_not_available, refund, cancelled_by_developer, new_subscription_replace, upgraded, unknown, adapty_revoked. |
| cohort_name | String | Название аудитории, к которой относится профиль. |
| currency | String | Локальная валюта (по умолчанию USD). |
| developer_id | String | Идентификатор плейсмента, в котором совершена транзакция. |
| environment | String | Возможные значения: Sandbox или Production. |
| event_datetime | ISO 8601 date | Дата и время события. |
| expires_at | ISO 8601 date | Дата и время окончания доступа. Adapty вычисляет В льготный период здесь хранится дата окончания льготного периода; после возврата средств или отмены — дата отмены. Отдельного поля для окончания льготного периода нет. |
| is_active | Boolean | Признак активности уровня доступа. Вычисляется из expires_at (вместе с starts_at и is_lifetime) на момент генерации события. |
| is_in_grace_period | Boolean | Признак того, что профиль находится в льготном периоде. Пока true, в expires_at хранится дата окончания льготного периода. |
| is_lifetime | Boolean | Признак пожизненного доступа. |
| is_refund | Boolean | Признак того, что транзакция является возвратом средств. |
| original_purchase_date | ISO 8601 date | Для возобновляемых подписок первоначальная покупка — это первая транзакция в цепочке; её идентификатор (original transaction ID) связывает цепочку продлений, а последующие транзакции являются её продолжением. Дата первоначальной покупки — это дата и время этой первой транзакции. |
| original_transaction_id | String | Для возобновляемых подписок — идентификатор первоначальной транзакции, связывающий цепочку продлений. Первоначальная транзакция — первая в цепочке; последующие являются её продолжением. Если продлений не было, |
| paywall_name | String | Название пейвола, в котором совершена транзакция. |
| paywall_revision | String | Ревизия пейвола, в котором совершена транзакция. Значение по умолчанию — 1. |
| profile_country | String | Определяется Adapty на основе IP-адреса профиля. |
| profile_event_id | UUID | Уникальный идентификатор события, который можно использовать для дедупликации. |
| profile_has_access_level | Boolean | Признак того, что профиль имеет активный уровень доступа. |
| profile_id | UUID | Внутренний идентификатор профиля пользователя в Adapty. |
| profile_ip_address | String | IP-адрес профиля (может быть IPv4 или IPv6; при наличии предпочтителен IPv4). null, если параметр Collect users’ IP addresses отключён в настройках приложения. |
| profile_total_revenue_usd | Float | Общий доход по профилю с учётом возвратов. |
| purchase_date | ISO 8601 date | Дата и время покупки продукта. |
| renewed_at | ISO 8601 date | Дата и время начала текущего оплаченного периода. До первого продления совпадает с activated_at. |
| starts_at | ISO 8601 date | Дата и время начала уровня доступа. |
| store | String | Стор, в котором был куплен продукт. Стандартные значения: app_store, play_store, stripe, paddle. Если транзакции установлены через серверный API с использованием пользовательских транзакций стора, используется значение из параметра store. |
| store_country | String | Страна, переданная в Adapty магазином приложений. |
| subscription_expires_at | ISO 8601 date | Дата истечения срока подписки. В данном событии содержит то же значение, что и expires_at: в льготный период — дату его окончания; после возврата средств или отмены — дату отмены. |
| transaction_id | String | Уникальный идентификатор транзакции. |
| trial_duration | String | Продолжительность пробного периода в днях (например, «7 days»). |
| variation_id | UUID | Идентификатор варианта, используемый для атрибуции покупок данному пейволу. |
| vendor_product_id | String | Идентификатор продукта в сторе (Apple/Google/Stripe). Для 12-месячного тарифного плана значение имеет вид Если доступ был предоставлен без реальной транзакции в сторе,
|
| will_renew | Boolean | Признак того, что платный уровень доступа будет продлён. |
Обратите внимание, что эта структура может расширяться со временем — по мере того как мы или наши партнёры добавляем новые данные. Убедитесь, что ваш код, обрабатывающий её, достаточно устойчив и опирается на конкретные поля, а не на всю структуру целиком.