*)variable;
```
```java
// track API调用示例一
[Growing track:@"registerSuccess"];
```
```java
// track API调用示例二
[Growing track:@"registerSuccess" withVariable:@{@"gender":@"male", @"age":@"21"}];
```
```java
// track API调用示例三
[Growing track:@"loanAmount" withNumber:@800000 andVariable:@{@"loanType":@"houseMortgage", @"province":@"Zhejiang"}];
```
### setEvar
发送一个转化信息用于高级归因分析，在添加代码之前必须在打点管理界面上声明转化变量。
#### 参数说明：
| 参数名称 | 参数类型 | 是否必须 | 说明 |
| ------------------- | ----------- | ---- | ------------ |
| key | String | 否 | 转化变量的标识符 |
| Value | String | 否 | 转化变量的值 |
| conversionVariables | JSON Object | 否 | 转化变量用于高级归因分析 |
**参数限制条件：**
| 参数名称 | 限制条件 |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| key | 不能为 nil 或者""，长度小于等于50 |
| Value | 变量不为nil或者""，若为字符串则长度应小于等于 1000 |
| conversionLevelVariable | 不能为nil; conversionLevelVariable 内部不允许含有JSONObject或者JSONArray；
key 长度限制小于等于50，value 长度限制小等于1000，值不能为空串，也就是""。
|
```java
// setEvar API原型
+ (void)setEvarWithKey:(NSString *)key andStringValue:(NSString *)stringValue;
+ (void)setEvarWithKey:(NSString *)key andNumberValue:(NSNumber *)numberValue;
+ (void)setEvar:(NSDictionary *)variable;
```
```java
// setEvar API调用示例一
[Growing setEvarWithKey:@"campaignId" andStringValue:@"1234567890"];
```
```java
// setEvar API调用示例二
[Growing setEvar:@{@"campaignId":@"12345", @"campaignOwner":@"Li Si"}];
```
### setPeopleVariable
发送用户信息用于用户信息相关分析，在添加代码之前必须在打点管理界面上声明用户变量。
#### 参数说明：
| 参数名称 | 参数类型 | 是否必须 | 说明 |
| ----------------- | ----------- | ---- | --------------- |
| key | String | 否 | 用户变量的标识符 |
| value | String | 否 | 用户变量的值 |
| customerVariables | JSON Object | 否 | 用户变量用于用户信息相关的分析 |
**参数限制条件：**
| 参数名称 | 限制条件 |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| key | 不能为nil或""，长度小于等于50 |
| value | 变量不为nil或者""，若为字符串则长度应小于等于 1000 |
| customerVariables | 不能为nil;customerVarialbes 内部不允许含有JSONObject或者JSONArray；
key 长度限制小于等于50，value 长度限制小等于1000，值不能为空串，也就是""。
|
```java
// setPeopleVariable API原型
+ (void)setPeopleVariableWithKey:(NSString *)key andStringValue:(NSString *)stringValue;
+ (void)setPeopleVariableWithKey:(NSString *)key andNumberValue:(NSNumber *)numberValue;
+ (void)setPeopleVariable:(NSDictionary *)variable;
```
```java
// setPeopleVariable API调用示例一
[Growing setPeopleVariableWithKey:@"gender" andStringValue:@"male"];
```
```java
// setPeopleVariable API调用示例二
[Growing setPeopleVariable:@{@"gender":@"male", @"age":@"25"}];
```
### setVisitor
#### 2.4.0以上版本支持
当用户未登录时，定义用户属性变量，也可用于A/B测试上传标签。
#### 参数说明：
| 参数名称 | 参数类型 | 是否必须 | 说明 |
| -------- | ----------- | ---- | ------ |
| variable | JSON Object | 是 | 访问用户信息 |
**参数限制条件：**
| 参数名称 | 限制条件 |
| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| variable | 不能为nil;variable 内部不允许含有JSONObject或者JSONArray；
key 长度限制小于等于50，value 长度限制小等于1000，值不能为空串，也就是""。
|
```java
// setVisitor 访问用户变量 API原型
+ (void)setVisitor:(NSDictionary *)variable;
```
```java
// setVisitor API调用示例
[Growing setVisitor:@{@"gender":@"male", @"age":@"25"}];
```
### setUserId
当用户登录之后调用setUserId API，设置登录用户ID。
#### 参数说明：
| 参数名称 | 参数类型 | 是否必须 | 说明 |
| ------ | ------ | ---- | --------- |
| userId | String | 是 | 用户的登录用户ID |
**参数限制条件：**
| 参数名称 | 限制条件 |
| ------ | ------------------------------------------------------------------------------ |
| userId | 英文数字组合的字符串，长度小于等于1000，且不能含有特殊字符，不允许传空、`""` 或者`nil`，如有清除操作，请调用 `clearUserId` 方法 |
```java
// setUserId API原型
+ (void)setUserId:(NSString *)userId;
```
```java
// setuserId API调用示例
[Growing setUserId:@"1234567890"];
```
{% hint style="warning" %}
如果您的应用是App，且每次用户升级App版本时无需重新登录的话，建议在用户每次升级App版本后初次访问时重新调用上述 setUserId 方法。
{% endhint %}
### clearUserId
当用户登出之后调用clearUserId，清除已经设置的登录用户ID。
```java
// clearUserId API原型
+ (void)clearUserId;
```
```java
// clearUserId API调用示例
[Growing clearUserId];
```
## 埋点SDK支持的其他接口
{% hint style="danger" %}
**GrowingIO 埋点 SDK 仅自动采集设备信息和您埋点内容数据，对比无埋点 SDK ，埋点 SDK 少很多 API， 请勿在埋点 SDK 中调用无埋点 SDK 接口。**
{% endhint %}
埋点SDK除了支持上面的打点事件，还支持以接口，接口详情请参考[IOS SDK API](https://docs.growingio.com/docs/sdk-integration/ios-sdk/ios-sdk-api)中的说明：
```java
1，如果需要采样设置一个采样值 0.01即1% 0.001即1‰ 最多支持小数点后5位
+ (void)startWithAccountId:(NSString*)accountId withAppId:(NSString*)appId withSampling:(CGFloat)sampling;
+ (void)startWithAccountId:(NSString*)accountId withSampling:(CGFloat)sampling;
2，默认采样100%
+ (void)startWithAccountId:(NSString*)accountId withAppId:(NSString*)appId;
+ (void)startWithAccountId:(NSString*)accountId;
3，命令行输出调试日志
+ (void)setEnableLog:(BOOL)enableLog;
+ (BOOL)getEnableLog;
4，若使用加密功能,请在UI元素初始化之前设置此函数
+ (void)setEncryptStringBlock:(NSString*(^)(NSString*string))block;
5，以下函数设置后会覆盖原有设置
// 并且只会在第一次安装后调用以保证同一设备的设备ID相同
// 请在方法startWithAccountId之前调用
// 使用自定义的ID 自定义ID长度不可大于64 否则会被抛弃NSUUID的UUIDString长度为36
+ (void)setDeviceIDModeToCustomBlock:(NSString*(^)(void))customBlock;
6，deeplink广告落地页参数回调设置
+ (void)registerDeeplinkHandler:(void(^)(NSDictionary*params, NSError*error))handler;
7，Universallink广告落地页参数回调设置
+ (void)registerUniversallinkHandler:(void(^)(NSDictionary*params, NSError*error))handler;
8，该函数请在main函数第一行调用APP启动后将不允许修改采集模式
+ (void)setAspectMode:(GrowingAspectMode)aspectMode;
+ (GrowingAspectMode)getAspectMode;
9，是否允许发送基本性能诊断信息，默认为开
+ (void)setEnableDiagnose:(BOOL)enable;
10，全局不发送统计信息
+ (void)disable;
11，设置发送数据的时间间隔（单位为秒）
+ (void)setFlushInterval:(NSTimeInterval)interval;
+ (NSTimeInterval)getFlushInterval;
12，设置每天使用数据网络（2G、3G、4G）上传的数据量的上限（单位是KB）
+ (void)setDailyDataLimit:(NSUInteger)numberOfKiloByte;
+ (NSUInteger)getDailyDataLimit;
13，设置数据收集平台服务器地址
+ (void)setTrackerHost:(NSString*)host;
14，设置设备报活服务器地址
+ (void)setReportHost:(NSString*)host;
15，设置数据查看平台服务器地址
+ (void)setDataHost:(NSString*)host;
16，设置数据后台服务器地址
+ (void)setGtaHost:(NSString*)host;
17，设置数据后台服务器地址
+ (void)setWsHost:(NSString*)host;
18，设置zone信息
+ (void)setZone:(NSString*)zone;
19，设置GDPR 生效
+ (void)disableDataCollect;
20，设置GDPR 失效
+ (void)enableDataCollect;
21，获取当前设备id
+ (NSString*)getDeviceId;
22，获取当前uid
+ (NSString*)getVisitUserId;
23，获取当前访问id
+ (NSString*)getSessionId;
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://growingio.gitbook.io/old_docs/sdk-integration/ios-sdk/ios-mai-dian-sdk.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.