English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語
POST /api/v1/client-api/metrics/funnel/

获取漏斗数据

Copy as Markdown

获取漏斗数据，以追踪用户在转化流程各阶段的进展情况。

速率限制：每秒 2 次请求。

Request body

filtersobjectrequired
datearray of stringrequired

输入您想要检索数据图表数据的日期或时间段

compare_datearray of string

输入用于对比的日期或时间段

storearray of string

按购买所在的应用商店进行筛选

countryarray of string

按购买发生地的两字母国家代码进行筛选

store_product_idarray of string

包含商店前缀的产品 ID，格式为 <store>:<product_id>，例如 app_store:premium_monthly 或带有基础计划的 Google 订阅 play_store:premium_sub:monthly-base-plan。不带商店前缀的纯产品 ID 将被拒绝。

durationarray of string

指定订阅时长

attribution_sourcearray of string

归因的来源集成

attribution_statusarray of string

表示归因是自然流量还是非自然流量

attribution_channelarray of string

带来该交易的营销渠道

attribution_campaignarray of string

带来该交易的营销活动

attribution_adgrouparray of string

带来该交易的归因广告组

attribution_adsetarray of string

带来该交易的归因广告集

attribution_creativearray of string

广告或营销活动中用于衡量效果的特定视觉或文字素材

offer_categoryarray of string

指定您想要检索数据的优惠类别

offer_typearray of string

指定您想要检索数据的优惠类型

offer_idarray of string

指定您想要检索数据的具体优惠

period_unitstring

指定用于聚合分析数据的时间间隔

One of: "day", "week", "month", "quarter", "year"

show_value_asstring

指定值的显示方式

One of: "absolute", "relative", "both"

segmentationstring

设置市场细分的依据

formatstring

指定导出文件格式

One of: "json", "csv"

Responses

漏斗数据获取成功

Schema

包含漏斗分析数据的响应，展示用户在转化阶段的进展情况

dataarray of object

漏斗市场细分数组，展示转化流程的不同阶段

titlestring

此漏斗细分的显示标题

typestring

漏斗细分的类型（'total' 表示汇总数据）

valuesarray of object

漏斗值数组，展示各阶段的转化进程

periodinteger

漏斗中的阶段编号（-2 = 安装，-1 = 付费墙已展示，以此类推）

titlestring

该漏斗阶段的显示标题

valueinteger

到达该阶段的用户数量

value_relativenumber

到达该阶段的用户占第一阶段用户的百分比

relative_changesnumber

与上一阶段相比的转化率变化

following_changesobject

在该阶段之后流失的用户信息

titlestring

流失阶段的标题

valueinteger

流失的用户数量

value_relativenumber

流失用户的百分比

churn_reason_titlestring

描述该阶段用户流失原因的标题

churn_reasonsarray of object

具体流失原因的数组

valuesarray of object

该漏斗阶段的额外嵌套数值

Example 
{
  "data": [
    {
      "title": "Total",
      "type": "total",
      "values": [
        {
          "period": -2,
          "title": "Install",
          "value": 2,
          "value_relative": 100,
          "relative_changes": 0,
          "following_changes": {
            "title": "Drop off",
            "value": 2,
            "value_relative": 100
          },
          "churn_reason_title": "",
          "churn_reasons": [],
          "values": []
        },
        {
          "period": -1,
          "title": "Paywall displayed",
          "value": 0,
          "value_relative": 0,
          "relative_changes": 0,
          "following_changes": {
            "title": "Drop off",
            "value": 0,
            "value_relative": 0
          },
          "churn_reason_title": "",
          "churn_reasons": [],
          "values": []
        }
      ]
    }
  ]
}

错误请求

Schema
errorsarray of object
sourcestring
errorsarray of string
error_codestring
status_codeinteger

未授权

Schema
errorsarray of object
sourcestring
errorsarray of string
error_codestring
status_codeinteger

超出速率限制。每个 API 密钥每秒最多 2 次请求。