广告投放报表_进阶版

需要携带 Token，详情看Token

本章节文档将介绍广告投放报表_进阶版接口。

拉取报表数据时机说明

数据更新规则：

• 小时维度数据：通常在 2-3小时 完成统计。
• 日维度数据（T+1）：通常在 2-4小时 完成统计。

推荐拉取时间：

• 小时维度数据：建议在目标时间点 2.5小时后 拉取。
• 日维度数据：建议在 次日03:00后 拉取。

示例：

• 拉取1月1日10小时(10:00:00-10:59:59)的数据 → 建议 1月1日12:30后 操作。
• 拉取1月1日全天数据 → 建议 1月2日02:30后 操作。

请求步骤

你可以调整 dimension_option 参数进行查询特定的维度。调用该接口需分成两个步骤：

1. 首先需要设置参数 type=1 并调用接口，系统会在服务端异步生成好数据。

1.1 请求后需要等待数据生成，可继续用 type = 1 发起相同请求（Token需要更新）获取数据生成信息。

1.2 当接口返回码 code=200，说明数据已经成功生成。

1.3 如果拉取的是当天的数据，数据可能不完整，数据更新为小时维度，可等待n小时直至数据准备，再重新发起 type=1 请求更新以及获取新的数据生成信息，从而判断是否使用 type=2 更新数据。

1.4 数据的生成信息参考下文 type=1 的响应结果。

2. 数据生成后，设置参数 type=2 再次调用接口即可直接下载数据。

2.1 若数据还没生成完，调用 type=2 接口会返回非 200 的 code。

2.2 若数据已经生成，使用 type=2 接口会直接返回文件字节流（Content-Type: application/octet-stream）。

2.3 数据按"\t"分列，按"\n"分行。

2.4 返回的数据每次返回的是当前请求的所有数据，并不是增量数据。

请求地址

https://ss-api.mintegral.com/api/v2/reports/data

请求方法

GET

请求示例

GET /api/v2/reports/data?start_time=2024-06-01&end_time=2024-06-01&type=1&dimension_option=Offer
HTTP/1.1 Host: ss-api.mintegral.com

请求参数

type=2 返回的文件表头（字段）

type=1 的响应结果

type=2 的响应结果（code 不是 200）

应答示例

{
  "code": 200,
  "msg": "Generate success, please use type = 2 to get data",
  "data": {
    "hours": 24,
    "is_complete": true
  }
}