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.

Collega il tuo negozio

Da Impostazioni → Integrazioni, inserisci il dominio myshopify.com del tuo negozio e clicca Collega Shopify. Verrai indirizzato alla schermata OAuth di Shopify per approvare l'accesso. MailInApp richiede read_customers, read_orders e read_products (tutti in sola lettura), più write_discounts per poter generare i codici sconto monouso descritti più sotto — non chiede mai l'accesso in scrittura ai prodotti, agli ordini o ai clienti del tuo negozio. All'approvazione, MailInApp crea una lista contatti dedicata per il negozio e avvia in background un backfill iniziale dei clienti, limitato a 5.000 clienti per connessione. Un negozio con più clienti di questo limite continua comunque a far crescere la sua lista da lì in poi tramite i webhook di Shopify, semplicemente senza un backfill in blocco oltre il limite.

Se installi direttamente dallo Shopify App Store, prima ancora di aver creato un account MailInApp, MailInApp te ne fornisce uno automaticamente usando l'indirizzo email del tuo negozio — atterri già autenticato, con il negozio già collegato.

Collegare Shopify è una tantum al costo di $30, fatturata una sola volta tramite la stessa Billing API di Shopify come parte di questo flusso, disponibile su ogni piano (incluso Free). Non è rimborsabile se in seguito disinstalli l'app — ma ricollegarlo in seguito sullo stesso account MailInApp è gratuito.

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). Gli ordini in corso si sincronizzano automaticamente dal webhook orders/paid; un negozio collegato prima che questa funzione venisse rilasciata, o con uno storico più vecchio, necessita di un'estrazione una tantum Backfill dello storico ordini da Impostazioni → Integrazioni — limitata a circa gli ultimi 60 giorni a meno che Shopify non abbia separatamente approvato questa app per lo storico ordini completo sul tuo negozio. 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. Un negozio collegato prima che questa funzione venisse rilasciata necessita di un rapido Disconnetti seguito da Collega Shopify per concedere il nuovo permesso read_products richiesto da Shopify — fino ad allora il selettore semplicemente non mostra nulla.

Stato della connessione e riconnessione

Shopify rilascia a MailInApp un token di accesso di breve durata (valido per circa un'ora) insieme a un refresh token rotante, e MailInApp aggiorna automaticamente quella coppia in background — la sincronizzazione dei clienti, i trigger di journey e la generazione degli sconti continuano tutti a funzionare senza alcuna azione da parte tua nell'uso normale.

Se Shopify revoca o invalida mai quel refresh token — ad esempio l'app è stata disinstallata e reinstallata al di fuori di MailInApp, l'accesso è stato revocato manualmente dal tuo admin Shopify, oppure il token è semplicemente scaduto per prolungata inattività — MailInApp si ferma deliberatamente invece di ritentare silenziosamente con credenziali obsolete, e Impostazioni → Integrazioni mostra lo stato del negozio come Riconnessione necessaria. Questa è una misura di sicurezza, non un bug: MailInApp non si ri-autentica mai per tuo conto senza che tu approvi una nuova concessione OAuth tramite la schermata di Shopify.

Se vedi quello stato, clicca Disconnetti e poi di nuovo Collega Shopify da Impostazioni → Integrazioni per ottenere una coppia di token pulita. Richiede pochi secondi, non ti addebita di nuovo la commissione di connessione una tantum, e non tocca i contatti o gli ordini già sincronizzati — la sincronizzazione riprende semplicemente non appena la nuova connessione è approvata.

Disconnessione

Disconnetti in Impostazioni interrompe immediatamente la sincronizzazione e qualsiasi ulteriore elaborazione dei webhook. 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. Disinstallare l'app dal lato Shopify funziona allo stesso modo, all'inizio. Circa 48 ore dopo, non appena si attiva il webhook di cancellazione dati di Shopify stesso, cancella completamente anche i contatti e i record di carrello sincronizzati — il periodo di garanzia standard che ogni app Shopify deve rispettare.