在日益增长的移动市场中，获客既不容易也代价高昂。因此，妥善运营已吸引的用户可以改善您的单位经济效益，在竞争激烈的细分市场中尤为如此。

Adapty 提供用户核心支付行为的实时信息。我们能知道您的客户何时开始试用、是否遇到支付问题，或者是否购买了订阅后又决定取消。所有这些事件以及其他事件都反映了客户状态的变化，这正是采取行动的最佳时机——发送优惠、个性化礼品或任何有助于留存的内容。

推送通知平台允许通过标准和自定义标签描述用户，从而构建有效的自动化留存体系。要使该体系正常运作，您只需提供触发事件，让系统知道是时候发送消息了。这些事件将通过已配置的集成从 Adapty 发送到推送平台。

请在下方选择您需要集成的服务并按照说明操作：

• Braze
• OneSignal
• Pushwoosh
• Slack

事件属性

Webhook 事件以 JSON 格式发送。所有事件遵循相同的结构，但其字段因事件类型、应用商店和您的具体配置而有所不同。

属性	类型	描述
profile_id	uuid	Adapty 用户 ID。
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 中的产品 ID。
base_plan_id	str	Google Play Store 中的基础方案 ID 或 Stripe 中的价格 ID。
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	在 Adapty 看板产品部分中标注的促销活动 ID。
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	交易来源版位的开发者（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	布尔值，表示用户画像是否拥有有效的访问等级（仅限 Webhook）。

每个事件都具有以下属性：

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 与我们记录的不同，则会进行更新。