RevenueCat 集成

RevenueCat 是一个订阅管理平台，可为 iOS、Android 和 Web 平台上的企业简化应用内购买和订阅。它提供了用于构建、分析和增强应用内订阅的全面工具。

通过将 Pushwoosh 与 RevenueCat 集成，企业可以根据 RevenueCat 发送到 Pushwoosh 的订阅事件，向用户发送有针对性的推送通知、应用内提示和其他消息。这可以鼓励用户续订、升级到更高等级或利用特别优惠，从而增强互动、最大化收入并简化订阅管理。

用例

个性化通信

企业可以使用此集成来与客户进行个性化通信。例如，一个电子学习平台可以通过在检测到订阅计划变更时发送个性化的推送通知来提高用户参与度。这些通知提供过渡指导，根据新计划推荐相关课程，并提供与更新一致的独家优惠。

账单问题通知

当用户的订阅遇到账单问题时，企业可以使用 RevenueCat 与 Pushwoosh 的集成来及时发送有针对性的通知。例如，流媒体服务可以通知用户账单问题，并提供解决问题的说明，例如更新支付信息。

非续订购买通知

企业可以利用 RevenueCat 与 Pushwoosh 的集成，将一次性购买转变为持久的客户关系。例如，送餐服务可以在购买后发送推送通知，感谢客户并推荐相关产品或推广订阅计划以持续便利。这将培养客户忠诚度，推动追加销售机会，并可能将一次性购买者转变为订阅者。

等级升级促销

拥有多个订阅等级的应用可以使用此集成来监控用户订阅并发送量身定制的升级提示。例如，游戏应用可以使用推送通知来强调高级等级的好处，如独家内容或折扣，鼓励用户提升其订阅。

事件

RevenueCat 发送的每个 webhook 都会成为一个 Pushwoosh 事件，名称为 RC_ 加上 RevenueCat 事件类型，例如 RC_INITIAL_PURCHASE、RC_RENEWAL、RC_CANCELLATION、RC_BILLING_ISSUE 或 RC_EXPIRATION。Pushwoosh 会在某类型的 webhook 首次到达时创建该事件，因此新的 RevenueCat 事件类型会自动出现在您的应用中。完整列表请参阅 RevenueCat 文档中的事件类型。

每个事件都会将 RevenueCat webhook 的字段作为事件属性携带，例如 price、price_in_purchased_currency、currency、product_id、store、period_type、environment、country_code 和 entitlement_ids：

以毫秒表示时间的字段会变为去掉 _ms 后缀的日期，例如 purchased_at 和 expiration_at。webhook 的发送日期为 timestamp 属性。
这些日期采用 UTC 时间，格式为 YYYY-MM-DD，不含具体时间。
您在 RevenueCat 中设置的客户属性也会成为事件属性。用于识别个人或设备的属性（例如电子邮件、电话号码、显示名称、IP 地址、广告 ID 和推送令牌）不会传递给 Pushwoosh。
一个事件最多保留 100 个属性。

来自 App Store、Google Play、Mac App Store 和 Amazon 的购买会分别记录在 iOS、Android、macOS 和 Amazon 平台上。来自其他商店（例如 Stripe、RevenueCat Billing 或促销赠送）的购买记录不带平台。

您可以在 Customer Journey 中使用这些事件。带有 price 属性的事件可用于 RFM 分群。

设置集成

该集成通过 RevenueCat webhook 实现，webhook 在 RevenueCat 的 Pro 套餐中提供。

将 RevenueCat 客户与 Pushwoosh 用户匹配

Pushwoosh 会为 webhook 中指定的 Pushwoosh 用户记录该 webhook，并跳过未指定任何用户的 webhook。请选择 RevenueCat 指定用户的方式：

如果您的应用使用自己的 ID 识别用户，并将其作为 App User ID 传递给 RevenueCat，请将 App User ID 用作 Pushwoosh User ID。
如果 App User ID 与 Pushwoosh User ID 不同，例如 RevenueCat 使用 $RCAnonymousID:… 之类的匿名 ID 时，请将 Pushwoosh ID 作为 RevenueCat 属性发送。否则，事件会发送到 Pushwoosh 中不存在的用户 ID。

将 RevenueCat App User ID 用作 Pushwoosh User ID

将您传递给 RevenueCat 的 App User ID 设置为 Pushwoosh User ID（setUserId）。

Android

Pushwoosh.getInstance().setUserId(appUserID);

iOS

Pushwoosh.configure.setUserId(appUserID)

将 Pushwoosh ID 作为 RevenueCat 属性发送

在 RevenueCat 中设置属性 pushwooshUserId 和 pushwooshHwid。Pushwoosh 会使用它们代替 App User ID：

pushwooshUserId：客户的 Pushwoosh User ID。
pushwooshHwid：客户设备的 Pushwoosh 硬件 ID（HWID）。此属性为可选项。如果未设置，Pushwoosh 会将 User ID 用作 HWID。

Android

Purchases.sharedInstance.setAttributes(mapOf(
    "pushwooshUserId" to pushwooshUserId,
    "pushwooshHwid" to Pushwoosh.getInstance().hwid
))

iOS

Purchases.shared.attribution.setAttributes([
    "pushwooshUserId": pushwooshUserId,
    "pushwooshHwid": Pushwoosh.configure.getHWID()
])

将 RevenueCat webhook 发送到 Pushwoosh

在您的 RevenueCat 控制面板中：

打开您的项目，在左侧菜单中找到 Integrations 卡片，然后点击 + New。

选择 Webhooks。

如果 RevenueCat 显示您的 webhook 列表，请点击 Add new configuration。
为集成指定一个简单的名称，例如 Pushwoosh，以便于识别。
输入以下 URL 作为 webhook URL：

https://integration-revenuecat.svc-nue.pushwoosh.com/integration-revenuecat/v1/post-event?pwapp=APP_CODE

在 URL 中，将 APP_CODE 替换为您现有的 Pushwoosh 应用程序代码，该代码位于您 Pushwoosh 帐户中应用程序名称的下方。

在 Authorization header value 字段中，插入您的 Pushwoosh API 令牌。 您可以在 Pushwoosh 的 Settings > API Access 下找到此令牌。

决定您是要为生产（实时）购买、沙盒（测试）购买还是两者都传输事件。
在 App 下拉菜单中，指定是为单个应用还是项目中的所有应用分派 webhook 事件。
在 Event Type 下拉菜单中，选择是发送所有事件还是指定要发送到 Pushwoosh 的事件。

选择显示所有事件、仅成功事件或仅失败事件。

要检查连接，请从 RevenueCat 发送一个测试 webhook。投递成功表示 Pushwoosh 已接受该 URL 和 API 令牌。测试 webhook 本身不会被记录为事件：每个 RC_ 事件会在该类型的第一个真实 webhook 到达后，出现在您 Pushwoosh 应用的受众 → 事件下。