导航|地址|刷新
数据统计接口文档-个推文档中心
图
图
图



文档中心开发者中心

，欢迎您！

您的优惠服务将于到期。





基本资料



安全设置



应用管理




退出登录
登录/注册SDK下载个推学堂请选择产品
消息推送

用户运营

OneID服务

AI应用工坊

统计分析

用户分析

标签管理

模型管理

短信服务

数字人外呼

一键认证

合规检测

点击提升







体验更多产品服务


欢迎登录开发者中心

立即登录

本月不再提醒





产品简介

产品使用手册
生命周期
概览

价值用户挖掘

沉默用户促活

流失用户预测

卸载原因分析


埋点行为数据采集和管理

数据统计分析和洞察

用户分层打标和群体扩量

场景模板
场景运营介绍


运营计划

用户群管理

数据管理

权限管理

流程画布

AI助手
ChatBI智能问数


Webhook
业务介绍

技术对接说明



应用场景
埋点应用场景案例


服务端
RestAPI
开发须知

接口调用规范

鉴权API

标签API

用户API

统计API

公共参数

返回码说明



客户端
Android
集成文档

API文档

使用文档

SDK集成视频


iOS
集成文档

API文档

使用文档

隐私清单说明


HarmonyOS
集成文档

API接口

使用文档


H5&小程序
集成文档

API文档


客户端插件

SDK更新日志


常见问题




当前位置：用户运营 > 客户端 > iOS > API文档



数据统计接口文档


数据统计接口文档

1 初始化启动接口

接口描述:

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

接口定义:
/** 初始化启动接口 @param appId 开发者后台生成的 appId @param channelId 渠道名称，默认为 'appstore' @param delegate delegate */ + (void)startSDKWithAppId:(NSString *)appId withChannelId:(NSString *)channelId delegate:(id<GTCountSDKDelegate>)delegate;
接口说明:

在 AppDelegate didFinishLaunchingWithOptions 方法中:通过平台分配的 APPID 启动统计 SDK。

参数参数说明
appId应用标识 APPID
channelId渠道名称，如果为 nil或者空串,默认为 'appstore'
delegateSDK代理回调


接口示例:
#import <GTCountSDK/GTCountSDK.h>#define kGcAppId @"xxxxxxx"@interfaceAppDelegate<GTCountSDKDelegate>@end@implementationAppDelegate - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { // 启动数据统计 SDK [GTCountSDK startSDKWithAppId:kGcAppId withChannelId:@"appstore" delegate:self]; returnYES; } //SDK代理回调，获取Gtcid - (void)GTCountSDKDidReceiveGtcid:(NSString *)gtcid error:(NSError *)error { NSLog(@"GTCountSDKDidReceiveGtcid gtcid:%@ error:%@", gtcid, error); }
2 获取gtcid

接口描述:

您可通过下面的方法获取gtcid，gtcid可用于用户画像标签的查询。

接口定义:
/// gtcid可用于用户画像标签的查询。 + (NSString*)gtcid;
接口示例:
NSLog(@"gtcid:%@", [GTCountSDK gtcid]);
3 次数统计事件

接口描述:

在事件执行开始时调用次数统计方法，SDK 会根据事件 Id ，统计该事件被点击的次数。

接口定义:
/** 计数事件统计 @param eventId 事件 Id @param args 自定义属性，key 必须为 NSString 类型（注意：不能以$开头），value 仅支持NSNumber, BOOL, NSString, NSDate 4 种类型 @param ext 内部字段，不建议使用。 */ + (void)trackCountEvent:(NSString *)eventId withArgs:(NSDictionary *)args withExt:(NSString *)ext;
接口参数说明:

参数参数说明
eventId自定义事件 Id
args⾃定义属性，key 必须为 NSString 类型（注意：不能以$开头），value 仅支持NSNumber, BOOL, NSString, NSDate 4 种类型
ext内部字段，不建议使用


接口示例:
@implementation TrackCountEventController - (IBAction)clickCount:(id)sender { [GTCountSDK trackCountEvent:@"test"withArgs:@{@"time":[NSDate date],@"number":@(34.0),@"string":@"str",@"BOOL":@YES} withExt:nil]; } @end
4 用户属性设置

接⼝描述:

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

接⼝定义:
/** 用户属性设置 @param profiles 用户属性参数，key 必须为 NSString 类型，value 仅支持NSNumber, BOOL, NSString, NSDate 4 种类型 @param ext 自定义ext字段内容。 */ + (void)setProfile:(NSDictionary *)profiles withExt:(NSString *)ext; + (void)setProfile:(NSDictionary *)profiles;
接⼝示例:
NSMutableDictionary *profiles = [NSMutableDictionary new]; [profiles setObject:@"username001"forKey:@"$name"]; [profiles setObject:@"男"forKey:@"$sex"]; [GTCountSDK setProfile:profiles.copy]; return YES;
5 设置会话超时时长

接口描述:

设置会话时长（默认 30000 ms，单位毫秒），在应用退到后台后停留时间超过会话时长，视为一次新的应用会话。

接口定义:
/** 设置会话时长（默认 30000 ms,单位毫秒），在应用退到后台后停留时间超过会话时长，视为一次新的应用会话。 */@property (nonatomic, assign)NSUInteger sessionTime;
接口示例:
#import <GTCountSDK/GTCountSDK.h>#define kGcAppId @"xxxxxxx" - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { [GTCountSDK sharedInstance].sessionTime = 30*1000; [GTCountSDK startSDKWithAppId:kGcAppId withChannelId:@"appstore"]; returnYES; }
6 设置有效活跃时长

接口描述:

