极光统计 iOS SDK 集成指南

使用提示

本文是JAnalytics iOS SDK 标准的集成指南文档。

匹配的 SDK 版本为：v1.0.0及以后版本。

• 如果您想要快速地测试、请参考本文在几分钟内跑通Demo。
• 极光推送文档网站上，有相关的所有指南、API、教程等全部的文档。包括本文档的更新版本，都会及时地发布到该网站上。

产品功能说明

利用事件模版统计App用户的行为事件并上报给极光服务器，极光提供加工过的数据通过WebPortal展示给开发者，让开发者更加了解自己的产品在用户手中的使用情况。

主要场景：

          1.统计页面流
2.统计事件：JAnalytics将事件统计模型化，目前提供了六种事件模型（登录，注册，购买，内容浏览，自定义计数事件，自定义计算事件）
3.动态圈选埋点统计（v2.0.0及以上版本支持，动态圈选功能仅支持iOS 9以上）

        

集成压缩包内容

• janalytics-ios-x.x.x.a静态库
• jcore-(noidfa-)ios-x.x.x.a静态库
• 统计入口JANALYTICSService.h头文件
• 统计事件对象文件JANALYTICSEventObject.h头文件
• 一个完整的 iOS Demo项目，通过这个演示了 JAnalytics SDK 的基本用法，可以用来做参考

iOS SDK 版本

目前SDK只支持iOS 7以上版本的手机系统。

IDFA

从 JCORE v2.1.4 版本开始，极光提供 idfa 和 noidfa 两个版本，请注意选择版本集成。 idfa 版本是标准版，默认自动采集 IDFA 数据， noidfa 版本不自动采集。极光建议开发者使 idfa 版本。当然，如果开发者不想使⽤ IDFA 或者担忧采集 IDFA 而未集成任何广告服务遭到 Apple 拒绝，请使用 noidfa 版本。

创建应用

• 创建成功后自动生成 AppKey 用以标识该应用。

SDK导入

选择1：Cocoapods导入

1. 如果使用标准版本(需要特别注意以下“注意事项”)

              pod 'JCore'    // 可选项，也可由pod 'JAnalytics'自动获取
    pod 'JAnalytics'    // 必选项

    注：如果无法导入最新版本，请执行 pod repo update master 这个命令来升级本机的 pod 库，然后重新 pod 'JAnalytics'

        

• 如果需要安装指定版本则使用以下方式（以 JAnalytics 2.1.2 版本为例）：

              pod 'JCore', '2.1.4'    // 可选项，也可由pod 'JAnalytics'自动获取
    pod 'JAnalytics', '2.1.2'    // 必选项

        

注意事项

• App在提交苹果审核时，对“此App是否使用广告标识符(IDFA)？”，需要选择“是”，并且需要根据App使用广告情况，勾选以下选项

  • 在App内投放广告 -- 确认是的话需要勾选
  • 标明此App安装来自先前投放的特定广告 -- 确认是的话需要勾选
  • 标明此App中发生的操作来自先前投放的广告 -- 确认是的话需要勾选
  • 勾选可参考以下示图：

2. 如果使用无IDFA版本

• JAnalytics安装默认版本，如果使用 JCore 2.1.4 及以上版本，使用方式如下：

              pod 'JCore', '2.1.4-noidfa'    // 必选项
    pod 'JAnalytics'    // 必选项

        

• JAnalytics安装默认版本，如果使用 JCore 2.1.2 及以下版本，使用方式如下：

              pod 'JCore', '2.1.2'    // 必选项
    pod 'JAnalytics'    // 必选项

        

• JAnalytics安装指定版本，如果使用 JCore 2.1.4 及以上版本，使用方式如下（以 JAnalytics 2.1.2 版本为例）：

              pod 'JCore', '2.1.4-noidfa'    // 必选项
    pod 'JAnalytics', '2.1.2'    // 必选项

        

• JAnalytics安装指定版本，如果使用 JCore 2.1.2 及以下版本，使用方式如下（以 JAnalytics 2.1.2 版本为例）：

              pod 'JCore', '2.1.2'    // 必选项
    pod 'JAnalytics', '2.1.2'    // 必选项

        

选择2：手动导入

• 在极光官网下载最新SDK

• 解压压缩包，将Lib下的所有文件复制到工程中（无IDFA版本请选择Lib-noidfa下的文件）

• 增加相关的framework依赖

  • UIKit
  • SystemConfiguration
  • CoreTelephony
  • CoreGraphics
  • Security
  • Foundation
  • CoreLocation
  • CoreFoundation
  • CFNetwork
  • libz.tbd
  • libresolv.tbd
  • libsqlite3.tbd（v2.0.0及以上版本需要）
  • WebKit(v2.1.2及以上版本需要)

• 可以开始使用统计SDK了！

设置URL Schemes

v2.0.0及以上版本激活圈选功能需要

请进入工程配置，选择Info，添加相应URL Schemes，如图

添加头文件

请将以下代码添加到 AppDelegate.m 引用头文件的位置

              // 引入JAnalytics功能所需头文件
    #import "JANALYTICSService.h"
    // 如果需要使用idfa功能所需要引入的头文件（可选）
    #import <AdSupport/AdSupport.h>

        

添加初始化代码

请将以下代码添加到 -(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions

              JANALYTICSLaunchConfig * config = [[JANALYTICSLaunchConfig alloc] init];
 
    config.appKey = @"your appkey";
     
    config.channel = @"channel";
     
    [JANALYTICSService setupWithConfig:config];

        

添加激活圈选代码

v2.0.0及以上版本需要

请实现以下方法并调用[JANALYTICSService handleUrl:]，在调试时确保函数[JANALYTICSService handleUrl:]会被执行到

          - (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
    if ([JANALYTICSService handleUrl:url]) {
        return YES;
    }
    return NO;
}

        

若您在 AppDelegate 中实现了以下一个或多个方法，请在已实现的函数中，调用[JANALYTICSService 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

        

更多 API

其他 API 的使用方法请参考接口文档：iOS SDK API

运行 demo

压缩包附带的 demo 是一个 API 演示例子。您可以将它导入到您的工程，并将您的 AppKey 填入到 demo 的 AppDelegate 中，设置上BundleID然后直接运行起来测试。

技术支持

邮件联系：support@jiguang.cn