流量分组
1. 流量分组介绍
不同的流量分组可以设置不同的瀑布流配置，开发者可根据实际的流量情况，进行不同规则下的流量分组，从而进行精细化的运营。
2. 流量分组规则
ToBid现支持的流量分组维度如下：设备ID、应用版本、SDK版本、user_ID、网络类型、国家/地区、省份、IDFA状态、设备类型等。
3. 流量分组规则说明
3.1 在瀑布流中添加流量分组
3.2 分组规则介绍
| 规则 | 条件 | 描述 | 示例 |
|---|---|---|---|
| 应用版本 | 包括、不包括 | 应用版本名称(App Version Name)，可填多个应用版本，用英文逗号分隔 | 1.100,1.107 |
| SDK版本 | 包括、不包括 | ToBid SDK版本，包括和不包括时，可填多个SDK版本号，用英文逗号分隔 | 3.5.0 |
| 设备ID | 包括、不包括 | 可填多个设备ID ，用英文逗号分隔。 安卓支持：GAID、OAID、IMEI iOS支持：IDFA | 28968E75-E7BE-4AA2-BFA0-C455DD74C111 |
| IDFA状态 | 包括、不包括 | 只针对iOS应用有该选项，可选有IDFA或无IDFA | 有IDFA |
| User ID | 包括、不包括 | App 用户体系内标识用户的id（类似游戏账号），可通过SDK user_id 方法传入 | 1234567890 |
| 网络类型 | 包括、不包括 | 可选择wifi、5G、4G、3G、2G | 5G |
| 国家/地区 | 包括、不包括 | 对于选择全球的流量，仅支持国家/地区维度，不支持下探到省份 | 中国、台湾 |
| 省份 | 包括、不包括 | 对于中国大陆地区，提供省份、城市的规则选择 | 北京市、上海市、三亚市 |
| 设备类型 | 包括、不包括 | 只针对iOS应用有该选项，可选iPad或iPhone | iphone |
| 渠道 | 包括、不包括 | 开发者的买量渠道，支持填入多个渠道号，用英文逗号隔开，渠道号需先通过SDK的自定义规则传入 | sigmob |
| 子渠道 | 包括、不包括 | 开发者的买量子渠道，支持填入多个子渠道号，用英文逗号隔开，渠道号需先通过SDK的自定义规则传入 | sigmob |
| 应用安装来源 | 包括、不包括 | 安装本应用的来源，需先通过SDK的自定义规则传入。 | com.android.vending |
| 自定义规则 | 包括、不包括 | 开发者自定义的流量分组属性，通过SDK的自定义规则传入Key-Value 对 | age=18,20&gender!=male |
| 安装时间 | 大于，小于 | 安装时间规则依赖于 ToBid SDK 2.7.0 版本及其以上，开发者可使用ToBid 内置获取的时间或通过初始化方法传入安装时间。 | |
| 选择自然日指的是安装日期到请求日期，默认时区是北京时间。 | |||
| 单位可选：天、小时、周、自然日 | |||
| 操作系统版本 | 包含、排除、大于、小于 | 填写明确的系统版本号，在包含/排除选项时可填写多个版本号，在选择大于/小于时仅可输入一个版本号 | 13.5.0 |
| 日期 | 包含、排除 | 用户请求广告的日期处于设置的日期范围内，则满足此分组条件。设置多个日期段，满足其一即满足条件。时区为UTC+8 | 2023-07-13 00:00 ~ 2023-07-22 23:59 |
| 小时 | 包含、排除 | 用户请求广告的小时处于指定的小时时间段，则满足此分组条件。设置多个小时时间段，满足其一即满足条件。时区为UTC+8 | 周三 |
| 星期 | 包含、排除 | 用户请求广告的日期处于指定的周几，则满足此分组条件。时区为UTC+8 | 00:00~04:04 |
3.3 自定义分组规则使用介绍
ToBid 支持开发者拓展设置自定义的分组条件，开发者可以根据自己的业务诉求调用 SDK 方法传入自定义属性。其次在ToBid 平台自定义流量分组规则中配置对应的自定义规则，ToBid 服务端会根据开发者设置的规则进行流量匹配。目前支持包括(=)、不包括(!=)逻辑运算，并且同一个自定义 key 支持多 value，例如 age=18,20&gender!=male
ToBid SDK v1.9.0 版本开始支持
3.3.1 自定义规则设置方法
- Android 自定义规则方法
java
Map<String, String> customMap = new HashMap<>();
customMap.put("user_source", "huawei");// 流量安装来源：oppo、华为等，开发者自己传
customMap.put("channel", "toutiao");// 买量渠道：穿山甲、快手、sigmob等
customMap.put("sub_channel", "toutiao");// 买量子渠道：穿山甲、快手、sigmob等
WindMillAd.sharedAds().initCustomMap(customMap); // App的自定义规则为全局设置，对全部Placement有效- iOS 自定义规则方法
objective-c
** NSDictionary *customData = @{**
** @"user_source": @"Apple Store", // 流量安装来源**
** @"channel": @"穿山甲", //**买量**渠道**
** @"sub_channel": @"穿山甲", // 买量子渠道**
**};**
**
**[WindMillAds initCustomGroup:customData];3.3.2 自定义规则预设 Key
ToBid SDK 在自定义规则中，预设置了以下键值
| Key | 说明 |
|---|---|
| channel | 开发者自定义买量渠道信息，调用SDK方法传入 |
| sub_channel | 开发者自定义买量渠道子渠道信息，调用SDK方法传入 |
| user_source | 安装本应用的来源，需先通过SDK的自定义规则传入。 |
为了防止字符串解析错误，自定义规则的 value 值禁止传入 \t ~ | \n
4. 使用流量分组
4.1 默认分组
系统会自动为每个聚合广告位下创建一个默认的流量分组。该分组不可编辑名称、不可删除且不可关闭，代表着开发者的应用所有流量请求，在没有其他规则的情况下，都会命中该分组的瀑布流配置。
即如果在同一个聚合广告位下创建多个流量分组，当所有分组规则都不满足流量特征后（如版本号、设备号、地域等），该默认分组将被作为兜底策略，进行广告下发。
4.2 自定义分组的使用
- 在瀑布流中为聚合广告位创建多个流量分组时，各个流量分组会有优先级，流量分组名称的前缀数字代表优先级，即从左向右，优先级依次降低。当同时命中多个流量分组时，ToBid会返回最高优先级的流量分组的瀑布流配置。
- 如已创建的流量分组需要暂时关闭，可点击页面内的分组开关按钮进行关闭操作。关闭后的流量分组将会在【已停用的分组】中展现，可通过下拉框进行选择查看。同时，服务端将不再对已关闭的分组进行规则判断，不会下发相应的瀑布流配置。
4.3 批量管理流量分组
- 在瀑布流管理页面内，点击【批量管理分组】，即可查看已创建的所有流量分组相应的瀑布流配置，如超时时长、并行请求数等通用配置。
- 在批量管理分组的页面内，可通过下拉框选择已开启分组/已关闭分组。并可直接拖动分组，进行优先级的调整。
- 勾选流量分组，可选择需要操作项，进行批量修改
