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

Récupérer les données de valeur vie client (LTV)

Copy as Markdown

Récupère les données LTV pour évaluer le potentiel de revenus à long terme des clients sur leur période d'engagement.

Limite de débit : 2 requêtes par seconde.

Request body

filtersobjectrequired

datearray of stringrequired

Entrez la date ou la période pour laquelle vous souhaitez récupérer les données du graphique

compare_datearray of string

Entrez la date ou la période de comparaison

storearray of string

Filtrez par le store où l'achat a été effectué

countryarray of string

Filtrez par le code pays à 2 lettres où l'achat a eu lieu

store_product_idarray of string

Identifiant unique d'un produit dans le store

durationarray of string

Indiquez la durée de l'abonnement

attribution_sourcearray of string

L'intégration source pour l'attribution

attribution_statusarray of string

Indique si l'attribution est organique ou non organique

attribution_channelarray of string

Canal marketing ayant conduit à la transaction

attribution_campaignarray of string

Campagne marketing ayant apporté la transaction

attribution_adgrouparray of string

Groupe d'annonces d'attribution ayant apporté la transaction

attribution_adsetarray of string

Ensemble d'annonces d'attribution ayant conduit à la transaction

attribution_creativearray of string

Éléments visuels ou textuels spécifiques d'une annonce ou d'une campagne, suivis pour mesurer leur efficacité

offer_categoryarray of string

Indiquez les catégories d'offres pour lesquelles vous souhaitez récupérer des données

offer_typearray of string

Indiquez les types d'offres pour lesquels vous souhaitez récupérer des données

offer_idarray of string

Indiquez les offres spécifiques pour lesquelles vous souhaitez récupérer des données

period_unitstring

Indiquez l'intervalle de temps pour l'agrégation des données d'analyse

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

period_typestring

Analysez les données par renouvellements ou par jours

One of: "renewals", "days"

segmentationstring

Définit la base de la segmentation

formatstring

Indiquez le format de fichier d'export

One of: "json", "csv"

Responses

Données LTV récupérées avec succès

Schema

Réponse contenant les données de valeur vie client (LTV) pour différents types de revenus

revenueobject

LTV calculée à partir du revenu brut

dataarray of object

Tableau de points de données LTV pour différentes cohortes

titlestring

Titre d'affichage pour ce point de données LTV

typestring

Type de données LTV ('total' pour les données agrégées)

valuenumber

Valeur LTV pour cette cohorte

valuesarray of object

Tableau de valeurs LTV par période

cohort_sizeinteger

Nombre d'utilisateurs dans cette cohorte

descriptionstring

Description HTML expliquant comment la LTV est calculée

valuenumber

La valeur LTV globale

unitstring

Unité de mesure (généralement 'USD')

titlestring

Titre d'affichage pour cette métrique LTV

proceedsobject

LTV calculée à partir des produits nets (après frais du store)

dataarray of object

Tableau de points de données LTV pour différentes cohortes

titlestring

Titre d'affichage pour ce point de données LTV

typestring

Type de données LTV ('total' pour les données agrégées)

valuenumber

Valeur LTV pour cette cohorte

valuesarray of object

Tableau de valeurs LTV par période

cohort_sizeinteger

Nombre d'utilisateurs dans cette cohorte

descriptionstring

Description HTML expliquant comment la LTV est calculée

valuenumber

La valeur LTV globale

unitstring

Unité de mesure (généralement 'USD')

titlestring

Titre d'affichage pour cette métrique LTV

net_revenueobject

LTV calculée à partir du revenu net

dataarray of object

Tableau de points de données LTV pour différentes cohortes

titlestring

Titre d'affichage pour ce point de données LTV

typestring

Type de données LTV ('total' pour les données agrégées)

valuenumber

Valeur LTV pour cette cohorte

valuesarray of object

Tableau de valeurs LTV par période

cohort_sizeinteger

Nombre d'utilisateurs dans cette cohorte

descriptionstring

Description HTML expliquant comment la LTV est calculée

valuenumber

La valeur LTV globale

unitstring

Unité de mesure (généralement 'USD')

titlestring

Titre d'affichage pour cette métrique 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"
  }
}

Requête incorrecte

Schema

errorsarray of object

sourcestring

errorsarray of string

error_codestring

status_codeinteger

Non autorisé

Schema

errorsarray of object

sourcestring

errorsarray of string

error_codestring

status_codeinteger

Limite de débit dépassée. Maximum 2 requêtes par seconde par clé 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()