文档中心
> 开放平台
开放平台
开发者通过自定义报表接口，创建、查询个性化数据报表。该接口是官方标准数据接口的额外补充，解决开发者个性化数据报表需求，进而为商家提供差异化的数据服务。
产品特色
应用场景
自定义报表接口是官方标准数据接口的额外补充，能帮助开发者解决个性化数据报表的需求，进而为商家提供差异化的数据服务。
使用说明
调用流程
通过自定义报表接口，开发者可以完成个性化报表的配置及使用。业务流程如下图：
流程中各步骤使用到的接口如下：
| 编号 | 流程步骤 | 使用接口 |
|---|---|---|
| 1 |
获取自定义报表数据字典 |
不调用接口，开放平台提供excel文档，请下载附件 |
| 2 |
配置自定义报表 |
自定义报表规则创建及更新接口 自定义报表规则删除接口 自定义报表规则详情查询接口 自定义报表规则列表分页查询接口 |
| 3 |
查询自定义报表数据 |
自定义报表数据查询接口 |
1 获取自定义报表数据字典
开放平台提供自定义报表的数据字典，开放会员信息、会员交易明细、会员交易汇总、会员活动明细、会员活动汇总5个数据集，开发者可以使用数据集配置自定义报表规则。数据集及相关业务逻辑定义，请下载附件查看。
- 维度说明：每个数据集都标注了维度标志，维度为自定义报表中看数据的角度，如城市维度、店铺维度等。开发者可以按照操作符对维度进行加工操作。对应参数为附件中的“开放类型”列中的GROUP_BY字段。
- 度量说明：度量为自定义报表结果中查看数据的业务指标，如金额、笔数、会员数等。开发者可以按照操作符对度量进行加工操作。对应参数为附件中的“开放类型”列中的SELECT字段。
- 条件说明：条件自定义报表的基础数据筛选条件范围，如限定最近30天交易数据。开发者可以按照条件字段对报表做数据范围限定。对应参数为附件中的“条件操作符”列中的字段。
2 配置自定义报表
开发者根据开放平台提供的数据字典，配置自定义报表规则，语法，校验通过之后可以完成自定义报表的配置和修改。
自定义报表配置需要遵循一定的规则：
- 自定义报表必须包含维度和度量2个要素，本期最多支持2维度报表，即配置信息中最多支持2个GROUP_BY参数，后续初步放开。
- 如果自定义报表设置了多个条件字段，条件字段之间为“与”的组合逻辑。
- 自定义报表可以跨数据集配置规则，数据集数量不受限制，但建议避免多数据集使用以提升查询性能。
3 查询自定义报表数据
通过自定义报表数据查询接口，开发者可根据不同维度进行条件查询，自定义报表数据查询，并对结果进行排序。
- 查询条件说明，自定义报表时配置的维度字段默认情况下都可以作为报表查询的条件。
- 排序条件说明，定义排序字段，能对报表查询结果数据进行排序，默认按倒序排列。
应用案例
一、某餐饮行业ISV，通过自定义报表接口分析活动用户画像，展示年龄性别、生日、星座分布分析，让商家直观了解参与活动用户的显著特征，优化活动配置。
准入条件
- 公司运营稳定，具有一定的客户群。具体考核将参考公司运营时长、规模、用户数来做出综合判定。
- 公司具备一定的技术能力，能够独立完成技术对接。
- 支持合作后的服务联动处理，数据反馈和异议处理。
计费模式
免费接口，暂未收取费用。
本接口及文档资料由口碑提供。您使用本接口，需要遵守开放平台相关协议及口碑要求。
