//
//  WeiboSDK+Statistics.h
//  WeiboSDK
//
//  Created by DannionQiu on 15/4/13.
//  Copyright (c) 2015年 SINA iOS Team. All rights reserved.
//

#import "WeiboSDK.h"

@interface WeiboSDK(Statistics)

/** 设置是否开启统计模式, 默认为NO.
 @param value 为YES, SDK会开启统计功能，记录日志，并在合适的实际传上服务器。
 @return void.
 */
+ (void)setStatisticsEnabled:(BOOL)value;

#pragma mark - Optional Configs Setting
/** 设置是否打印SDK的log信息, 默认NO(不打印log).
 @param value 设置为YES, WeiboSDK 会输出log信息可供调试参考. 除非特殊需要，否则发布产品时需改回NO.
 @return void.
 */
+ (void)setStatisticsLogEnabled:(BOOL)value;

/** 设置版本信息.
 @param version 版本号，为nil或@""时, 默认为Build号(CFBundleVersion)
 @return void.
 */
+ (void)setVersion:(NSString*)version;

/** 设置渠道信息.
 @param channelID 渠道名称, 为nil或@""时, 默认为@"AppStore"渠道
 @return void.
 */
+ (void)setChannelID:(NSString*)channelID;

/** 设定日志上传的发送间隔
 @param frequecy 单位为秒，最小30秒，最大8*60*60秒(8小时)。默认为180秒(3分钟)
 @return void.
 */
+ (void)setUploadFrequecy:(NSTimeInterval)frequecy;

#pragma mark - Statistics Api
/** 自动页面时长统计, 开始记录某个页面展示时长.
 使用方法：必须配对调用beginLogPageView:和endLogPageView:两个函数来完成自动统计，若只调用某一个函数不会生成有效数据。
 在该页面展示时调用beginLogPageView:，当退出该页面时调用endLogPageView:
 @param pageName 统计的页面名称.
 @return void.
 */
+ (void)beginLogPageView:(NSString *)pageName;

/** 自动页面时长统计, 结束记录某个页面展示时长.
 使用方法：必须配对调用beginLogPageView:和endLogPageView:两个函数来完成自动统计，若只调用某一个函数不会生成有效数据。
 在该页面展示时调用beginLogPageView:，当退出该页面时调用endLogPageView:
 @param pageName 统计的页面名称.
 @return void.
 */
+ (void)endLogPageView:(NSString *)pageName;


/** 自动事件时长统计, 开始记录某个事示时长.
 使用方法：调用event:函数来完成自动统计。
 @param eventID 统计的事件标识符.
 @warning eventID不能使用空格和特殊字符，且长度不能超过255个字符（否则将截取前255个字符）
 */
+ (void)event:(NSString *)eventID;

/** 自动事件时长统计, 开始记录某个事示时长.
 使用方法：调用event:函数来完成自动统计。
 @param eventID 统计的事件标识符.
 @param pageName 事件发生时所在页面.
 @param userInfo 事件相关信息.
 @return void.
 
 @warning 每个event的userInfo不能超过10个
 eventID、pageName、userInfo中key和value都不能使用空格和特殊字符，且长度不能超过255个字符（否则将截取前255个字符）
 */
+ (void)event:(NSString *)eventID onPageView:(NSString*)pageName withUserInfo:(NSDictionary*)userInfo;

/** 强制日志上传
 调用后，若距离上次成功上传日志时间不小于30秒，立刻上传日志。
 */
+ (void)forceUploadRecords;




@end