We constantly publish updates to our documentation, which may not yet be available in your language. For the most current information, use the English version.

开发者

过滤器数据终端

通过过滤器数据终端，您可以调取有效指标列表，用来在报告服务 API 套件中过滤向其他终端的调用。

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

操作前须知

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

终端

https://dash.adjust.com/control-center/reports-service/filters_data

GET 请求

返回过滤器项目列表。这些项目与您在 Automate 可访问的 KPI 相对应。请使用返回对象的id字段过滤其他 API 调用。

参数

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

必要过滤器

过滤器	描述
`apps`	返回应用列表。
`apps_network`	返回应用和相应应用商店 ID 的列表。
`overview_metrics`	返回概览指标列表。
`skad_metrics`	返回 SKAdNetwork 相关指标列表。
`cohort_maturity`	返回同期群成熟度相关的指标列表。示例： `mature`、`immature`。
`cohort_metrics`	返回同期群相关指标列表。
`event_metrics`	返回事件相关指标列表。每个事件都重复所有指标。
`cost_metrics`	返回成本相关指标列表。
`etl_metrics`	返回 Adjust 和另一系统间 ETL (抽取、转换、加载) 过程的相关指标列表。
`dimensions`	返回维度列表。
`countries`	返回国家/地区列表。
`currencies`	返回货币币种列表。
`os_names`	返回操作系统名称列表。
`networks`	返回渠道列表。
`partners`	返回合作伙伴列表。
`ad_revenue_sources`	返回广告收入来源列表。
`ad_revenue_mode`	返回广告收入模式列表。
`attribution_type`	返回归因类型列表。示例： `all`、 `click` 、 `impression`。
`attribution_source`	返回归因来源列表。
`attribution_status`	返回归因状态列表。
`cost_mode`	返回成本模式列表。示例： `attribution`、 `network` 、 `mixed`。
`ad_spend_mode`	返回广告支出模式列表。示例： `attribution`、 `network` 、 `mixed`。
`utc_offset`	与 UTC `0` 时区的时差（按小时）。
`attributes`	返回推广变量列表。
`index`	返回与所有应用相关的重要指标列表。
`period_over_period`	返回用于数据对比的时间周期列表。
`cohort_metric_names`	返回同期群指标的可读名称列表。
`full_cohort_periods`	返回同期群相关时间周期的列表。
`store_type`	返回应用商店列表。
`skad_time_adjustment`	返回有效 SKAdNetwork 活动窗口列表。

Section

Section	描述
`conversion`	点击和展示转化相关指标。
`fraud`	防作弊相关指标。
`cost`	成本相关指标。
`revenue`	应用收入相关指标。
`retention`	基于同期群的用户留存相关指标。
`events`	事件相关指标。
`conversion_events`	SKAdNetwork 转化事件相关指标。
`installs`	应用安装和重装相关指标。
`conversion_values`	SKAdNetwork 转化值相关指标。

响应

终端返回以下响应：

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

成功响应

{
   "required_filters_1": [
      {
         "id": "string",
         "name": "string",
         "short_name": "string",
         "section": "string",
         "formatting": "string"
      }
   ],
   "required_filters_2": [
      {
         "id": "string",
         "name": "string",
         "short_name": "string",
         "section": "string",
         "formatting": "string"
      },
      {
         "id": "string",
         "name": "string",
         "short_name": "string",
         "section": "string",
         "formatting": "string"
      }
   ]
}

参数

参数			数据类型	描述
`required_filters`			数组<对象>	包含过滤器对象的数组。添加到调用中的每个 `required_filter` 都会返回一个数组。
	Returned value		对象	返回的过滤器项目。
		`id`	字符串	过滤器项目的 ID，用来过滤 API 调用。
		`name`	字符串	过滤器项目的可读名称。
		`short_name`	字符串	过滤器项目的缩略名称。
		`section`	字符串	过滤器项目相关的 section。
		`formatting`	字符串	过滤器项目的数据格式。示例： `money`、 `decimal` 、 `string`。

示例

cURL

curl --location --request GET 'https://dash.adjust.com/control-center/reports-service/filters_data?required_filters=overview_metrics,cost_metrics&section=cost&overview_metrics__contains=ecpi&cost_metrics__contains=Ad spend' \
--header 'Authorization: Bearer {API_TOKEN}'

{
    "overview_metrics": [
        {
            "id": "ecpi_all",
            "name": "eCPI (All Installs)",
            "short_name": "eCPI (All)",
            "section": "Cost",
            "formatting": "money"
        },
        {
            "id": "ecpi",
            "name": "eCPI (Paid Installs)",
            "short_name": "eCPI (Paid)",
            "section": "Cost",
            "formatting": "money"
        }
    ],
    "cost_metrics": [
        {
            "id": "network_cost",
            "name": "Ad Spend (Network)",
            "short_name": "",
            "section": "Cost",
            "formatting": "decimal"
        },
        {
            "id": "network_cost_diff",
            "name": "Ad Spend Diff (Network)",
            "short_name": "",
            "section": "Cost",
            "formatting": "decimal"
        }
    ]
}