信息流配置

优质
小牛编辑
160浏览
2023-12-01

概述

信息流分析功能,是百度移动统计新推出的统计功能,是针对用户在App中“信息列表”模块的行为分析。

MTJ会帮助应用统计所有的“列表控件”及其“信息元素”的展现、浏览、点击等行为。

使用该功能需要集成最新版(V4.8.0以上)的“应用分析(无埋点)”类型的SDK。

概念解释图:

控件举例

如上图的app结构中,MTJ会获取“列表”的展现次数、“每一条新闻”的展现次数、展现时长、点击次数等信息,通过信息流分析报表给您展现统计结果。

适用场景

  1. iOS中,信息流分析功能针对的“列表控件”指UITableView控件,“信息元素”指UITableViewCell控件。
  2. 如果您的app中有列表控件,无论是“新闻列表”、“商品列表”、“联系人列表”,只要是UITableView的控件类型,均可以被获取到。

集成步骤

  1. 下载并集成MTJ最新版的“应用分析(无埋点)”类型的SDK 您可以前往SDK中心下载对应的版本、并按照本文档的集成步骤进行集成。

    SDK中心

  2. 当您完成上述的“集成步骤”之后,SDK会自动开启信息流分析功能,整个集成只需要一行初始化代码。

测试步骤

  1. 当您完成了集成操作,启动app,正常浏览应用中的“列表”,浏览完成后退出app。

    • 如果您在初始化代码[[BaiduMobStat defaultStat] startWithAppId:@"APP KEY"];前调用接口打开了SDK调试开关:[[BaiduMobStat defaultStat] setEnableDebugOn:NO];,那么在每次列表浏览结束时,会有调试Log在Xcode窗口中: [BaiduMobStat]:Put list,证明统计功能正常。
  2. 再次启动app(kill之后重新打开、或放置后台30s之后重新打开),sdk将会把之前的信息流数据日志发送回MTJ服务器。

    • 同第一步所述,如果打开了SDK调试开关,在app启动时,会在Xcode调试窗口中看到如下Log,说明发送成功: [BaiduMobStat]:Send log success
  3. 登录MTJ官网,查看信息流分析报表的数据。由于MTJ服务器是以小时级处理报告,所以可能有一定时间的延迟,请耐心等待。

报表查看

  1. 登录MTJ网站,并选择您的应用查看报告。
  2. 选择页面顶部的“探索”tab。
  3. 报表中相关指标解释可以在web中查看。

    报表效果

    MTJ将每一个列表定义为一个栏目,通过报表可以看到栏目的使用情况,以及栏目下每个信息元素的展现、使用情况。

