2024年如何通过Firebase Functions(Node.js)上报Firebase Analytics自定义事件？

2024年是否支持后端发送自定义事件？ #

是的，Firebase Admin SDK for Node.js目前支持从后端向Firebase Analytics发送自定义事件，但需使用正确的API方法，且确保你的Admin SDK版本为v11.0.0及以上（该版本首次引入后端Analytics事件上报能力）。

解决analytics is not a function报错 #

你遇到的语法错误源于使用了错误的API调用方式，以下是正确的实现步骤：

1. 升级Admin SDK版本
   检查package.json中firebase-admin的版本，若低于v11.0.0，执行升级命令：

   npm install firebase-admin@latest
   

2. 正确的事件上报代码示例
   初始化Admin SDK后，使用admin.analytics().logEvent()方法（而非log()），需指定用户标识（userId或deviceId）、事件名称及参数：

   const admin = require('firebase-admin');
   const functions = require('firebase-functions');
   
   admin.initializeApp();
   
   exports.reportBackendAnalyticsEvent = functions.https.onRequest(async (req, res) => {
     try {
       await admin.analytics().logEvent({
         userId: 'user_12345', // 可替换为deviceId，二选一即可
         name: 'backend_custom_action',
         params: {
           action_type: 'data_sync',
           sync_duration: 120
         }
       });
       res.status(200).send('自定义事件上报成功');
     } catch (err) {
       console.error('上报失败:', err);
       res.status(500).send('事件上报失败');
     }
   });
   

3. 关键注意事项

   • 后端上报的事件会显示在Firebase Analytics控制台的「事件」页面，但部分自动收集的用户属性需手动通过params传入。
   • 确保Firebase Functions的服务账号拥有firebaseanalytics.eventLogWriter权限，默认配置下Functions服务账号已具备该权限，自定义权限组需单独校验。
   • 事件名称需符合规则：仅含字母、数字、下划线，不以数字开头，长度不超过40字符。

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