无埋点 SDK集成
Last updated
Was this helpful?
Last updated
Was this helpful?
获取项目ID,请参考。
获取URL Scheme,在GrowingIO平台创建对应的应用时会生成URL Scheme。请参考。
集成环境:Xcode 9.0及以上;
App适配最低系统版本:iOS 8及以上
组件化SDK
GrowingIO iOS SDK 包含以下2个组件SDK:
• GrowingCoreKit (组件基础库,具备分析功能)
• GrowingAutoTrackKit (无埋点库)
请保证Growing、GrowingCoreKit、GrowingAutoTrackKit版本号一致。
在您的Podfile中添加pod 'GrowingAutoTrackKit'
。
执行或 pod update
更新pod依赖库。不要使用 --no-repo-update
选项。
(可选)GrowingIO推荐您添加 AdSupport.framework 依赖库,用于来源管理激活匹配,有利于您更好的分析数据 ,添加项目依赖库的位置在项目设置target -> 选项卡General -> Linked Frameworks and Libraries
在工程项目中添加以下库文件。
添加项目依赖库的位置在项目设置target -> 选项卡General -> Linked -> Linked Frameworks and Libraries
库名称
说明
Foundation.framework
基础依赖库
Security.framework
用户App连接圈选页面SSL连接
CoreTelephony.framework
用于读取运营商
SystemConfiguration.framework
用于判断网络状态
AdSupport.framework
用于来源管理激活匹配
libicucore.tbd
用户App连接圈选页面解析
libsqlite3.tbd
存储日志
CoreLocation.framework
用于读取地理位置信息(如果您的App有权限)
JavaScriptCore.framework
Web圈选App交互
WebKit.framework
Web圈选
添加编译参数,并注意大小写。
添加URL Scheme 到项目中,以便唤醒您的程序进行圈选。
在 AppDelegate 中引入
#import "Growing.h"
并添加初始化方法。
请确保将代码添加在上述位置,添加到其他方法或异步block中可能导致数据不准确。
在 AppDelegate 中添加激活圈选的代码
因为您代码的复杂程度以及iOS SDK的版本差异,有时候 [Growing handleUrl:url] 并没有被调用。请在各个平台上调试这段代码,确保当App被URL scheme唤醒之后,该函数能被调用到。
常用示例:
若您在 AppDelegate 中实现了以下一个或多个方法,请在已实现的函数中,调用[Growing handleUrl:]
若以上所有方法均未实现,请实现以下方法并调用[Growing handleUrl:]
有些时候,当您代码中的原有页面标题不足以支持业务人员对页面进行识别时,您可以使用此接口设置一个容易识别的页面名称来替换页面标题字段。
为处理这种场景,我们提供了取别名的方法,方法如下:
当您的应用界面改版时,可能会导致无法准确地统计已经圈选的元素。因此,对于应用中的主要流程涉及到的界面元素,建议您为它们设置固定的唯一ID,以保证数据的一致性。
若要为元素设置ID,请在viewWillAppear或者时机更早的方法里添加以下代码:
ID 只能设置为字母、数字和下划线的组合
对于已经集成过旧版SDK并圈选过的应用,对某个元素设置ID后再圈选它,指标数值会从零开始计算,类似初次集成SDK后发版的效果,但不影响之前圈选的其它指标数据。如果不希望出现这种情况,请不要使用这个方法。
当您想采集一些可能没有文字的控件(比如UIImageView,UIView)时,也可以给属性growingAttributesValue 赋值作为文字,用来在圈选的时候区分不同的内容。
如果您的 app 上方有横向滚动的 Banner 广告,若要收集 Banner 相关数据,请在响应点击的控件上添加如下代码:
其中 view 是您的广告元素,请确保两点:
对不同广告图,广告的唯一 ID 也不相同
响应点击的控件,与设置 ID 的控件是同一个
如果您需要采集应用内某个输入框内的文字(例如搜索框),请调用如下接口进行设置:
view代表要被采集的输入框。 当这个输入框失去焦点(包括应用退到后台),且输入框内容跟获取焦点前相比发生变化时,输入框内文字会被发送回GrowingIO。
如果您使用了 Facebook 广告 SDK,请务必在 main 函数第一行调用以下代码来避免冲突,否则可能造成无法创建项目或者统计准确性问题。注意:APP启动后,将不允许修改采集模式。
SDK会自动采集H5页面的数据,不需要特殊配置。
如果您的应用有相应的圈选,SDK将自动采集您的GPS数据。
您可以在项目中添加以下方法以启用Hashtag识别:
SDK 版本支持:2.3.2及以上。
GrowingIO SDK 针对欧盟区的一般数据保护法(GDPR)提供了以下的API共开发者调用。
DeepLink功能
SDK版本
基础DeepLink功能(Scheme打开App至首页)
>=2.3.0
直达落地页(Scheme打开至活动页)
>=2.3.2
Universal Link、应用宝微下载链接支持
>=2.4.1
确认URl Scheme添加正确。
添加自定义参数回调方法:
使用Universal Link唤醒App,步骤如下:
请在AppDelegate.m添加以下代码:
3. 添加Universal Link参数解析回调方法,此方法与DeepLink方法一致。
如果您添加了库AdSupport.framework,GrowingIO则会启用 IDFA,所以在向 App Store 提交应用时,需要:
对于问题 Does this app use the Advertising Identifier (IDFA),选择 YES。
对于选项Attribute this app installation to a previously served advertisement,打勾。
对于选项Attribute an action taken within this app to a previously served advertisement,打勾。
为什么 GrowingIO 使用 IDFA?
GrowingIO 使用 IDFA 来做来源管理激活设备的精确匹配,让你更好的衡量广告效果。如您不希望启用IDFA,可以选择不引入 AdSupport.framework
在IOS SDK 2.6.3 版本, 支持采集用户点击本应用的通知的题和内容。此功能默认关闭,如需开启,请在 Application 初始化 GrowingIO 中设置,例如:
查看通知采集数据
支持对于通知的展现和点击事件的采集,GrowingIO 并未增加新的采集事件类型,而是使用了自定义事件发送,所以需要您创建自定义事件和事件级变量,事件级变量标识符为notification_title
,notification_content
,自定义事件的标识符为notification_show
,notification_click
如图:
SDK版本支持:>=2.8.4
添加代码之后,请先Clean项目,然后再进行编译,并在你的 iOS App 安装了 SDK 后重新启动几次 App,保证行为采集数据自动发送给 GrowingIO,以便顺利完成检测。
在GrowingIO平台的应用创建页面继续完成应用创建的数据检测,检测成功后应用创建成功。
GrowingIO为您提供多种验证SDK是否正常采集数据的方式:
方式二:在SDK中设置了Debug模式后,在IDE编译器控制台查看数据采集日志。
配置链接:。
「用户浏览事件」半自动采集方案已经上线,详细配置请参考。
除上述的用户行为数据(无埋点数据)之外,GrowingIO 还提供了多种 API 接口,供您上传一些自定义的数据指标及维度 ,请参考iOS SDK API > 。
了解GrowingIO平台数据采集类型请参考。
方式一:
方式三: