English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語
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

ストア修飾子付きのプロダクトID。<store>:<product_id> の形式で指定します。例えば app_store:premium_monthly や、ベースプランを持つ Google サブスクリプションの場合は play_store:premium_sub:monthly-base-plan のように指定します。ストアプレフィックスのないプロダクトIDは拒否されます。

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 リクエストです。