# cstm（事件以及关联的事件级变量）事件

### 场景一：计数器类型的埋点事件（无关联事件级变量）

> 以”登录成功“这个事件为例，打点记录登录成功的次数。

**事件配置方式示例**

| 标识符          | 名称   | 事件级变量 | 类型  | 描述     |
| ------------ | ---- | ----- | --- | ------ |
| loginSuccess | 登录成功 | 无     | 计数器 | 登录成功次数 |

**对应的代码**

| 平台          | 方法原型                                             | 代码示例                                           |
| ----------- | ------------------------------------------------ | ---------------------------------------------- |
| JS SDK      | gio('track', eventId) ;                          | gio('track', 'loginSuccess');                  |
| Android SDK | GrowingIO.getInstance().track(`String` eventId); | GrowingIO.getInstance().track("loginSuccess"); |
| iOS SDK     | +(void)track:(NSString \*)eventId;               | \[Growing track: @"loginSuccess"];             |

**数据验证方法**

在对应的应用（网站、Android或者iOS App）中触发登录成功事件，通过Debugger工具验证数据准确性。

按照如下流程图进行验证：

![](https://2602900487-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo08UtW7H58ehFKeZ4g%2F-LrIsRzv86DPpI6HOO1U%2F-LrIznfY9QVgZHPL9B0i%2Fcstm2x.png?alt=media\&token=fcd4158f-ce48-454d-a314-c2c2ac10c573)

在本例中，如下图的数据请求说明打点代码生效

![](https://2602900487-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo08UtW7H58ehFKeZ4g%2F-LrE00A8UlBZIpsZnduI%2F-LrHYfz4Ot7BYrvfQWz4%2F%E8%AE%A1%E6%95%B0%E5%99%A8%E6%97%A0%E5%8F%98%E9%87%8F.png?alt=media\&token=7babc928-e2e5-4242-a0dc-945baddc6781)

### 场景二：计数器类型的埋点事件（有关联事件级变量）

> 以”登录成功“这个事件为例，打点记录登录成功的次数，同时需要区分不同登录方式对应的登录成功次数。
>
> 那么”登录方式“就作为”登录成功“这个事件的属性，也就是事件级变量。

**事件配置方式示例**

| 标识符          | 名称   | 事件级变量 | 类型  | 描述     |
| ------------ | ---- | ----- | --- | ------ |
| loginSuccess | 登录成功 | 登录方式  | 计数器 | 登陆成功次数 |

**事件级变量配置方式示例**

| 标识符           | 名称   | 类型  | 描述                 |
| ------------- | ---- | --- | ------------------ |
| loginWay\_var | 登录方式 | 字符串 | 登录方式，取值包括QQ、微信、手机等 |

**对应的代码**

此示例中的自定义事件为”登录成功（loginSuccess）“，关联一个事件级变量为”登录方式（loginWay\_var）“。

| 平台          | 原型                                                                                    | 代码示例                                                                                       |
| ----------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| JS SDK      | gio('track', eventId, eventLevelVariables);                                           | gio('track', 'loginSuccess', {loginWay\_var':'QQ'})                                        |
| Android SDK | GrowingIO.getInstance().track(`String` eventId, `JSONObject` eventLevelVariables);    | GrowingIO.getInstance().track("loginSuccess", new JSONObject().put("loginWay\_var","QQ")); |
| iOS SDK     | <p>+(void)track:(NSString *)eventId withVariable:</p><p>(NSDictionary *)variable;</p> | \[Growing track:@"loginSuccess" withVariable: @{@"loginWay\_var":@"QQ"}];                  |

**数据验证方法**

在对应的应用（网站、Android 或者 iOS App）中触发登录成功事件，通过 Debugger 工具验证数据准确性。

按照如下流程图进行验证：

![](https://2602900487-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo08UtW7H58ehFKeZ4g%2F-LrMZ4OGPue--zLpArFR%2F-LrMZ9Sh12jC1ktq1iFb%2Fcstm2x2.png?alt=media\&token=a63d5134-f349-4059-8342-bf244bd4a695)

在本例中，如下图的数据请求说明打点代码生效

![](https://2602900487-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo08UtW7H58ehFKeZ4g%2F-LrHbLj2hOyV02mKy_h9%2F-LrHfc2jCe7e2kpsQqAU%2Fcstm%E4%BA%8B%E4%BB%B6%E9%AA%8C%E8%AF%812.png?alt=media\&token=799d5a62-95be-4845-80b9-a95d5acd2ec1)
