Menu della documentazione

Shopify

Collega un negozio Shopify per sincronizzare i suoi clienti in una lista contatti di MailInApp, attivare journey a partire da eventi reali del negozio e vedere i ricavi ricondursi a una campagna o a una variante.

Video in inglese

Collega il tuo negozio

Per collegare un negozio crei una piccola app nel tuo admin di Shopify, poi incolli le due chiavi di quell'app in MailInApp. Ci vogliono circa cinque minuti. Non ti servono un account Shopify Partner né codice, e l'app resta privata del tuo negozio.

Devi essere il proprietario del negozio su Shopify (o un collaboratore autorizzato a sviluppare app) e il proprietario del tuo account MailInApp.

Passo 1: apri il Dev Dashboard

Nell'admin di Shopify, vai su Impostazioni → App e fai clic su Develop apps in alto a destra.

La pagina Impostazioni → App dell'admin di Shopify, con il pulsante Develop apps evidenziato

Nella pagina App development, fai clic su Build apps in Dev Dashboard. La prima volta, Shopify ti chiede di confermare la tua email e di accedere di nuovo, poi crea un'organizzazione di sviluppo con il nome del tuo negozio. Se la pagina Stores del Dev Dashboard dice "No stores yet", va bene così: il tuo negozio non deve comparire lì.

La pagina App development, con il pulsante Build apps in Dev Dashboard evidenziato

Passo 2: crea l'app

Nel Dev Dashboard, apri Apps e fai clic su Create app e poi su Create app manually. È tutto in un unico modulo:

  • App name: un nome che riconosci, ad esempio MailInApp.
  • App URL: https://mailinapp.com/dashboard/settings/integrations. Shopify apre questa pagina dopo l'installazione dell'app, così arrivi sul modulo di collegamento di MailInApp con l'indirizzo del negozio già compilato.
  • Embed app in Shopify admin: deselezionalo. La tua app non ha una pagina dentro Shopify.
  • Scopes: read_customers,read_orders,read_products,write_discounts. Permettono a MailInApp di leggere clienti, ordini e prodotti e di creare i codici sconto monouso descritti più sotto. MailInApp non modifica mai prodotti, ordini o clienti. Per raggiungere gli ordini più vecchi di circa 60 giorni, aggiungi anche read_all_orders: Shopify lo concede automaticamente alla tua app.
  • Webhooks API version: lascia il valore predefinito.

Il modulo Create an app, con App URL, la casella Embed app in Shopify admin deselezionata, gli scope e il pulsante Create app evidenziati

Fai clic su Create app. Shopify ti chiede di rilasciare la prima versione: fai clic su Release.

La finestra Release version, con il pulsante Release evidenziato

Passo 3: installa l'app sul tuo negozio

Nella pagina Overview dell'app, fai clic su Test app nella scheda Installs e scegli il tuo negozio.

La pagina Overview dell'app, con il pulsante Test app evidenziato

Shopify mostra la sua schermata di installazione con gli accessi di cui l'app ha bisogno. Dice anche che l'app non è stata verificata. È normale, perché l'app è tua e non passa mai dall'App Store. Fai clic su Install.

La schermata di installazione dell'app di Shopify, con il pulsante Install evidenziato

Ora il tuo negozio elenca l'app in Impostazioni → App.

Passo 4: incolla le chiavi in MailInApp

Torna alla pagina Overview dell'app nel Dev Dashboard: la scheda Credentials contiene il Client ID e il Client secret. Il secret è nascosto; il suo pulsante di copia lo copia.

La scheda Credentials nella pagina Overview dell'app, con i campi Client ID e Client secret

In MailInApp, apri Impostazioni → Integrazioni. Nella scheda Shopify, inserisci l'indirizzo del negozio (tuo-negozio.myshopify.com), incolla il Client ID e il Client secret e fai clic su Collega Shopify. MailInApp potrebbe chiederti prima di accedere di nuovo, perché le chiavi danno pieno accesso ai dati del tuo negozio.

La scheda Shopify in Impostazioni → Integrazioni, con l'indirizzo del negozio compilato e il pulsante Collega Shopify evidenziato

MailInApp verifica le chiavi con Shopify, cripta il Client secret e non lo mostra più. Poi crea una lista contatti per il negozio e, in background, sincronizza i tuoi clienti (fino a 5.000 in questo primo passaggio; quelli successivi arrivano man mano che vengono creati) e il tuo catalogo prodotti.

Lascia disattivata la IP allowlist nelle impostazioni della tua app. Se è attiva, Shopify rifiuta le richieste di MailInApp.

