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

Yaşam Boyu Değer (LTV) verilerini al

Copy as Markdown

Müşterilerin etkileşim süresi boyunca uzun vadeli gelir potansiyelini değerlendirmek için LTV verilerini getirir.

Hız sınırı: Saniyede 2 istek.

Request body

filtersobjectrequired

datearray of stringrequired

Grafik verilerini almak istediğiniz tarihi veya zaman dilimini girin

compare_datearray of string

Karşılaştırma tarihini veya zaman dilimini girin

storearray of string

Satın almanın gerçekleştiği uygulama mağazasına göre filtreleyin

countryarray of string

Satın almanın gerçekleştiği ülkenin 2 harfli ülke koduna göre filtreleyin

store_product_idarray of string

Mağaza nitelikli ürün kimliği; <store>:<product_id> biçiminde belirtilir — örneğin app_store:premium_monthly veya temel plana sahip bir Google aboneliği için play_store:premium_sub:monthly-base-plan. Mağaza öneki içermeyen bir ürün kimliği reddedilir.

durationarray of string

Abonelik süresini belirtin

attribution_sourcearray of string

Attribution için kaynak entegrasyon

attribution_statusarray of string

Attribution'ın organik mi yoksa organik olmayan mı olduğunu gösterir

attribution_channelarray of string

İşleme yol açan pazarlama kanalı

attribution_campaignarray of string

İşlemi getiren pazarlama kampanyası

attribution_adgrouparray of string

İşlemi getiren attribution reklam grubu

attribution_adsetarray of string

İşleme yol açan attribution reklam seti

attribution_creativearray of string

Etkinliği ölçmek amacıyla takip edilen bir reklam veya kampanyadaki belirli görsel ya da metin öğeleri

offer_categoryarray of string

Veri almak istediğiniz teklif kategorilerini belirtin

offer_typearray of string

Veri almak istediğiniz teklif türlerini belirtin

offer_idarray of string

Veri almak istediğiniz belirli teklifleri belirtin

period_unitstring

Analitik verilerini toplamak için zaman aralığını belirtin

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

period_typestring

Verileri yenilemeler veya günler bazında analiz edin

One of: "renewals", "days"

segmentationstring

Segmentasyonun temelini belirler

formatstring

Dışa aktarma dosya biçimini belirtin

One of: "json", "csv"

Responses

LTV verileri başarıyla alındı

Schema

Farklı gelir türleri için Yaşam Boyu Değer (LTV) verilerini içeren yanıt

revenueobject

Brüt gelir kullanılarak hesaplanan LTV

dataarray of object

Farklı kohortlar için LTV veri noktalarının dizisi

titlestring

Bu LTV veri noktası için görüntüleme başlığı

typestring

LTV verisi türü (toplu veriler için 'total')

valuenumber

Bu kohort için LTV değeri

valuesarray of object

Dönem bazlı LTV değerlerinden oluşan dizi

cohort_sizeinteger

Bu kohortdaki kullanıcı sayısı

descriptionstring

LTV'nin nasıl hesaplandığını açıklayan HTML açıklaması

valuenumber

Genel LTV değeri

unitstring

Ölçüm birimi (genellikle 'USD')

titlestring

Bu LTV metriği için görüntüleme başlığı

proceedsobject

Hasılat kullanılarak hesaplanan LTV (mağaza ücretleri düşüldükten sonra)

dataarray of object

Farklı kohortlar için LTV veri noktalarının dizisi

titlestring

Bu LTV veri noktası için görüntüleme başlığı

typestring

LTV verisi türü (toplu veriler için 'total')

valuenumber

Bu kohort için LTV değeri

valuesarray of object

Dönem bazlı LTV değerlerinden oluşan dizi

cohort_sizeinteger

Bu kohortdaki kullanıcı sayısı

descriptionstring

LTV'nin nasıl hesaplandığını açıklayan HTML açıklaması

valuenumber

Genel LTV değeri

unitstring

Ölçüm birimi (genellikle 'USD')

titlestring

Bu LTV metriği için görüntüleme başlığı

net_revenueobject

Net gelir kullanılarak hesaplanan LTV

dataarray of object

Farklı kohortlar için LTV veri noktalarının dizisi

titlestring

Bu LTV veri noktası için görüntüleme başlığı

typestring

LTV verisi türü (toplu veriler için 'total')

valuenumber

Bu kohort için LTV değeri

valuesarray of object

Dönem bazlı LTV değerlerinden oluşan dizi

cohort_sizeinteger

Bu kohortdaki kullanıcı sayısı

descriptionstring

LTV'nin nasıl hesaplandığını açıklayan HTML açıklaması

valuenumber

Genel LTV değeri

unitstring

Ölçüm birimi (genellikle 'USD')

titlestring

Bu LTV metriği için görüntüleme başlığı

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

Hatalı İstek

Schema

errorsarray of object

sourcestring

errorsarray of string

error_codestring

status_codeinteger

Yetkisiz

Schema

errorsarray of object

sourcestring

errorsarray of string

error_codestring

status_codeinteger

Hız sınırı aşıldı. API anahtarı başına saniyede maksimum 2 istek.

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()