POST /api/v1/client-api/metrics/cohort/

Kohort verilerini getir

Kullanıcı gruplarını zaman içinde takip etmek için kohort verilerini getirin.

Bu endpoint'ten elde edilen gelir, kurulum tarihi kohortuna dayalıdır: her kullanıcının geliri, işlem tarihine değil kurulum tarihine atfedilir. Yanıt, total_revenue_usd ve total_proceeds_usd değerlerini içerir. Dahili raporları Ads Manager ile mutabık kılmak için analytics endpoint'i yerine bu endpoint'i kullanın; Ads Manager da kohort/kurulum tarihi bazlıdır.

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"

value_typestring

Değerlerin nasıl görüntüleneceğini belirtin

One of: "absolute", "relative"

value_fieldstring

Görüntülenen değerlerin türünü belirtin

One of: "revenue", "arppu", "arpu", "arpas", "subscribers", "subscriptions"

accounting_typestring

Kullanılan muhasebe yöntemi

One of: "revenue", "proceeds", "net_revenue"

renewal_daysarray of integer

period_type=days kohort türü için uygulamanın yüklenmesinden bu yana geçen gün listesi

prediction_monthsinteger

Kaç aylık tahmin istediğinizi girin

One of: 3, 6, 9, 12, 18, 24

formatstring

Dışa aktarma dosya biçimini belirtin

One of: "json", "csv"

Responses

Kohort verileri başarıyla getirildi

Schema

Aynı dönemde başlayan kullanıcı gruplarının zaman içindeki davranışlarını gösteren kohort analizi verilerini içeren yanıt

dataarray of object

Her biri aynı dönemde başlayan bir kullanıcı grubunu temsil eden kohort segmentlerinden oluşan dizi

segment_start_datestring

Bu kohort segmentinin başlangıç tarihi

typestring

Segment türü (toplanmış veriler için 'total', bireysel kohort için 'single')

titlestring

Bu kohort segmenti için görüntüleme başlığı

total_installsinteger

Bu kohortdaki toplam uygulama kurulum sayısı

total_subscriptionsinteger

Bu kohortdaki toplam abonelik sayısı

total_paid_subscribersinteger

Bu kohortdaki toplam ücretli abone sayısı

total_revenue_usdnumber

Bu kohort için USD cinsinden toplam gelir

total_proceeds_usdnumber

Bu kohort için USD cinsinden toplam hasılat (mağaza ücretleri düşüldükten sonra)

total_net_revenue_usdnumber

Bu kohort için USD cinsinden toplam net gelir

total_anrpas_usdnumber

USD cinsinden toplam Aktif Abone Başına Ortalama Net Gelir (ANRPAS)

total_appas_usdnumber

USD cinsinden toplam Aktif Abone Başına Ortalama Hasılat (APPAS)

total_arpas_usdnumber

USD cinsinden toplam Aktif Abone Başına Ortalama Gelir (ARPAS)

total_anrppu_usdnumber

USD cinsinden toplam Ödeme Yapan Kullanıcı Başına Ortalama Net Gelir (ANRPPU)

total_apppu_usdnumber

USD cinsinden toplam Ödeme Yapan Kullanıcı Başına Ortalama Hasılat (APPPU)

total_arppu_usdnumber

USD cinsinden toplam Ödeme Yapan Kullanıcı Başına Ortalama Gelir (ARPPU)

total_anrpu_usdnumber

USD cinsinden toplam Kullanıcı Başına Ortalama Net Gelir (ANRPU)

total_appu_usdnumber

USD cinsinden toplam Kullanıcı Başına Ortalama Hasılat (APPU)

total_arpu_usdnumber

USD cinsinden toplam Kullanıcı Başına Ortalama Gelir (ARPU)

predictobject

Bu kohort için tahmin verisi (mevcutsa)

valuesarray of object

Kohort performansını zaman içinde gösteren dönem bazlı değerler dizisi

arpas_usdnumber

Bu dönem için USD cinsinden Aktif Abone Başına Ortalama Gelir

appas_usdnumber

Bu dönem için USD cinsinden Aktif Abone Başına Ortalama Gelir Payı

anrpas_usdnumber

Bu dönem için USD cinsinden Aktif Abone Başına Ortalama Net Gelir

anrppu_usdnumber

Bu dönem için USD cinsinden Ödeme Yapan Kullanıcı Başına Ortalama Net Gelir

apppu_usdnumber

Bu dönem için USD cinsinden Ödeme Yapan Kullanıcı Başına Ortalama Gelir Payı

arppu_usdnumber

Bu dönem için USD cinsinden Ödeme Yapan Kullanıcı Başına Ortalama Gelir

