Metrics
Métriques Kiwify via l'API
Votre client connecte son compte Kiwify et votre produit interroge 59 métriques par le même endpoint que les autres plateformes. Chaque métrique a un identifiant (reference_key) qui figure dans l'appel.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "kiwify:total_products",
"component": "number_v1",
"metrics": [
"total_products"
],
"dimensions": [
"product"
]
}
]
}Plus d'exemples d'appels Kiwify
Le même endpoint pour chaque type de métrique. Les champs metrics et dimensions de chaque élément viennent du catalogue de la plateforme (GET /api/metrics/{integration_slug}).
Graphique
Ventes par Pays
Graphique à barres présentant la répartition des ventes par pays.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "kiwify:sales_by_country_chart",
"component": "chart_v1",
"metrics": [
"total_orders"
],
"dimensions": [
"country"
]
}
]
}Tableau
Produits en vedette
Résumé des performances des produits enregistrés dans le compte.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "kiwify:products_table",
"component": "datatable_v1",
"metrics": [
"status",
"total_orders",
"productPrice",
"affiliates_enabled"
],
"dimensions": [
"product"
]
}
]
}Chiffre
Produits Actifs
Nombre de produits actuellement actifs.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "kiwify:active_products",
"component": "number_v1",
"metrics": [
"active_products"
],
"dimensions": [
"product"
]
}
]
}Chiffres
45 métriques
Total des Produits
Nombre total de produits enregistrés sur la plateforme.
kiwify:total_productsProduits Actifs
Nombre de produits actuellement actifs.
kiwify:active_productsTotal des Commandes
Nombre total de ventes réalisées pendant la période analysée.
kiwify:total_ordersRevenu Brut Total ($)
Revenu total généré par les ventes avant toute déduction.
kiwify:total_gross_revenueRevenu Brut Total (R$)
Revenu total généré par les ventes avant toute déduction.
kiwify:total_gross_revenue_brlRevenu Net Total ($)
Revenu total après déductions telles que frais, remboursements et rétrofacturations.
kiwify:total_net_revenueRevenu Net Total (R$)
Revenu total après déductions telles que frais, remboursements et rétrofacturations.
kiwify:total_net_revenue_brlTicket Moyen ($)
Valeur moyenne de chaque transaction de vente.
kiwify:average_ticketTicket Moyen (R$)
Valeur moyenne de chaque transaction de vente.
kiwify:average_ticket_brlTotal Payé aux Partenaires ($)
Montant total payé aux partenaires dans le cadre du partage des revenus.
kiwify:total_paid_to_partnersTotal Payé aux Partenaires (R$)
Montant total payé aux partenaires dans le cadre du partage des revenus.
kiwify:total_paid_to_partners_brlVentes terminées ($)
Nombre de ventes entièrement réalisées.
kiwify:completed_salesVentes Complétées (R$)
Nombre de ventes entièrement réalisées.
kiwify:completed_sales_brlVentes annulées ($)
Nombre de ventes annulées en raison de problèmes ou d’empêchements.
kiwify:canceled_salesVentes Annulées (R$)
Nombre de ventes annulées en raison de problèmes ou d’empêchements.
kiwify:canceled_sales_brlVentes refusées ($)
Montant total des ventes qui ont été refusées.
kiwify:refused_salesVentes refusées (R$)
Montant total des ventes qui ont été refusées.
kiwify:refused_sales_brlEn attente de paiement ($)
Montant total des ventes en attente de paiement.
kiwify:waiting_payment_salesEn attente de paiement (R$)
Montant total des ventes en attente de paiement.
kiwify:waiting_payment_sales_brlFrais ($)
Montant total des frais facturés pour les ventes effectuées.
kiwify:feeFrais (R$)
Montant total des frais facturés pour les ventes effectuées.
kiwify:fee_brlMontant des Taxes sur les Ventes ($)
Montant total des taxes facturées pour les ventes effectuées.
kiwify:sale_tax_amountMontant des Taxes sur les Ventes (R$)
Montant total des taxes facturées pour les ventes effectuées.
kiwify:sale_tax_amount_brlVentes en attente ($)
Nombre de ventes en attente de confirmation.
kiwify:pending_salesVentes en Attente (R$)
Nombre de ventes en attente de confirmation.
kiwify:pending_sales_brlNombre de ventes remboursées ($)
Nombre de ventes ayant fait l’objet d’un remboursement.
kiwify:refunded_countNombre de Ventes Remboursées (R$)
Nombre de ventes ayant fait l’objet d’un remboursement.
kiwify:refunded_count_brlTaux de remboursement ($)
Pourcentage des ventes ayant entraîné des remboursements.
kiwify:refund_rateTaux de Remboursement (R$)
Pourcentage des ventes ayant entraîné des remboursements.
kiwify:refund_rate_brlRétrofacturations ($)
Nombre total de rétrofacturations enregistrées durant la période analysée.
kiwify:chargebacksRétrofacturations (R$)
Nombre total de rétrofacturations enregistrées durant la période analysée.
kiwify:chargebacks_brlTaux d'approbation de la carte de crédit ($)
Percentage of card sales that were approved.
kiwify:credit_card_approval_rateTaux d'approbation de la carte de crédit (R$)
Percentage of card sales that were approved.
kiwify:credit_card_approval_rate_brlVentes par Boleto
Nombre de ventes effectuées via boleto comme moyen de paiement.
kiwify:sales_by_bank_slipVentes par Pix
Nombre de ventes effectuées via Pix comme moyen de paiement.
kiwify:sales_by_pixVentes par carte ($)
Nombre de ventes effectuées par carte de crédit ou débit.
kiwify:sales_by_cardVentes par Carte (R$)
Nombre de ventes effectuées par carte de crédit ou débit.
kiwify:sales_by_card_brlTaux de rétrofacturation ($)
Pourcentage des ventes ayant abouti à une rétrofacturation.
kiwify:chargeback_rateTaux de rétrofacturation (R$)
Pourcentage des ventes ayant abouti à une rétrofacturation.
kiwify:chargeback_rate_brlVentes approuvées par carte ($)
Number of sales approved using credit or debit card.
kiwify:approved_card_salesVentes approuvées par carte (R$)
Number of sales approved using credit or debit card.
kiwify:approved_card_sales_brlTaux de Boleto
Pourcentage des ventes réalisées via boleto.
kiwify:bank_slip_rateTotal des Affiliés
Nombre total d’affiliés enregistrés dans le système.
kiwify:total_affiliatesTotal des Commissions des Affiliés ($)
Total des commissions versées aux affiliés.
kiwify:total_affiliate_commissionsTotal des Commissions des Affiliés (R$)
Total des commissions versées aux affiliés.
kiwify:total_affiliate_commissions_brl
Graphiques
11 métriques
Ventes par Pays
Graphique à barres présentant la répartition des ventes par pays.
kiwify:sales_by_country_chartVentes par Type de Paiement
Graphique circulaire représentant la répartition des ventes par méthode de paiement.
kiwify:sales_by_payment_type_chartStatut des Ventes
Graphique circulaire indiquant la répartition des ventes par statut, telles qu’approuvées, complétées et annulées.
kiwify:sales_status_chartRevenu par Produit ($)
Graphique à barres illustrant les revenus générés par produit.
kiwify:revenue_by_product_chartRevenu par Produit (R$)
Graphique à barres illustrant les revenus générés par produit.
kiwify:revenue_by_product_chart_brlTicket Moyen par Produit ($)
Graphique à barres indiquant la valeur moyenne du ticket par produit.
kiwify:average_ticket_by_product_chartTicket Moyen par Produit (R$)
Graphique à barres indiquant la valeur moyenne du ticket par produit.
kiwify:average_ticket_by_product_chart_brlVentes au fil du temps ($)
Graphique linéaire montrant l’évolution des ventes pendant la période sélectionnée.
kiwify:sales_over_time_chartVentes au fil du temps (R$)
Graphique linéaire montrant l’évolution des ventes pendant la période sélectionnée.
kiwify:sales_over_time_chart_brlRevenus au Fil du Temps ($)
Graphique linéaire illustrant l’évolution des revenus au fil du temps.
kiwify:revenue_over_time_chartRevenu au Fil du Temps (R$)
Graphique linéaire illustrant l’évolution des revenus au fil du temps.
kiwify:revenue_over_time_chart_brl
Tableaux
3 métriques
Produits en vedette
Résumé des performances des produits enregistrés dans le compte.
kiwify:products_tableVentes par produit
Résumé des performances des ventes par produit durant la période analysée.
kiwify:sales_by_product_tableÉvénements
Résumé des événements créés avec disponibilité et statistiques d’utilisation des billets.
kiwify:events
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
