Dopo il lancio di Shopify, verifica questi 5 set di dati
Il progetto Shopify è stato lanciato e il fraintendimento più comune è: la pagina si apre, l’ordine di prova può essere pagato, quindi il rilascio è finito.
Il successo della pagina e della transazione dimostra solo che il flusso principale funziona in una condizione di test. Una volta entrati nell’ambiente di produzione, ordini, tracciamento, Webhook, sincronizzazione dell’inventario e attribuzione del marketing scriveranno dati contemporaneamente. Qualsiasi ripetizione, omissione o ritardo in uno di questi punti può distorcere i report. Questi problemi di solito non generano errori immediati. Il team spesso si rende conto che ci sono stati problemi il giorno del lancio solo quando le conversioni pubblicitarie non corrispondono, il servizio clienti scopre anomalie nell’inventario, o la contabilità si accorge di discrepanze alla fine del mese.
L’accettazione dei dati dopo il rilascio dovrebbe essere un passaggio separato del lancio, con un responsabile, una finestra temporale, ordini campione e standard di approvazione. Non è complicato: lasciare che gli stessi dati aziendali attraversino diversi sistemi e poi verificare ogni registrazione.
Prima di tutto, conserva uno snapshot del rilascio
Prima dell’accettazione, registra la versione di rilascio, l’orario, il negozio, l’ID del tema, la versione dell’app e l’ambito delle modifiche. Quando si esegue shopify app deploy tramite Shopify CLI, la configurazione dell’app e le estensioni formano una versione dell’app e vengono pubblicate. È possibile creare solo la versione senza rilasciarla immediatamente, utilizzando --no-release. Shopify supporta anche il ripristino a una versione precedente dell’app.
Senza uno snapshot, se il team vede un calo improvviso di un indicatore alle 20:00, sarà difficile collegarlo a un rilascio specifico. Si consiglia di conservare commit SHA, versione dell’app, ID del tema, orario di rilascio, operatore e versione della migrazione del database. Se si modifica solo il tema, è necessario annotare gli ID del tema e le configurazioni delle sezioni chiave prima e dopo il rilascio.
Si può concordare di completare il test di fumo entro 15 minuti, controllare errori e flussi di eventi entro 2 ore e verificare le discrepanze nelle conversioni, ordini e piattaforme pubblicitarie dopo 24 ore. Per i negozi ad alto traffico, è utile fare un ulteriore controllo dopo 7 giorni.
Cosa deve lasciare un ordine di 188 euro in sei sistemi
Ad esempio, un negozio indipendente di articoli per animali chiamato “Punto di rifornimento per palline di pelo” ha circa duecento SKU e ha appena lanciato una nuova logica di sconto e Meta Pixel. Il team ha preparato un ordine di prova facilmente identificabile: totale merce 198 euro, sconto 20 euro, spese di spedizione 10 euro, totale pagato 188 euro. Allo stesso tempo, si salvano l’ID dell’ordine, il token di checkout, il codice sconto, il metodo di pagamento, UTM e orario dell’ordine.
Poi si procede alla verifica dell’ordine. Verificare se gli importi, le tasse, le spese di spedizione e gli sconti sono corretti in Shopify Admin; se nel backend di pagamento c’è solo una cattura; se l’inventario è stato ridotto solo una volta; se ERP o WMS hanno ricevuto lo stesso ordine; se le email e i punti fedeltà non sono stati attivati più volte; se gli strumenti di analisi mostrano checkout_started e checkout_completed; se la piattaforma pubblicitaria ha ricevuto importo, valuta e ID evento.
Shopify Web Pixels API definisce checkout_completed come un evento standard attivato quando un visitatore completa un acquisto. È utile per confermare il flusso di analisi front-end, ma non può fungere da verità assoluta per l’ordine. Gli script del browser possono essere bloccati e l’utente potrebbe chiudere la pagina prima che l’evento venga inviato. L’ordine e il pagamento devono essere confermati tramite Shopify Admin, Admin API e registrazioni di pagamento.
È consigliabile effettuare anche un test di rimborso o cancellazione per questo ordine. Altrimenti, si potrebbero perdere importi di rimborso, reintegrazione dell’inventario, revoca dei punti e feedback pubblicitario. Se il negozio supporta più valute, abbonamenti o autorizzazioni seguite da addebiti, è necessario testare almeno uno degli scenari speciali più comuni. Non è necessario coprire tutte le combinazioni in una volta, ma è importante specificare quali combinazioni non sono state verificate.
Non limitarti a controllare “ricevuto” per i Webhook
Nel Shopify Dev Dashboard, sotto Apps > Nome App > Monitoring, puoi visualizzare il conteggio delle consegne, il tasso di fallimento e il tempo di risposta per ciascun topic; Logs consente di filtrare i registri per codice di stato, negozio, tipo di evento e tempo. L’intervallo di tempo dei log include l’ultimo giorno, 7 giorni o 30 giorni, e il monitoraggio dei Webhook supporta l’ultimo giorno o 7 giorni.
Shopify considera una risposta 2xx come un successo. L’interfaccia Webhook deve rispondere entro 5 secondi, altrimenti la consegna fallisce. L’ufficiale considera un tasso di fallimento superiore allo 0,5% come un livello da monitorare e mostra il tempo di risposta P90. Dopo il rilascio, è necessario controllare i topic coinvolti, come orders/create, orders/updated o products/update, non limitandosi a guardare il tasso di successo totale.
I tentativi di ripetizione dei fallimenti possono creare un’illusione. Shopify spiega che i Webhook falliti vengono ripetuti al massimo 8 volte. Il lato di elaborazione deve essere idempotente utilizzando l’ID del webhook o l’ID dell’oggetto aziendale, restituendo rapidamente un 2xx e mettendo i compiti che richiedono tempo in coda. Altrimenti, una query lenta del database potrebbe causare timeout, ripetizioni e scritture duplicate.
Durante l’accettazione, puoi generare manualmente un evento, ad esempio creando un prodotto nel negozio di sviluppo, attivando products/create. Successivamente, confronta il log di consegna di Shopify, il log delle richieste dell’app, i compiti in coda e i registri del database, verificando negozio, topic, ID del webhook e tempo. I log del Dev Dashboard non sono in tempo reale e l’ufficiale avverte che potrebbero esserci ritardi di alcuni minuti. Pertanto, non vedere registrazioni entro pochi secondi non significa necessariamente che ci sia stato un fallimento.
Quando gli indicatori non corrispondono
I numeri di Shopify Analytics, GA4, Meta Ads e del backend di pagamento non sono naturalmente uguali. La definizione di sessione, il fuso orario, la finestra di attribuzione e lo stato di consenso ai cookie possono differire. Il centro assistenza di Shopify specifica anche le discrepanze di Analytics e mostrerà un’icona di interruzione dei dati in alcune schede e report influenzati.
L’accettazione non richiede che tutte le piattaforme siano completamente allineate, ma deve confermare che ciascuna piattaforma registra come concordato e annotare le differenze spiegabili. Ad esempio, se lo stesso utente clicca prima sull’email e poi su Google Shopping, due piattaforme esterne potrebbero registrare conversioni separatamente; il report delle campagne di Shopify potrebbe basarsi sull’ultima attribuzione di clic pubblicitario. Mettere direttamente in relazione i “numeri di acquisto” dei tre backend di solito porta a conclusioni inaffidabili.
Un metodo più pratico è creare un foglio di riconciliazione. Ogni riga rappresenta un ordine di prova, con colonne per l’ordine Shopify, il pagamento, l’evento pixel, la conversione pubblicitaria, l’ordine ERP e i registri di rimborso, verificando ID ordine, importo, valuta, tempo e stato. Se la piattaforma non può trasmettere l’ID ordine, utilizzare l’ID evento consentito o un identificatore di prova per stabilire la corrispondenza. Verifica i campioni prima, poi guarda gli indicatori aggregati, per localizzare i problemi più rapidamente.
È anche necessario preparare una linea di base storica, confrontando il tasso di completamento del checkout, il tasso di fallimento dei pagamenti, il tasso di fallimento dei Webhook e il ritardo nella sincronizzazione dell’inventario nella stessa settimana e nello stesso periodo prima e dopo il rilascio. I campioni dei piccoli negozi potrebbero non essere sufficienti e le fluttuazioni delle conversioni nelle 24 ore potrebbero non avere significato statistico; in questo caso, è meglio concentrarsi sugli ordini di prova tracciabili e sui log degli errori.
Gli standard di approvazione devono determinare il rollback e indicare quali dati non possono essere recuperati
“Sembra normale” non è uno standard di accettazione. Il documento di rilascio deve chiarire almeno alcuni requisiti: l’ordine di prova deve apparire una sola volta nei sistemi necessari; gli importi e le valute devono corrispondere; i Webhook principali non devono avere nuovi 4xx o 5xx; il tempo di risposta P90 non deve avvicinarsi ai 5 secondi; gli eventi chiave del front-end devono attivarsi in sequenza; il campionamento degli ordini reali non deve comportare una doppia riduzione dell’inventario.
I requisiti devono essere combinati con la linea di base esistente. L’ufficiale considera un tasso di fallimento dei Webhook superiore allo 0,5% come elevato, ma un’app che normalmente ha un tasso di fallimento dello 0,02% e che sale allo 0,4% dopo il lancio merita comunque di essere sospesa. Se ci sono state solo una dozzina di consegne, un singolo fallimento può far sembrare il tasso molto elevato; in questo caso, è necessario controllare i log specifici e non eseguire un rollback meccanico.
Le condizioni di rollback devono essere scritte in anticipo: tornare alla versione dell’app, ripristinare il vecchio tema, disattivare il flag della funzionalità o sospendere la coda dei consumatori? Se la migrazione del database non è reversibile, il vecchio codice può ancora leggere la nuova struttura? Discutere dopo che si è verificato un guasto sprecherà il tempo più prezioso.
Shopify può tornare a una versione dell’app, ma i punti già creati, le email già inviate e gli ordini scritti nell’ERP non verranno ripristinati automaticamente e richiederanno un trattamento di compensazione. I ritardi delle applicazioni di terze parti e gli aggiornamenti di attribuzione variano, e l’ufficiale non ha specificato un tempo di accettazione uniforme. Non ho ancora provato questo set di finestre in ogni combinazione di gateway di pagamento e applicazioni di abbonamento, quindi 15 minuti, 2 ore e 24 ore sono solo un punto di partenza.
Infine, i registri devono essere suddivisi in almeno tre sezioni: snapshot del rilascio e ordini di prova, prove e anomalie dei vari sistemi, responsabile e tempo di revisione. La pubblicazione della pagina è solo un’azione completata; questi registri possono dimostrare che i dati di produzione rimangono affidabili.
Riferimenti
Shopify Dev: Monitoring and logs in the Dev Dashboard https://shopify.dev/docs/apps/build/dev-dashboard/monitoring-and-logs
Shopify Dev: Troubleshoot webhooks https://shopify.dev/docs/apps/build/webhooks/troubleshoot
Shopify Dev: Deploy app versions https://shopify.dev/docs/apps/launch/deployment/deploy-app-versions
Shopify Dev: Web Pixels API Standard Events https://shopify.dev/docs/api/web-pixels-api/standard-events
Shopify Help Center: Analytics discrepancies https://help.shopify.com/en/manual/reports-and-analytics/discrepancies