Come eseguire l'integrazione con ShipStation

Cosa imparerai

Scopri come integrare ShipStation con Klaviyo. Questa integrazione sincronizza ogni 30 minuti i dati relativi alla creazione dell'ordine e allo stato di spedizione da ShipStation. Dopo aver completato i passaggi di questo articolo, potrai personalizzare e fare targeting sulle e-mail in base agli eventi di spedizione e agli stati degli ordini tracciati da ShipStation.

Prima di iniziare

Questa integrazione utilizza l'API V1 di ShipStation, che richiede il piano ShipStation Standard o Premium.

Ti serve anche l'autorizzazione per gestire le integrazioni nel tuo account Klaviyo.

Crea una chiave API e un segreto in ShipStation

Per eseguire l'integrazione con Klaviyo, ti serviranno una chiave API e un segreto di ShipStation. Devi usare l’API V1 di ShipStation per integrarti. Le chiavi API e gli API secret verranno mostrati nell’interfaccia utente di ShipStation solo quando vengono generati e solo alla persona che li ha generati.

Se hai già generato e salvato una chiave e un segreto V1, puoi passare direttamente alla sezione successiva. In caso contrario, creali in ShipStation:

1. Nel tuo account ShipStation, seleziona l'icona a forma di ingranaggio per accedere alle impostazioni del tuo account.
2. Seleziona Account > Impostazioni API.
   
3. Seleziona API V1 dal menu a discesa e fai clic su Genera chiave API.
   

4. Fai clic sul link di verifica inviato da ShipStation al tuo indirizzo e-mail. Il pulsante Genera chiave API verrà reimpostato una volta verificata la tua e-mail. Una volta reimpostato, fai clic di nuovo su Genera chiave API.
5. Imposta la scadenza (3, 6 o 12 mesi) per la nuova chiave API, quindi fai clic su Genera.
6. Copia la chiave API e il segreto API appena generati e assicurati di conservarli in modo sicuro. Tieni presente che dovrai ruotare la tua chiave e aggiornarla in Klaviyo una volta scaduta.

Scopri di più su generazione e rotazione delle chiavi API in ShipStation.

Integra ShipStation con Klaviyo

1. Vai al tuo account Klaviyo e seleziona la scheda Integrazioni.
2. Clicca su Scopri le app e cerca ShipStation, quindi clicca sulla scheda.
3. Dopodiché, clicca su Installa.
4. Inserisci la chiave API e l’API secret generati in ShipStation, quindi clicca su Connetti a ShipStation.
   

5. Se l'integrazione è andata a buon fine, vedrai un messaggio di operazione completata.

Monitora la sincronizzazione di Klaviyo

L'integrazione ShipStation sincronizza i dati da tutti i tuoi store ShipStation, permettendoti di filtrare segmenti e flussi in base al nome dello store, e sincronizza automaticamente gli ultimi 90 giorni di dati. Dopo il completamento dell'integrazione iniziale, viene eseguita una sincronizzazione periodica ogni 30 minuti, che cerca aggiornamenti di stato per creare eventi aggiuntivi in Klaviyo. Solo gli ordini e le spedizioni con un indirizzo e-mail cliente valido vengono sincronizzati in Klaviyo.

Per controllare la sincronizzazione della tua integrazione:

1. Fai clic sul menu a tendina Analisi in Klaviyo e seleziona Metrica.
2. Seleziona ShipStation dal filtro integrazione.
3. Fai clic su una metrica di ShipStation, ad esempio Order Awaiting Shipment, quindi seleziona la scheda Feed attività.
4. Se la tua integrazione ha iniziato a sincronizzare i dati, inizierai a vedere eventi aggiunti a questo feed di attività.

Per verificare i dati delle spedizioni, confronta il numero di eventi Order Shipped per un giorno specifico con i record di spedizione di ShipStation creati quel giorno. Ogni spedizione crea un evento separato, quindi un ordine con più spedizioni può apparire più di una volta.

1. In Klaviyo, vai su Analytics > Metrics e fai clic sulla metrica Order Shipped.
2. Questo ti porterà alla pagina del grafico delle metriche che, per impostazione predefinita, mostrerà gli ultimi 30 giorni di dati.
3. Passa il mouse sul punto dati di ieri oppure guarda la tabella sotto il grafico per vedere quanti eventi Ordine spedito si sono verificati ieri. Confronta questo numero con i record di spedizione ShipStation creati quel giorno.

Se i conteggi differiscono, considera l’intervallo di sincronizzazione di 30 minuti e verifica che i record di spedizione abbiano indirizzi e-mail cliente validi. Confronta inoltre lo stesso intervallo di date e lo stesso fuso orario in entrambi gli account. Per controllare l'impostazione del fuso orario in Klaviyo:

1. Fai clic sul nome del tuo account in basso a sinistra.
2. Seleziona Impostazioni > Generale > Account.
3. Scorri verso il basso fino a Fuso orario.

Metriche di ShipStation

ShipStation sincronizza le seguenti metriche con Klaviyo:

• Ordine in attesa di spedizione
• Ordine in attesa di pagamento
• Ordine in sospeso
• Ordine spedito
• Ordine annullato

Per maggiori informazioni sugli stati degli ordini specifici tracciati in ShipStation, consulta la documentazione di ShipStation.

Ordine in attesa di spedizione

Questa metrica viene tracciata quando un ordine è pronto per la spedizione in ShipStation.

Ordine in attesa di pagamento

Questa metrica viene tracciata quando un ordine non è pagato ed è contrassegnato come In attesa di pagamento in ShipStation. Non tutti i negozi supportano gli ordini non pagati. Quando un ordine viene pagato, il negozio invierà a ShipStation le informazioni aggiornate sull’ordine oppure puoi contrassegnare manualmente l’ordine come pagato; quindi ShipStation contrassegnerà l’ordine come pronto per la spedizione. Klaviyo registra un evento Order Awaiting Shipment quando sincronizza lo stato aggiornato.

Ordine in sospeso

Questa metrica viene monitorata quando utilizzi l'azione Hold in ShipStation per mettere in attesa un ordine. Questo è utile per i preordini, per ritardare gli ordini con prodotti non disponibili oppure per ritardare gli ordini per qualsiasi altro motivo. Gli ordini possono essere impostati su In attesa fino a una data prestabilita o dopo un numero specificato di giorni.

Ordine spedito

Questa metrica viene monitorata una volta stampata un'etichetta per un ordine, momento in cui ShipStation sposta l'ordine allo stato Spedito. L'evento usa l'orario di creazione della spedizione e non conferma la consegna. Gli ordini contrassegnati manualmente come spediti o contrassegnati come spediti da un soggetto terzo per le spedizioni non attivano questa metrica.

Ordine annullato

Questa metrica viene monitorata quando un ordine viene annullato in ShipStation.

Risultato

Hai completato l'integrazione con ShipStation e hai verificato i dati di ShipStation in Klaviyo. Ora potrai personalizzare le e-mail ed effettuare il targeting in base agli eventi di spedizione e allo stato dell'ordine tracciato da ShipStation.

Risorse aggiuntive