Se la tua piattaforma ecommerce non ha un'integrazione nativa con Omnisend, puoi collegarla utilizzando la nostra API. Questo ti dà accesso alle stesse funzionalità delle integrazioni native – flusso automatizzato per carrelli abbandonati, segmentazione dei clienti, tracciamento degli ordini e altro ancora.

La configurazione prevede due passaggi: aggiungere uno snippet di tracciamento (integrazione frontend) e sincronizzare i tuoi dati tramite API (integrazione backend).

Stai già utilizzando un'integrazione nativa?
We have built-in integrations for , , and . Usa quelle guide invece per una configurazione più rapida.

Prima di iniziare

A chi è destinata questa guida

Usa questa guida se il tuo negozio è costruito su:

Siti web o piattaforme personalizzati non elencati nelle nostre integrazioni native.
Piattaforme con supporto nativo limitato: Etsy, Squarespace, Hostinger Website Builder, temi WordPress personalizzati.
Impostazioni di commercio headless: Shopify Hydrogen, frontend personalizzati in React/Vue, piattaforme API-first.

Se sei su Shopify, WooCommerce, BigCommerce o Wix, utilizza le nostre guide di integrazione native per una configurazione più semplice.

Hai bisogno di uno sviluppatore?

Integrazione frontend (aggiungendo il frammento) può essere effettuata da chiunque si senta a proprio agio con:

Accedere ai file HTML o Template email del tuo sito web.
Aggiungere frammenti di codice al piè di pagina del tuo sito (come Google Analytics).
Utilizzando Google Tag Manager (metodo opzionale).

Integrazione backend (sincronizzazione dei dati tramite API) richiede uno sviluppatore con:

Conoscenza dell'API REST.
Accesso al database clienti e ordini del tuo negozio.
Capacità di implementare webhook o sincronizzazioni di dati pianificate.

Cosa puoi fare senza uno sviluppatore:

