メインコンテンツまでスキップ

パフォーマンスチャート

アプリケーションのパフォーマンスチャートには、Aptoide Connect デベロッパーコンソールを介して、またはこの API エンドポイントを通じてプログラムでアクセスできます。

エンドポイント​

メソッドURL
GEThttps://ws.catappult.io/api/applications/{applicationName}/statistics/chart

認証​

この API にアクセスするには、Aptoide Connect でアクティブなアカウントサブスクリプションを持ち、API キーで認証する必要があります（生成方法はこちらを確認してください）。

⚠️
必要なアカウントタイプ

パフォーマンスデータは Developer タイプのアカウントでのみ取得できます。

ヘッダー​

ヘッダー型必須説明
Api-Keystring必須API リクエストの認証に使用します。値は Aptoide Connect の API キーです。

パスパラメータ​

パラメータ型説明
applicationNamestringアプリケーションの一意のパッケージ名（例: com.example.test）。

クエリパラメータ​

パラメータ型必須説明
typestring (YYYY-MM-DD)必須データをタイプでフィルタリングします。指定可能な値: revenue、installs、または downloads。
fromstring (YYYY-MM-DD)必須統計を取得する期間の開始日。現在の日付より 6 か月以上前であってはなりません。例: 2024-01-01。
tostring (YYYY-MM-DD)必須統計を取得する期間の終了日。例: 2024-01-31。
aggregationstring任意（デフォルト: day）選択した期間でデータを集計します。指定可能な値: month、または day。
countryCodesstring任意ISO 3166-1 alpha-2 コードを使用して、1 つ以上の国でフィルタリングします。複数のコードはカンマで区切る必要があります。例: PT、US。
partnerAccountUidsstring任意1 つ以上のパートナーアカウント UID でフィルタリングします。複数の UID はカンマで区切る必要があります。パートナーリストはこちらを参照してください。例: b25f95eb-5da9-43a6-b24a-9096c7ecfcb8。
amountTypestring任意（デフォルト: 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
    }
}