(可选)其他个性化参数设置

  1. 监控模式设置

    A) 接口声明:

     /**
      设置TableView监控策略
      默认为BaiduMobStatFeedTrackStrategyAll,全部监控
      设置为BaiduMobStatFeedTrackStrategySingle单个监控,则要监控的tableview需要设置enableListTrack属性为YES
      设置为BaiduMobStatFeedTrackStrategyNone,则不监控任何列表
      */
     @property (nonatomic, assign) BaiduMobStatFeedTrackStrategy feedTrackStrategy;
    

    B)接口调用举例:

     [BaiduMobStat defaultStat].feedTrackStrategy = BaiduMobStatFeedTrackStrategyAll;
    

    C) 调用位置:

    集成步骤的第6步介绍SDK的初始化代码[[BaiduMobStat defaultStat] startWithAppId:@"APP KEY"];前调用feedTrackStrategy设置接口。即:

     [BaiduMobStat defaultStat].feedTrackStrategy = BaiduMobStatFeedTrackStrategyAll;
     [[BaiduMobStat defaultStat] startWithAppId:@"APP KEY"];
    

    D) 调用场景:

    • 默认情况下,SDK采用第一种BaiduMobStatFeedTrackStrategyAll策略,会监控所有的列表浏览信息。

    • 如果您只想要监控个别列表信息,可以将策略设置为BaiduMobStatFeedTrackStrategySingle,此时SDK只会监控您代码中指定开启的列表。指定列表的接口,是UITableView的enableListTrack属性,下面会详细介绍。

    • 如果您不想监控任何列表信息,即不使用信息流监控功能,则可以将策略设置为BaiduMobStatFeedTrackStrategyNone。

  2. 指定开启单个列表监控

    A) 接口声明:

     /**
      * 设置单个TableView是否需要被监控
      * 默认情况下,sdk监控全局TableView,不需要设置该接口
      * 当设置了全局关闭之后,可以设置单个tableview打开指定的TableView监控
      */
     @property (nonatomic, assign) BOOL enableListTrack;
    

    B) 接口调用举例:

     //UITableView对象
     UITableView *myTableView = [[UITableView alloc] initWithFrame:CGRectMake(0, 0, 100, 100) style:UITableViewStylePlain];
     //调用category属性,设置开启
     myTableView.enableListTrack = YES;
     [self.view addSubview:myTableView];
    

    C) 调用位置:

    在对应的UITableView控件加载展现之前(建议是UITableView init初始化完成就设置),调用enableListTrack接口,将列表设置为需要监控对象。

    D) 调用场景:

    • 在BaiduMobStatFeedTrackStrategySingle模式下,只有enableListTrack被设置为YES的列表,会被监控。

    • 在其他两种模式下,enableListTrack属性无效。

    • 因为MTJ SDK对UITableView进行了Category扩展,所以直接调用UITableView对象的enableListTrack赋值,即可完成开启设置。

  3. 列表名称设置

    A) 接口声明:

     /**
      * 设置TableView的栏目名称,为MTJ分析信息流报表中的”栏目名称“,长度限制256字节,超出截断
      * 如果不设置,则默认采用tableview所在的Controller title作为“栏目名称”
      * 建议在TableView加载前设置。
      */
     @property (nonatomic, copy) NSString *listName;
    

    B) 接口调用举例:

     //UITableView对象
     UITableView *myTableView = [[UITableView alloc] initWithFrame:CGRectMake(0, 0, 100, 100) style:UITableViewStylePlain];
     //调用category属性,设置开启
     myTableView.listName = @"首页新闻";
    

    C) 调用位置: 在对应的UITableView控件加载展现之前(建议是UITableView init初始化完成就设置),调用listName接口,设置列表的名称。

    D) 调用场景:

    • 设置的列表名称后,该列表将会以这个listName作为识别名称,在MTJ报表中展现。

    • 默认情况下,MTJ会自动识别列表名称,大部分情况下是列表所在页面的title。如果您觉得名称不准确、或者要设置自己的识别名称,可以通过UITableView的Category属性listName进行手动设置。

    • 注意:如果您多个列表设置为相同的名称,则MTJ将识别为同一个列表,进行统计。

    • 举例说明,如果您的app中,在不同页面下都有“商品列表”控件要区分统计,则可以通过设置listName分别为“商品列表_1”、“商品列表_2”等格式进行区分。

  4. 内容元素Title设置

    A) 接口声明:

     /**
      * 设置Cell的信息Title,为MTJ分析信息流报表中的”信息标题“,长度限制256字节,超出截断
      * 如果不设置,则SDK会自动识别一个Title
      * 建议在cell加载前设置。
      */
     @property (nonatomic, copy) NSString *contentTitle;
    

    B) 接口调用举例:

     - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
     NSString *cellIdentifier = @"cellIdentifier";
    
     UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:cellIdentifier];
     if (!cell) {
         cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:cellIdentifier];
         [cell setAccessoryType:UITableViewCellAccessoryDisclosureIndicator];
     }
     if (indexPath.row == 2) { // 找到目标cell,设置对应名称
         cell.contentTitle = @"新闻标题一";
     } else {    // 由于Cell是重用的,不是目标cell,需要清除contentTitle设置
         cell.contentTitle = nil;
     }
     return cell;
     }
    

    C) 调用位置:

    这里如上方调用举例,建议在UITableView的delegate函数tableView:cellForRowAtIndexPath:中,进行contentTitle 设置。注意Cell的重用机制,需要在不是目标cell时,进行清除contentTitle设置。

    D) 调用场景

    • 设置的Title后,该Cell元素将会以这个Title作为识别名称,在MTJ的报表中展现。

    • 默认情况下,SDK会自动识别cell中的文字Title,即以Cell元素中字体最大的控件文字为标题。

    • 当您觉得识别不准确、或者不想用该title进行统计时,可以在UITableViewCell展现之前,调用Category属性contentTitle,设置自定义的Title。

  5. 内容元素contentId设置(目前不在报表中展现)

    A) 接口声明:

     /**
      * 设置Cell的信息ID,是用户自身系统中的内容id,长度限制256字节,超出截断
      * 如果不设置,则id为空
      * 建议在cell加载前设置。
      */
     @property (nonatomic, copy) NSString *contentId;
    

    B) 接口调用举例:

     - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
     NSString *cellIdentifier = @"cellIdentifier";
    
     UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:cellIdentifier];
     if (!cell) {
         cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:cellIdentifier];
         [cell setAccessoryType:UITableViewCellAccessoryDisclosureIndicator];
     }
     if (indexPath.row == 2) { // 找到目标cell,设置对应名称
         cell.contentId = @"1";
         cell.contentTitle = @"新闻标题一";
     } else {    // 由于Cell是重用的,不是目标cell,需要清除contentID设置
         cell.contentId = nil;
         cell.contentTitle = nil;
     }
     return cell;
     }
    

    C) 调用位置:

    这里如上方调用举例,建议在UITableView的delegate函数tableView:cellForRowAtIndexPath:中,进行contentId 设置。注意Cell的重用机制,需要在不是目标cell时,进行清除contentId设置。

    D) 调用场景:

    • 默认情况下,每一个元素UITableViewCell的contentId信息是空的。

    • 如果您希望统计自己业务系统中,这条信息的id,可以通过UITableViewCell的Category属性contentId进行设置。

    • 这里如上方调用举例,建议在UITableView的delegate函数中,进行设置。注意Cell的重用机制,需要在不是目标cell时,进行清除contentTitle设置。