目录

Analytics Kit集成指导

分析服务(Analytics Kit)预置大量分析模型,可帮助您清晰地了解用户的行为方式,从而实现用户、产品、内容的深度洞察,让您实现基于数据驱动的运营。关于Analytics Kit详细的介绍和使用限制请参见分析服务业务介绍。

Coding Assistant可以帮助您更高效的完成Analytics Kit的集成开发和调试。

Analytics Kit集成开发

请根据Configuration Wizard完成Analytics Kit的集成环境配置。

[h2]Analytics服务初始化

  1. 选择“Coding Assistant > App Services > Analytics Kit”,点击“Add Analytics to your app”卡片,进入Initialization详情页,选择拖拽或者拷贝的方式将接口对应的代码样例片段拖到代码中,这种方式需要您清楚需要拖拽代码的位置,即可完成Analytics的初始化。

  2. 在(Optional) Set event reporting policies中,可以选择上报策略,通过拖拽或者拷贝的方式添加上报策略的配置参数。

[h2]预置事件和自定义事件

选择“Coding Assistant > App Services > Analytics Kit”,点击“Log on Analytics event”卡片。在Log Events中,点击“New Event”添加事件。

添加预置事件

  1. 在“Predefined Events”中放置了Analytics SDK根据常用的使用场景而预先定义的预置事件。Analytics SDK推荐优先使用预置事件进行埋点和分析。在“Event ID”中放置了所有预置事件的事件ID,您可通过下拉选择需要的预置事件,查看事件参数及对应的埋点代码样例。此外,您可以点击“OK”并填写“Event Name”将该事件保存到Log Events下的“Predefined Events and Custom Events”中。

  2. 您可以通过拖拽或者拷贝的方式将需要埋点的事件的代码样例集成到工程中。您只需要在工程中根据实际情况补齐代码样例的参数值,即可完成该事件的埋点。

添加自定义事件

  1. 在“Custom Events”中,您可以自定义事件ID和事件参数,以满足您的个性化分析需求。完成事件定义后,您可以点击“OK”并填写“Event Name”保存该事件到Log Events下的“Predefined Events and Custom Events”中,方便后续进行事件埋点。下面以一次考试的简要信息为例。

  2. 您可以通过拖拽或者拷贝的方式将需要埋点的事件的代码样例集成到工程中。您只需要在工程中根据实际情况补齐代码样例的参数值,即可完成该事件的埋点。

  3. 埋点后,您需要到分析服务控制台去注册自定义事件及相关参数。您可以通过点击“Custom Events”界面底部的Login - My project - Huawei Analytics - Management - Event management快捷跳转到分析服务控制台,注册方法请参见事件管理。

[h2]模板事件

Analytics Kit为您提供了TOP2热点行业(游戏、教育)的埋点方案模板及代码样例,并提供了复制代码埋点的埋点方式。Coding Assistant可辅助提高复制代码埋点方式的效率,使您在IDE内即可便捷获取到您应用的埋点方案模板事件的代码样例,并可使用拖拽或者拷贝的方式,将所需代码样例快速集成到工程中。导入模板事件的具体步骤如下:

  1. 选择“Coding Assistant > App Services > Analytics Kit”,点击“Log on Analytics event”卡片。在Log Events中,点击“Import Event”导入模板事件。

  2. 选择“Team”和“Module”,确定您正在开发的应用。然后点击“Get App ID and App Secret”获取“App ID”和“App Secret”。最后点击“Next”获取应用的埋点方案模板。

    • 若您的界面显示错误信息“The AccessToken obtaining failed please check out”,说明您未提前配置应用的埋点方案模板,请根据界面提示点击“AppGallery Connect” , 在“智能数据接入 > 埋点开发”中配置模板,详情请参见埋点开发。

    • 若您的界面显示错误信息“The region service is not enabled for the project”,说明您未提前开启区域服务,请根据界面提示点击“AppGallery Connect” ,在“我的项目”中找到需要开通分析服务的应用, 点击“华为分析”下的任意菜单,并点击“启动分析服务”即可开通分析服务。最后在“项目接入设置”页面设置数据处理位置。详情请参见开通服务。

  3. 在“Import Event”界面中,左侧为模板列表,点击需要导入的模板,在“Event ID”下可查看该模板下的所有模板事件。点击“Batch Import”,即可导入该模板下的所有模板事件。模板事件被保存在“Template Events”中。

  4. 您可以通过拖拽或者拷贝的方式将需要埋点的事件的代码样例集成到工程中。您只需要在工程中根据实际情况补齐代码样例的参数值,即可完成该事件的埋点。
    • 如果您想要生成某个埋点方案模板的分析报告,您需要完成该模板下所有模板事件的埋点。
    • 当完成埋点开发后,通过埋点验证模块可以帮助您快速验证已埋点事件是否埋点正确,详情请参见埋点验证。
    • 若您已经将某个埋点方案模板导入到“Template Events”中,并在分析服务控制台中更新了该模板的事件数据,您可以再次点击“Import Event”打开导入模板事件的面板,Coding Assistant会自动识别模板事件的变动信息,并提醒您更新。

[h2]设置用户属性

  1. 选择“Coding Assistant > App Services > Analytics Kit”界面,点击“Log on Analytics event”卡片。在“Set UserProfile”中,点击“Set UserProfile”,在弹出的“New UserAttributes”页面内编辑用户属性。一次最多可以设置25个用户属性。用户属性值需要您根据实际需求自己填写,填写完成点击“OK”保存该用户属性。

  2. 将该用户属性对应的逻辑代码拖拽或者拷贝到您指定的应用程序中,其中包含的参数值需要您根据实际需要自己填写,即可完成该用户属性的记录。

    完成了事件和用户属性的记录的代码逻辑如下。

  3. 如果您想要删除用户属性,在“Delete UserProfile”中,将对应的逻辑代码拖拽或者拷贝到您指定的应用程序中,即可删除用户属性信息。

Analytics接入调试

在开发过程中可以启用调试模式,所有事件将实时上报,您可在“华为分析 > 应用调试”页面实时查看上报的数据,观察具体结果并根据需要进行调整。

  1. 在Analytics Kit卡片中,点击工具栏中的“Analytics Model”,可以启动或关闭调试模式。
    • “Analytics Model”显示绿色圆点表示启动调试模式,所有事件将实时上报。
    • “Analytics Model”显示灰色圆点表示关闭调试模式,暂停事件上报。

  2. 调试模式启动后,所有事件将实时上报至AppGallery Connect网站。点击工具栏中的“App Debugging”,登录AppGallery Connect网站。点击“我的项目”图标,选择需要查看分析数据的应用,选择“华为分析 > 应用调试”页面,实时查看应用上报的数据。详情请参见应用调试。