Moduli di iscrizione (tutti i tipi: pop-up, ruota, landing page)
Campagne Email e SMS
Benvenuto flusso automatizzato
Navigazione e Abbandono del Prodotto (richiede la configurazione dell'evento prodotto visualizzato)
Tracciamento dei visitatori in tempo reale

Cosa richiede uno sviluppatore:

Flusso automatizzato per Carrello abbandonato e Checkout.
Conferma d'ordine, Conferma di spedizione, Cancellazione dell'ordine.
Segmentazione avanzata (ad es., "Clienti che hanno acquistato X ma non Y").
Selettore di Prodotto nelle email.
Reportistica dei ricavi nell'analisi delle campagne.

Se non sei sicuro, inizia con l'integrazione frontend. Puoi aggiungere l'integrazione backend in seguito.

Limitazioni specifiche della piattaforma

⚠️ Alcune piattaforme hanno restrizioni di accesso al codice o ai dati:

Etsy: Non consente codice personalizzato nelle pagine del negozio. Avrai bisogno di una landing page esterna o di un sito web per aggiungere lo snippet di Omnisend e utilizzare i moduli di iscrizione. L'integrazione backend richiede lavoro da sviluppatore o strumenti come Zapier.
Squarespace: Personalizzazione del codice limitata. Usa Zapier o Make per sincronizzare le invii dei moduli, oppure contatta il tuo sviluppatore per una completa integrazione API.
Hostinger Website Builder, Wix (domini personalizzati): Il frammento frontend può essere aggiunto, ma l'integrazione backend richiede uno sviluppatore.
Negozi headless (Shopify Hydrogen, framework personalizzati): Il tuo team di sviluppo controlla il tracciamento degli eventi e la sincronizzazione dei dati tramite API.

Se la tua piattaforma ha limitazioni, contatta il tuo sviluppatore prima di iniziare la configurazione.

Cosa sblocca ogni integrazione

Livello di integrazione	Cosa ottieni	Cosa non puoi ancora fare	Hai bisogno di uno sviluppatore?
Solo frontend	Moduli di registrazione, flusso automatizzato di benvenuto, navigazione e abbandono del prodotto, visualizzazione dal vivo, campagne email	Carrello abbandonato, automazioni degli ordini, segmentazione basata sugli acquisti, reportistica dei ricavi	No
Frontend + Backend	Tutte le automazioni (carrello, ordine, riattivazione), segmentazione avanzata, Selettore di Prodotti, attribuzione delle vendite	N/A	Sì

Integrazione Frontend

L'integrazione frontend aggiunge il frammento di tracciamento di Omnisend alle pagine del tuo sito web. Questo sblocca i moduli di registrazione, l'abbandono della navigazione, il tracciamento dei visitatori e le campagne email.

Passo 1: Collega il tuo Negozio

Registrati per un account Omnisend e accedi.
Nel tuo Pannello di controllo Omnisend, fai clic su Collega negozio.
Scegli Altro dalla lista delle piattaforme del negozio.

Passo 2: Inserisci l'URL del tuo Negozio

Inserisci l'URL del tuo negozio e clicca su Collega negozio.

Passo 3: Aggiungi il frammento di tracciamento

Vedrai un frammento JavaScript nella pagina successiva. Incolla questo frammento nel file footer HTML del tuo sito web, subito prima del tag di chiusura su ogni pagina – proprio come Google Analytics.

Dove aggiungere il frammento:

Il metodo più semplice è aggiungere il frammento al file del piè di pagina del tuo sito (di solito footer.html, footer.php o theme.liquid a seconda della tua piattaforma). Questo file viene visualizzato su tutte le pagine.

⚠️ Se non sei sicuro di dove aggiungerlo, contatta il tuo sviluppatore web.

Utilizzando Google Tag Manager

Se utilizzi Google Tag Manager:

Accedi al tuo account Google Tag Manager e seleziona il tuo spazio di lavoro.
Clicca Tag → Nuovo.
Fai clic su Configurazione Tag → HTML Personalizzato.
Copia il frammento da Omnisend e incollalo nel campo HTML. Posizionalo all'interno dei tag .
Imposta il Trigger per attivarsi su Tutte le Pagine.
Salva e pubblica.

Controlla questa guida di Google per ulteriori dettagli sulla configurazione di GTM.

Passo 4: Verifica la tua connessione

Una volta aggiunto il frammento, clicca Verifica e Connetti in Omnisend. Se la verifica ha successo, hai completato l'integrazione frontend. Ora puoi utilizzare i moduli di registrazione, l'abbandono della navigazione e le campagne email.

⚠️ Importante: Verifica di Google Tag Manager

Se hai aggiunto il frammento tramite GTM, la verifica potrebbe fallire anche quando il frammento funziona correttamente. Questo accade perché la nostra verifica controlla il posizionamento diretto dell'HTML.

Come controllare se funziona:

Apri il tuo sito web
Premi F12 per aprire la console del browser
Digita window.omnisend e premi Invio
Se vedi un array, il frammento sta funzionando correttamente

Prossimi passi:
Contatto supporto via in-app chat with your store URL. Verificheremo manualmente la tua connessione.

Risoluzione dei problemi: Verifica fallita

Se la verifica fallisce:

Attendi 5–10 minuti dopo aver aggiunto il frammento (le modifiche potrebbero richiedere tempo per propagarsi).
Cancella la cache del tuo browser e aggiorna il tuo sito web.
Controlla la posizione del frammento: Fai clic destro sul tuo sito web → Visualizza sorgente pagina. Cerca omnisend.push. Dovrebbe apparire prima di su ogni pagina.
Ricopia il frammento da Omnisend e incollalo di nuovo per assicurarti che non manchino caratteri.
Controlla il tuo ID Brand: Assicurati che l'ID Brand nel frammento corrisponda a quello nel tuo account Omnisend (passa il mouse sull'icona del negozio a sinistra → Il tuo ID brand).

Se stai utilizzando Google Tag Manager, vedi l'avviso sopra – contatta il supporto per la verifica manuale.

Cosa testare dopo

Una volta verificato, testa immediatamente queste funzionalità:

