记录事件 | Firebase Documentation

如果您的应用已关联到BigQuery 项目，自定义参数也将包含在导出至BigQuery 的数据中。

如需查看示例查询及更多内容，请访问Google Analytics（分析）4 BigQuery Export ... 产品 构建 发布与监控 吸引 用例 价格 文档 概览 基础知识 构建 发布与监控 吸引 参考文档 示例 社区 学习 活动 支持 Language English BahasaIndonesia Deutsch Español–AméricaLatina Français Italiano Polski Português–Brasil TiếngViệt Türkçe Русский עברית العربيّة فارسی हिंदी বাংলা ภาษาไทย 中文–简体 中文–繁體 日本語 한국어 转到控制台 登录 FirebaseDocumentation 概览 基础知识 添加Firebase-iOS 添加Firebase-Android 添加Firebase-Web 添加Firebase-C++ 添加Firebase-Unity 添加Firebase-服务器环境 管理Firebase项目 支持的平台和框架 使用AppCheck保护项目资源 使用EmulatorSuite 构建 EmulatorSuite Authentication RealtimeDatabase Firestore Storage ML Hosting CloudFunctions 安全规则 Extensions 发布与监控 Crashlytics PerformanceMonitoring TestLab AppDistribution 吸引 Analytics RemoteConfig A/BTesting CloudMessaging In-AppMessaging DynamicLinks GoogleAdMob GoogleAds AppIndexing 参考文档 示例 产品 更多 用例 价格 文档 更多 概览 基础知识 更多 构建 更多 发布与监控 更多 吸引 更多 参考文档 示例 社区 更多 支持 转到控制台 概览 Analytics 简介开始使用记录事件设置用户属性调试事件TrackScreens设置用户ID衡量电子商务衡量广告收入在WebView中使用通过CloudFunctions扩展配置数据收集和使用方式错误代码 C++ 开始使用记录事件设置用户属性 Unity 开始使用记录事件设置用户属性 RemoteConfig 简介开始使用 RemoteConfig有哪些用途？ RemoteConfig用例 主要概念和策略 参数和条件模板和版本控制配置加载策略实时传播更新RemoteConfig与Analytics以编程方式修改RemoteConfig 个性化 概览开始使用 API参考文档 RESTAPI参考文档条件表达式参考文档AndroidSDK参考文档iOSSwiftSDK参考文档iOSObj-CSDK参考文档Unity参考文档C++参考文档 A/BTesting 简介FirebaseA/BTesting简介使用A/BTesting来创建RemoteConfig实验使用A/BTesting来创建消息传递实验使用A/BTesting来创建In-AppMessaging实验视频系列：了解A/BTesting CloudMessaging 简介FCM架构概览FCM消息简介了解消息传送管理FCM注册令牌 iOS 设置iOS客户端发送测试消息向多台设备发送消息在通知载荷中发送图片接收消息向主题发送消息向设备组发送消息使用Firebase控制台发送消息 Android 设置Android客户端发送测试消息向多台设备发送消息在通知载荷中发送图片接收消息向主题发送消息向设备组发送消息发送上行消息使用Firebase控制台发送消息 C++ 设置C++客户端接收消息向主题发送消息向设备组发送消息发送上行消息使用Firebase控制台发送消息 Unity 设置Unity客户端接收消息向主题发送消息向设备组发送消息发送上行消息使用Firebase控制台发送消息 Web(JavaScript) 设置JavaScript客户端发送测试消息向多台设备发送消息接收消息向主题发送消息向设备组发送消息使用Firebase控制台发送消息 服务器环境 您的服务器环境和FCM改为使用HTTPv1API授权发送请求构建发送请求接收上行消息从服务器管理主题 In-AppMessaging 简介开始使用探索使用情形编写广告系列修改消息行为自定义消息 DynamicLinks 简介 用例 概览将网页用户转化为应用用户邀请用户使用您的应用奖励用户引荐操作系统集成 创建动态链接 简介iOSAndroidC++UnityREST手动构造网址 接收动态链接 iOSAndroidC++Unity使用自定义域名查看分析数据调试动态链接链接预览和社交元数据 GoogleAdMob 简介适用于iOS的使用入门适用于Android的使用入门将Analytics和Firebase与AdMob应用结合使用 在游戏中使用AdMob C++ 开始使用Cocos2d-x激励视频广告 Unity 开始使用 解决方案 测试采用新广告格式的情况 解决方案概览解决方案教程 优化广告频率 解决方案概览解决方案教程 GoogleAds 简介 AppIndexing 概览 相关产品 Authentication Crashlytics Extensions 构建 发布与监控 吸引 概览 基础知识 构建 发布与监控 吸引 参考文档 示例 学习 活动 添加Firebase-iOS 添加Firebase-Android 添加Firebase-Web 添加Firebase-C++ 添加Firebase-Unity 添加Firebase-服务器环境 管理Firebase项目 支持的平台和框架 使用AppCheck保护项目资源 使用EmulatorSuite EmulatorSuite Authentication RealtimeDatabase Firestore Storage ML Hosting CloudFunctions 安全规则 Extensions Crashlytics PerformanceMonitoring TestLab AppDistribution Analytics RemoteConfig A/BTesting CloudMessaging In-AppMessaging DynamicLinks GoogleAdMob GoogleAds AppIndexing Firebase FirebaseDocumentation 吸引 发送反馈 记录事件 iOS+ Android Web Flutter 本指南介绍如何在您的应用中记录事件。