Collegare Shopify è gratuito su ogni piano, incluso Free. Il tuo piano MailInApp viene fatturato da MailInApp come sempre, da Impostazioni → Piano e utilizzo. Tutto il tuo catalogo prodotti si sincronizza su ogni piano, e ogni piano include una quota mensile di codici sconto del negozio.

Se il collegamento non riesce

La scheda Shopify dice cosa non ha funzionato:

  • Shopify non ha accettato questo Client ID e questo Client secret: copiali di nuovo dalla scheda Credentials. Se hai generato un nuovo secret, usa quello nuovo.
  • L'app non è installata su questo negozio: ripeti il passo 3 (Test app, poi Install).
  • Alla tua app mancano questi scope di accesso: nel Dev Dashboard, apri Versions dell'app, crea una nuova versione con gli scope del passo 2, rilasciala, poi collega di nuovo.
  • Questa app appartiene a un'altra organizzazione Shopify: crea l'app dall'admin del tuo negozio, come al passo 1, e non da un altro account Partner o di sviluppo.
  • Questo non è un indirizzo di negozio Shopify: usa l'indirizzo myshopify.com che compare sotto il nome del negozio in Impostazioni, non il tuo dominio.

Cosa fa

  • Sincronizzazione clienti: i clienti Shopify arrivano in una lista contatti circoscritta a questa integrazione, mantenuta aggiornata in seguito dai webhook di Shopify (customers/create, più checkouts/create e orders/paid per i trigger descritti sotto) anziché da un nuovo polling periodico.
  • Trigger di journey: un negozio collegato può attivare il trigger carrello abbandonato di una journey (un checkout iniziato ma non completato) e il suo trigger acquisto (un ordine pagato), così un'automazione di benvenuto o di carrello abbandonato può funzionare a partire da attività reale su Shopify invece che solo dal checkout del blocco Prodotto di MailInApp. Vedi Journey.
  • Attribuzione dei ricavi: la campagna/variante di un ordine, dove identificabile, confluisce negli stessi numeri di ricavo delle risposte e del test A/B che un ordine da checkout nativo già produce.
  • Segmenti sullo storico acquisti e offerte di sconto: le voci degli ordini si sincronizzano insieme ai clienti, così un filtro sul pubblico può far corrispondere "ha acquistato il prodotto X tra la data A e B" (vedi Storico acquisti), e un progetto può generare un codice sconto Shopify monouso per ciascun destinatario corrispondente, riscattabile sul checkout del tuo stesso negozio (vedi Offerta di sconto). I nuovi ordini si sincronizzano automaticamente dal webhook orders/paid. Per gli ordini effettuati prima del collegamento, esegui una volta Backfill dello storico ordini da Impostazioni → Integrazioni; Shopify lo limita a circa gli ultimi 60 giorni. Un blocco Prodotto importato dal tuo catalogo può generare autonomamente il proprio Sconto per prodotto, circoscritto solo a quell'articolo, senza bisogno di alcun filtro sul pubblico: vedi Sconti nativi del negozio e Codici sconto prodotto Shopify.
  • Catalogo prodotti per lo studio: anche le inserzioni attive del tuo negozio si sincronizzano in MailInApp, aggiornate automaticamente con la stessa cadenza dei clienti (nessun pulsante separato). Il selettore Importa dal negozio del blocco Prodotto cerca in questo catalogo sincronizzato e compila nome, descrizione, immagine e prezzo di un blocco a partire da un prodotto reale. È una copia una tantum, non un collegamento live, così nulla in un'email inviata può discostarsi da ciò che hai revisionato. Sincronizza inoltre la pagina propria di ciascun prodotto (a partire dall'handle Shopify) e, quando disponibile, imposta il blocco su Link al checkout di un negozio esterno puntato direttamente su di essa, così un prodotto importato è pronto per essere venduto sul tuo negozio Shopify senza nient'altro da configurare. Riportalo manualmente su Checkout MailInApp se preferisci invece incassare il pagamento tramite il tuo account Stripe collegato.

Recensioni del negozio

Shopify non conserva recensioni proprie, quindi MailInApp le legge da Judge.me, l'app di recensioni del tuo negozio:

  1. In Judge.me apri Settings → Integrations e fai clic su View API token. Copia il token privato.
  2. In MailInApp apri Impostazioni → Integrazioni. Nella scheda del negozio, sotto Judge.me, incolla il token e fai clic su Collega Judge.me.

MailInApp verifica il token con Judge.me, poi sincronizza le recensioni, e di nuovo a ogni sincronizzazione del negozio. Tiene solo le recensioni pubblicate sul negozio (né nascoste né in attesa di approvazione in Judge.me), al massimo le 5.000 più recenti. Una recensione che nascondi o elimini in Judge.me sparisce alla sincronizzazione successiva. MailInApp non conserva mai l'indirizzo email di chi scrive e mostra il nome come nome di battesimo e iniziale del cognome. La scheda mostra quante recensioni sono sincronizzate, e Sincronizza le recensioni ora le sincronizza subito.

