Cosa fa l'importazione degli ordini Shopify storici in Alva?
L'importazione degli ordini Shopify storici in Alva Digital Downloads ricrea i record di acquisto per gli ordini effettuati prima dell'installazione dell'app. L'importatore legge un CSV degli ordini passati, abbina ogni voce di riga a una mappatura del prodotto esistente e scrive l'acquisto mancante. I download appaiono poi retroattivamente sulla pagina dell'account cliente e sulla pagina di stato dell'ordine.
Pensalo come un recupero retroattivo. Nulla degli ordini originali cambia in Shopify. Alva ottiene semplicemente i record di consegna che non aveva mai ricevuto la prima volta, e ogni cliente abbinato riacquista l'accesso self-service ai file esatti legati a ciò che ha acquistato.
Perché gli ordini precedenti all'installazione non possono scaricare i loro file
Alva consegna i file mettendosi in ascolto del webhook ORDERS_PAID di Shopify. Ogni ordine pagato attiva quel webhook, Alva crea un record di acquisto e il cliente ottiene l'accesso al download. Gli ordini effettuati prima che tu installassi l'app non hanno mai attivato quel webhook per Alva, quindi per loro non è mai stato creato alcun record di acquisto.
Senza un record di acquisto, le superfici rivolte al cliente non hanno nulla da mostrare. Un acquirente che apre la propria pagina di stato dell'ordine o la scheda dei download nel proprio account Shopify vede uno spazio vuoto dove dovrebbe esserci il suo file. Non c'è alcun link da cliccare, perché Alva non ha alcuna traccia del fatto che la vendita sia avvenuta.
In pratica questo si traduce in un flusso di richieste di assistenza del tipo "dov'è il mio file?" — e colpisce più duramente nei giorni subito dopo il cambio di app, quando i clienti di lunga data tornano aspettandosi che il pulsante di download che usavano prima funzioni ancora.
Le tre garanzie inderogabili: niente email, niente controlli antifrode, niente chiavi di licenza
Un'importazione storica può toccare migliaia di vecchi ordini in una volta sola, quindi Alva la tratta come un'operazione silenziosa con tre garanzie applicate a livello di codice. L'importazione non invia email, non esegue controlli antifrode e non assegna chiavi di licenza. Nessuna di queste può essere riattivata per l'importazione — sono limiti rigidi e deliberati.
Il ragionamento dietro ciascuna è semplice:
- Niente email. Recuperare due anni di ordini non deve mai bombardare due anni di clienti con notifiche di consegna. Nessuno riceve un'email; i download diventano semplicemente disponibili per la volta successiva in cui ciascun cliente visita il proprio account.
- Niente controlli antifrode. Questi ordini sono già stati pagati, evasi e regolati molto tempo fa. Rieseguirli attraverso la pipeline antifrode inonderebbe la tua coda di controlli su transazioni che appartengono a un lontano passato.
- Niente chiavi di licenza. L'importazione non attinge mai dalle tue scorte di chiavi di licenza. Un recupero in blocco che assegnasse chiavi a vecchi ordini potrebbe esaurire silenziosamente l'inventario che stai conservando per le vendite dal vivo, quindi l'assegnazione delle chiavi viene saltata completamente.
Il senso stesso dell'importazione storica è ripristinare l'accesso in silenzio. È una riparazione in background, non una nuova evasione. I tuoi clienti riottengono i loro download senza una singola notifica, e il tuo inventario di chiavi di licenza e la tua coda antifrode restano intatti.
È idempotente, quindi rieseguirla è sicuro
L'importazione storica è idempotente, il che significa che eseguirla due volte produce lo stesso risultato di eseguirla una sola volta. Ricaricare lo stesso CSV non crea acquisti duplicati — Alva riconosce i record che esistono già e li salta, creando solo gli acquisti che mancano davvero.
Questa rete di sicurezza conta più di quanto sembri. Se un caricamento di grandi dimensioni viene interrotto, puoi semplicemente rieseguirlo. Se in seguito aggiungi mappature dei prodotti per un secondo gruppo di prodotti, puoi reimportare la stessa cronologia degli ordini e solo gli ordini appena mappabili vengono recuperati. Non c'è alcuna penalità nell'eseguirla più di una volta.
Come importare i tuoi ordini storici, passo dopo passo
L'importazione si basa su un CSV che esporti da Shopify. A grandi linee ci sono quattro passaggi: mappa i tuoi prodotti, esporta gli ordini, carica il file e importa. Prima di iniziare, assicurati che i tuoi prodotti digitali siano già mappati ai loro file in Alva — l'importatore effettua l'abbinamento rispetto a quelle mappature.
1. Mappa prima i tuoi prodotti ai file
L'importatore funziona abbinando le voci di riga di ogni ordine storico alle tue mappature dei prodotti esistenti. Se un prodotto non è ancora mappato a un file, un pacchetto o un link in Alva, i suoi vecchi ordini non hanno nulla a cui collegarsi. Configura le tue mappature prima di importare così ogni ordine passato può trovare il suo abbinamento.
2. Esporta gli ordini storici da Shopify
Nel tuo admin Shopify, apri Ordini, filtra all'intervallo di date che vuoi recuperare, e usa Esporta per scaricare gli ordini come CSV. La documentazione sull'esportazione degli ordini di Shopify illustra i filtri e il formato del file.
3. Carica il CSV in Alva e importa
Tornato nell'admin di Alva, apri l'importazione degli ordini storici, carica il tuo CSV ed esegui l'importazione. Alva legge ogni riga, abbina le voci di riga alle tue mappature e crea gli acquisti mancanti. Quando termina, i download di ogni ordine abbinato sono attivi sulle pagine dell'account cliente e di stato dell'ordine.
Le importazioni CSV sono esigenti riguardo ai nomi e ai formati delle colonne. Per le colonne esatte che Alva si aspetta e una guida dettagliata schermata per schermata, segui l'articolo di supporto passo dopo passo su come importare gli ordini Shopify storici prima di caricare.
Migrare da SendOwl, Gumroad o dai download nativi di Shopify
Il cambio di strumenti di consegna digitale è il momento in cui questa funzione dimostra il suo valore. Quando passi ad Alva da SendOwl, Gumroad o dal flusso nativo di download digitali di Shopify, solo i nuovi ordini iniziano a fluire automaticamente attraverso Alva. Ogni vendita precedente al cambio è invisibile alla nuova app finché non la recuperi.
L'importazione storica è il passaggio che mantiene integri i tuoi clienti esistenti durante una migrazione. Importa i tuoi ordini passati e nessuno perde l'accesso a ciò che ha già acquistato — l'acquirente che ha comprato un pacchetto di preset l'anno scorso può ancora riscaricarlo, anche se quella vendita è avvenuta sulla tua vecchia piattaforma. Se stai valutando un cambio, il nostro approfondimento su com'è davvero passare da SendOwl ad Alva copre il resto della transizione.
Dove appaiono i download importati per i clienti
Una volta importato, un acquisto storico si comporta come qualsiasi altro. Il download appare sulla pagina di stato dell'ordine Shopify per quell'ordine e nella sezione download digitali dell'account del cliente, così gli acquirenti possono servirsi da soli senza contattarti. Riutilizza le stesse superfici di consegna che ogni ordine Alva dal vivo già attiva.
Poiché non viene inviata alcuna email, l'accesso è lì ad attendere anziché annunciato. Di solito è esattamente ciò che vuoi dopo una migrazione: la volta successiva in cui un cliente passato cerca il suo file, è semplicemente lì. Per una panoramica di ogni luogo in cui i clienti possono raggiungere i loro file, consulta la nostra guida ai modi in cui i clienti ricevono i loro download digitali su Shopify.
Chi può usare l'importazione storica
L'importazione degli ordini storici è oggi disponibile a tutti i negozi Alva, dopo essere uscita da una beta iniziale. Non c'è alcuna lista d'attesa né alcun flag speciale da richiedere — esporta i tuoi ordini, mappa i tuoi prodotti ed eseguila ogni volta che hai bisogno di recuperare. Controlla il tuo piano per i limiti di storage e consegna, poi importa tutti gli ordini passati che la tua cronologia contiene.
Domande frequenti
No. L'importazione degli ordini storici in Alva Digital Downloads invia zero email, per progettazione e applicato a livello di codice. È un recupero silenzioso che crea i record di acquisto mancanti così i download appaiono nell'account di ciascun cliente e nella pagina di stato dell'ordine. Nessun cliente viene avvisato, quindi importare migliaia di vecchi ordini non può mai fare spam ai tuoi acquirenti.
Sì. L'importazione è idempotente, quindi ricaricare lo stesso CSV non crea acquisti duplicati. Se un primo passaggio fallisce a metà strada o aggiungi nuove mappature dei prodotti e vuoi recuperare di nuovo, puoi rieseguirla in sicurezza. I record esistenti vengono riconosciuti e saltati, e vengono creati solo gli acquisti realmente mancanti.
Gli ordini effettuati prima che tu installassi l'app non sono mai passati attraverso il webhook ORDERS_PAID, quindi per loro non esiste alcun record di acquisto. Senza quel record, la pagina di stato dell'ordine e la scheda dell'account cliente non hanno nulla da mostrare. L'importazione storica ricrea gli acquisti mancanti così quei download appaiono retroattivamente.
No. L'importazione storica non assegna chiavi di licenza e non esegue controlli antifrode. Entrambi vengono deliberatamente saltati così un recupero in blocco di vecchi ordini non consuma mai le scorte di chiavi di licenza né inonda la tua coda antifrode. Crea solo i record di acquisto che permettono ai clienti di raggiungere i file legati alle loro mappature dei prodotti esistenti.
Esporta i tuoi ordini storici come CSV dall'admin di Shopify, mappa i tuoi prodotti ai file in Alva, poi carica il CSV in Alva e importa. Lo strumento abbina le voci di riga di ogni ordine alle tue mappature e crea gli acquisti mancanti, così i clienti che hanno acquistato tramite SendOwl, Gumroad o il flusso nativo di Shopify mantengono l'accesso a ciò che già possiedono.