埋点 SDK集成

埋点 SDK 的目标用户是使用第三方插件开发的 APP，比如使用 Weex、APICloud 等。在这些平台中，我们无法自动采集用户的点击事件和页面浏览事件等，需要依赖调用自定义事件和变量 API来进行数据采集。如果您的 APP 使用 iOS 原生开发，并且希望自动采集用户的点击事件、页面浏览事件等无埋点事件，请集成 iOS 无埋点SDK 。

前提条件

获取项目ID，获取方法请参考"项目管理 > 项目概览 > 查看项目基本信息"。
获取URL Scheme，在GrowingIO平台创建对应的应用时会生成URL Scheme。请参考创建应用。

1. 添加跟踪代码

集成环境：Xcode 9.0及以上；

App适配最低系统版本：iOS 8及以上

组件化SDK

GrowingIO iOS SDK 2.8.19 包含以下组件SDK:

• GrowingCoreKit (组件基础库,具备分析功能)

请保证Growing、GrowingCoreKit版本号一致

1. 添加依赖

在您的Podfile中添加pod 'GrowingCoreKit'。
执行pod install 或 pod update 更新pod依赖库。
（可选）GrowingIO推荐您添加 AdSupport.framework 依赖库，用于来源管理激活匹配,有利于您更好的分析数据 ,添加项目依赖库的位置在项目设置target -> 选项卡General -> Linked Frameworks and Libraries

2. 添加 URL Scheme

添加URL Scheme 到项目中，以便唤醒您的程序进行圈选。

3. 初始化配置

在 AppDelegate 中引入#import "Growing.h"并添加初始化方法。

#import "Growing.h"
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  ...
  // 启动GrowingIO

   [Growing startWithAccountId:@"您的项目ID"];      // 替换为您的项目ID
      // 其他配置
      // 开启Growing调试日志 可以开启日志
      // [Growing setEnableLog:YES];

请确保将代码添加在上述位置，添加到其他方法或异步block中可能导致数据不准确。

4.添加代码

因为您代码的复杂程度以及iOS SDK的版本差异，有时候 [Growing handleUrl:url] 并没有被调用。请在各个平台上调试这段代码，确保当App被URL scheme唤醒之后，该函数能被调用到。

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
{
    ...
 if ([Growing handleUrl:url]) // 请务必确保该函数被调用
  {
      return YES;
  }
  return NO;
 ...
}

提醒：

若您在 AppDelegate 中实现了以下一个或多个方法，请在已实现的函数中，调用[Growing handleUrl:]

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(nullable NSString *)sourceApplication annotation:(id)annotation
- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString*, id> *)options

若以上所有方法均未实现，请实现以下方法并调用[Growing handleUrl:]

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(nullable NSString *)sourceApplication annotation:(id)annotation

实际情况可能很复杂，请在调试时确保函数[Growing handleUrl:]会被执行到

3. App Store提交应用注意事项

如果您添加了库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

4. 自定义数据上传

除上述的用户行为数据（无埋点数据）之外，GrowingIO 还提供了多种 API 接口，供您上传一些自定义的数据指标及维度，请参考iOS SDK API > 自定义数据上传API 。

5. 创建应用

添加代码之后，请先Clean项目，然后再进行编译，并在你的 Android App 安装了 SDK 后重新启动几次 App，保证行为采集数据自动发送给 GrowingIO，以便顺利完成检测。

在GrowingIO平台的应用创建页面继续完成应用创建的数据检测，检测成功后应用创建成功。

6. 验证SDK是否正常采集数据

了解GrowingIO平台数据采集类型请参考数据模型。

GrowingIO为您提供多种验证SDK是否正常采集数据的方式：

方式一：Mobile Debugger

方式二：在SDK中设置了Debug模式后，在IDE编译器控制台查看数据采集日志。

方式三：数据校验

Previous无埋点 SDK集成 NextiOS SDK API

Last updated 5 years ago

Was this helpful?