设置有效活跃时长，活跃时长满足[min, max]的才会上报服务器记录。

接口定义:
/** 设置有效活跃时长，活跃时长满足[min, max]的才会上报服务器记录 minAppActiveDuration默认 1000 ms, maxAppActiveDuration默认 12*3600*1000 ms, 单位毫秒 */@property (nonatomic, assign) NSInteger minAppActiveDuration; @property (nonatomic, assign) NSInteger maxAppActiveDuration;
接口示例:
#import <GTCountSDK/GTCountSDK.h>#define kGcAppId @"xxxxxxx" - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { [GTCountSDK sharedInstance].minAppActiveDuration = 1000; [GTCountSDK sharedInstance].maxAppActiveDuration = 12*3600*1000; [GTCountSDK startSDKWithAppId:kGcAppId withChannelId:@"appstore"]; returnYES; }
7 设置事件上传频率

接口描述:

时长统计事件和次数统计事件累计条数到达ForceUploadSize 或 距离上一次汇报时间间隔超过UploadInterval后，将触发上传流程。

接口定义:
/** // trackCustomKeyValueEvent和trackCountEvent的上报间隔， 默认10000毫秒，即10秒 @property(nonatomic, assign) NSInteger eventUploadInterval; // trackCustomKeyValueEvent和trackCountEvent 的上报条数阈值，默认30 @property(nonatomic, assign) NSInteger eventForceUploadSize;
接口示例:
#import <GTCountSDK/GTCountSDK.h>#define kGcAppId @"xxxxxxx" - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { [GTCountSDK sharedInstance].eventUploadInterval = 10000; [GTCountSDK sharedInstance].eventForceUploadSize = 30; [GTCountSDK startSDKWithAppId:kGtAppId withChannelId:@""]; returnYES; }
8 设置Profile上报频率

接口描述:

SetProfile累计条数到达ForceUploadSize 或 距离上一次汇报时间间隔超过UploadInterval后，将触发上传流程。

接口定义:
/** // Profile上报间隔， 默认5000毫秒，即5秒 @property(nonatomic, assign) NSInteger profileUploadInterval; // Profile上报条数阈值，默认5 @property(nonatomic, assign) NSInteger profileForceUploadSize;
接口示例:
#import <GTCountSDK/GTCountSDK.h>#define kGcAppId @"xxxxxxx" - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { [GTCountSDK sharedInstance].profileUploadInterval = 5000; [GTCountSDK sharedInstance].profileForceUploadSize = 5; [GTCountSDK startSDKWithAppId:kGtAppId withChannelId:@""]; returnYES; }
9 设置App Groups ID

接口描述:

通过苹果开发者后台创建Group Identify， 用于App主包和Extension之间的数据打通。

接口定义:
+ (void)setApplicationGroupIdentifier:(NSString*)identifier;
接口示例:

主包AppDelegate.m文件：
#import <GTCountSDK/GTCountSDK.h>#define kGcAppId @"xxxxxxx" - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { //设置主包GroupId [GTCountSDK setApplicationGroupIdentifier:@"group.ent.com.getui.demo"]; [GTCountSDK startSDKWithAppId:kGtAppId withChannelId:@""]; returnYES; }
Widget小组件swift文件：
func getTimeline(forconfiguration: ConfigurationIntent, incontext: Context, completion: @escaping (Timeline<Entry>) -> ()) { var entries: [SimpleEntry] = []//设置小组件GroupIdGTCountSDK.setApplicationGroupIdentifier("group.ent.com.getui.demo")GTCountSDK.start(withAppId: kGtAppId, withChannelId: "widget") }
10 应用内弹窗统计

接口描述:

在GTSDK的应用内弹窗回调中，埋点统计应用内弹窗事件。

接口定义:
/// 对应GTSDK应用内弹窗回调的展示埋点/// - Parameter dic: 弹窗数据 + (void)popupDidShow:(NSDictionary *)dic; /// 对应GTSDK应用内弹窗回调的点击埋点/// - Parameter dic: 弹窗数据 + (void)popupDidClick:(NSDictionary *)dic;
接口示例:
// 展示回调 - (void)GeTuiSdkPopupDidShow:(NSDictionary *)info { NSString *msg = [NSString stringWithFormat:@"[ TestDemo ] GeTuiSdkPopupDidShow%@", info]; [self.homePage logMsg:msg]; //已经集成用户运营SDK的用户, 建议调用IDO的应用内弹窗统计 [GTCountSDK popupDidShow:info]; } // 点击回调 - (void)GeTuiSdkPopupDidClick:(NSDictionary *)info { NSString *msg = [NSString stringWithFormat:@"[ TestDemo ] GeTuiSdkPopupDidClick%@", info]; [self.homePage logMsg:msg]; //已经集成用户运营SDK的用户, 建议调用IDO的应用内弹窗统计 [GTCountSDK popupDidClick:info]; }



以上文档对您是否有帮助？
有帮助没帮助



您的改进建议

是否遇到以下问题

问题类型


1、内容与功能不一致；

2、文章描述不清晰；

3、图片和视频难理解；

4、对产品功能不满意；

5、不是我想要的内容；

6、其他:


问题类型不能为空



反馈建议



联系方式



取 消提 交





反馈成功

非常感谢您的反馈，我们会继续努力做到更好！
确定






在这篇文章中：1 初始化启动接口2 获取gtcid3 次数统计事件4 用户属性设置5 设置会话超时时长6 设置有效活跃时长7 设置事件上传频率8 设置Profile上报频率9 设置App Groups ID10 应用内弹窗统计







文档中心搜索

搜 索















------
导航页 打开网址