更新记录

1.0.5（2023-10-08）

修复iOS新版本基座打包问题

1.0.4（2023-07-25）

1. 优化Android内部逻辑

1.0.3（2023-05-22）

1. 修复iOS 事件接口logEvent

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

Firebase Analytics

Google Analytics 是一种免费的应用衡量解决方案，可提供有关应用使用情况和用户参与度的洞察。

功能

1. 记录事件
2. 衡量电子商务
3. 跟踪屏幕
4. 衡量广告收入
5. 设置默认事件参数
6. 设置用户属性
7. 设置用户ID
8. 禁用/开启Analytics 数据收集

集成步骤

1. 在Firebasehttps://console.firebase.google.com/?hl=zh-cn平台创建项目
2. 点击创建的项目，分别添加Android、iOS应用，添加的时候Android需要绑定包名和打包证书的SHA-1(可选)，iOS需要绑定包名，再分别下载Android的google-services.json和iOS的GoogleService-Info.plist
3. 下载demo，将demo里的nativeplugins下的wrs-firebaseAnalytics文件夹复制到自己项目的nativeplugins下
4. Android的google-services.json的处理方式有2种：

4.1 联系作者(QQ:252797991)将google-services.json转换为config.xml，然后替换nativeplugins/wrs-firebaseAnalytics/android/res/values的google-services.json文件

4.2 使用google-services.json的值替换config.xml的值，对应的替换值为：

5. 将iOS的GoogleService-Info.plist替换nativeplugins/wrs-firebaseAnalytics/ios/BundleResources下的GoogleService-Info.plist文件
6. 在插件市场本插件网页里选择“试用”绑定ID，在unapp项目的App原生插件的云插件里选择本插件
7. 升级app版本号(避免自定义基座后运行时没有更新到基座)
8. 删除本地基座，重新自定义基座
9. 删除手机app，试用自定义基座运行

插件声明

var firebaseAnalytics = uni.requireNativePlugin("wrs-firebaseAnalytics");

• 记录事件 详细业务参考官网https://firebase.google.com/docs/analytics/events?hl=zh-cn&platform=android

                var options = {};
                // 事件名称
                options.name = "select_content";
                // 事件参数
                options.params = {
                    "item_id": "123456_uniapp",
                    "item_name": "张三-uniapp",
                    "content_type": 1
                };
                firebaseAnalytics.logEvent(options);

• 已有的options.name推荐事件事件常量有https://firebase.google.com/docs/reference/android/com/google/firebase/analytics/FirebaseAnalytics.Event?hl=zh-cn：

ad_impression、add_payment_info、add_to_cart、add_to_wishlist、app_open、begin_checkout
、campaign_details、generate_lead、join_group、level_end、level_start、level_up、login、
post_score、search、select_content、share、sign_up、spend_virtual_currency、tutorial_begin
、tutorial_complete、unlock_achievement、view_item、view_item_list、view_search_results、earn_virtual_currency
screen_view、remove_from_cart、add_shipping_info、purchase、refund、select_item、select_promotion
、view_cart、view_promotion

• 已有的options.params的key预设参数常量有https://firebase.google.com/docs/reference/android/com/google/firebase/analytics/FirebaseAnalytics.Param?hl=zh-cn：

achievement_id、ad_format、ad_platform、ad_source、ad_unit_name、character、travel_class、
、content_type、currency、coupon、start_date、end_date、extend_session、flight_number、group_id
、item_category、item_id、item_name、location、level、level_name、method、number_of_nights、number_of_passengers
、number_of_rooms、destination、origin、price、quantity、score、shipping
、transaction_id、search_term、success、tax、value、virtual_currency_name、campaign
、source、medium、term、content、aclid、cp1、item_brand、item_variant、creative_name
、creative_slot、affiliation、index、discount、item_category2、item_category3、item_category4
、item_category5、item_list_id、item_list_name、items、location_id、payment_type
、promotion_id、promotion_name、screen_class、screen_name、shipping_tier

除了预设参数外，您还可以将以下参数添加到事件中：

1. 自定义参数：可使用自定义参数作为 Analytics 报告中的维度或指标。 您可以对非数值事件参数数据使用自定义维度，而对更适合以数值形式表示的参数数据使用自定义指标。使用 SDK 记录自定义参数后，请注册维度或指标，以确保这些自定义参数能够出现在 Analytics 报告中。可依次点击以下各项完成此操作：“分析”>“事件”>“管理自定义设置”>“创建自定义维度”。 自定义参数可用于每份报告都可能使用的受众群体定义中。如果您的应用已关联到 BigQuery 项目，自定义参数也将包含在导出至 BigQuery 的数据中。如需查看示例查询及更多内容，请访问 Google Analytics（分析）4 BigQuery Export。

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

• 设置默认事件参数

                // defaultParams参数可以任意增加key/value属性值，建议不要有多级节点
                var defaultParams = {};
                defaultParams.system = "ios";
                defaultParams.version = "1.0.1"
                firebaseAnalytics.setDefaultEventParameters(defaultParams);

• 设置用户属性

https://firebase.google.cn/docs/analytics/user-properties?hl=zh-cn&platform=ios 要设置用户属性，请执行以下步骤：

在 Firebase 控制台的Analytics自定义定义页面中为用户属性创建自定义定义。有关详细信息，请参阅自定义维度和指标。 使用setUserProperty()方法在您的应用程序中设置用户属性。

                // 按照name、value形式对应属性值
                var userProperty = {};
                userProperty.name = "userName";
                userProperty.value = "张三";
                firebaseAnalytics.setUserProperty(userProperty);

• 设置用户ID

            firebaseAnalytics.setUserId({
                    userId: "12121351"
                });

• 禁用/开启Analytics 数据收集

firebaseAnalytics.setAnalyticsCollectionEnabled({
                    enable: true
                });

支持定制，联系方式 QQ:252797991

如果觉得可以就点个👍吧，欢迎粉丝收藏，土豪打赏，您的关注就是我们创作的动力！