扫一扫,手机查看更快捷

LOTUSEED帮助文档

Android & iOS & WinPhone & Html5 SDK集成指南

Android iOS
  • WinPhone
  • Html5

    Lotuseed WinPhone SDK 集成指南

    一、产品介绍

    Lotuseed统计提供,实时、稳定的移动应用统计分析服务,启动次数、活跃用户、用户黏性、渠道效果等情况一目了然。
    WindowsPhone 统计SDK支持 WindowsPhone 7.5(mongo)版本以上(包括7.5版本)
    您下载的SDK安装包中包含以下内容:
    LotuseedWPSDKDemo : Lotuseed统计分析DEMO
    Lotuseed.dll : 统计分析sdk包
    LotuseedWPSDKGuide.html : 集成文档

    二、获取Lotuseed WinPhone SDK & AppKey

    注册用户并登录www.lotuseed.com,即可找到链接下载SDK;新建App后可获取应用编号AppKey。

    三、 集成Lotuseed WinPhone SDK

    添加基本功能

    导入SDK压缩包内的文件到Visual Studiio工程:
    1.解压SDK,并将其中的Lotuseed.dll复制到WP工程目录下:
    请在你的工程目录结构中,右键选择References-->Add References...,选择Lotuseed.dll这个文件将其加入工程引用目录。
    2.配置 WMAppManifest.xml:

    <Capabilities>
    <Capability Name="ID_CAP_IDENTITY_DEVICE"/>;
    <Capability Name="ID_CAP_NETWORKING"/>;
    </Capabilities>

    说明
    ID_CAP_NETWORKING:建立网络连接,发送数据到Lotuseed服务器
    ID_CAP_IDENTITY_DEVICE:用来读取ANID标示唯一的设备
    添加基本统计代码 :
    在您的Application_Launching和private void Application_Activated事件中绑定LotuseedSDK启动监听方法: Lotuseed.Analytics.startWithAppKey(appkey) ;和Lotuseed.Analytics.onResume();

    private void Application_Launching(object sender, LaunchingEventArgs e)
    {
    //Lotuseed.Analytics.setDebugMode(true); //是否开启调试模式
    Lotuseed.Analytics.setCrashReportEnabled(true); //错误日志
    Lotuseed.Analytics.startWithAppKey(appkey); //必须添加的接口调用
    //其他Lotuseed API调用请放在startWithAppKey()后!!!
    }
    private void Application_Activated(object sender, ActivatedEventArgs e)
    {
    Lotuseed.Analytics.onResume(); //必须添加的接口调用 }

    API说明:

    public void setDebugMode(bool isDebug)
    sDebug 是否输出debug信息(默认不输出,请在发布之前关闭debug输出)
    public void setCrashReportEnabled(bool isReport)
    isReport是否收集异常错误信息(默认不收集)
    public void startWithAppKey(string appkey)
    public void startWithAppKey(string appkey, int channel)
    appkey appkey用来定位该应用程序的唯一性
    channel(可选) 渠道号,用来标注应用推广渠道,区分新用户的来源来查看统计
    public void onResume()
    从休眠或墓碑中恢复时激活sdk

    跟踪记录PageView访问时长

    在需要统计的页面对应的OnNavigatedFrom 和 OnNavigatedTo 方法中调用onPageViewEnd和onPageViewBegin方法:

    protected override void OnNavigatedFrom(System.Windows.Navigation.NavigationEventArgs e)
    {
    base.OnNavigatedFrom(e);
    Lotuseed.Analytics.onPageViewEnd("PAGE NAME");
    }
    protected override void OnNavigatedTo(System.Windows.Navigation.NavigationEventArgs e)
    {
    base.OnNavigatedTo(e);
    Lotuseed.Analytics.onPageViewBegin("PAGE NAME");
    }

    API说明:
    public void onPageViewBegin(string pageName)
    public void onPageViewEnd(string pageName)
    pageName pageName为页面名称,注意同一个页面的Begin和End方法中要传入相同的pageName,且需配对使用。

    使用错误报告

    Lotuseed SDK提供两种提交错误报告的方法:
    1. 自动提交Crash Log :
    Lotuseed.Analytics.setCrashReportEnabled(true);
    2. 手动提交Custom Log:
    代码中调用 Lotuseed.Analytics.onCustomLog("XXXX");
    参数为开发者提交的调试日志信息;

    使用自定义事件

    除了基本统计分析功能外,我们还支持您自定义的事件分析,例如您可以统计游戏中通过不同关卡的人数,广告的点击次数或者视频被播放的次数等等。

    事件数量统计

    Lotuseed.Analytics.onEvent(string event_id);
    Lotuseed.Analytics.onEvent(string event_id, long count);
    Lotuseed.Analytics.onEvent(string event_id, string label);
    Lotuseed.Analytics.onEvent(string event_id, string label, long count);
    Lotuseed.Analytics.onEvent(string event_id, Dictionary dic);
    Lotuseed.Analytics.onEvent(string event_id, Dictionary dic, long count);

    参数说明:
    event_id 为当前统计的事件ID;
    count 当大量重复事件发生时,为减少网络流量,建议程序中先本地计算累计数count值;
    label 事件的一个属性描述;
    dic 为当前事件的属性和取值集合(key-value);

    事件时长统计

    Lotuseed.Analytics.onEventDuration(string event_id, long duration);
    Lotuseed.Analytics.onEventDuration(string event_id, string label, long duration);
    Lotuseed.Analytics.onEventDuration(string event_id, Dictionarydic, long duration);

    参数说明:
    event_id 为当前统计的事件ID;:
    duration 时长,单位:毫秒;:
    label 事件的一个属性描述;:
    dic 为当前事件的属性和取值集合(key-value);

    添加辅助功能:

    添加app更新提醒功能:
    这个功能将帮助您把应用程序更新消息推送给用户。
    在Application_Launching方法中Lotuseed.Analytics.startWithAppKey(appkey);后调用Lotuseed.Analytics.checkUpdate(); 该方法会请求服务器检查最新版本。
    使用默认更新方式:

    private void Application_Launching(object sender, LaunchingEventArgs e)
    {
    Lotuseed.Analytics.startWithAppKey(appkey); //必须添加的接口调用
    Lotuseed.Analytics.checkUpdate(); //须放置在startWithAppKey后
    }

    API说明:
    public void checkUpdate()
    使用自定义更新回调:
    如果程序想自己处理更新可以按如下步骤处理更新事件:

    Lotuseed.Analytics.checkUpdateWithDelegate
    (new Lotuseed.Analytics.UpdateAppEventHandler((bool done, Dictionarydic) =>
    {
    if (done)
    {
    if (dic != null)
    {
    //TODO...
    }
    }
    }));

    API说明:
    public delegate void UpdateAppEventHandler(bool done, Dictionarydic);
    public void checkUpdateWithDelegate(UpdateAppEventHandler handler)
    在线参数配置功能:
    通过www.lotuseed.com网站云端配置key-value键值对。
    value可以是一个字符串,也可以是一个文件下载URL;
    key,value支持中文字符编码;
    1.如何更新在线参数配置:
    使用默认更新方式:
    在Application_Launching方法中Lotuseed.Analytics.startWithAppKey(appkey);后调用Lotuseed.Analytics.updateOnlineConfig(); 该方法会请求服务器检查最新参数设置。

    private void Application_Launching(object sender, LaunchingEventArgs e)
    {
    Lotuseed.Analytics.startWithAppKey(appkey); //必须添加的接口调用
    Lotuseed.Analytics.updateOnlineConfig(); //须放置在startWithAppKey后
    }

    API说明:
    public delegate void UpdateConfigEventHandler(bool done, Dictionary dic);
    public void checkOnlineConfigWithDelegate(UpdateConfigEventHandler handler)
    done 表示是否成功响应;
    dic 参数K-V串;

    2. 程序内获取参数方法如下:
    string value = Lotuseed.Analytics.getConfigParams("key", "default value");
    public void updateOnlineConfig();
    使用自定义更新回调:如果程序想自己处理更新可以按如下步骤处理更新事件:

    特别说明:

    1.Lotuseed SDK默认为RELEASE模式;
    2.SDK默认统计数据发送策略:
      a)debug模式时实时发送数据;
      b)realease模式时session启动事件数据实时发送(包括历史session所有缓存数据);
      c)缓存数据量达上限时会触发发送统计数据;

    四、集成SDK后测试

    1.确认startWithAppKey使用了正确的AppKey和ChannelID;
    2.确认所有的onPageViewBegin和onPageViewEnd方法成对出现;
    3.确认测试手机(或者模拟器)已成功连入网络;
    4.启动应用程序,几分钟之后您应该已经可以看到相应的报表;

    如果几分钟后报表中仍然没有收到数据,请与我们的技术支持联系:
    QQ:835371627
    email:support@lotuseed.com
    我们会尽快回复您的意见或建议。

    五、使用Lotuseed在线帮助

    Lotuseed主站链接:www.lotuseed.com
    Lotuseed在线文档:www.lotuseed.com/doc/index.html
    Lotuseed FAQ链接:www.lotuseed.com/faq/index.html

    六、【附】

    渠道编码表:

    渠道编号 渠道名称 备注
    android
    1 安智市场 http://www.anzhi.com/login.php
    2 安卓市场 http://apk.hiapk.com/
    3 应用汇商店 http://www.appchina.com/market/dev/index.action
    4 机锋市场 http://apk.gfan.com/
    5 EOE http://dev.eoemarket.com/
    6 N多网 http://www.nduoa.com/
    7 华为智慧云 http://developer.huaweidevice.com/
    8 爱米8 http://www.aimi8.com/
    9 腾讯 http://tap.3g.qq.com:8080/login.jsp
    10 3G门户 http://dev.3g.cn/
    11 安卓星空 http://www.starandroid.com/
    12 HTC商店 http://appstoreconnect.com/publish/
    13 木蚂蚁 http://dev.mumayi.com/developers/
    14 TOMPDA http://www.tompda.com/
    15 XDA http://www.xda.cn/
    16 搜狐下载频道 http://download.sohu.com/developer
    17 91手机商城 http://market.sj.91.com/
    18 魅族应用中心 http://developer.meizu.com/
    19 历趣市场 http://www.liqucn.com/
    20 泡椒网 http://anzhuo.paojiao.cn/
    21 网易应用 http://m.163.com/help/business.html
    22 360应用平台 http://open.app.360.cn/
    23 群挑网 http://www.quntiao.com
    iOS
    1001 91手机助手 http://market.sj.91.com/
    1002 同步推 http://app.tongbu.com/
    1003 iAPPS http://www.iapps.im/
    1004 威锋Cydia http://apt.weiphone.com/
    1005 PP助手 http://www.25pp.com/
    1006 快装商店 http://www.kuaiapp.cn/Home.aspx
    1007 I派党 http://www.ipadown.com/
    1008 YOUAPP http://www.youapp.cn/
    1009 51ipa.com http://www.51ipa.com/
    1010 麦芽地 http://www.maiyadi.com/
    1011 信有网 http://apps.xinyou.com/
    1012 7度苹果 http://www.7do.net/
    1013 佳软网 http://www.hiapp.org/
    1014 APP http://www.iapps.im/
    1015 掌心网 http://www.zhangxin.cc/
    1016 猫人吧 http://www.maoren8.com/
    1017 多玩游戏网 http://www.duowan.com/
    1018 宝软网 http://www.baoruan.com/
    1019 IPHONE中文网 http://iphone.tgbus.com/
    1020 PDA玩家网 http://www.playpda.com/
    1021 当乐网 http://ios.d.cn/
    1022 86wan苹果站 http://iphone.86wan.com/
    1023 APP游戏部落 http://www.appgz.com/
    1024 软饭下载 http://i.tgbus.com/
    WinPhone

    国外渠道(2001~4000)

    渠道编号 渠道名称 备注
    android
    2001 Android Market https://market.android.com/publish/Home
    2002 Amazon https://developer.amazon.com/home.html
    2003 Soc.io.Mall AndAppStore http://www.dev.soc.io/Login
    2004 SlideMe http://slideme.org/en
    2005 Opera http://publishers.mobilestore.opera.com/
    2006 MOBANGO http://www.mobango.com/
    2007 GETJAR http://developer.getjar.com/
    2008 SYNAPSY http://publisher.synapsy.net/join/
    iOS
    3001 AppStroe Apple官方应用商店
    WinPhone
    4001 微软应用商店 http://www.windowsphone.com/zh-cn/store

    未知渠道(10000~20000)

    • 帮助中心

      查阅文档、提交问题工单、搜索故障的解决方案,都可以前往帮助中心

      前往帮助中心 >
    • 销售咨询

      销售经理为您解答企业版 LOTUSEED 报价、部署实施方案的各种问题。

      support@lotuseed.com
    • 技术支持

      使用 LOTUSEED 时,遇到任何技术上的问题,都可以发送邮件给我们。

      support@lotuseed.com