Firebase 与 Google Analytics
如果您使用 Google Analytics 和 Firebase 等 Google 产品,可以通过本文介绍的集成方式,将 Adapty 的事件数据丰富到您的分析数据中。事件通过 Google Analytics 发送到 Firebase,可在这两个服务中使用。
此功能使您能够在 Firebase 中将用户行为与其付款历史相关联,从而帮助您做出明智的产品决策。
如何设置 Firebase 集成
1. 配置 Firebase
首先,您需要启用 Firebase 与 Google Analytics 之间的集成。您可以在 Firebase 控制台的 Integrations 标签页中完成此操作。
2. 与 Adapty 集成
接下来,Adapty 需要您的 Firebase App ID 和 Google Analytics API Secret 来发送事件和用户属性。您可以分别在 Firebase 控制台和 Google Analytics 数据流标签页中找到这些参数。
接下来,在 Google Analytics 管理设置的数据流部分,进入应用的数据流详情页面。
在 Additional settings 下,进入 Measurement Protocol API secrets 页面,如果尚不存在,请创建一个新的 API Secret。复制该值。
然后,您需要在 Adapty 看板中完成集成配置。您需要为 iOS、Android 和/或 Stripe 平台提供 Firebase App ID 和 Google Analytics API Secret。
如果您正在使用 Stripe 集成,请参阅专门的指南了解其限制。这些限制同样适用于 Firebase 集成。
SDK 配置
要使集成正常工作,请确保首先将 Firebase 添加到您的应用中:
然后,您需要配置 Adapty SDK 以将用户与 Firebase 关联。对于每个用户,您应将 firebase_app_instance_id 发送给 Adapty。以下是可用于集成 Firebase SDK 和 Adapty SDK 的示例代码。
发送事件和用户属性
现在是时候决定您将在 Firebase 和 Google Analytics 中接收哪些事件了。
您可以看到,某些事件有指定名称,例如”Purchase”,而其他事件则是普通的 Adapty 事件。这种差异来源于 Google Analytics 事件类型。目前支持的事件为 Refund 和 Purchase。其他事件为自定义事件。因此,请确保您的事件名称受 Google Analytics 支持。
此外,您还可以在 Adapty 看板中设置发送用户属性。
这意味着 Adapty 将为您的事件附加 subscription_state 和 subscription_product_id。但您还需要在 Google Analytics 中启用此功能。因此,要在分析中使用用户属性,请先通过 Firebase 控制台的 Custom Definitions 将其分配给自定义维度,选择用户范围并为其命名和描述。
请确认您的用户属性名称为 subscription_state 和 subscription_product_id。否则,我们将无法向您发送订阅状态数据。
大功告成!等待来自 Google 的新洞察吧。
故障排查
数据差异
如果 Adapty 与 Firebase 之间存在数据差异,这可能是因为并非所有用户都使用了包含 Adapty SDK 的应用版本。为确保数据一致性,您可以强制用户将应用更新到包含 Adapty SDK 的版本。
此外,沙盒事件默认会发送到 Firebase,且无法禁用。因此,当应用有少量正式环境事件和大量沙盒事件时,Adapty 分析与 Firebase 之间的数据可能存在明显差异。
事件在 Adapty 中显示已送达,但在 Firebase 中不可见
从 Adapty 发送事件到事件出现在 Google Analytics 看板上之间存在时间延迟。建议监控您 Google Analytics 账户中的实时看板,以实时查看最新事件。