Il token serve solo a leggere le recensioni. Scollega Judge.me elimina il token e le recensioni sincronizzate, come anche scollegare il negozio. Le stelle dei prodotti importati non hanno bisogno del token: arrivano dalla valutazione che Judge.me salva già su ogni prodotto in Shopify. Vedi Recensioni del negozio per stelle, recensioni nelle email e pubblicazione.

Stato della connessione e aggiornamento delle chiavi

MailInApp scambia le chiavi della tua app con un token di accesso Shopify di breve durata (vale circa un giorno) e ne ottiene uno nuovo da solo prima che scada. Nell'uso normale non devi fare nulla.

Se le chiavi smettono di funzionare, MailInApp interrompe la sincronizzazione, e la scheda Shopify in Impostazioni → Integrazioni mostra Richiede attenzione e spiega perché:

  • Le chiavi della tua app Shopify non funzionano più: il secret è stato revocato, oppure l'app è stata eliminata. Fai clic su Aggiorna chiavi e incolla il Client ID e il Client secret attuali dell'app.
  • La tua app Shopify non è più installata sul negozio: l'app è stata disinstallata dal tuo negozio. Installala di nuovo dalla sua pagina Overview (Test app). Le chiavi restano le stesse, quindi MailInApp si ricollega da solo entro 6 ore e configura di nuovo i suoi webhook. Per ricollegarlo subito, fai clic su Aggiorna chiavi e incollale.

Per cambiare il Client secret (ad esempio, come abitudine di sicurezza periodica), fallo in due passaggi così il negozio non si scollega mai:

  1. Nel Dev Dashboard, apri Settings dell'app e fai clic su Generate new secret. Entrambi i secret funzionano finché non revochi quello vecchio.
  2. In MailInApp, fai clic su Aggiorna chiavi nella scheda Shopify e incolla il nuovo secret.
  3. Torna nel Dev Dashboard e revoca il vecchio secret.

Shopify continua a firmare i suoi webhook con il vecchio secret finché non lo revochi, e nel frattempo MailInApp accetta l'uno o l'altro, per tutto il tempo necessario. Aggiorna chiavi sposta anche un negozio su un'altra delle tue app: incolla il Client ID e il secret di quell'app.

Disconnessione

Disconnetti in Impostazioni → Integrazioni interrompe subito la sincronizzazione e qualsiasi ulteriore elaborazione dei webhook. MailInApp rimuove i suoi webhook dalla tua app ed elimina le chiavi salvate. Poi puoi disinstallare l'app dal tuo negozio, o eliminarla nel Dev Dashboard.

Disinstallare l'app senza prima disconnetterla mette solo in pausa il negozio: la scheda indica che l'app non è installata, e una reinstallazione riprende da dove si era fermata. Se l'app resta disinstallata per 30 giorni, MailInApp elimina le chiavi salvate e scollega il negozio. Per ricollegare un negozio scollegato, compila il modulo nella scheda Shopify. Parte dall'indirizzo del negozio, e il negozio mantiene la sua lista contatti.

I codici sconto che MailInApp ha già creato sul tuo negozio (iniziano con MIA-) restano in Shopify quando disinstalli l'app o la scolleghi, e funzionano fino alla scadenza, quindi i codici nelle email già inviate restano validi. La schermata di disinstallazione di Shopify dice che gli sconti dell'app verranno eliminati; si riferisce agli sconti che un'app gestisce da sé, e MailInApp non ne crea. Per fermare i codici prima, eliminali nell'admin di Shopify, in Discounts.

I clienti già sincronizzati rimangono nella loro lista contatti: disconnettere un'integrazione non elimina mai i contatti, poiché potrebbero già essere un pubblico di invio per altri progetti. Elimina tu la lista se non ti serve più.

MailInApp conserva i clienti del tuo negozio per tuo conto. La tua app non inoltra a MailInApp le richieste di cancellazione dei dati dei clienti di Shopify, quindi quando un cliente ti chiede di eliminare i suoi dati, cancellalo anche in MailInApp, dal suo profilo contatto (vedi Esportare o cancellare i dati di un Destinatario). Lo stesso vale per una disinstallazione: la schermata di disinstallazione di Shopify dice che allo sviluppatore dell'app verrà chiesto di eliminare i dati dei clienti entro 48 ore. Per la tua app, quello sviluppatore sei tu, e Shopify non inoltra quella richiesta a MailInApp, quindi elimina tu la lista contatti del negozio se vuoi che sparisca.