事件可让您了解您的应用中发生了什么，例如用户操作、系统事件或错误。

Analytics会自动为您记录一些事件，您无需为此添加任何代码。

如果应用需要收集其他数据，您可以在其中记录多达500种不同的Analytics事件类型。

应用可记录的事件总量不受限制。

请注意，事件名称区分大小写。

即便两个事件的名称只是大小写不同，系统也会将其视作两种不同的事件。

准备工作 确保您已按照Analytics使用入门中的说明设置了您的项目，并且可以访问Analytics。

记录事件 配置firebase.analytics()实例后，您可以开始使用logEvent()方法记录事件。

如果您已熟悉GoogleAnalytics（分析），此方法与在gtag.js中使用event命令的效果相同。

为帮助您着手使用，AnalyticsSDK定义了许多常见于各类型应用（零售、电子商务、差旅以及游戏应用等）的推荐事件。

如需详细了解这些事件及其适用情形，请参阅推荐事件。

注意：为了让您的报告尽可能详尽，请记录对您的应用有意义的推荐事件及其预设参数。

这也能确保您可以立即获取最新的GoogleAnalytics（分析）功能。

您可以在gtag.js事件参考文档中找到多个事件及其参数的实现详情。

下面的示例演示了如何记录select_content事件： Webversion9 详细了解可实现摇树优化的Webv9模块化SDK，并从版本8升级。

import{getAnalytics,logEvent}from"firebase/analytics"; constanalytics=getAnalytics(); logEvent(analytics,'select_content',{ content_type:'image', content_id:'P12453', items:[{name:'Kittens'}] });analytics_log_event_params.js Webversion8 analytics.logEvent('select_content',{ content_type:'image', content_id:'P12453', items:[{name:'Kittens'}] });index.js 除了预设参数外，您还可以将以下参数添加到事件中： 自定义参数：可使用自定义参数作为Analytics报告中的维度或指标。

您可以对非数值事件参数数据使用自定义维度，而对以数值形式表示的参数数据使用自定义指标。

使用SDK记录自定义参数后，请注册维度或指标，以确保这些自定义参数能够出现在Analytics报告中。

可依次点击以下各项完成此操作：“Analytics”>“事件”>“管理自定义设置”>“创建自定义维度” 在每份报告采用的受众群体定义中，可以使用自定义参数。

如果您的应用已关联到BigQuery项目，自定义参数也将包含在导出至BigQuery的数据中。

如需查看示例查询及更多内容，请访问GoogleAnalytics（分析）4BigQueryExport。

value参数：value是一个通用参数，可用于累积与事件相关的关键指标，例如收入、距离、时间和分数。

如果推荐的事件类型未涵盖您的应用的特定需求，您可以记录自己的自定义事件。

例如，如果您正在开发一款游戏并且想要跟踪玩家何时完成特定的目标，则可以按以下示例所示方式记录事件： Webversion9 详细了解可实现摇树优化的Webv9模块化SDK，并从版本8升级。

import{getAnalytics,logEvent}from"firebase/analytics"; constanalytics=getAnalytics(); logEvent(analytics,'goal_completion',{name:'lever_puzzle'});analytics_log_event_custom_params.js Webversion8 analytics.logEvent('goal_completion',{name:'lever_puzzle'});index.js 在信息中心内查看事件 您可以在Firebase控制台信息中心内查看有关事件的汇总统计信息。

这些信息中心会全天定时更新。

如需立即测试，请按照上一部分中所述的方式使用logcat输出。

您可以在Firebase控制台的事件信息中心访问这些数据。

此信息中心显示了为应用记录的每种不同事件自动创建的事件报告。

发送反馈 Exceptasotherwisenoted,thecontentofthispageislicensedundertheCreativeCommonsAttribution4.0License,andcodesamplesarelicensedundertheApache2.0License.Fordetails,seetheGoogleDevelopersSitePolicies.JavaisaregisteredtrademarkofOracleand/oritsaffiliates. Lastupdated2022-07-22UTC. [{ "type":"thumb-down", "id":"missingTheInformationINeed", "label":"没有我需要的信息" },{ "type":"thumb-down", "id":"tooComplicatedTooManySteps", "label":"太复杂/步骤太多" },{ "type":"thumb-down", "id":"outOfDate", "label":"内容需要更新" },{ "type":"thumb-down", "id":"translationIssue", "label":"翻译问题" },{ "type":"thumb-down", "id":"samplesCodeIssue", "label":"示例/代码问题" },{ "type":"thumb-down", "id":"otherDown", "label":"其他" }] [{ "type":"thumb-up", "id":"easyToUnderstand", "label":"易于理解" },{ "type":"thumb-up", "id":"solvedMyProblem", "label":"解决了我的问题" },{ "type":"thumb-up", "id":"otherUp", "label":"其他" }] 需要向我们提供更多信息？ 学习 指南 参考 示例 库 GitHub 掌握动态 博客 Firebase峰会 Facebook Twitter YouTube 支持 与支持团队联系 StackOverflow Slack社区 Googlegroup 版本说明 常见问题解答 Android Chrome Firebase GoogleCloudPlatform 所有产品 条款 隐私权政策 Language English BahasaIndonesia Deutsch Español–AméricaLatina Français Italiano Polski Português–Brasil TiếngViệt Türkçe Русский עברית العربيّة فارسی हिंदी বাংলা ภาษาไทย 中文–简体 中文–繁體 日本語 한국어