使用文档

初始化

使用统计功能以前，需要先启动 SDK，该接口用于在 App 运行时启动数据统计 SDK。

#import <GTCountSDK/GTCountSDK.h>
#define kGcAppId @"xxxxxxx"

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // 启动开发者模式，打印相关的数据上传信息
    [GTCountSDK setDebugEnable:YES];
    // 启动数据统计 SDK
    [GTCountSDK startSDKWithAppId:kGcAppId withChannelId:@"appstore"];
    return YES;
 }

自定义事件

统计事件

自定义事件可以统计某些用户自定义埋点的发生时间以及次数，例如广告点击、短信数量等。

// 进入主页面
[GTCountSDK trackCountEvent:@"enter_main_page" withArgs:nil withExt:nil];

// 进入支付页面
[GTCountSDK trackCountEvent:@"enter_pay_page" withArgs:@{@"page_from":@"active_page"} withExt:nil];

// 进行支付
[GTCountSDK trackCountEvent:@"pay" withArgs:@{@"pay_amount":@(100),@"pay_type":@"alipay"} withExt:nil];

// 点击了广告模块
[GTCountSDK trackCountEvent:@"click_home_ad" withArgs:@{@"ad_id":@"ad_001",@"ad_name":@"ad_name_001"} withExt:nil];

用户属性事件

设置⽤户属性，用于记录用户基本固定不变的属性，例如性别、年龄、注册时间、注册地域、注册渠道等。

// 设置用户固定属性
NSMutableDictionary *profiles = [NSMutableDictionary new];
[profiles setObject:@"123456" forKey:@"identify"];
[profiles setObject:@"378jkdfjs209afds899" forKey:@"useId"];
[profiles setObject:@"male" forKey:@"sex"];
[profiles setObject:@(20) forKey:@"age"];
[profiles setObject:@"2024-01-01 00:00:00" forKey:@"register_time"];
[GTCountSDK setProfile:profiles.copy];