一、功能简介

穿山甲开发者平台上线数据预警功能，开发者可通过设置数据预警，对核心指标最近一天的数据进行监控。指标命中设定规则后，会触发报警并发出报警通知。其中：

监控对象：开发者设置的核心指标最近一天的数据；

数据粒度：账号、应用、代码位；

数据指标：预估收益、点击量、ecpm等；

触发条件：不同对比方式，包括同比、环比、特定值数据对比；

预警通知方式：站内信、邮件；

预警通知时间：中国区媒体媒体10点前发出预警；

二、功能优势

开发者使用数据预警功能，可以对核心指标进行数据监控，及时了解数据波动情况、快速响应。

三、功能位置

四、组成模块

数据预警功能主要由预警报告、预警设置两个模块组成，其中：

- 预警报告：展示具体的预警触发结果，开发者可查看预警触发详情、对应数据报告；

- 预警设置：支持开发者新建预警、支持条件筛选查看已创建预警信息、编辑/开启/关闭/删除数据预警等；

五、使用说明

1、预警设置页面

在“预警设置页面”，开发者可以：

- 查看已创建的预警列表，支持条件筛选；

- 新建数据预警；

2、预警列表页

在“预警列表页”页面支持查看当前已创建的数据预警，支持预警筛选模块、列表展示模块、新建预警等功能；

1. 列表表格展示信息

不同的账号权限展示数据预警不一样，具体表格展示信息如下：

- 主账号：可以查看自己创建的预警，以及子账号创建的预警（不能进行编辑操作等）；

- 子账号：仅可以查看自己创建的数据预警；

- 预警名称：点击预警名称可进入“预警详情”页面

- 创建人：预警对应的创建账号名称

- 最近更新时间：预警设置修改的最近更新时间；

- 最近通知时间：展示最近一次预警通知时间，如果没有显示--；

- 数据粒度：数据预警监控的数据指标粒度；

- 触发条件：数据预警需要监控的条件规则

- 预警方式：设置的预警通知方式；

- 预警状态：分为开启中、已关闭两个状态，如果为自己创建的预警，可以对状态进行修改；

- 操作：

- 查看报告：点击则跳转到预警报告页面；

- 编辑：点击则进入预警详情编辑页面；

- 删除：点击则对数据预警进行删除（二次确认是否需要删除），删除后数据预警对应的数据报告将也被删除；

2. 筛选模块

筛选器包含预警名称（输入筛选，模糊匹配）、预警维度（下拉筛选）、预警状态（下拉筛选）、创建人（下拉筛选，仅主账号显示此筛选器）。

3、 新建预警页

点击新建预警，则进入新建预警页面。开发者通过设置想要的预警条件，以及通知方式，完成数据预警的创建过程，一个账号最多可创建20条数据预警（开启状态中）。

1. 预警名称：最长输入20字

2. 数据粒度：数据预警监控的数据指标粒度，选项包含：账号、应用、代码位类型、代码位

1）账号：只有主账号才可以监控账号粒度的指标数据；

2）应用：监控账号权限下应用数据，如某运营账号A，只有应用a、应用b两个应用的数据权限，则只支持监控应用a、应用b这两个应用的指标数据；

3）代码位类型：监控账号权限下应用对应代码位类型数据，如某运营账号A，只有应用a、应用b两个应用的数据权限，则只支持监控应用a、应用b这两个应用对应的代码位类型指标数据；

4）代码位：监控账号权限下应用对应代码位数据，如某运营账号A，只只有应用a、应用b两个应用的数据权限，则只支持监控应用a、应用b这两个应用对应代码位指标数据；

3. 触发条件

功能支持设置3条规则，以及设置规则之间的关系，满足全部条件、满足任一条件（且/或的关系）

1）指标：下拉单选项，具体指标支持在数据报表中看到的指标；

2）对比方式：支持高于（>=）、低于（<=）两种对比方式；

3）对比值：支持特定值、昨天、上周同期三种选项；

4）阈值：支持输入数值、百分比数值

- 对比值=特定值：仅支持输入数值；

- 对比值=昨天/上周同期，则支持输入数值/百分比两种类型；

举例：开发者在6月28日设置条件【预估收益低于上周同期30%】，则6月28日计算的是6月27日的预估收益X，对比6月20日的预估收益值Y，如果(X-Y)/Y*100%=A，如果A<=30%则触发预警；

4. 预警通知模块

1）预警发出时间：中国区媒体预计每天10点前发出预警；

2）通知方式：多选项，包含站内信、邮件，默认都勾选；

- 站内信：下拉选择站内信账号；

- 邮件地址：下拉选择需要接收数据预警的邮件地址；

4、 预警报告页面

在“预警报告”页面，开发者可以：

- 查看预警触发的消息详情，支持条件筛选；

- 查看对应数据报告；

- 其中，子账号可以看自己创建的预警对应报告，主账号可以看全部预警规则对应报告。

5、 预警报告列表页

数据预警报告列表页，展示数据预警规则+数据日期的数据，即一条数据预警，一天内只会存在一条记录，明细数据可在预警详情页进行查看。

1. 列表展示信息

- 数据时间：触发预警的日期时间

- 预警名称：预警名称

- 预警状态：预警状态

- 数据粒度：预警设置中信息，数据时间执行时对应设置的数据粒度；

- 通知时间：触发预警对应的通知时间；

- 通知人数：触发预警对应的通知人数（分站内信/邮件）；

- 实际触发条数：实际触发预警的明细总条数；

- 操作：查看报告详情，点击则跳转到预警详情页面

2. 筛选器

筛选器包含预警名称（下拉筛选）、数据时间、预警维度（下拉筛选）、预警状态（下拉筛选）

6、 预警报告详情页

报告详情页展示数据预警对应实际触发明细数据，预计对应的触发值。

1. 预警基本信息模块

预警基本信息模块，展示的是执行数据预警时对应的设置信息，具体包含数据时间、预警名称、预警状态、数据粒度、通知时间、通知人数、触发条件。

注意：预警触发规则为当前时间的配置规则，规则修改不影响修改前的预警触发条件。

举个例子：

1）配置的预警规则为：触发条件为代码位粒度，预估收益低于上周同期10%时触发预警

6月28日执行预警规则时，跑27号的数据，此时有20个代码位触达预警

2）28号下午修改数据预警条件：改为预估收益低于上周同期30%时触发预警（次日生效）

6月29号执行预警规则时，跑28号的数据，此时有5个代码位触发预警

3）查看数据报告的详情页时

1. 查看6月28号的预警基本信息模块，规则为：预估收益低于上周同期30%

2. 查看6月27号的预警基本信息模块，规则为：预估收益低于上周同期10%

2. 预警报告详情

报告详情表格展示信息包含

- 预警对象：不同的预警数据粒度，对应的预警对象展示信息不一样

- 账号粒度：展示账号名称、账号ID

- 应用粒度：展示应用名称、应用ID

- 代码位类型粒度：展示代码位类型

- 代码位粒度：展示代码位名称、代码位ID

- 实际触发数值：展示实际触发数值，不同的触发条件下，展示数据不一样

比如设置触发条件为：展示量高于1000时触发预警

实际触发数值：代码位ID XXX，【展示量：3153】比特定值：+2153

- 操作：查看更多数据，点击则跳转到广告收益报告页面，带上当前的数据日期+预警对象ID的筛选条件，可以更加快速完成分析，确认当前预警是否符合预期。

六、版本更新