过滤器数据终端

Filters Data 端点可用于获取过滤器选项列表。用来在报告服务 API 套件中过滤向其他终端的调用。

您可以在我们的Datascape 指标术语表中查看完整指标列表。

操作前须知

要使用该终端，您需要 Adjust API 识别码。请按照验证指南中的说明操作，获得识别码。

终端

1
GET https://automate.adjust.com/reports-service/filters_data

GET 请求

返回过滤器项目列表。请使用返回对象的id字段过滤其他 API 调用。

参数

参数	数据类型	位置	描述
`required_filters`*	`String`	查询	用逗号隔开的过滤器列表。请查看下方 “必要过滤器” 表格，获取值的列表。
`[required_filters]__contains`	`String`	查询	输入搜索词条，在对象 id 和name字段中查找完全或部分匹配的结果。

必要过滤器

过滤	描述
`ad_revenue_sources`	返回广告收入来源列表。
`ad_spend_mode`	返回广告支出模式列表。示例：attribution；network；mixed。
`apps`	返回应用列表。
`apps_network`	返回应用和相应应用商店 ID 的列表。
`attributes`	返回推广变量列表。
`attribution_types`	返回归因类型列表。示例：点击、展示、engaged_ad。
`attribution_source`	返回归因来源列表。
`attribution_status`	返回归因状态列表。
`channels`	返回渠道列表。
`cohort_maturity`	返回同期群成熟度选项列表。示例：immature
`countries`	返回国家/地区列表。
`currencies`	返回货币币种列表。
`dimensions`	返回维度列表。
`full_cohort_periods`	返回同期群相关时间周期的列表。
`iap_revenue_mode`	返回广告收入模式列表。
`monetization_partners`	返回广告收入变现合作伙伴列表。
`networks`	返回渠道列表。
`os_names`	返回操作系统名称列表。
`partners`	返回合作伙伴列表。
`platform`	返回平台列表。示例：mobile_app
`period_over_period`	返回用于数据对比的时间周期列表。
`sdk_signature_version`	返回 SDK 签名版本列表。
`skad_time_adjustment`	返回有效 SKAdNetwork 活动窗口列表。
`store_type`	返回应用商店列表。
`subscription_revenue_mode`	返回广告收入模式列表。
`utc_offset`	与 UTC 时区的时差（按小时），默认为 0 (UTC)。

响应

终端返回以下响应：

响应	消息	注意事项
`200`	`Success`	返回报告信息
`204`	`No content`	响应对象为空时
`400`	`Bad request`	请求格式错误或包含不受支持的参数
`401`	`Unauthorized`	您的凭证不正确或缺失
`403`	`Forbidden`	您没有访问此信息的权限
`429`	`Too many requests`	超过速率限制时则返回此响应
`503`	`Service unavailable`	无法连接服务器
`504`	`Gateway timeout`	查询返回响应时间过长

成功响应

1
{
2
   "required_filters_1": [
3
      {
4
         "id": "string",
5
         "name": "string",
6
         "short_name": "string",
7
         "section": "string",
8
         "formatting": "string",
9
         "description": "string"
10
      }
11
   ],
12
   "required_filters_2": [
13
      {
14
         "id": "string",
15
         "name": "string",
16
         "short_name": "string",
17
         "section": "string",
18
         "formatting": "string",
19
         "description": "string"
20
      },
21
      {
22
         "id": "string",
23
         "name": "string",
24
         "short_name": "string",
25
         "section": "string",
26
         "formatting": "string",
27
         "description": "string"
28
      }
29
   ]
30
}

参数

参数	数据类型	描述
`id`	`String`	过滤器项目的 ID，用来过滤 API 调用。
`name`	`String`	过滤器项目的可读名称。
`short_name`	`String`	过滤器项目的缩略名称。
`section`	`String`	过滤器项目相关的 section。
`formatting`	`String`	过滤器项目的数据格式。示例：`money` 、 `decimal` 、 `string`。
`description`	`String`	过滤器项目的描述。

示例

curl --location --request GET 'https://automate.adjust.com/reports-service/filters_data?required_filters=dimension,ad_spend_modes&dimensions__contains=source' \
--header 'Authorization: Bearer {API_TOKEN}'

{
   "ad_spend_mode": [
      {
         "id": "adjust",
         "name": "Attribution",
         "short_name": "",
         "section": "",
         "formatting": null,
         "description": ""
      },
      {
         "id": "mixed",
         "name": "Mixed",
         "short_name": "",
         "section": "",
         "formatting": null,
         "description": ""
      },
      {
         "id": "network",
         "name": "Network",
         "short_name": "",
         "section": "",
         "formatting": null,
         "description": ""
      }
   ],
   "dimensions": [
      {
         "id": "source_id_network",
         "name": "Source ID",
         "short_name": "",
         "section": "",
         "formatting": null,
         "description": "The ID of the app where the ad was placed."
      },
      {
         "id": "source_network",
         "name": "Source name",
         "short_name": "",
         "section": "",
         "formatting": null,
         "description": "The name of the app where the ad was placed."
      }
   ]
}