Metrics
Métriques TikTok Shop via l'API
Votre client connecte son compte TikTok Shop et votre produit interroge 34 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": "tiktok_shop:orders",
"component": "number_v1",
"metrics": [
"orders"
]
}
]
}Plus d'exemples d'appels TikTok Shop
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
Commandes au fil du temps
Commandes passées chaque jour durant la période analysée.
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": "tiktok_shop:orders_over_time",
"component": "chart_v1",
"metrics": [
"orders"
],
"dimensions": [
"date"
]
}
]
}Tableau
Résumé des ventes
Ventes des commandes passées chaque jour durant la période analysée, nettes des remboursements complétés ce jour-là.
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": "tiktok_shop:sales_summary",
"component": "datatable_v1",
"metrics": [
"orders",
"items_sold",
"gross_sales",
"seller_discount",
"platform_discount",
"net_sales",
"shipping",
"taxes",
"total_sales"
],
"dimensions": [
"date"
]
}
]
}Chiffre
Commandes livrées
Commandes passées durant la période analysée qui ont été livrées au client ou complétées.
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": "tiktok_shop:delivered_orders",
"component": "number_v1",
"metrics": [
"delivered_orders"
]
}
]
}Chiffres
22 métriques
Ordres
Nombre de commandes passées durant la période analysée, excluant les commandes non payées, les commandes annulées et les commandes d'échantillons envoyées aux créateurs.
tiktok_shop:ordersCommandes livrées
Commandes passées durant la période analysée qui ont été livrées au client ou complétées.
tiktok_shop:delivered_ordersCommandes annulées
Commandes dont l'annulation a été complétée durant la période analysée, peu importe quand elles ont été passées.
tiktok_shop:cancelled_ordersArticles vendus
Unités vendues sur les commandes passées durant la période analysée.
tiktok_shop:items_soldClients
Nombre de clients distincts ayant passé des commandes durant la période analysée.
tiktok_shop:customersVentes brutes
Prix des produits avant remises sur les commandes passées durant la période analysée.
tiktok_shop:gross_salesRemise du vendeur
Remises prises en charge par la boutique sur les commandes passées durant la période analysée.
tiktok_shop:seller_discountRemise de la plateforme
Remises prises en charge par TikTok Shop sur les commandes passées durant la période analysée. Étant donné qu'elles sont payées par la plateforme, elles ne sont pas déduites des ventes de la boutique.
tiktok_shop:platform_discountVentes nettes
Ventes brutes moins les remises prises en charge par la boutique et les remboursements complétés durant la période analysée.
tiktok_shop:net_salesExpédition
Frais de port payés par les clients sur les commandes passées durant la période analysée.
tiktok_shop:shippingTaxes
Taxes appliquées sur les commandes passées durant la période analysée.
tiktok_shop:taxesVentes Totales
Ventes nettes plus les frais de port et les taxes appliquées sur les commandes passées durant la période analysée. Les commandes annulées ne sont jamais incluses dans les ventes, c'est pourquoi les annulations ne sont pas déduites.
tiktok_shop:total_salesValeur moyenne des commandes
Montant des produits des commandes passées durant la période analysée, avant remises et remboursements, divisé par le nombre de commandes.
tiktok_shop:average_order_valueArticles par commande
Articles vendus divisés par le nombre de commandes passées durant la période analysée.
tiktok_shop:items_per_orderMontant des annulations
Montant remboursé aux clients pour les annulations complètes durant la période analysée.
tiktok_shop:cancelled_amountRemboursements
Demandes de retour et de remboursement complétées avec remboursement durant la période analysée, peu importe quand la commande a été passée.
tiktok_shop:refundsArticles remboursés
Unités remboursées par les retours complétés durant la période analysée.
tiktok_shop:refunded_itemsValeur des remboursements
Montant remboursé aux clients pour les retours complets durant la période analysée.
tiktok_shop:refunded_amountTaux d'annulation
Commandes dont l'annulation a été complétée durant la période analysée divisées par les commandes passées durant cette période.
tiktok_shop:cancellation_rateTaux de remboursement
Retours complétés avec remboursement durant la période analysée divisés par les commandes passées durant cette période.
tiktok_shop:refund_rateFrais de port moyen
Frais de port payés par les clients divisés par le nombre de commandes passées durant la période analysée.
tiktok_shop:average_shippingRemise moyenne
Remises financées par la boutique divisées par le nombre de commandes passées durant la période analysée.
tiktok_shop:average_discount
Graphiques
5 métriques
Commandes au fil du temps
Commandes passées chaque jour durant la période analysée.
tiktok_shop:orders_over_timeVentes dans le temps
Total des ventes des commandes passées chaque jour durant la période analysée.
tiktok_shop:sales_over_timeCommandes par situation
Répartition des commandes passées durant la période analysée par la situation actuelle, y compris les commandes non payées et annulées.
tiktok_shop:orders_by_statusAnnulations par demandeur
Répartition des annulations complètes durant la période analysée par qui les a demandées : le client, la boutique, les opérateurs de TikTok Shop ou le système.
tiktok_shop:cancellations_by_initiatorRetours par type
Répartition des retours complétés durant la période analysée par la solution apportée : remboursement uniquement, retour et remboursement, remplacement ou échange.
tiktok_shop:returns_by_type
Tableaux
7 métriques
Résumé des ventes
Ventes des commandes passées chaque jour durant la période analysée, nettes des remboursements complétés ce jour-là.
tiktok_shop:sales_summaryAnnulations et remboursements par jour
Annulations et remboursements complétés chaque jour durant la période analysée.
tiktok_shop:cancellations_and_refunds_by_dayVentes par mode de paiement
Commandes passées durant la période analysée regroupées par le mode de paiement choisi par le client.
tiktok_shop:sales_by_payment_methodProduits les plus vendus
Produits vendus durant la période analysée ; les ventes nettes déduisent les remboursements de ces articles complétés durant la période. La situation, les variations et le stock reflètent le catalogue au moment du rapport, pas durant la période.
tiktok_shop:best_selling_productsVentes par variante
Variantes de produit vendues durant la période analysée ; les ventes nettes déduisent les remboursements de ces articles complétés durant la période. Le prix et le stock reflètent le catalogue au moment du rapport, pas durant la période.
tiktok_shop:sales_by_variantAnnulations par raison
Annulations complètes durant la période analysée regroupées par la raison indiquée.
tiktok_shop:cancellations_by_reasonRetours par motif
Retours complétés durant la période analysée regroupés par le motif indiqué par le client.
tiktok_shop:returns_by_reason
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