anrpu_usdnumber

Bu dönem için USD cinsinden Kullanıcı Başına Ortalama Net Gelir

appu_usdnumber

Bu dönem için USD cinsinden Kullanıcı Başına Ortalama Gelir Payı

arpu_usdnumber

Bu dönem için USD cinsinden Kullanıcı Başına Ortalama Gelir

installsinteger

Bu dönemdeki uygulama kurulum sayısı

periodinteger

Dönem numarası (1 = birinci dönem, 2 = ikinci dönem, vb.)

revenue_usdnumber

Bu dönem için USD cinsinden toplam gelir

proceeds_usdnumber

Bu dönem için USD cinsinden toplam gelir payı (mağaza ücretleri düşüldükten sonra)

net_revenue_usdnumber

Bu dönem için USD cinsinden toplam net gelir

revenue_relativenumber

Birinci döneme göre yüzde olarak gelir (%100 = birinci dönem)

proceeds_relativenumber

Birinci döneme göre yüzde olarak gelir payı (%100 = birinci dönem)

net_revenue_relativenumber

Birinci döneme göre yüzde olarak net gelir (%100 = birinci dönem)

subscriptionsinteger

Bu dönemdeki abonelik sayısı

subscriptions_relativenumber

Birinci döneme göre yüzde olarak abonelik sayısı (%100 = birinci dönem)

subscribersinteger

Bu dönemdeki abone sayısı

subscribers_relativenumber

Birinci döneme göre yüzde olarak abone sayısı (%100 = birinci dönem)

currently_active_periodboolean

Bunun kohort için şu anda aktif dönem olup olmadığı

Example

{
  "data": [
    {
      "segment_start_date": "2024-04-01",
      "type": "total",
      "title": "Total",
      "total_installs": 0,
      "total_subscriptions": 0,
      "total_paid_subscribers": 0,
      "total_revenue_usd": 0,
      "total_proceeds_usd": 0,
      "total_net_revenue_usd": 0,
      "total_anrpas_usd": 0,
      "total_appas_usd": 0,
      "total_arpas_usd": 0,
      "total_anrppu_usd": 0,
      "total_apppu_usd": 0,
      "total_arppu_usd": 0,
      "total_anrpu_usd": 0,
      "total_appu_usd": 0,
      "total_arpu_usd": 0,
      "predict": null,
      "values": [
        {
          "arpas_usd": 0,
          "appas_usd": 0,
          "anrpas_usd": 0,
          "anrppu_usd": 0,
          "apppu_usd": 0,
          "arppu_usd": 0,
          "anrpu_usd": 0,
          "appu_usd": 0,
          "arpu_usd": 0,
          "installs": 0,
          "period": 1,
          "revenue_usd": 0,
          "proceeds_usd": 0,
          "net_revenue_usd": 0,
          "revenue_relative": 0,
          "proceeds_relative": 0,
          "net_revenue_relative": 0,
          "subscriptions": 0,
          "subscriptions_relative": 0,
          "subscribers": 0,
          "subscribers_relative": 0,
          "currently_active_period": false
        }
      ]
    }
  ]
}

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/cohort/' \
  --header 'Authorization: Api-Key YOUR_SECRET_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "filters": {
      "date": [
        "2024-04-01",
        "2024-09-30"
      ],
      "store": [
        "app_store"
      ],
      "country": [
        "us"
      ]
    },
    "period_unit": "month",
    "period_type": "renewals",
    "value_type": "absolute",
    "value_field": "subscriptions"
  }'

const response = await fetch('https://api-admin.adapty.io/api/v1/client-api/metrics/cohort/', {
  method: 'POST',
  headers: {
    'Authorization': 'Api-Key YOUR_SECRET_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "filters": {
      "date": [
        "2024-04-01",
        "2024-09-30"
      ],
      "store": [
        "app_store"
      ],
      "country": [
        "us"
      ]
    },
    "period_unit": "month",
    "period_type": "renewals",
    "value_type": "absolute",
    "value_field": "subscriptions"
  }),
});
const data = await response.json();

import requests

response = requests.post('https://api-admin.adapty.io/api/v1/client-api/metrics/cohort/', headers={
    'Authorization': 'Api-Key YOUR_SECRET_API_KEY',
    'Content-Type': 'application/json',
}, json={
      "filters": {
        "date": [
          "2024-04-01",
          "2024-09-30"
        ],
        "store": [
          "app_store"
        ],
        "country": [
          "us"
        ]
      },
      "period_unit": "month",
      "period_type": "renewals",
      "value_type": "absolute",
      "value_field": "subscriptions"
    })
data = response.json()