Come funziona l'importazione dei dati
Panoramica
Una volta collegato il tuo TikTok Shop, Dashboardly inizia automaticamente a importare i tuoi dati. Questo processo acquisisce i tuoi prodotti, ordini, estratti conto finanziari, rimborsi e altro ancora, in modo che le tue dashboard, i report di profitti e perdite e tutte le altre pagine di analisi siano popolati con numeri accurati.
Non devi fare nulla manualmente: le importazioni avvengono in background. Puoi continuare a usare Dashboardly mentre l'importazione è in corso; le pagine si popolano progressivamente man mano che ogni tipo di dato diventa disponibile.
Cosa viene importato
Dashboardly importa i seguenti tipi di dati da TikTok Shop:
| Tipo di dato | Descrizione |
|---|---|
| Prodotti | Il tuo catalogo prodotti completo, inclusi SKU, prezzi e immagini |
| Inventario prodotti | Livelli di stock in tutti i magazzini (FBS e FBT) |
| Ordini | Cronologia completa degli ordini con dati del cliente e stato dell'ordine |
| Voci degli ordini | Singoli articoli all'interno di ciascun ordine |
| Estratti conto finanziari | Estratti dei pagamenti con la suddivisione dei ricavi |
| Transazioni degli estratti conto | Dettagli finanziari a livello di ordine (commissioni, tasse, sconti) |
| Rimborsi e resi | Tutti gli ordini rimborsati e restituiti con importi e motivazioni |
| Dati di magazzino | Informazioni sui magazzini FBT e spedizioni in entrata |
Fasi dell'importazione
L'importazione viene eseguita tramite una pipeline a più fasi. Vedrai l'avanzamento di ogni fase in tempo reale:
- Catalogo prodotti -- recupera tutti i tuoi prodotti e SKU
- Dettagli e immagini dei prodotti -- scarica le informazioni estese sui prodotti
- Inventario prodotti -- sincronizza i livelli di stock correnti per magazzino
- Ordini -- scarica la cronologia completa dei tuoi ordini
- Estratti conto finanziari -- recupera i dati di liquidazione dei pagamenti
- Transazioni degli estratti conto -- importa le suddivisioni finanziarie a livello di ordine
- Rimborsi e resi -- importa tutti i record di resi e rimborsi
- Magazzini e FBT -- sincronizza i dati di magazzino e di evasione (se applicabile)
- Analisi e metriche -- calcola le metriche aziendali da tutti i dati importati
Prodotti sintetici per gli ordini all'asta
Se vendi tramite il Countdown Bidding (aste) di TikTok, Dashboardly crea automaticamente record di prodotto per queste inserzioni temporanee. I prodotti vengono raggruppati per nome: se vendi lo stesso articolo tramite più sessioni di Countdown Bidding, esso appare come un unico prodotto nelle tue analisi. Non è necessaria alcuna azione da parte tua.
Quanto dura la prima importazione?
Il tempo di importazione dipende dalle dimensioni del tuo negozio:
| Dimensione del negozio | Tempo stimato |
|---|---|
| Piccolo (meno di 100 ordini) | 5 -- 15 minuti |
| Medio (100 -- 10K ordini) | 30 minuti -- 2 ore |
| Grande (10K -- 250K ordini) | 2 -- 8 ore |
| Molto grande (250K+ ordini) | 8+ ore |
Durante l'importazione, vedrai una finestra di avanzamento con:
- Una barra di avanzamento complessiva
- Lo stato di ogni fase di importazione (in attesa, in corso, completata)
- Il tempo stimato rimanente
- Gli elementi elaborati rispetto al totale
Puoi chiudere la finestra e continuare a usare Dashboardly: l'importazione viene eseguita in background.
Affidabilità dell'importazione
Dashboardly è progettato per gestire in modo affidabile importazioni di qualsiasi dimensione:
- Importazioni di lunga durata. Per i negozi di grandi dimensioni, le importazioni possono richiedere diverse ore. Dashboardly mantiene attiva la tua sessione API per tutta la durata, in modo che le importazioni si completino senza errori di autorizzazione. Se un token scade effettivamente, ricollega il negozio in Impostazioni → Negozi e l'importazione riprenderà .
- Tentativi automatici per i dati di marketing. Se si verifica un errore di rete temporaneo durante l'importazione dei tuoi dati di TikTok Ads, l'importazione viene ritentata automaticamente. Non devi fare nulla.
Sincronizzazione automatica dei dati (dopo l'importazione iniziale)
Dopo l'importazione iniziale, Dashboardly mantiene i tuoi dati aggiornati automaticamente:
- La sincronizzazione programmata viene eseguita due volte al giorno, alle 02:00 e alle 14:00 UTC
- Ogni sincronizzazione programmata esamina gli ultimi 3 giorni di dati per intercettare eventuali aggiornamenti che TikTok ha emesso dall'esecuzione precedente
- I webhook di TikTok forniscono aggiornamenti in tempo reale per nuovi ordini, modifiche ai prodotti e resi
Non devi fare nulla: i tuoi dati restano aggiornati automaticamente.
Note importanti
Ritardo degli estratti conto finanziari
Gli estratti conto finanziari di TikTok richiedono almeno 48 ore per diventare disponibili dopo che un ordine è stato effettuato. Se vedi ordini senza dati finanziari, è normale: gli estratti conto appaiono alla sincronizzazione successiva al momento in cui TikTok li genera.
Completezza dei dati
Le suddivisioni di commissioni e tasse per i tuoi ordini vengono recuperate automaticamente quando i dati di TikTok arrivano in ritardo o erano inizialmente incompleti. Ciò significa che i tuoi calcoli di Profit & Loss diventano completi prima, senza che tu debba avviare una sincronizzazione manuale.
Accuratezza dei dati
Dashboardly importa i dati esattamente come forniti dall'API di TikTok. Se noti discrepanze, consulta I miei numeri non corrispondono a TikTok e Comprendere la qualità dei tuoi dati.
Avviare un'importazione manuale
Se hai bisogno di aggiornare i tuoi dati immediatamente:
- Vai su Impostazioni → Cronologia importazioni
- Fai clic su Esegui importazione
- L'importazione elabora tutti i tipi di dati e mostra l'avanzamento
Questa utilizza la stessa pipeline della sincronizzazione automatica. Non elimina i dati esistenti: li aggiorna e vi aggiunge nuovi dati.
Suggerimenti
- Non scollegare e ricollegare il tuo negozio per "risolvere" problemi sui dati. Una sincronizzazione manuale è l'approccio corretto.
- Controlla Impostazioni → Cronologia importazioni se i tuoi numeri sembrano obsoleti. Puoi vedere lo stato dell'ultima sincronizzazione e avviare una sincronizzazione manuale se necessario.
- I negozi di grandi dimensioni possono mostrare dati parziali sulla Dashboard mentre l'importazione è ancora in corso. Attendi il completamento dell'importazione prima di valutare i tuoi numeri.
Problemi comuni
Importazione bloccata in una fase
Occasionalmente, un'importazione può bloccarsi a causa di limiti temporanei di frequenza dell'API di TikTok. Dashboardly ritenta automaticamente con ritardi crescenti. Se un'importazione non mostra alcun avanzamento per oltre ~2 ore, contatta l'assistenza.
Importazione completata ma i dati sembrano incompleti
Verifica se TikTok Seller Center mostra dati per lo stesso intervallo di date. Alcune metriche (come gli estratti conto finanziari) sono disponibili solo dopo che TikTok le ha finalizzate, il che richiede almeno 48 ore ma può essere più lungo per alcuni ordini.
Errore "Importazione fallita"
Di solito significa che l'API di TikTok ha restituito un errore. Cause comuni:
- Il tuo token di autorizzazione è scaduto (ricollega il negozio in Impostazioni → Negozi)
- I server di TikTok erano temporaneamente non disponibili (l'importazione verrà ritentata automaticamente)
- Il tuo negozio è stato sospeso o limitato da parte di TikTok
Se il problema persiste dopo aver ricollegato il negozio, contatta l'assistenza.