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"
      ]
    }
  ]
}
Exemple : « Ordres » en octobre, comparé à septembre.

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:orders
  • Commandes 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_orders
  • Commandes 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_orders
  • Articles vendus

    Unités vendues sur les commandes passées durant la période analysée.

    tiktok_shop:items_sold
  • Clients

    Nombre de clients distincts ayant passé des commandes durant la période analysée.

    tiktok_shop:customers
  • Ventes brutes

    Prix des produits avant remises sur les commandes passées durant la période analysée.

    tiktok_shop:gross_sales
  • Remise du vendeur

    Remises prises en charge par la boutique sur les commandes passées durant la période analysée.

    tiktok_shop:seller_discount
  • Remise 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_discount
  • Ventes 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_sales
  • Expédition

    Frais de port payés par les clients sur les commandes passées durant la période analysée.

    tiktok_shop:shipping
  • Taxes

    Taxes appliquées sur les commandes passées durant la période analysée.

    tiktok_shop:taxes
  • Ventes 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_sales
  • Valeur 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_value
  • Articles par commande

    Articles vendus divisés par le nombre de commandes passées durant la période analysée.

    tiktok_shop:items_per_order
  • Montant des annulations

    Montant remboursé aux clients pour les annulations complètes durant la période analysée.

    tiktok_shop:cancelled_amount
  • Remboursements

    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:refunds
  • Articles remboursés

    Unités remboursées par les retours complétés durant la période analysée.

    tiktok_shop:refunded_items
  • Valeur des remboursements

    Montant remboursé aux clients pour les retours complets durant la période analysée.

    tiktok_shop:refunded_amount
  • Taux 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_rate
  • Taux 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_rate
  • Frais 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_shipping
  • Remise 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_time
  • Ventes dans le temps

    Total des ventes des commandes passées chaque jour durant la période analysée.

    tiktok_shop:sales_over_time
  • Commandes 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_status
  • Annulations 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_initiator
  • Retours 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_summary
  • Annulations et remboursements par jour

    Annulations et remboursements complétés chaque jour durant la période analysée.

    tiktok_shop:cancellations_and_refunds_by_day
  • Ventes 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_method
  • Produits 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_products
  • Ventes 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_variant
  • Annulations par raison

    Annulations complètes durant la période analysée regroupées par la raison indiquée.

    tiktok_shop:cancellations_by_reason
  • Retours 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.