Crea un modulo di iscrizione (Campagne → Moduli) e testalo sul tuo sito.
Controlla Live View (Negozio → Live View) per vedere se le visite alle pagine sono tracciate.
Imposta un flusso automatizzato di benvenuto (Flusso automatizzato → Predefinito) – questo funziona solo con integrazione frontend.

Nota: Il tracciamento degli eventi (eventi del carrello, visualizzazioni del prodotto) funziona solo dopo che un contatto è stato identificato tramite il modulo di iscrizione o API. I visitatori anonimi non attiveranno eventi fino a quando non invieranno la loro email.

Integrazione Backend

L'integrazione backend sincronizza i dati del cliente, dell'ordine e del prodotto con Omnisend tramite API. Questo sblocca il flusso automatizzato per i carrelli abbandonati, le conferme d'ordine, la segmentazione avanzata e la reportistica dei ricavi.

L'integrazione backend richiede conoscenze da sviluppatore. Condividi queste risorse con il tuo team di sviluppo:

Cosa sblocca l'integrazione backend

Una volta completata l'integrazione backend, avrai accesso a:

Flusso automatizzato per Carrello abbandonato e Checkout abbandonato.
Automazioni relative agli ordini: Conferma d'ordine, Cancellazione dell'ordine, Conferma di spedizione, Follow-up dell'ordine, Feedback del cliente, Riattivazione del cliente.
Flussi automatizzati personalizzati basati sul comportamento d'acquisto (ad esempio, "Acquistato X ma non Y").
Segmentazione avanzata con dati di ordine e prodotto.
Selettore di prodotto nelle campagne Email.
Reporting dei ricavi nell'analisi delle campagne e del flusso automatizzato.

Una volta che il tuo sviluppatore invia i dati richiesti tramite l'API, tutte le funzionalità abilitate inizieranno a funzionare immediatamente. Nota: Alcune funzionalità (come Live View) richiedono ancora il frammento frontend.

Risoluzione dei problemi

Ho aggiunto il frammento, ma la verifica è fallita

Vedi la sezione "Risoluzione dei problemi: Verifica fallita" sopra per i passaggi dettagliati.

Se stai utilizzando Google Tag Manager, la verifica potrebbe fallire anche se la configurazione è corretta – vedi l'avviso GTM nel Passo 4 e contatta il supporto per la verifica manuale.

Ricevo errori 400 quando traccio eventi

Gli eventi richiedono un contatto identificato per funzionare. Un errore 400 di solito significa che il contatto non è stato ancora identificato.

Come vengono identificati i contatti:

Inviano un modulo di iscrizione con la loro Email
Li identifichi tramite API utilizzando il setContact metodo

Per risolvere:

Assicurati che il tuo codice di tracciamento degli eventi venga eseguito dopo l'identificazione del contatto
Testa inviando prima un modulo di iscrizione, poi attivando l'evento
Controlla Impostazioni Negozio → API → Log per dettagli specifici sugli errori

I visitatori anonimi non attiveranno eventi finché non saranno identificati.

Il Selettore di Prodotto non è visualizzato

Il Selettore di Prodotto richiede che Omnisend abbia i dati del tuo catalogo prodotti. Per piattaforme personalizzate:

Sincronizza il tuo catalogo prodotti tramite API (integrazione backend)
Aggiungi il tracciamento dell'evento prodotto visualizzato alle tue pagine prodotto (frammento frontend + dati prodotto dinamici)

Segui la guida alla configurazione del Selettore di Prodotto per istruzioni dettagliate.

Il negozio è collegato, ma le automazioni non funzionano

Per attivare i flussi automatizzati, è necessario passare l'evento e i dati associati tramite l'API. Ad esempio:

Il Carrello abbandonato richiede eventi API Carrello e API Ordine
La conferma d'ordine richiede l'evento Ordine effettuato
L'abbandono del prodotto richiede un evento Prodotto Visualizzato

Controlla Impostazioni Negozio → API → Log API per errori.

