POST /api/v1/client-api/metrics/conversion/

Dönüşüm verilerini al

Copy as Markdown

Kullanıcı eylemlerini analiz etmek ve pazarlama çabalarının etkinliğini zaman içinde ölçmek için dönüşüm verilerini alı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 yapıldığı uygulama mağazasına göre filtrele

countryarray of string

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

store_product_idarray of string

Uygulama mağazasındaki ürünün benzersiz tanımlayıcısı

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 için 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

from_periodstring | nullrequired

Kullanıcının dönüşüm öncesindeki başlangıç abonelik durumu

to_periodstringrequired

Dönüşümün ardından kullanıcının yeni abonelik durumu

period_unitstring

Analitik verilerinin toplanacağı 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

Segmentasyonun temelini belirler

formatstring

Dışa aktarma dosya formatını belirtin

One of: "json", "csv"

Responses

Dönüşüm verileri başarıyla alındı

Schema

Kullanıcıların abonelik durumları arasındaki geçişini gösteren dönüşüm verilerini içeren yanıt

dataarray of object

Dönüşüm veri noktaları dizisi (toplu metrikler için boş olabilir)

valuenumber

Dönüşüm oranı değeri

value_frominteger

Dönüşüm için başlangıç abonelik durumu

value_tointeger

Dönüşüm için hedef abonelik durumu

compare_value_fromnumber

Karşılaştırma dönemi için başlangıç değeri

compare_value_tonumber

Karşılaştırma dönemi için bitiş değeri

titlestring

Dönüşüm türünü açıklayan görüntüleme başlığı

typestring

Dönüşüm metriği türü

default_aggregationstring

Bu metrik için varsayılan toplama yöntemi

descriptionstring

Dönüşüm oranının nasıl hesaplandığına dair ayrıntılı açıklama

metric_namestring

Dönüşüm metriğinin dahili adı

is_jsonboolean

Verinin JSON formatında olup olmadığı

unitstring

Ölçüm birimi (dönüşüm oranları için genellikle 'percent')

recommended_periodobject

Bu dönüşüm metriği için önerilen tarih aralığı

date_fromstring

Önerilen dönemin başlangıç tarihi

date_tostring

Önerilen dönemin bitiş tarihi

period_unitstring

Önerilen dönem birimi

Example 
{
  "data": [],
  "value": 0,
  "value_from": 0,
  "value_to": 0,
  "compare_value_from": null,
  "compare_value_to": null,
  "title": "Conversion rate from Paid to more than 6 months",
  "type": "multi",
  "default_aggregation": "sum",
  "description": "If Х - the number of the 1st payments taken during the selected date, and Y - the amount of the renewals that happened after the 6 months since the selected date from those 1st payments, then Conversion = (Y / X) * 100%. For example, we had 100 1st subscriptions of various products on the 1st of January and among them 20 renewed on the 1st week of July (the 25th payment). On the 8th of July, we open the chart and see the conversion of the 1st of January = (20 / 100) * 100% = 20%. Then 30 more subscribers of the 1st of January renewed by the start of August (the 8th payment). We open the chart on the 1st of August and see that the conversion of the 1st of January = ((20+30) / 100) * 100% = 50%. This number shows which part of those who had their 1st payment on the 1st of January converted to the period > 6 months with any number of payments by the current moment.",
  "metric_name": "from_paid_to_6_months_conversion",
  "is_json": true,
  "unit": "percent",
  "recommended_period": {
    "date_from": "2018-04-29",
    "date_to": "2024-12-31",
    "period_unit": "month"
  }
}

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.