跳转到主要内容
PRODUCT DOCUMENTS

快速找到所需文档,高效完成接入与排障

浏览产品文档与友盟 Skill,展开目录并阅读正文。

接入指南

接入友盟+SDK流程概述

20210812120137

引入&配置SDK

1、友盟+SDK为开发者提供了两种引入SDK方式:自动集成和手动集成。自动集成是指Android的maven依赖和iOS的cocospod配置,手动集成是指在下载页下载SDK后导入App工程。

2、iOS SDK的配置为埋点验证配置。

  • 埋点验证配置是指,友盟+为开发者提供了集成后验证是否集成成功的功能,该功能需要进行初期的配置。

初始化SDK

初始化友盟+SDK后,App的基础数据就会上报,包括App的启动次数、渠道、版本和使用时长等。具体体现为产品中的“实时”和“统计”除“功能使用”外都会有数据。

63A7080D-3F24-4A33-880C-3C64C147D5BE

高级功能

高级功能包括账号统计、自定义事件埋点和页面采集。

  • 账号统计是指您可以将您用户的账号通过API上传至友盟+服务端,友盟+经过计算后将统计数据展示在U-App后台。注意该功能需要在“设置”中打开账号统计。

  • 自定义事件是指您可以通过API监听App用户的行为事件,例如触发“购买”的次数、人数、商品名称、商品价格等。

  • 页面采集是指您可以通过API监听App用户的页面访问行为,友盟+也会主动记录页面访问的顺序并提供数据分析结果。

集成测试

集成测试是友盟+为开发者提供的集成友盟+SDK是否成功的数据校验工具。通过集成测试您可以看到打开App后,上传至友盟+服务端的所有用户行为日志,通过这些日志可以确认集成、自定义事件埋点和页面采集是否符合您的预期。该功能依赖于埋点验证配置,和Android9.4.0和iOS7.3.0及以上版本的SDK。

相关知识

创建应用,获取Appkey

Appkey是友盟+为每一个应用生成的唯一标识码,用来在数据计算时,区分数据是哪个应用的,非常重要!请勿填写出错!

集成【友盟+】SDK之前,您首先需要到应用列表注册并且添加新应用,获得AppKey。

说明

特别提醒: 我们建议开发者在注册账号时使用企业邮箱,避免使用个人邮箱注册,防止由于个人离职带来的问题,建议使用的账号形式:umeng@企业域名、apps@企业域名、dev@企业域名。

1

说明

注意: 应用的安卓版和iOS版不能使用相同的AppKey,需要分开注册。 【友盟+】的应用名与实际应用名和包名无关,若注册应用时,提示应用名称已存在,建议命名为应用名+平台(iOS/Android)。

创建应用,获取Appkey

集成SDK

流程示意图

1

使用SDK功能

1

完成SDK集成后即可在U-App产品后台中查看相关数据。

进行集成测试

具体操作可点击点击查看。

相关知识

发送策略

设置发送策略说明

发送策略设定了用户产生的数据发送回友盟+服务器的频率,此发送策略的数据都是离线计算。iOS平台数据发送策略包括BATCH(启动时发送)和SEND_INTERVAL(按间隔发送)两种,友盟+默认使用退出时发送(更省流量)组件化SDK不同以以前非组件化的SDK,用户现在不需要在SDK端显式的设置发送策略。 组件化SDK默认使用BATCH(启动时发送),减少用户的网络发送请求。 同时在用户做前后台切换的时候,组件化SDK也会触发网络请求,批量的把数据发送出去,以节约网络请求的流量。

  • 启动时发送:新增、活跃、启动次数、使用时长、自定义事件等数据在APP本次启动或退出时即刻发送,错误统计产生的消息数据会在下次启动应用时发送。如果应用程序启动时处在不联网状态,那么消息将会缓存在本地,下次再尝试发送。

  • 按间隔发送:按特定间隔发送数据,间隔时长介于90秒与1天之间。新增、活跃、启动次数等数据在APP本次打开时即刻发送,使用时长、自定义事件、错误统计等在使用过程中产生的所有数据都按间隔发送,如果应用程序启动时处在不联网状态,那么消息将会缓存在本地,下次再尝试发送。

发送策略设置方法

进入后台选择“应用”->设置->发送策略 页面自定义发送间隔。具体如下图:

analytics1

说明

注意: 在没有获取到在线配置时,默认使用启动时发送的策略; 在打开debug调试模式或者使用集成测试时,不受发送策略控制。

IDFA说明

从组件化产品开始,【友盟+】SDK默认采集idfa标识,用来更准确的分析核对数据。对于应用本身没有获取idfa的情况,建议将应用提交至AppStore时按如下方式配置:(以避免被苹果以“应用不含广告功能,但获取了广告标示符IDFA”的而拒绝其上架。)

常见问题

问题1 :应用的安卓版和iOS版能否共用一个AppKey。

答案:不同平台的应用禁止使用相同的AppKey,需要分开注册。

问题2 :注册应用时,提示应用名称已存在。

答案 :【友盟+】后台的应用名与实际应用名和包名无关,建议命名为应用名+平台(iOS/Android)。

更多集成问题可点我进入常见问题