パフォーマンスチャート
アプリケーションのパフォーマンスチャートには、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) | 必須 | 統計を取得する期間の終了日。from と to の間隔は 120 日を超えることはできません。例: 2024-01-31。 |
aggregation | string | 任意 (デフォルト: day) | 選択した期間単位でデータを集計します。指定可能な値: month、day。 |
countryCodes | string | 任意 | ISO 3166-1 alpha-2 コードを使用して 1 つ以上の国でフィルタリングします。複数のコードはカンマで区切ってください。例: PT,US。 |
partnerAccountUids | string | 任意 | 1 つ以上のパートナーアカウント UID でフィルタリングします。複数の UID はカンマで区切ってください。パートナー一覧はこちらを参照してください。例: b25f95eb-5da9-43a6-b24a-9096c7ecfcb8。 |
amountType | string | 任意 (デフォルト: wallet) | 純収益と総収益のどちらを返すかを指定します。type が revenue の場合にのみ適用されます。指定可能な値: wallet (純額) または global (総額)。 |
⚠️
期間の上限
1 回のリクエストで取得できる期間は最大 120 日であり、from に本日から 6 か月より前の日付を指定することはできません。
より長い期間については、代わりに パフォーマンスレポート (CSV) エンドポイントを使用してください。月次レポートごとに downloadUrl が返されるため、複数のチャートリクエストに分割することなく任意の期間をカバーできます。
レスポンス
成功
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
}
}