Nota: L'integrazione frontend da sola supporta solo le automazioni di Benvenuto, Abbandono della navigazione e Abbandono del Prodotto. Tutte le automazioni basate sugli ordini richiedono integrazione backend.

La scheda del prodotto nel profilo di contatto non mostra nulla

Le informazioni visualizzate sotto la scheda Prodotti nel profilo di un contatto provengono dal tracciamento di Live View. Per le piattaforme basate su API, Omnisend non può tracciare alcuni eventi (come ordine effettuato o prodotto acquistato) tramite Live View – riceve questi dati tramite API invece.

Questo significa che la scheda Prodotti potrebbe rimanere vuota anche se la tua integrazione funziona correttamente. Controlla Impostazioni Negozio → API → Log per confermare che i dati dell'ordine e del prodotto siano sincronizzati.

Domande frequenti

Posso usare questa guida per Etsy, Squarespace, Hostinger o altre piattaforme non elencate nelle vostre integrazioni?

Sì. Qualsiasi piattaforma che consente HTML/JavaScript personalizzati può utilizzare l'integrazione frontend (moduli di registrazione, automazioni di base).

Etsy: Non consente codice personalizzato nelle pagine del negozio. Avrai bisogno di una landing page o di un sito web esterno per aggiungere il frammento, oppure usa Zapier per sincronizzare i contatti. L'integrazione backend richiede lavoro da sviluppatore.
Squarespace: Personalizzazione del codice limitata. Usa Zapier o Make per sincronizzare le invii dei moduli, oppure contatta il tuo sviluppatore per una completa integrazione API.
Hostinger Website Builder: Il frammento frontend può essere aggiunto. L'integrazione backend richiede uno sviluppatore.

L'integrazione completa del backend richiede l'accesso API ai dati degli ordini del tuo negozio.

Ho aggiunto il frammento tramite Google Tag Manager, ma la verifica è fallita. Cosa devo fare?

La tua integrazione potrebbe funzionare anche se la verifica fallisce. I frammenti installati tramite GTM spesso non superano la nostra verifica automatica perché controlliamo il posizionamento diretto dell'HTML.

Per confermare che funzioni:

Apri il tuo sito web
Premi F12 per aprire la console del browser
Digita window.omnisend e premi Invio
Se vedi un array, il frammento sta funzionando correttamente

Contatta il supporto tramite chat in-app con l'URL del tuo Negozio. Verificheremo manualmente la tua connessione.

Assicurati che:

Il tuo tag GTM si attiva su Tutte le Pagine
Il tag è pubblicato in GTM
Il frammento è racchiuso in tag

Quali automazioni funzionano solo con l'integrazione frontend?

Con solo l'integrazione frontend, puoi utilizzare:

Email di benvenuto
Abbandono della navigazione
Abbandono del Prodotto (richiede la configurazione dell'evento prodotto visualizzato)
Email di compleanno
Automazioni attivate da segmenti di contatto

Non puoi utilizzare senza integrazione backend:

Carrello abbandonato vs.
Conferma d'ordine
Conferma di spedizione
Cancellazione dell'Ordine
Reattivazione Cliente
Qualsiasi flusso basato sui dati di acquisto

Questi richiedono integrazione API del backend per passare i dati degli ordini a Omnisend.

Posso inviare eventi di carrello e checkout tramite Google Tag Manager?

Puoi inviare eventi del carrello (checkout avviato, aggiunto al carrello) tramite GTM utilizzando tag HTML personalizzati con variabili di dati del prodotto dinamici.

Tuttavia, gli ordini completati devono essere inviati tramite API di backend perché GTM viene eseguito nel browser e non può accedere in modo sicuro ai dati finali dell'ordine dopo il pagamento.

Per l'abbandono del carrello:

Invia l'evento $startedCheckout con i dettagli del carrello tramite GTM

Per la conferma dell'ordine:

Utilizza l'API lato server per inviare i dati dell'ordine

Vedi la nostra documentazione API per il tracciamento degli eventi per i dettagli di implementazione.

Perché ricevo errori 400 quando traccio eventi?