目录

华为分析是基于事件分析数据模型。

分析数据模型采用了 Event-Param-User 模型来记录数据，通过不同的参数对事件进行描述，同时对用户的特征也进行了描述。

术语名称说明

Event

事件

描述一个用户在某个时间点、某个地方、以某种方式完成了某个具体的事情。包含who、when、where、how、what等关键要素。

Param

参数

事件上报的关联参数。如加入购物车事件中的 商品名称参数，商品价格参数，支持后续的深入分析。

UserProfiles

用户属性

用户的属性表，常见的用户属性有 ODID、设备型号、应用版本、自定义的用户属性（如食品偏好）等。

Analytics Kit 会收集AAID。AAID由HMS Instance Id为每个安装在设备上的应用实例分配。AAID用于连通华为提供的各项服务，例如Push、华为分析、远程配置等。

AAID会在如下场景重置：

接入步骤

1.初始化Analytics SDK

agconnect-services.plist文件导入成功后，在AppDelegate中通过config接口完成初始化。

Objective C代码：在AppDelegate.m中进行初始化

  1. #import "AppDelegate.h"
  2. #import <HiAnalytics/HiAnalytics.h>
  3. @interface AppDelegate ()
  4. @end
  5. @implementation AppDelegate
  6. ...
  7. - (BOOL)Application:(UIApplication *)Application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  8.     // Override point for customization after Application launch.
  9.     [HiAnalytics config];//初始化
  10.     return YES;
  11. }
  12. ...
  13. @end

Swift代码示例：在AppDelegate.swift中进行初始化。

  1. import UIKit
  2. import HiAnalytics
  3. @UIApplicationMain
  4. class AppDelegate: UIResponder, UIApplicationDelegate {
  5. ...
  6.  func Application(_ Application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool  {
  7.         // Override point for customization after Application launch.
  8.         HiAnalytics.config();//初始化
  9.         return true
  10.  }
  11. ...
  12. }

2.通过 onEvent 接口记录定义事件。各类事件的定义请参见“事件说明”。

3.参考“API说明”，调用接口实现各类功能。例如：设置用户属性（setUserProfile）。

示例代码

在代码合适位置插入埋点代码：

  1. //设置用户属性
  2. [HiAnalytics setUserProfile:@"userProfile1" setValue:@"userProfileValue1"];
  3. [HiAnalytics setUserProfile:@"userProfile2" setValue:@"userProfileValue2"];
  4. //自定义打点，在工程合适位置插入打点代码
  5. [HiAnalytics onEvent:@"customEventName" setParams:@{@"key1":@"value1",@"key2":@"value2"}];

接入调试

在开发过程中可以启用调试模式，借助DebugView实时查看事件的记录情况，观察具体结果并根据需要进行调整。

开启/停用调试模式

1.开启调试模式：

Xcode菜单选择“Product > Scheme > Edit Scheme”,然后选择第二个页签“Arguments”，单击“+”号增加一个参数“-HADebugEnabled”,添加完成后单击右下角的“Close”按钮进行保存。

  1. -HADebugEnabled

说明：
“调试”模式将保持启用状态，直至您通过设置“-HADebugDisabled”参数明确停用“调试”模式

2.停用调试模式：

  1. -HADebugDisabled

数据成功上报后，开发者联盟上会展示出数据，如下图：

在开发者联盟系统上查看数据，请参考操作指南-应用调试。

通过增加运行参数来调整日志级别

通过增加运行参数来调整日志级别：

有如下四个级别的可选项：-HALogLevelDebug、-HALogLevelInfo、-HALogLevelWarn、-HALogLevelError，以-HALogLevelDebug为例；

Xcode菜单选择“Product > Scheme > Edit Scheme”,然后选择第二个页签“Arguments”，点击“+”号增加一个参数“-HALogLevelDebug”,添加完成后点击右下角的“Close”按钮进行保存。

  1. -HALogLevelDebug