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

Recuperar datos de Valor de Vida del Cliente (LTV)

Recupera datos de LTV para evaluar el potencial de ingresos a largo plazo de los clientes durante su período de participación.

Límite de tasa: 2 solicitudes por segundo.

Request body

filtersobjectrequired

datearray of stringrequired

Introduce la fecha o el período de tiempo para el que deseas recuperar los datos del gráfico

compare_datearray of string

Introduce la fecha o el período de tiempo de comparación

storearray of string

Filtra por el store donde se realizó la compra

countryarray of string

Filtra por el código de país de 2 letras donde se realizó la compra

store_product_idarray of string

ID de producto cualificado por store, con el formato <store>:<product_id> — por ejemplo app_store:premium_monthly o play_store:premium_sub:monthly-base-plan para una suscripción de Google con un plan base. Se rechaza un ID de producto sin prefijo de store.

durationarray of string

Especifica la duración de la suscripción

attribution_sourcearray of string

La integración de origen para la atribución

attribution_statusarray of string

Indica si la atribución es orgánica o no orgánica

attribution_channelarray of string

Canal de marketing que originó la transacción

attribution_campaignarray of string

Campaña de marketing que originó la transacción

attribution_adgrouparray of string

Grupo de anuncios de atribución que originó la transacción

attribution_adsetarray of string

Conjunto de anuncios de atribución que originó la transacción

attribution_creativearray of string

Elementos visuales o de texto específicos de un anuncio o campaña cuyo seguimiento se realiza para medir su efectividad

offer_categoryarray of string

Especifica las categorías de oferta para las que deseas recuperar datos

offer_typearray of string

Especifica los tipos de oferta para los que deseas recuperar datos

offer_idarray of string

Especifica las ofertas concretas para las que deseas recuperar datos

period_unitstring

Especifique el intervalo de tiempo para agregar los datos de análisis

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

period_typestring

Analice los datos por renovaciones o por días

One of: "renewals", "days"

segmentationstring

Establece la base para la segmentación

formatstring

Especifique el formato del archivo de exportación

One of: "json", "csv"

Responses

Datos de LTV recuperados correctamente

Schema

Respuesta que contiene datos de Valor de Vida del Cliente (LTV) para diferentes tipos de ingresos

revenueobject

LTV calculado usando los ingresos brutos

dataarray of object

Array de puntos de datos LTV para diferentes cohortes

titlestring

Título de visualización para este punto de datos LTV

typestring

Tipo de datos LTV ('total' para datos agregados)

valuenumber

Valor LTV para esta cohorte

valuesarray of object

Array de valores LTV basados en períodos

cohort_sizeinteger

Número de usuarios en esta cohorte

descriptionstring

Descripción en HTML que explica cómo se calcula el LTV

valuenumber

El valor LTV general

unitstring

Unidad de medida (normalmente 'USD')

titlestring

Título de presentación para esta métrica LTV

proceedsobject

LTV calculado usando los ingresos netos (después de las comisiones del store)

dataarray of object

Array de puntos de datos LTV para diferentes cohortes

titlestring

Título de visualización para este punto de datos LTV

typestring

Tipo de datos LTV ('total' para datos agregados)

valuenumber

Valor LTV para esta cohorte

valuesarray of object

Array de valores LTV basados en períodos

cohort_sizeinteger

Número de usuarios en esta cohorte

descriptionstring

Descripción en HTML que explica cómo se calcula el LTV

valuenumber

El valor LTV general

unitstring

Unidad de medida (normalmente 'USD')

titlestring

Título de presentación para esta métrica LTV

net_revenueobject

LTV calculado usando los ingresos netos

dataarray of object

Array de puntos de datos LTV para diferentes cohortes

titlestring

Título de visualización para este punto de datos LTV

typestring

Tipo de datos LTV ('total' para datos agregados)

valuenumber

Valor LTV para esta cohorte

valuesarray of object

Array de valores LTV basados en períodos

cohort_sizeinteger

Número de usuarios en esta cohorte

descriptionstring

Descripción en HTML que explica cómo se calcula el LTV

valuenumber

El valor LTV general

unitstring

Unidad de medida (normalmente 'USD')

titlestring

Título de presentación para esta métrica LTV

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

Solicitud incorrecta

Schema

errorsarray of object

sourcestring

errorsarray of string

error_codestring

status_codeinteger

No autorizado

Schema

errorsarray of object

sourcestring

errorsarray of string

error_codestring

status_codeinteger

Límite de tasa superado. Máximo 2 solicitudes por segundo por clave de API.

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