iOS 集成文档

iOS 集成文档

1. 获取appid

登陆个推开发者中心,进入个像产品页,按照步骤提示注册应用,可获得 appid。

请确保在个像开发者中心正确配置 BundleId。

2. 打开项目工程

启动 Xcode, 打开您之前创建的 Xcode 项目工程

3. 配置个像 SDK

3.1 CocoaPods 集成方式

3.1.1 安装 CocoaPods

安装方式简单 , Mac 下都自带 ruby,使用 ruby 的 gem 命令即可下载安装:

$ sudo gem install cocoapods
$ pod setup

3.1.2 准备 Podfile

使用时需要新建一个名为 Podfile 的文件(若已存在该文件不需要重新创建),如下格式,将依赖的库名字依次列在文件中即可:

target 'YourTargetName' do
    platform :ios, "7.0"
    pod 'GInsightSDK'
end

3.1.3 完成 GInsight 导入

将编辑好的 Podfile 文件放到你的项目根目录中,执行如下命令即可:

$ cd "<path/to/project>"
$ pod install

3.2 Xcode 集成方式

前往SDK下载中心下载对应资料包

3.2.1 导入 GInsight SDK 和相应 Framework

添加需要用到的Framework

注意事项:集成GInsight SDK需要使用到IDFA所以必须添加AdSupport.framework,并且为了审核通过需要勾选如图:

初始化

在您应用的启动入口application:didFinishLaunchingWithOptions:方法中调用GInsight SDK初始化方法

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [GInsightSDK startSDKWithAppId:@"your appid" channel:@"your channel" delegate:self];
    return YES;
}

同时实现两个回调;

实现获取GIUid回调委托,获取到GIUid之后上传到服务端用于查询用户画像。

- (void)GInsightSDKDidReceiveGiuid:(NSString *)giUid{
    //绑定成功GIUid回调
    //TODO 上传服务器用于查询画像
}

实现错误回调委托

- (void)GInsightSDKDidReceiveError:(NSError *)error{
    /* 回调错误码类型
     * 1001 APPID 不能为空
     * 1002 IDFA 获取失败
     * 1003 绑定失败
     * 1004 异常错误
     */
}

4. SDK 接口类说明

SDK 功能接口,用于调用 GInsight 相关功能

方法详细资料

初始化

+ (void)startSDKWithAppId:(NSString *)appId channel:(NSString *)channel delegate:(id<GInsightSDKDelegate>)delegate;

参数:

appId - 您的appid

delegate - 回调委托对象

示例:

[GInsightSDK startSDKWithAppId:@"your appid" channel:@"your channel" delegate:self];

获取SDK版本号

+ (NSString *)version;

返回:

SDK版本号

示例:

NSString *version = [GInsightSDK version];

文档中心搜索