表现图表

您可以通过 Aptoide Connect 开发者控制台，或以编程方式通过此 API 端点访问您应用的表现图表。

端点

方法	URL
GET	https://ws.catappult.io/api/applications/{applicationName}/statistics/chart

身份验证

要访问此 API，您需要在 Aptoide Connect 上拥有有效的账户订阅，并使用 API 密钥进行身份验证（请查看此处了解如何生成密钥）。

⚠️

所需的账户类型

表现数据只能由 Developer 类型的账户检索。

请求头

请求头	类型	是否必需	说明
Api-Key	string	必需	用于对您的 API 请求进行身份验证。其值为您的 Aptoide Connect API 密钥。

路径参数

参数	类型	说明
applicationName	string	应用的唯一软件包名称（例如 com.example.test）。

查询参数

参数	类型	是否必需	说明
type	string (YYYY-MM-DD)	必需	按类型筛选数据。可能的值：revenue、installs 或 downloads。
from	string (YYYY-MM-DD)	必需	检索统计数据的时间范围的开始日期。不得早于当前日期前 6 个月。示例：2024-01-01。
to	string (YYYY-MM-DD)	必需	检索统计数据的时间范围的结束日期。示例：2024-01-31。
aggregation	string	可选（默认值：day）	按所选周期聚合数据。可能的值：month 或 day。
countryCodes	string	可选	使用 ISO 3166-1 alpha-2 代码按一个或多个国家/地区进行筛选。多个代码必须用逗号分隔。示例：PT、US。
partnerAccountUids	string	可选	按一个或多个合作伙伴账户 UID 进行筛选。多个 UID 必须用逗号分隔。请参阅此处的合作伙伴列表。示例：b25f95eb-5da9-43a6-b24a-9096c7ecfcb8。
amountType	string	可选（默认值：wallet）	指定返回净收入还是总收入。仅当 type 为 revenue 时适用。可能的值：wallet（净值）或 global（总值）。

响应

成功

如果 API 调用返回 HTTP 200 状态代码，则表示请求成功，并返回一个表现图表对象，其中包含根据您的查询参数聚合的数据。

响应示例

类型： revenue

{
    "datasets": [
        {
            "data": [
                {
                    "arppu": 1.374375,
                    "arpt": 0.6467647058823529,
                    "transactions": 17,
                    "users": 8,
                    "volume": 10.995,
                    "volumeInUsd": 10.995
                },
                {
                    "arppu": 0.505,
                    "arpt": 0.505,
                    "transactions": 6,
                    "users": 6,
                    "volume": 3.03,
                    "volumeInUsd": 3.03
                },
                {
                    "arppu": 0,
                    "arpt": 0,
                    "transactions": 0,
                    "users": 0,
                    "volume": 0,
                    "volumeInUsd": 0
                },
                {
                    "arppu": 0,
                    "arpt": 0,
                    "transactions": 0,
                    "users": 0,
                    "volume": 0,
                    "volumeInUsd": 0
                },
                {
                    "arppu": 1.753125,
                    "arpt": 0.6875,
                    "transactions": 51,
                    "users": 20,
                    "volume": 35.0625,
                    "volumeInUsd": 35.0625
                }
            ],
            "identifiers": null
        }
    ],
    "labels": [
        "2023-11-30",
        "2023-12-01",
        "2023-12-02",
        "2023-12-03",
        "2023-12-04"
    ],
    "totals": {
        "arppu": 1.63625,
        "arpt": 0.6633445945945946,
        "raw": {
            "arppu": 1.63625,
            "arpt": 0.6633445945945946,
            "transactions": 74,
            "usd_revenue": 49.0875,
            "wallets": 30
        },
        "transactions": 74,
        "users": 30,
        "volume": 49.0875,
        "volumeInUsd": 49.0875
    }
}

类型： downloads

{
    "datasets": [
        {
            "data": [
                {
                    "total": 10
                },
                {
                    "total": 20
                },
                {
                    "total": 0
                },
                {
                    "total": 30
                },
                {
                    "total": 0
                }
            ],
            "identifiers": {}
        }
    ],
    "labels": [
        "2023-11-30",
        "2023-12-01",
        "2023-12-02",
        "2023-12-03",
        "2023-12-04"
    ],
    "totals": {
        "total": 60
    }
}