Firebase Analytics 上传事件的小注意事项

在使用 Firebase Analytics 的 logEvent 方法记录事件时，有一些关于事件名称和参数的限制。以下是主要的限制：

保留前缀问题：

Firebase Analytics 不允许使用以 firebase_ 或其他保留前缀开头的自定义事件名称

事件名称限制

1. 长度限制：事件名称的最大长度为 40 个字符。
2. 字符集：事件名称只能包含字母数字字符和下划线（A-Z、a-z、0-9 和 _）。
3. 保留事件名称：某些事件名称是 Firebase 保留的，不能用于自定义事件。例如：
   • first_open
   • session_start
   • in_app_purchase
   • add_to_cart
   • remove_from_cart
   • begin_checkout
   • purchase
   • refund
   • screen_view
   • search
   • select_content
   • share
   • sign_up
   • tutorial_begin
   • tutorial_complete
   • user_engagement
   • view_item
   • view_item_list
   • view_search_results

参数限制

1. 参数数量：每个事件最多可以有 25 个参数。
2. 参数名称长度：参数名称的最大长度为 40 个字符。
3. 参数值长度：参数值的最大长度为 100 个字符。
4. 参数类型：参数值可以是字符串、长整型或浮点型。
5. 保留参数名称：某些参数名称是 Firebase 保留的，不能用于自定义参数。例如：
   • currency
   • value
   • item_id
   • item_name
   • item_category
   • quantity
   • price
   • start_date
   • end_date
   • search_term
   • content_type
   • item_list_name
   • item_list_id
   • screen_class
   • screen_name
   • campaign_name
   • campaign_source
   • campaign_medium
   • campaign_content
   • campaign_term
   • user_id
   • user_properties

示例

以下是一个符合限制的 logEvent 调用示例：

val params = Bundle().apply {
    putString("item_id", "12345")
    putString("item_name", "Example Item")
    putLong("quantity", 1)
    putDouble("price", 19.99)
}

Firebase.analytics.logEvent("item_purchased", params)

注意事项

• 如果事件名称或参数名称超过长度限制，Firebase 会自动截断。
• 如果参数值超过长度限制，Firebase 会记录一个警告日志，并且不会记录该参数。
• 尽量使用有意义且简洁的事件名称和参数名称，以便于后续的数据分析。