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

Получить данные когорты

Copy as Markdown

Возвращает данные когорт для отслеживания групп пользователей с течением времени.

Ограничение частоты запросов: 2 запроса в секунду.

Request body

filtersobjectrequired

datearray of stringrequired

Укажите дату или период времени, за который необходимо получить данные графика

compare_datearray of string

Укажите дату или период для сравнения

storearray of string

Фильтр по стору, в котором была совершена покупка

countryarray of string

Фильтр по двухбуквенному коду страны, в которой была совершена покупка

store_product_idarray of string

Уникальный идентификатор продукта в сторе

durationarray of string

Укажите длительность подписки

attribution_sourcearray of string

Источник интеграции для атрибуции

attribution_statusarray of string

Указывает, является ли атрибуция органической или неорганической

attribution_channelarray of string

Маркетинговый канал, приведший к транзакции

attribution_campaignarray of string

Маркетинговая кампания, приведшая к транзакции

attribution_adgrouparray of string

Группа объявлений атрибуции, приведшая к транзакции

attribution_adsetarray of string

Набор объявлений атрибуции, приведший к транзакции

attribution_creativearray of string

Конкретные визуальные или текстовые элементы объявления или кампании, отслеживаемые для измерения эффективности

offer_categoryarray of string

Укажите категории предложений, по которым необходимо получить данные

offer_typearray of string

Укажите типы предложений, по которым необходимо получить данные

offer_idarray of string

Укажите конкретные предложения, по которым необходимо получить данные

period_unitstring

Укажите временной интервал для агрегации аналитических данных

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

period_typestring

Анализировать данные по продлениям или по дням

One of: "renewals", "days"

value_typestring

Укажите способ отображения значений

One of: "absolute", "relative"

value_fieldstring

Укажите тип отображаемых значений

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

accounting_typestring

Используемый метод учёта

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

renewal_daysarray of integer

Список дней с момента установки приложения для типа когорты period_type=days

prediction_monthsinteger

Укажите количество месяцев прогноза

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

formatstring

Укажите формат экспортируемого файла

One of: "json", "csv"

Responses

Данные когорты успешно получены

Schema

Ответ, содержащий данные когортного анализа и поведение пользователей с течением времени

dataarray of object

Массив сегментов когорт, каждый из которых представляет группу пользователей, начавших пользоваться приложением в одном периоде

segment_start_datestring

Дата начала данного сегмента когорты

typestring

Тип сегмента ('total' для агрегированных данных, 'single' для отдельной когорты)

titlestring

Отображаемое название данного сегмента когорты

total_installsinteger

Общее количество установок приложения в данной когорте

total_subscriptionsinteger

Общее количество подписок в данной когорте

total_paid_subscribersinteger

Общее количество платных подписчиков в данной когорте

total_revenue_usdnumber

Общий доход в USD для данной когорты

total_proceeds_usdnumber

Общие поступления в USD для данной когорты (после вычета комиссии стора)

total_net_revenue_usdnumber

Общий чистый доход в USD для данной когорты

total_anrpas_usdnumber

Общий средний чистый доход на активного подписчика (ANRPAS) в USD

total_appas_usdnumber

Общие средние поступления на активного подписчика (APPAS) в USD

total_arpas_usdnumber

Общий средний доход на активного подписчика (ARPAS) в USD

total_anrppu_usdnumber

Общий средний чистый доход на платящего пользователя (ANRPPU) в USD

total_apppu_usdnumber

Общие средние поступления на платящего пользователя (APPPU) в USD

total_arppu_usdnumber

Общий средний доход на платящего пользователя (ARPPU) в USD

total_anrpu_usdnumber

Общий средний чистый доход на пользователя (ANRPU) в USD

total_appu_usdnumber

Общие средние поступления на пользователя (APPU) в USD

total_arpu_usdnumber

Общий средний доход на пользователя (ARPU) в USD

predictobject

Данные прогноза для данной когорты (если доступны)

valuesarray of object

Массив периодических значений, отражающих динамику когорты с течением времени

arpas_usdnumber

Средний доход на активного подписчика в USD за данный период

appas_usdnumber

Средние поступления на активного подписчика в USD за данный период

anrpas_usdnumber

Средний чистый доход на активного подписчика в USD за данный период

anrppu_usdnumber

Средний чистый доход на платящего пользователя в USD за данный период

apppu_usdnumber

Средние поступления на платящего пользователя в USD за данный период

arppu_usdnumber

Средний доход на платящего пользователя в USD за данный период

anrpu_usdnumber

Средний чистый доход на пользователя в USD за данный период

appu_usdnumber

Средние поступления на пользователя в USD за данный период

arpu_usdnumber

Средний доход на пользователя в USD за данный период

installsinteger

Количество установок приложения за данный период

periodinteger

Номер периода (1 = первый период, 2 = второй период и т.д.)

revenue_usdnumber

Общий доход в USD за данный период

proceeds_usdnumber

Общие поступления в USD за данный период (после вычета комиссии стора)

net_revenue_usdnumber

Общий чистый доход в USD за данный период

revenue_relativenumber

Доход в процентах относительно первого периода (100% = первый период)

proceeds_relativenumber

Поступления в процентах относительно первого периода (100% = первый период)

net_revenue_relativenumber

Чистый доход в процентах относительно первого периода (100% = первый период)

subscriptionsinteger

Количество подписок за данный период

subscriptions_relativenumber

Подписки в процентах относительно первого периода (100% = первый период)

subscribersinteger

Количество подписчиков за данный период

subscribers_relativenumber

Подписчики в процентах относительно первого периода (100% = первый период)

currently_active_periodboolean

Указывает, является ли данный период текущим активным периодом когорты

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

Неверный запрос

Schema

errorsarray of object

sourcestring

errorsarray of string

error_codestring

status_codeinteger

Не авторизован

Schema

errorsarray of object

sourcestring

errorsarray of string

error_codestring

status_codeinteger

Превышено ограничение частоты запросов. Максимум 2 запроса в секунду на один API-ключ.

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