Firebase 与 Google Analytics

如果您使用 Google Analytics 和 Firebase 等 Google 产品,可以通过本文介绍的集成方式,将 Adapty 的事件数据丰富到您的分析数据中。事件通过 Google Analytics 发送到 Firebase,可在这两个服务中使用。

此功能使您能够在 Firebase 中将用户行为与其付款历史相关联,从而帮助您做出明智的产品决策。

如何设置 Firebase 集成

1. 配置 Firebase

首先,您需要启用 Firebase 与 Google Analytics 之间的集成。您可以在 Firebase 控制台的 Integrations 标签页中完成此操作。

14b6d84-CleanShot_2023-08-18_at_20.37.462x.webp

2. 与 Adapty 集成

接下来,Adapty 需要您的 Firebase App ID 和 Google Analytics API Secret 来发送事件和用户属性。您可以分别在 Firebase 控制台和 Google Analytics 数据流标签页中找到这些参数。

14d8224-CleanShot_2023-08-21_at_12.14.182x.webp

接下来,在 Google Analytics 管理设置的数据流部分,进入应用的数据流详情页面。

b26ae6a-CleanShot_2023-08-21_at_12.28.482x.webp

Additional settings 下,进入 Measurement Protocol API secrets 页面,如果尚不存在,请创建一个新的 API Secret。复制该值。

7404bde-CleanShot_2023-08-21_at_12.33.242x.webp
0266112-CleanShot_2023-08-21_at_12.34.442x.webp

然后,您需要在 Adapty 看板中完成集成配置。您需要为 iOS、Android 和/或 Stripe 平台提供 Firebase App ID 和 Google Analytics API Secret。

如果您正在使用 Stripe 集成,请参阅专门的指南了解其限制。这些限制同样适用于 Firebase 集成。

4eaae3f-CleanShot_2023-08-21_at_12.35.312x.webp

SDK 配置

要使集成正常工作,请确保首先将 Firebase 添加到您的应用中:

然后,您需要配置 Adapty SDK 以将用户与 Firebase 关联。对于每个用户,您应将 firebase_app_instance_id 发送给 Adapty。以下是可用于集成 Firebase SDK 和 Adapty SDK 的示例代码。

发送事件和用户属性

现在是时候决定您将在 Firebase 和 Google Analytics 中接收哪些事件了。

7923397-set_up_events_names.webp

您可以看到,某些事件有指定名称,例如”Purchase”,而其他事件则是普通的 Adapty 事件。这种差异来源于 Google Analytics 事件类型。目前支持的事件为 RefundPurchase。其他事件为自定义事件。因此,请确保您的事件名称受 Google Analytics 支持
此外,您还可以在 Adapty 看板中设置发送用户属性。

e053006-CleanShot_2023-08-21_at_12.50.162x.webp

这意味着 Adapty 将为您的事件附加 subscription_statesubscription_product_id。但您还需要在 Google Analytics 中启用此功能。因此,要在分析中使用用户属性,请先通过 Firebase 控制台的 Custom Definitions 将其分配给自定义维度,选择用户范围并为其命名和描述。

1962ef1-CleanShot_2023-08-21_at_12.48.222x.webp
2425cc0-CleanShot_2023-08-21_at_12.52.532x.webp

请确认您的用户属性名称为 subscription_statesubscription_product_id。否则,我们将无法向您发送订阅状态数据。

大功告成!等待来自 Google 的新洞察吧。

故障排查

数据差异

如果 Adapty 与 Firebase 之间存在数据差异,这可能是因为并非所有用户都使用了包含 Adapty SDK 的应用版本。为确保数据一致性,您可以强制用户将应用更新到包含 Adapty SDK 的版本。

此外,沙盒事件默认会发送到 Firebase,且无法禁用。因此,当应用有少量正式环境事件和大量沙盒事件时,Adapty 分析与 Firebase 之间的数据可能存在明显差异。

事件在 Adapty 中显示已送达,但在 Firebase 中不可见

从 Adapty 发送事件到事件出现在 Google Analytics 看板上之间存在时间延迟。建议监控您 Google Analytics 账户中的实时看板,以实时查看最新事件。