素材数据报表

约 875 字大约 3 分钟

此接口用于获取引力后台素材报表页数据，包括素材展点消数据、产品后向回收等数据指标。

数据更新频率

素材报表的后向数据为 T+1 更新一次
媒体消耗数据每隔 1h 更新一次

申请引力开发者应用

在正式接入本接口之前，您需要在引力后台-引力开发者open in new window页面申请引力开发者应用，申请之后，我们将在一个工作日内完成审核，审核通过之后，您的开发者应用才可以正常拉取数据。

创建好开发者应用之后，请复制app_key参数，并发送给研发同学以供后续接口调用使用。

接口限频

默认接口限频：每 10 分钟 1 次，接口限频是按开发者应用维度，即同一个app_key下限频共用同一套频次统计。如果开发者绑定应用过多，导致频繁触发限频，请联系引力运营评估后提升限频等级。

接口信息

请求地址

https://backend.gravity-engine.com/openapi/api/v1/report/material_get/open in new window

请求方法

POST

字段	类型	描述
Authorization	string	具体如何生成，请参考【签名生成】

body 请求参数

字段	必填	参数类型	描述
data_dims	Y	string[]	数据维度列表，单选数组，可选枚举值：material = '素材'、album_id = '专辑'、designer_id = '设计师'、creative_user_id = '创意人'。举例： ["material"]表示按素材维度
date_dims	Y	string	日期维度，字符串，可选枚举值：day = 分日、week=分周、month = 分月、total = 汇总。举例：day 表示按日拆分
date_list	Y	string[]	起始日期数组，格式 YYYY-MM-DD，举例： ["2023-08-14","2023-08-19"]
metrics_list	Y	string[]	指定需要的素材指标名称，不同媒体情况下，参考的指标不一样，分别如下：不限open in new window、巨量引擎open in new window、腾讯广告open in new window、磁力引擎open in new window
gravity_metrics_list	Y	string[]	指定需要的引力后向指标名称，参考这个open in new window文件
filters	Y	FilterObject	具体参见【FilterObject】
page	Y	number	当前页
page_size	Y	number	当前页大小
sign	Y	string	签名，详情请参考【签名生成】

FilterObject

必填筛选项：ad_platform，values 取值：

aggregate（不限）
kuaishou（快手）
bytedance（字节）
tencent（腾讯）

[
  {
    "field": "ad_platform",
    "operator": "EQUALS",
    "values": ["aggregate"]
  }
]

应答示例

主要关注 list、page_info 和 total，具体示例如下

{
  "data": {
    "list": [
      {
        "file_md5": "1fbf9bb1f352e6ca167ea1565fd37016",
        "gravity_material_id": "6411380209881088",
        "AdCost": 0.52,
        "AdShow": 301,
        "AdAvgShowCost": 1.7276,
        "AdClick": 10,
        "AdClickRate": 0.0332,
        "AdAvgClickCost": 0.052,
        "AdConvert": 0,
        "AdConvertCost": 0,
        "AdConvertRate": 0,
        "AdDeepConvert": 0,
        "AdDeepConvertCost": 0,
        "AdDeepConvertRate": 0,
        "AdAppActivate": 0,
        "AdAppActivateRate": 0,
        "AdAppActivateCost": 0,
        "AdAppRegister": 0,
        "AdAppRegisterRate": 0,
        "AdAppRegisterCost": 0,
        "AdAppFirstPay": 0,
        "AdAppFirstPayRate": 0,
        "AdAppFirstPayCost": 0,
        "AdAppFirstDayPay": 0,
        "AdAppFirstDayPayAmount": 0,
        "AdAppGamePay": 0,
        "AdAppGamePayCost": 0,
        "AdAppGamePayAmount": 0,
        "AdAppKeyActive": 0,
        "AdAppKeyActiveRate": 0,
        "AdAppKeyActiveCost": 0,
        "AdAppRetention": 0,
        "AdAppRetentionRate": 0,
        "AdAppRetentionCost": 0,
        "AppMultiDayGamePayAmountBuried_6": 0,
        "file_type": "video",
        "folder_id": 131297,
        "file_name": "上传测试16",
        "thumbnail_url": "https://gravity-client-resource.oss-cn-hangzhou.aliyuncs.com/1/video/1fbf9bb1f352e6ca167ea1565fd37016.mp4?spm=a2c4g.11186623.2.1.yjOb8V&x-oss-process=video/snapshot,t_7000,f_jpg,w_1080,h_1920,m_fast",
        "file_url": "https://gravity-client-resource.oss-cn-hangzhou.aliyuncs.com/1/video/1fbf9bb1f352e6ca167ea1565fd37016.mp4",
        "folder_name": "文件夹推送"
      }
    ],
    "page_info": {
      "page": 1,
      "page_size": 20,
      "total_number": 4,
      "total_page": 1
    },
    "total": {
      "AdCost": 4.75,
      "AdShow": 394,
      "AdAvgShowCost": 12.0558,
      "AdClick": 26,
      "AdClickRate": 0.066,
      "AdAvgClickCost": 0.1827,
      "AdConvert": 0,
      "AdConvertCost": 0,
      "AdConvertRate": 0,
      "AdDeepConvert": 0,
      "AdDeepConvertCost": 0,
      "AdDeepConvertRate": 0,
      "AdAppActivate": 0,
      "AdAppActivateRate": 0,
      "AdAppActivateCost": 0,
      "AdAppRegister": 0,
      "AdAppRegisterRate": 0,
      "AdAppRegisterCost": 0,
      "AdAppFirstPay": 0,
      "AdAppFirstPayRate": 0,
      "AdAppFirstPayCost": 0,
      "AdAppFirstDayPay": 0,
      "AdAppFirstDayPayAmount": 0,
      "AdAppGamePay": 0,
      "AdAppGamePayCost": 0,
      "AdAppGamePayAmount": 0,
      "AdAppKeyActive": 0,
      "AdAppKeyActiveRate": 0,
      "AdAppKeyActiveCost": 0,
      "AdAppRetention": 0,
      "AdAppRetentionRate": 0,
      "AdAppRetentionCost": 0,
      "AppMultiDayGamePayAmountBuried_6": 0
    },
    "update_at": {
      "tencent": "",
      "kuaishou": "",
      "bytedance": ""
    }
  },
  "extra": {
    "error": ""
  },
  "code": 0,
  "msg": "成功"
}

素材数据报表

# 申请引力开发者应用

# 接口限频

# 接口信息

# 请求地址

# 请求方法

# Header

# body 请求参数

# FilterObject

# 应答示例