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

获取转化数据

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

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

from_periodstring | nullrequired

用户转化前的订阅起始状态

to_periodstringrequired

用户转化后的新订阅状态

period_unitstring

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

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

date_typestring

指定将哪个日期作为用户加入日期

One of: "purchase_date", "profile_install_date"

segmentationstring

设置市场细分的依据

formatstring

指定导出文件格式

One of: "json", "csv"

Responses

成功获取转化数据

Schema

包含转化数据的响应，展示用户在订阅状态之间的流转情况

dataarray of object

转化数据点数组（聚合数据图表可能为空）

valuenumber

转化率数值

value_frominteger

转化的起始订阅状态

value_tointeger

转化的目标订阅状态

compare_value_fromnumber

对比周期的起始值

compare_value_tonumber

对比周期的结束值

titlestring

描述转化类型的显示标题

typestring

转化数据图表的类型

default_aggregationstring

该数据图表的默认聚合方式

descriptionstring

转化率计算方式的详细说明

metric_namestring

转化数据图表的内部名称

is_jsonboolean

数据是否为 JSON 格式

unitstring

计量单位（转化率通常为 'percent'）

recommended_periodobject

该转化数据图表的建议日期范围

date_fromstring

建议周期的开始日期

date_tostring

建议周期的结束日期

period_unitstring

建议的周期单位

Example 
{
  "data": [],
  "value": 0,
  "value_from": 0,
  "value_to": 0,
  "compare_value_from": null,
  "compare_value_to": null,
  "title": "Conversion rate from Paid to more than 6 months",
  "type": "multi",
  "default_aggregation": "sum",
  "description": "If Х - the number of the 1st payments taken during the selected date, and Y - the amount of the renewals that happened after the 6 months since the selected date from those 1st payments, then Conversion = (Y / X) * 100%. For example, we had 100 1st subscriptions of various products on the 1st of January and among them 20 renewed on the 1st week of July (the 25th payment). On the 8th of July, we open the chart and see the conversion of the 1st of January = (20 / 100) * 100% = 20%. Then 30 more subscribers of the 1st of January renewed by the start of August (the 8th payment). We open the chart on the 1st of August and see that the conversion of the 1st of January = ((20+30) / 100) * 100% = 50%. This number shows which part of those who had their 1st payment on the 1st of January converted to the period > 6 months with any number of payments by the current moment.",
  "metric_name": "from_paid_to_6_months_conversion",
  "is_json": true,
  "unit": "percent",
  "recommended_period": {
    "date_from": "2018-04-29",
    "date_to": "2024-12-31",
    "period_unit": "month"
  }
}

错误请求

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 次请求。