如何在Python Django中使用PyFCM开启Google Firebase通知分析功能

前置依赖校验 #

• 首先确认Firebase项目已开通Google Analytics服务，通知分析全链路数据默认依赖Analytics的上报能力，未开通可进入控制台「设置」→「项目设置」→「集成」页面，找到Google Analytics卡片完成关联开通，需选择对应应用所属的GA数据流。
• 确认客户端集成的FCM SDK版本符合最低要求：Android端com.google.firebase:firebase-messaging:20.1.0及以上，iOS端Firebase/Messaging 6.22.0及以上，低版本SDK不支持自动上报通知全链路事件。

PyFCM服务端发送适配 #

要让通知被纳入分析统计，使用PyFCM发送时必须携带analytics_label参数，该参数为自定义的分析标签，用于分类统计不同批次的通知数据，参考调用代码：

from pyfcm import FCMNotification

push_service = FCMNotification(api_key="<你的服务端FCM API密钥>")
# 通知消息、数据消息、混合类型消息都需要添加该配置
result = push_service.notify_single_device(
    registration_id="<目标设备token>",
    message_title="测试通知",
    message_body="分析功能验证内容",
    fcm_options={"analytics_label": "push_campaign_20240520"}
)

未携带analytics_label的通知请求不会被统计到分析报告中。

客户端配置要求 #

• Android端：集成符合版本要求的FCM SDK和Firebase Analytics SDK即可，无需额外编码，系统会自动上报发送、接收、打开三类核心事件，注意不要禁用FCM的自动初始化配置。
• iOS端：完成FCM SDK和Analytics SDK集成的基础上，正常实现用户通知中心的打开回调即可，事件会自动上报，无需手动埋点。

数据查看说明 #

• 配置完成后新发送的通知，数据最多有24小时的延迟才会展示在Firebase控制台「报告」→「Cloud Messaging」分析面板中，可按自定义的analytics_label筛选对应批次通知的发送量、接收率、打开率等明细指标。
• 如需导出全量明细数据，可进入关联的Google Analytics资源，通过自定义探索报表筛选notification_send、notification_receive、notification_open三类事件，导出对应维度的明细数据。

常见排查点 #

• 若配置后仍无数据，首先确认服务端发送请求的响应为成功状态，排除token无效、权限不足、配额耗尽等发送失败问题。
• 确认客户端未关闭Firebase Analytics的数据收集权限，用户主动关闭数据收集的设备不会上报对应事件。

内容的提问来源于stack exchange，提问作者Saurabh