iOS SDK 提供了 无埋点 和 埋点 两个SDK版本：

• 埋点 SDK 只自动采集用户访问事件，需要开发同学调用相应埋点 API 采集自定义事件;

• 无埋点 SDK 具备埋点 SDK 的所有功能，同时具备自动采集基本用户行为事件，如页面访问，点击事件等。

CDP无埋点SDK（包括埋点 SDK）代码托管在 Github，欢迎 star，fork 一波。

无埋点SDK集成

Cocoapods集成

在Podfile文件中添加

pod 'GrowingAnalytics-cdp/Autotracker'

添加 URL Scheme

URL Scheme 是您在 GrowingIO 平台创建应用时生成的该应用的唯一标识。把 URL Scheme 添加到您的项目，以便使用Mobile Debug等功能时唤醒您的应用。

选择工程 → Target → Info → URL Types → 添加您的Url Scheme 即可

SDK初始化配置

1. 导入头文件"GrowingAutotracker.h"请将以下 [GrowingAutoTracker startWithConfiguration:]加在您的AppDelegate 的 application:didFinishLaunchingWithOptions: 方法中 代码示例:

// Config GrowingIO
// 参数需要从GrowingIO网站上，创建新应用，或从已知应用中获取 
// YourProjectId eg:0a1b4118dd954ec3bcc69da5138bdb96
// YourServerHost 域名前面需要加上 协议://  eg:http://106.75.81.105:8080 
// YourDatasourceId eg: 11223344aabbcc
GrowingTrackConfiguration *configuration = [GrowingTrackConfiguration configurationWithProjectId:@"YourProjectId"];
configuration.dataCollectionServerHost = @"YourServerHost";
configuration.dataSourceId = @"YourDatasourceId";
[GrowingAutotracker startWithConfiguration:configuration launchOptions:launchOptions];

2. 在appDelegate.m文件中实现urlSchme跳转以及DeepLink跳转的代理方法

// url scheme跳转
- (BOOL)application:(UIApplication *)application
            openURL:(NSURL *)url
  sourceApplication:(NSNSString *)sourceApplication
         annotation:(id)annotation {
​
    return NO;
}
​
// universal Link执行
- (BOOL) application:(UIApplication *)application
continueUserActivity:(NSUserActivity *)userActivity
  restorationHandler:(void (^)(NSArray<id <UIUserActivityRestoring>> *_Nullable))restorationHandler {
    return YES;
}

3. 若使用了iOS 13的 UIScene，请在您指定的SceneDelegate中设置如下

- (void)scene:(UIScene *)scene continueUserActivity:(NSUserActivity *)userActivity {
}
​
- (void)scene:(UIScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts {
}

SDK 初始化配置项

埋点SDK集成

埋点 SDK只自动采集用户访问事件和APP关闭事件，其他事件均需要开发同学调用相应埋点 API 采集自定义事件。

Cocoapods集成

在Podfile文件中添加

pod 'GrowingAnalytics-cdp/Tracker'

添加 URL Scheme

URL Scheme 是您在 GrowingIO 平台创建应用时生成的该应用的唯一标识。把 URL Scheme 添加到您的项目，以便使用Mobile Debug等功能时唤醒您的应用。

选择工程 -> Target -> Info -> URL Types -> 添加您的Url Scheme 即可

SDK初始化配置

1. 导入头文件"GrowingTracker.h",请将以下 [GrowingTracker startWithConfiguration:]加在您的AppDelegate 的 application:didFinishLaunchingWithOptions: 方法中 代码示例:

// Config GrowingIO
// 参数需要从GrowingIO网站上，创建新应用，或从已知应用中获取 
// YourProjectId eg:0a1b4118dd954ec3bcc69da5138bdb96
// YourServerHost eg:http://106.75.81.105:8080
// YourDatasourceId eg: 11223344aabbcc
GrowingTrackConfiguration *configuration = [GrowingTrackConfiguration configurationWithProjectId:@"YourProjectId"];
configuration.dataCollectionServerHost = @"YourServerHost";
configuration.dataSourceId = @"YourDatasourceId";
[GrowingTracker startWithConfiguration:configuration launchOptions:launchOptions];

2. 在appDelegate.m文件中实现 urlScheme 跳转以及 DeepLink 跳转的代理方法

// url scheme跳转
- (BOOL)application:(UIApplication *)application
            openURL:(NSURL *)url
  sourceApplication:(NSString *)sourceApplication
         annotation:(id)annotation {
​
    return NO;
}
​
// universal Link执行
- (BOOL) application:(UIApplication *)application
continueUserActivity:(NSUserActivity *)userActivity
  restorationHandler:(void (^)(NSArray<id <UIUserActivityRestoring>> *_Nullable))restorationHandler {
    return YES;
}

3. 若使用了iOS 13的 UIScene，请在您指定的SceneDelegate中设置如下

- (void)scene:(UIScene *)scene continueUserActivity:(NSUserActivity *)userActivity {
}
​
- (void)scene:(UIScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts {
}

SDK 初始化配置项

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

关于权限获取

• 对于iOS 14之前，你无需主动获取 广告标识IDFA 的权限

• 对于iOS 14之后，你需要使用如下方法来开启你的 广告标识IDFA 的权限

1. Plist 文件中添加 NSUserTrackingUsageDescription

   <key>NSUserTrackingUsageDescription</key>
   <string>GrowingIO测试demo 需要使用你的广告标识信息以用于数据追踪分析</string> //描述内容请根据App修改

2. 导入框架 #import <AppTrackingTransparency/AppTrackingTransparency.h>

3. 调用获取权限代码

       if (@available(iOS 14, *)) {
           // iOS14及以上版本需要先请求权限
           [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
               switch (status) {
                   case ATTrackingManagerAuthorizationStatusDenied:
                       //用户拒绝向App授权
                       break;
                   case ATTrackingManagerAuthorizationStatusAuthorized:
                       //用户同意向App授权
                       break;
                   case ATTrackingManagerAuthorizationStatusNotDetermined:
                       //用户未做选择或未弹窗
                       break;
                   case ATTrackingManagerAuthorizationStatusRestricted:
                       //用户在系统级别开启了限制广告追踪
                       break;
                   default:
                       break;
               }
           }];
       }