English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語
POST /api/v1/client-api/metrics/analytics/

Analitik verilerini al

Copy as Markdown

Grafiklerde kullanmak üzere kullanıcı davranışı ve performans metrikleri hakkında içgörüler için analitik verileri getirir.

Bu endpoint'ten elde edilen gelir etkinlik tabanlıdır: her değer işlem tarihine göre ilişkilendirilir — satın alma, yenileme veya iade işleminin gerçekleştiği gün. Geliri bunun yerine her kullanıcının kurulum tarihine göre ilişkilendirmek için (örneğin Ads Manager ile uzlaştırmak amacıyla) kohort endpoint'ini kullanın (POST /api/v1/client-api/metrics/cohort/).

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

Request body

chart_idstringrequired

Hangi grafiğe ihtiyaç duyduğunuzu belirtin. Her istekte yalnızca bir grafik türü belirtebilirsiniz.

One of: "revenue", "mrr", "arr", "arppu", "subscriptions_active", "subscriptions_new", "subscriptions_renewal_cancelled", "subscriptions_expired", "trials_active", "trials_new", "trials_renewal_cancelled", "trials_expired", "grace_period", "billing_issue", "refund_events", "refund_money", "non_subscriptions", "arpu", "installs"

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"

date_typestring

Kullanıcının katılım tarihi olarak hangi tarihin kullanılacağını belirtin

One of: "purchase_date", "profile_install_date"

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 dosya biçimini belirtin

One of: "json", "csv"

Responses

Analitik verileri başarıyla getirildi

Schema

İstenen grafik türü için analitik verilerini içeren yanıt

dataobject

Farklı metrik türlerini içeren nesne (revenue, proceeds, net_revenue, vb.)

Example 
{
  "data": {
    "revenue": {
      "data": [],
      "value": 0,
      "value_from": null,
      "value_to": null,
      "compare_value_from": null,
      "compare_value_to": null,
      "title": "revenue",
      "type": "multi",
      "default_aggregation": "sum",
      "description": "<div>Total money received from both subscriptions and one-time purchases. Does not include\nrevenue from subscriptions and purchases that were refunded afterward. Calculated before the store's fee.<br />\nFor example, there were 5 monthly $10 subs, 1 yearly $100 sub and 10 one-time $50 purchases today,<br />\nrevenue = 5*$10 + 1*$100 + 10*$50 = $650</div>",
      "metric_name": "Revenue",
      "is_json": true,
      "unit": "USD",
      "recommended_period": null
    },
    "proceeds": {
      "data": [],
      "value": 0,
      "value_from": null,
      "value_to": null,
      "compare_value_from": null,
      "compare_value_to": null,
      "title": "revenue",
      "type": "multi",
      "default_aggregation": "sum",
      "description": "<div>Total money received from both subscriptions and one-time purchases. Does not include\nrevenue from subscriptions and purchases that were refunded afterward. Calculated before the store's fee.<br />\nFor example, there were 5 monthly $10 subs, 1 yearly $100 sub and 10 one-time $50 purchases today,<br />\nrevenue = 5*$10 + 1*$100 + 10*$50 = $650</div>",
      "metric_name": "Revenue",
      "is_json": true,
      "unit": "USD",
      "recommended_period": null
    },
    "net_revenue": {
      "data": [],
      "value": 0,
      "value_from": null,
      "value_to": null,
      "compare_value_from": null,
      "compare_value_to": null,
      "title": "revenue",
      "type": "multi",
      "default_aggregation": "sum",
      "description": "<div>Total money received from both subscriptions and one-time purchases. Does not include\nrevenue from subscriptions and purchases that were refunded afterward. Calculated before the store's fee.<br />\nFor example, there were 5 monthly $10 subs, 1 yearly $100 sub and 10 one-time $50 purchases today,<br />\nrevenue = 5*$10 + 1*$100 + 10*$50 = $650</div>",
      "metric_name": "Revenue",
      "is_json": true,
      "unit": "USD",
      "recommended_period": null
    }
  }
}

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 maksimum 2 istek.