Comment fonctionne l'importation des données
Vue d'ensemble
Dès que vous connectez votre TikTok Shop, Dashboardly commence automatiquement à importer vos données. Ce processus récupère vos produits, commandes, relevés financiers, remboursements, et bien plus, afin que vos tableaux de bord, vos rapports de profits et pertes et toutes les autres pages d'analyse soient renseignés avec des chiffres exacts.
Vous n'avez rien à faire manuellement -- les importations se déroulent en arrière-plan. Vous pouvez continuer à utiliser Dashboardly pendant que l'importation est en cours ; les pages se remplissent progressivement à mesure que chaque type de données devient disponible.
Ce qui est importé
Dashboardly importe les types de données suivants depuis TikTok Shop :
| Type de données | Description |
|---|---|
| Produits | Votre catalogue de produits complet, y compris les SKU, les prix et les images |
| Inventaire des produits | Niveaux de stock dans tous les entrepôts (FBS et FBT) |
| Commandes | Historique complet des commandes avec les données clients et le statut des commandes |
| Lignes de commande | Articles individuels au sein de chaque commande |
| Relevés financiers | Relevés de paiement avec ventilation des revenus |
| Transactions de relevé | Détails financiers au niveau de la commande (frais, taxes, remises) |
| Remboursements et retours | Toutes les commandes remboursées et retournées avec les montants et les motifs |
| Données d'entrepôt | Informations sur les entrepôts FBT et les expéditions entrantes |
Étapes de l'importation
L'importation suit un pipeline en plusieurs étapes. Vous verrez la progression de chaque étape en temps réel :
- Catalogue de produits -- récupère tous vos produits et SKU
- Détails et images des produits -- télécharge les informations produit étendues
- Inventaire des produits -- synchronise les niveaux de stock actuels par entrepôt
- Commandes -- télécharge l'historique complet de vos commandes
- Relevés financiers -- récupère les données de règlement des paiements
- Transactions de relevé -- importe les ventilations financières au niveau de la commande
- Remboursements et retours -- importe tous les enregistrements de retour et de remboursement
- Entrepôts et FBT -- synchronise les données d'entrepôt et de traitement des commandes (le cas échéant)
- Analyses et indicateurs -- calcule les indicateurs métier à partir de toutes les données importées
Produits synthétiques pour les commandes aux enchères
Si vous vendez via le Countdown Bidding (enchères) de TikTok, Dashboardly crée automatiquement des fiches produit pour ces annonces temporaires. Les produits sont regroupés par nom -- si vous vendez le même article via plusieurs sessions de Countdown Bidding, il apparaît comme un seul produit dans vos analyses. Aucune action n'est requise de votre part.
Combien de temps prend la première importation ?
La durée de l'importation dépend de la taille de votre boutique :
| Taille de la boutique | Durée estimée |
|---|---|
| Petite (moins de 100 commandes) | 5 -- 15 minutes |
| Moyenne (100 -- 10 K commandes) | 30 minutes -- 2 heures |
| Grande (10 K -- 250 K commandes) | 2 -- 8 heures |
| Très grande (250 K+ commandes) | 8 heures et plus |
Pendant l'importation, vous verrez une fenêtre de progression avec :
- Une barre de progression globale
- Le statut de chaque étape d'importation (en attente, en cours, terminée)
- Le temps restant estimé
- Les éléments traités par rapport au total
Vous pouvez fermer la fenêtre et continuer à utiliser Dashboardly -- l'importation se poursuit en arrière-plan.
Fiabilité de l'importation
Dashboardly est conçu pour gérer de manière fiable des importations de toute taille :
- Importations de longue durée. Pour les grandes boutiques, les importations peuvent prendre plusieurs heures. Dashboardly maintient votre session API active pendant toute la durée afin que les importations se terminent sans erreurs d'autorisation. Si un jeton expire réellement, reconnectez la boutique dans Paramètres → Boutiques et l'importation reprendra.
- Nouvelles tentatives automatiques pour les données marketing. Si une erreur réseau temporaire survient lors de l'importation de vos données TikTok Ads, l'importation est relancée automatiquement. Vous n'avez rien à faire.
Synchronisation automatique des données (après l'importation initiale)
Après l'importation initiale, Dashboardly maintient vos données à jour automatiquement :
- La synchronisation planifiée s'exécute deux fois par jour, à 02:00 et 14:00 UTC
- Chaque synchronisation planifiée examine les données des 3 derniers jours pour récupérer toutes les mises à jour émises par TikTok depuis l'exécution précédente
- Les webhooks de TikTok fournissent des mises à jour en temps réel pour les nouvelles commandes, les modifications de produits et les retours
Vous n'avez rien à faire -- vos données restent à jour automatiquement.
Remarques importantes
Délai des relevés financiers
Les relevés financiers de TikTok mettent au moins 48 heures à devenir disponibles après le passage d'une commande. Si vous voyez des commandes sans données financières, c'est normal -- les relevés apparaissent lors de la synchronisation suivant leur génération par TikTok.
Exhaustivité des données
Les ventilations des frais et des taxes de vos commandes sont récupérées automatiquement lorsque les données de TikTok arrivent en retard ou étaient initialement incomplètes. Cela signifie que vos calculs de Profit & Loss deviennent complets plus rapidement, sans que vous ayez à déclencher une synchronisation manuelle.
Exactitude des données
Dashboardly importe les données exactement telles que fournies par l'API de TikTok. Si vous constatez des écarts, consultez My Numbers Don't Match TikTok et Understanding Your Data Quality.
Déclencher une importation manuelle
Si vous devez actualiser vos données immédiatement :
- Allez dans Paramètres → Historique des importations
- Cliquez sur Lancer l'importation
- L'importation traite tous les types de données et affiche la progression
Cela utilise le même pipeline que la synchronisation automatique. Elle ne supprime pas les données existantes -- elle les met à jour et les complète.
Astuces
- Ne déconnectez pas et ne reconnectez pas votre boutique pour « réparer » des problèmes de données. Une synchronisation manuelle est la bonne approche.
- Consultez Paramètres → Historique des importations si vos chiffres semblent obsolètes. Vous pouvez y voir le statut de la dernière synchronisation et déclencher une synchronisation manuelle si nécessaire.
- Les grandes boutiques peuvent voir des données partielles sur le Dashboard pendant que l'importation est encore en cours. Attendez la fin de l'importation avant d'évaluer vos chiffres.
Problèmes courants
Importation bloquée à une étape
Il arrive qu'une importation se bloque en raison de limites de débit temporaires de l'API TikTok. Dashboardly réessaie automatiquement avec des délais croissants. Si une importation ne montre aucune progression pendant plus de ~2 heures, contactez le support.
L'importation est terminée mais les données semblent incomplètes
Vérifiez si TikTok Seller Center affiche des données pour la même plage de dates. Certains indicateurs (comme les relevés financiers) ne sont disponibles qu'une fois que TikTok les a finalisés, ce qui prend au moins 48 heures, mais peut être plus long pour certaines commandes.
Erreur « Échec de l'importation »
Cela signifie généralement que l'API de TikTok a renvoyé une erreur. Causes fréquentes :
- Votre jeton d'autorisation a expiré (reconnectez la boutique dans Paramètres → Boutiques)
- Les serveurs de TikTok étaient temporairement indisponibles (l'importation réessaiera automatiquement)
- Votre boutique a été suspendue ou restreinte du côté de TikTok
Si le problème persiste après la reconnexion, contactez le support.