POST /api/v1/client-api/metrics/ltv/

ライフタイムバリュー（LTV）データの取得

Copy as Markdown

顧客のエンゲージメント期間における長期的な収益ポテンシャルを評価するための LTV データを取得します。

レート制限：1 秒あたり 2 リクエスト。

Request body

filtersobjectrequired

datearray of stringrequired

チャートデータを取得する日付または期間を入力します

compare_datearray of string

比較する日付または期間を入力します

storearray of string

購入が行われたアプリストアでフィルタリングします

countryarray of string

購入が行われた国の 2 文字の国コードでフィルタリングします

store_product_idarray of string

アプリストアのプロダクト固有識別子

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

データを取得する特定のオファーを指定します

period_unitstring

アナリティクスデータを集計する時間間隔を指定します

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

period_typestring

更新回数または日数でデータを分析します

One of: "renewals", "days"

segmentationstring

セグメンテーションの基準を設定します

formatstring

エクスポートファイルの形式を指定します

One of: "json", "csv"

Responses

LTV データを正常に取得しました

Schema

異なる収益タイプの LTV データを含むレスポンス

revenueobject

総収益を使用して計算した LTV

dataarray of object

異なるコホートの LTV データポイントの配列

titlestring

この LTV データポイントの表示タイトル

typestring

LTV データのタイプ（集計データの場合は 'total'）

valuenumber

このコホートの LTV 値

valuesarray of object

期間別 LTV 値の配列

cohort_sizeinteger

このコホートのユーザー数

descriptionstring

LTV の計算方法を説明する HTML の説明文

valuenumber

全体的な LTV 値

unitstring

測定単位（通常は 'USD'）

titlestring

この LTV 指標の表示タイトル

proceedsobject

プロシード（ストア手数料控除後）を使用して計算した LTV

dataarray of object

異なるコホートの LTV データポイントの配列

titlestring

この LTV データポイントの表示タイトル

typestring

LTV データのタイプ（集計データの場合は 'total'）

valuenumber

このコホートの LTV 値

valuesarray of object

期間別 LTV 値の配列

cohort_sizeinteger

このコホートのユーザー数

descriptionstring

LTV の計算方法を説明する HTML の説明文

valuenumber

全体的な LTV 値

unitstring

測定単位（通常は 'USD'）

titlestring

この LTV 指標の表示タイトル

net_revenueobject

純収益を使用して計算した LTV

dataarray of object

異なるコホートの LTV データポイントの配列

titlestring

この LTV データポイントの表示タイトル

typestring

LTV データのタイプ（集計データの場合は 'total'）

valuenumber

このコホートの LTV 値

valuesarray of object

期間別 LTV 値の配列

cohort_sizeinteger

このコホートのユーザー数

descriptionstring

LTV の計算方法を説明する HTML の説明文

valuenumber

全体的な LTV 値

unitstring

測定単位（通常は 'USD'）

titlestring

この LTV 指標の表示タイトル

Example

{
  "revenue": {
    "data": [
      {
        "title": "Total",
        "type": "total",
        "value": 0,
        "values": [],
        "cohort_size": 0
      }
    ],
    "description": "<div>LTV (Lifetime Value) is calculated as revenue for the period / number of subscribers on start.\n It's an actual, not predicted LTV.\n <a target=\"_blank\" rel=\"noopener noreferrer\" href='https://adapty.io/docs/ltv'> Read more</a>.</div>",
    "value": 0,
    "unit": "USD",
    "title": "LTV"
  },
  "proceeds": {
    "data": [
      {
        "title": "Total",
        "type": "total",
        "value": 0,
        "values": [],
        "cohort_size": 0
      }
    ],
    "description": "<div>LTV (Lifetime Value) is calculated as revenue for the period / number of subscribers on start.\n It's an actual, not predicted LTV.\n <a target=\"_blank\" rel=\"noopener noreferrer\" href='https://adapty.io/docs/ltv'> Read more</a>.</div>",
    "value": 0,
    "unit": "USD",
    "title": "LTV"
  },
  "net_revenue": {
    "data": [
      {
        "title": "Total",
        "type": "total",
        "value": 0,
        "values": [],
        "cohort_size": 0
      }
    ],
    "description": "<div>LTV (Lifetime Value) is calculated as revenue for the period / number of subscribers on start.\n It's an actual, not predicted LTV.\n <a target=\"_blank\" rel=\"noopener noreferrer\" href='https://adapty.io/docs/ltv'> Read more</a>.</div>",
    "value": 0,
    "unit": "USD",
    "title": "LTV"
  }
}

リクエストが不正です

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 キーごとに 1 秒あたり最大 2 リクエストです。

Try it

Authorization

Body

curl --request POST \
  --url 'https://api-admin.adapty.io/api/v1/client-api/metrics/ltv/' \
  --header 'Authorization: Api-Key YOUR_SECRET_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "filters": {
      "date": [
        "2024-01-01",
        "2024-12-31"
      ],
      "compare_date": [
        "2023-01-01",
        "2023-12-31"
      ],
      "offer_category": [
        "introductory"
      ],
      "store": [
        "app_store"
      ],
      "country": [
        "us"
      ],
      "attribution_source": [
        "appsflyer"
      ],
      "attribution_status": [
        "organic"
      ],
      "attribution_channel": [
        "social_media"
      ]
    },
    "period_unit": "quarter",
    "period_type": "renewals",
    "segmentation": "store_product_id",
    "format": "csv"
  }'

const response = await fetch('https://api-admin.adapty.io/api/v1/client-api/metrics/ltv/', {
  method: 'POST',
  headers: {
    'Authorization': 'Api-Key YOUR_SECRET_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "filters": {
      "date": [
        "2024-01-01",
        "2024-12-31"
      ],
      "compare_date": [
        "2023-01-01",
        "2023-12-31"
      ],
      "offer_category": [
        "introductory"
      ],
      "store": [
        "app_store"
      ],
      "country": [
        "us"
      ],
      "attribution_source": [
        "appsflyer"
      ],
      "attribution_status": [
        "organic"
      ],
      "attribution_channel": [
        "social_media"
      ]
    },
    "period_unit": "quarter",
    "period_type": "renewals",
    "segmentation": "store_product_id",
    "format": "csv"
  }),
});
const data = await response.json();

import requests

response = requests.post('https://api-admin.adapty.io/api/v1/client-api/metrics/ltv/', headers={
    'Authorization': 'Api-Key YOUR_SECRET_API_KEY',
    'Content-Type': 'application/json',
}, json={
      "filters": {
        "date": [
          "2024-01-01",
          "2024-12-31"
        ],
        "compare_date": [
          "2023-01-01",
          "2023-12-31"
        ],
        "offer_category": [
          "introductory"
        ],
        "store": [
          "app_store"
        ],
        "country": [
          "us"
        ],
        "attribution_source": [
          "appsflyer"
        ],
        "attribution_status": [
          "organic"
        ],
        "attribution_channel": [
          "social_media"
        ]
      },
      "period_unit": "quarter",
      "period_type": "renewals",
      "segmentation": "store_product_id",
      "format": "csv"
    })
data = response.json()