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

Lifetime Value (LTV) verilerini al

Copy as Markdown

Müşterilerin etkileşim süreleri boyunca uzun vadeli gelir potansiyelini değerlendirmek için LTV verilerini alır.

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

Request body

filtersobjectrequired

datearray of stringrequired

Grafik verilerini almak istediğiniz tarih veya zaman dilimini girin

compare_datearray of string

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

storearray of string

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

countryarray of string

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

store_product_idarray of string

Mağaza ön ekiyle biçimlendirilmiş ürün kimliği; örneğin <store>:<product_id> formatında app_store:premium_monthly veya temel planı olan bir Google aboneliği için play_store:premium_sub:monthly-base-plan. Mağaza ön eki olmayan yalın bir ürün kimliği kabul edilmez.

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 izlenen bir reklam veya kampanyadaki belirli görsel ya da metin ögeleri

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

placement_idarray of string

Veri almak istediğiniz placement'ların Adapty içindeki dahili kimlikleri — SDK'ya ilettiğiniz placement kimliği değil, placement'ın kontrol paneli URL'sindeki UUID

audience_idarray of string

Veri almak istediğiniz placement kitlelerinin Adapty içindeki dahili kimlikleri

paywall_idarray of string

Veri almak istediğiniz paywall'ların Adapty içindeki dahili kimlikleri — paywall'ın kontrol paneli URL'sindeki UUID

flow_idarray of string

Veri almak istediğiniz flow'ların Adapty içindeki dahili kimlikleri — flow'un kontrol paneli URL'sindeki UUID

flow_screen_idarray of string

Veri almak istediğiniz flow ekranları; her biri <flow_id>:<screen_id> formatında biçimlendirilmiş — örneğin 3f8a1c2e-0b7d-4e5a-9c61-2d4f8e7b1a90:paywall

segment_idarray of string

Veri almak istediğiniz segment'lerin Adapty içindeki dahili kimlikleri

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

Verileri bu boyutun her değeri için ayrı bir seriye böler. Örneğin, flow_id her flow için ayrı bir seri döndürür ve placement_id her placement için ayrı bir seri döndürür.

One of: "period", "renewal_status", "cancellation_reason", "store_product_id", "country", "store", "paywall_id", "audience_id", "placement_id", "flow_id", "flow_screen_id", "segment_id", "duration", "offer_category", "offer_type", "offer_id", "attribution_source", "attribution_status", "attribution_channel", "attribution_campaign", "attribution_adgroup", "attribution_adset", "attribution_creative", "day", "week", "month", "year"

formatstring

Dışa aktarma dosyası 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ı. Uygulamanın tüm API anahtarları tarafından paylaşılan, uygulama başına saniyede en fazla 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()