流量分组
一、流量分组说明
服务器会根据开发者传入key来做筛选项，会直接传给后台；没分组，会走默认组策略
1、TradPlus 上报数据
以下数据由TradPlus SDK上报，开发者不需要处理。
| 类别 | 参数 | 类型 | 条件 | 规则数量 | 描述 |
|---|---|---|---|---|---|
| app | 应用版本 | version | 包括、不包括 | 1 | 安卓填写versionName，ios填写version。包括和不包括时，可填多个版本号，用英文逗号分隔。 |
| app | 应用安装时间 | int | 范围、>、< | 1 | 从第一次初始化TradPlus SDK开始算起 |
| app | SDK版本 | version | 包括、不包括 、范围、>、< | 1 | TradPlus SDK版本，包括和不包括时，可填多个版本号，用英文逗号分隔。> 和<时，只能填写一个。 |
| device | IDFA | string | 包括 | 1 | 针对iOS14无法获取时，我们可以通过用户是否授权IDFA来创建一个流量分组归类这些设备。 |
| device | 设备ID | string | 包括 | 1 | web端可填多个设备ID ，用英文逗号分隔，设备ID可以是 IDFA, IDFV, GAID, OAID |
| device | 系统版本 | version | 包括、不包括 、>、< | 1 | 手机系统版本，包括和不包括时，可填多个系统版本号，用英文逗号分隔。>和<时，只能填写一个 |
| device | 设备类型 | string(ignoreCase) | 包括、不包括 | 1 | 可选择iPhone或iPad，可多选 |
| device | 设备制造商 | string(ignoreCase) | 包括、不包括 | 1 | 举例Huawei ，可多选 |
| device | 网络连接类型 | string | 包括 | 1 | web端可多选，可取值为：WiFi,2G,3G,4G,5G |
2、应用上报数据
以下数据由开发者根据需要，通过sdk接口上报。如果不上报，如下规则将无法在中介组中使用。
| 参数 | Key | 类型 | 条件 | 规则数量 | 描述 |
|---|---|---|---|---|---|
| 自定义用户ID | user_id | string | 包括 | 1 | Web端可输入多个ID,英文逗号分隔。另外，TradPlus 可基于此user id提供设备层级的变现数据（API）。 |
| 年龄 | user_age | int | 范围 、>、<, = | 多个 | 输入数字（0-99）， 单位 岁 |
| 性别 | user_gender | string | = | 1 | web端只能单选，可取值为：male、female；sdk端可传值：unknown、male、female |
| 游戏中等级 | user_level | int | 范围 、>、<, = | 1 | |
| 应用内付费金额 | user_iap_amount | float | 范围 、>、<, = | 1 | |
| 应用内付费币种 | user_iap_currency | string | = | 1 | 目前支持USD, CNY, EUR。 单选 |
| 应用内付费次数 | user_iap_count | int | >、<, = | 1 | |
| 渠道 | channel | string | 包括、不包括 | 1 | Web端支持填入多个渠道号，用英文逗号分隔，渠道号需要开发者在SDK中传入 |
| 子渠道 | sub_channel | string | 包括、不包括 | 1 | Web端支持填入多个子渠道号，用英文逗号分隔，子渠道号需要开发者在SDK中传入 |
| 自定义用户属性 | custom_xxx | string/int | 整数：范围，>、<, = ；字符串:包括，不包括 | 最多5个 | 应用通过Key-Value形式（key以’custom_’+字段名），传入自定义用户属性，如custom_username。最多支持5个。 |
| segment tag | segment_tag | string | 包括 | 1 | 如SDK上报segment_tag，会使用指定segment的waterfall配置。此参数匹配时，会无视其他参数。最多支持1个。 |
二、流量分组使用
1、APP全局自定义规则设置
- 需要在初始化SDK之前调用接口
| 平台 | 方法 |
|---|---|
| Android | SegmentUtils.initCustomMap(customMap); |
2、Placement自定义规则设置
- 需要在loadAd之前调用接口
| 平台 | 方法 |
|---|---|
| Android | SegmentUtils.initPlacementCustomMap("placementId", customMap); |
3、示例
- Android SDK代码示例
HashMap<String, String> customMap = new HashMap<>();
customMap.put("user_gender", "male");//男性
customMap.put("user_level", "10");//游戏等级10
SegmentUtils.initCustomMap(customMap);//设置APP维度的规则，对全部placement有效
SegmentUtils.initPlacementCustomMap("placementId", customMap);//仅对该广告位有效，会覆盖APP维度设置的规则