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

パフォーマンスチャート

アプリケーションのパフォーマンスチャートには、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)必須統計を取得する期間の終了日。from と to の間隔は 120 日を超えることはできません。例: 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 (総額)。
⚠️
期間の上限

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
}
}