Setup

Questa guida copre tutto ciò di cui hai bisogno da configurare prima che Clerk.io possa inviare email per tuo conto.

Questi passaggi si applicano solo quando desideri inviare email tramite Clerk.io — campagne, flussi e trigger automatici come il Carrello Abbandonato. Se vuoi solo aggiungere raccomandazioni di prodotto personalizzate alle email che già invii tramite Klaviyo, Mailchimp o un’altra piattaforma, nulla di questo è necessario. Vai direttamente su Embeds.

Configurazione #

Questi passaggi autorizzano Clerk.io a inviare email dal tuo dominio, gli forniscono un elenco di destinatari e preparano il tuo primo design di email. Avrai bisogno di accesso a my.clerk.io, al provider di hosting del tuo dominio e alla tua piattaforma email esistente.

Stato della configurazione #

La scheda Stato della Configurazione in Email > Configuration > Setup Status ti offre una panoramica in tempo reale se la tua configurazione email è completa e funzionante.

Ogni elemento nell’elenco mostra un pallino colorato — verde significa che tutto è a posto, rosso segnala che manca qualcosa o c’è un errore, e arancione è un avviso da indagare. L’intestazione della scheda stessa mostra quante fasi obbligatorie mancano così puoi vedere al volo se è necessaria un’azione.

I controlli sono raggruppati in tre aree:

Configurazione copre i requisiti base — se il tuo negozio e l’azienda sono abilitati, se l’accesso all’invio email è attivo, quale dominio mittente è configurato, quanti destinatari iscritti sono disponibili e se tutti i passaggi attivi dei tuoi flussi hanno un design email assegnato.

Tracciamento onsite mostra se il tracciamento dei visitatori è attivo e quanti visitatori o carrelli sono stati collegati a un indirizzo email negli ultimi sette giorni. Numeri bassi qui indicano di solito una raccolta email mancante.

Flussi & invio mostra se i flussi attivi sono configurati, quanti eventi sono in attesa, quante email sono state inviate di recente e se la coda di invio è sana. Se le email non vengono inviate come previsto, questa sezione è il primo posto da controllare.

Configurazione DNS #

La configurazione DNS è obbligatoria per tutti i negozi che usano Clerk.io Email. Prima che Clerk.io possa inviare email, devi autenticare il tuo dominio mittente aggiungendo record DNS presso il provider del tuo dominio.

Pensa così: quando Clerk.io invia un’email per te, ha bisogno di provare al server di posta del destinatario di essere davvero autorizzato a farlo. Senza questa prova, l’email appare sospetta — come qualcuno che si spaccia per te senza documento. I mail server non gradiscono questo e possono rifiutare o mandare l’email nello spam.

I record DNS sono il modo in cui concedi questa autorizzazione. Aggiungi alcuni record nelle impostazioni del tuo dominio (dove gestisci il dominio — Route 53, Cloudflare, GoDaddy, ecc.), e questi istruiscono Internet: “Clerk.io può inviare email come noi.”

Ci sono tre tipi di record da aggiungere:

• SPF — Dichiara quali servizi sono autorizzati a inviare email dal tuo dominio.
• DKIM — Aggiunge una firma crittografica alle email inviate così i destinatari possono verificarne l’autenticità e che non siano state modificate in transito.
• CNAME — Usato per tracciare aperture e clic nelle campagne.

Record SPF: Un dominio può avere un solo record SPF TXT. Se ne hai già uno, devi unire la direttiva, es. include:mailgun.org, invece di crearne un secondo.

Per trovare i tuoi record DNS, vai su Email > Configuration > Domain Setup e segui la guida step-by-step per il tuo provider.

Dopo aver inserito Email Mittente e Nome Mittente, Clerk.io genererà i valori dei record esatti che devi aggiungere. Una volta fatti, torna su Email > Configuration > DNS Records e clicca Verifica Ora. Clerk.io controllerà che tutti e tre i record siano configurati correttamente.

Sincronizzazione Iscritti #

La sincronizzazione degli iscritti è obbligatoria per tutti i negozi che usano Clerk.io Email. Un iscritto è un indirizzo email che ha dato il consenso a ricevere email marketing. Clerk.io deve sapere chi sono queste persone prima di poter inviare campagne.

Se hai già iscritti in una piattaforma come Klaviyo o MailChimp, puoi sincronizzarli direttamente in Clerk.io. Questo ti dà una lista completa sin dal primo giorno.

Per configurare la sincronizzazione, vai su Settings > Integrations e collega la tua piattaforma email. Quando l’integrazione è salvata, vai su Email > Configuration > Sync Subscribers e abilita lo switch accanto all’integrazione desiderata.

Per trovare la guida di setup per la tua piattaforma email, cercala nel menu delle integrazioni nella sidebar e segui la sua guida Sync Data.

Se non usi una piattaforma email esterna, puoi importare iscritti tramite un file CSV o includerli nel tuo feed dati usando l’attributo subscribed: true nei record clienti.

Personalizzazione #

La scheda Personalization in Email > Configuration > Personalization ti permette di impostare il logo dello shop che Clerk.io userà nei tuoi design email.

Puoi caricare un’immagine direttamente oppure usare Rilevamento automatico dal sito web per far trovare e importare il logo automaticamente da Clerk.io dal tuo store. È la via più veloce se il logo è già visibile — Clerk.io lo rileverà e applicherà senza caricamento manuale.

Il logo impostato qui viene usato come logo predefinito nei design mail creati da Clerk.io. Se crei i design manualmente, puoi sempre referenziarlo tramite l’URL del logo direttamente nel template.

Design Email #

Ogni campagna o flusso automatizzato richiede un design email — il template visuale che Clerk.io usa per generare la mail inviata.

Il modo più facile per crearne uno è tramite Ask Clerk.io Design Studio. Descrivi a parole cosa vuoi — layout, colori, quali prodotti mostrare, come visualizzare i prezzi scontati — e crea un’anteprima direttamente nella chat che puoi rivedere e modificare. Puoi anche indicargli il tuo sito o allegare uno screenshot: copierà lo stile esistente. Leggi di più nella guida Design Studio.

Per più controllo, l’editor MJML integrato di Clerk.io ti permette di scrivere i design come markup strutturato. MJML compila in HTML che si visualizza bene su Gmail, Outlook e Apple Mail. Vedi la guida ai Design MJML per esempi e dettagli.

Tutti i design email in Clerk.io sono responsive — si adattano automaticamente a qualsiasi schermo, quindi appaiono bene su desktop, tablet e mobile senza ulteriori sforzi.

Se vuoi includere immagini statiche nei tuoi design — banner, loghi, header stagionali — puoi ospitarle direttamente sui server Clerk.io usando la Media Library. Le immagini caricate ricevono un riferimento template come {{ media.your-image }} che puoi inserire in qualsiasi design. Puoi anche allegare un’immagine direttamente in Ask Clerk.io e chiedergli di caricarla e usarla nel design generato — farà tutto lui.

Link Annulla Iscrizione #

Ogni email marketing deve includere una possibilità per il destinatario di annullare l’iscrizione. Come gestirlo dipende dal metodo di invio email.

Usando una piattaforma esterna (Klaviyo, Mailchimp, ecc.) — Continua a usare il link di annullamento attuale. Gestisce l’opt-out e tiene la lista iscritti sincronizzata automaticamente.

Inviando tutte le email tramite Clerk.io — Aggiungi il link di annullamento Clerk.io al tuo design. Se usi Ask Clerk.io per creare la mail, basta chiedere di includere il link: si occuperà del resto.

Per i design realizzati a mano, usa il link qui sotto. La variabile {{ email }} verrà sostituita con il destinatario al momento dell’invio. Sostituisci YOUR_PUBLIC_API_KEY con la Public Key da Developers > API Keys.

<a href="https://api.clerk.io/v2/subscriber/unsubscribe?key=YOUR_PUBLIC_API_KEY&email={{ email }}&redirect=true">Annulla iscrizione</a>

Per annullare l’iscrizione solo da una lista specifica, aggiungi list_id:

<a href="https://api.clerk.io/v2/subscriber/unsubscribe?key=YOUR_PUBLIC_API_KEY&email={{ email }}&list_id=FSY27248&redirect=true">Annulla iscrizione da questa lista</a>

Per reindirizzare verso una pagina di conferma personalizzata dopo l’annullamento, aggiungi redirect_url:

<a href="https://api.clerk.io/v2/subscriber/unsubscribe?key=YOUR_PUBLIC_API_KEY&email={{ email }}&redirect=true&redirect_url=https://yoursite.com/unsubscribed">Annulla iscrizione</a>

Configurazione nello Store #

Questi passaggi richiedono modifiche sul tuo store e abilitano personalizzazione, flussi automatici e Carrello Abbandonato. Non tutti sono necessari per ogni negozio — dipende da cosa vuoi inviare.

Raccolta Email #

Necessaria per tutti i flussi automatici — abbandono navigazione, serie di benvenuto, e carrello abbandonato.

Ogni visitatore riceve un ID visitatore. Clerk.io lo usa per tracciare cosa visualizza, cerca e aggiunge al carrello.

Il problema è che l’ID visitatore all’inizio è anonimo — Clerk.io non può inviare email a quell’utente senza conoscerne l’indirizzo. La raccolta email effettua la connessione.

Una volta che l’email è collegata all’ID visitatore, tutto il comportamento della sessione può essere usato per attivare o personalizzare le email.

Ci sono due situazioni in cui questa connessione deve avvenire:

Quando il visitatore digita la mail — Se un visitatore inserisce l’email da qualche parte sul sito (campo checkout, iscrizione newsletter, modulo login), Clerk.io può rilevarlo e registrarlo automaticamente. Questo avviene tramite la funzione collect_email, che può essere attivata nella config di Clerk.js o da Developers > Clerk.js Config su my.clerk.io.

Quando il cliente è già autenticato — Se un cliente torna sul sito già autenticato, la sua email è subito disponibile. In questo caso, uno script su ogni pagina può loggare la mail una volta a sessione, quindi la connessione è fatta senza che debba digitare nulla.

Tracciamento Carrello #

Necessario per il Carrello Abbandonato.

Quando un visitatore abbandona senza acquistare, Clerk.io può inviargli un’email coi prodotti lasciati nel carrello — ma solo se conosce il contenuto.

Il tracciamento carrello deve essere chiamato ogni volta che cambia il carrello: aggiunta, rimozione o aggiornamento completo. Senza questo, il flusso Carrello Abbandonato non riceve dati prodotti.

Moduli Iscrizione #

Opzionale — serve solo se raccogli nuovi iscritti direttamente con Clerk.io.

Se usi Clerk.io come piattaforma email principale, serve un modo per far iscrivere i visitatori dal tuo sito. Così la tua lista iscritti cresce direttamente in Clerk.io, senza dipendere da piattaforme esterne.

Se preferisci continuare a raccogliere iscritti su Klaviyo o altro, tieni la sincronizzazione attiva in modo che i nuovi iscritti vengano portati continuativamente in Clerk.io. In questo caso, i moduli iscrizione non servono: puoi saltare questa sezione.

Vedi la sezione implementazione sotto per un modulo iscrizione pronto all’uso.

Con Clerk.js #

DNS setup e sincronizzazione iscritti sono sempre eseguiti tramite Email > Configuration e Settings > Integrations in my.clerk.io — non è richiesto codice.

Rilevamento automatico input email #

Se usi uno dei plugin installabili di Clerk.io (DanDomain Classic, Magento 1, Magento 2, PrestaShop, Shopware 6, VTEX o WooCommerce), attiva collect_email dalle impostazioni del plugin. Altrimenti, abilitato nella tua config Clerk.js. Clerk.js monitorerà tutti i campi email sulla pagina e registrerà l’indirizzo automaticamente quando il visitatore lo digita.

Clerk('config', {
  key: 'your-public-api-key',
  collect_email: true
});

Funziona per i campi checkout, iscrizione newsletter, login ed ogni altro <input type="email"> sulla pagina.

Clienti autenticati #

Se un cliente è già autenticato quando arriva, registra la mail una sola volta per sessione. L’implementazione precisa dipende dalla tua piattaforma, ma la parte importante è usare Clerk('call', 'log/email') per inviare la mail a Clerk.io appena è disponibile nella sessione.

Ecco un esempio con sessionStorage per evitare la chiamata su ogni caricamento pagina:

if (!sessionStorage.getItem('clerk_email_logged')) {
  Clerk('call', 'log/email', {
    email: 'CUSTOMER_EMAIL'
  });
  sessionStorage.setItem('clerk_email_logged', '1');
}

Sostituisci CUSTOMER_EMAIL con il vero indirizzo email della tua piattaforma. Assicurati di rendere lo script solo sulle pagine dove l’email è disponibile — saltalo per i guest.

Tracciamento Carrello #

Se usi i plugin Magento 1, Magento 2, PrestaShop o WooCommerce, il tracciamento carrello è automatico — nessun codice extra richiesto.

Per tutte le altre configurazioni, comunica a Clerk.io il contenuto del carrello con il metodo set. Chiamalo ogni volta che il carrello cambia, passando la lista corrente degli ID prodotto. Ogni chiamata viene associata automaticamene alla sessione visitatore attiva.

Clerk('cart', 'set', [1234, 5678, 42]);

Leggi di più sull’ integrazione Shopping Cart qui.

Moduli Iscrizione #

Di seguito trovi un modulo iscrizione pronto da inserire nel tuo sito — footer, homepage, popup. Personalizzalo come preferisci.

<div class="clerk-sign-up">
   <h2 class="clerk-sign-up-headline">Iscriviti ora!</h2>
   <div class="clerk-sign-up-subtitle">Ricevi offerte personali e resta aggiornato sulle tendenze.</div>
   <div class="clerk-input-wrapper">
      <input type="text" id="clerk-add-subscriber-input" placeholder="Inserisci la tua email">
      <button id="clerk-add-subscriber-btn" onclick="add_subscriber()">Iscriviti</button>
   </div>
   <div id="clerk-subscribe-message"></div>
</div>

<script>
   function add_subscriber() {
      var clerk_btn = document.getElementById("clerk-add-subscriber-btn");
      var clerk_input = document.getElementById("clerk-add-subscriber-input");
      var clerk_message = document.getElementById("clerk-subscribe-message");
      Clerk("call", "subscriber/subscribe", {
         email: clerk_input.value
      },
      function(response) {
         clerk_message.style.color = "#008001";
         clerk_message.innerText = "Sei ora iscritto!";
         clerk_btn.innerText = "Iscritto!";
         clerk_btn.style.opacity = "0.5";
         clerk_btn.disabled = true;
      },
      function(response) {
         clerk_message.style.color = "#EE360E";
         clerk_message.innerText = "Iscrizione non riuscita. Riprova.";
      });
   }
</script>

<style>
   .clerk-sign-up {
      width: 50%;
      padding: 60px 0;
      max-width: 800px;
      min-width: 500px;
      margin: 40px auto;
      background-color: #FEFAF4;
   }
   .clerk-sign-up-headline {
      margin: 0 14px 14px;
      text-align: center;
   }
   .clerk-sign-up-subtitle {
      margin: 14px 14px 28px;
      text-align: center;
      color: #808080;
   }
   .clerk-input-wrapper {
      margin: 10px auto;
      text-align: center;
   }
   #clerk-add-subscriber-input {
      height: 28px;
      width: 50%;
      padding: 0 0 0 6px;
      border: 1px solid #D3D3D3;
   }
   #clerk-add-subscriber-btn {
      height: 30px;
      background-color: #008001;
      border: 1px solid #008001;
      color: white;
      cursor: pointer;
   }
   #clerk-subscribe-message {
      height: 20px;
      margin: auto;
      text-align: center;
   }
</style>

Per iscrivere a una lista specifica anziché globalmente, aggiungi list_id alla chiamata. Gli ID lista sono disponibili in Email > Subscribers > Lists.

Clerk("call", "subscriber/subscribe", {
  email: "customer@example.com",
  list_id: "FSY27248"
});

Leggi di più su gestione iscritti e liste qui.

Con la API #

Questa sezione spiega lo stesso setup tramite chiamate API dirette. È rilevante per integrazioni lato server che non usano Clerk.js.

Quando usi la API, sei responsabile di generare e mantenere l’ID visitatore per ciascuna sessione. Vedi la Guida Tracking per dettagli su come fare.

Logga Email #

Usa log/email per associare un ID visitatore a un indirizzo email. Effettua questa chiamata una volta per sessione appena l’email è disponibile — sia quando il cliente effettua il login, sia se torna già autenticato.

curl -X POST https://api.clerk.io/v2/log/email \
  -H 'Content-Type: application/json' \
  -d '{
    "key": "your-public-api-key",
    "email": "customer@example.com",
    "visitor": "SESSION_VISITOR_ID"
  }'

Sostituisci SESSION_VISITOR_ID con l’ID visitatore della sessione corrente. Salta completamente la chiamata per i guest senza email.

Tracciamento Carrello #

Usa log/cart/update per stabilire lo stato corrente del carrello. Chiamalo ogni volta che il carrello cambia, passando la lista completa dei prodotti.

curl -X POST https://api.clerk.io/v2/log/cart/update \
  -H 'Content-Type: application/json' \
  -d '{
    "key": "your-public-api-key",
    "visitor": "SESSION_VISITOR_ID",
    "products": [
      {"id": 1234, "quantity": 2},
      {"id": 5678, "quantity": 1}
    ]
  }'

Puoi anche inviare email anziché (o insieme a) visitor se l’indirizzo è già noto al momento della chiamata.

Moduli Iscrizione #

Usa subscriber/subscribe per aggiungere una email come iscritto quando un visitatore si iscrive dal sito.

curl -X POST https://api.clerk.io/v2/subscriber/subscribe \
  -H 'Content-Type: application/json' \
  -d '{
    "key": "your-public-api-key",
    "email": "customer@example.com"
  }'

Per iscrivere a una lista specifica, includi list_id:

curl -X POST https://api.clerk.io/v2/subscriber/subscribe \
  -H 'Content-Type: application/json' \
  -d '{
    "key": "your-public-api-key",
    "email": "customer@example.com",
    "list_id": "FSY27248"
  }'

Leggi la documentazione completa su docs.clerk.io/reference/subscriberssubscribe.

Disiscrizione #

Usa subscriber/unsubscribe per disiscrivere una email tramite API — ad esempio da una pagina personalizzata o workflow backend.

curl -X POST https://api.clerk.io/v2/subscriber/unsubscribe \
  -H 'Content-Type: application/json' \
  -d '{
    "key": "your-public-api-key",
    "email": "customer@example.com"
  }'

Questo disiscrive globalmente. Per disiscrivere solo da una lista, includi list_id:

curl -X POST https://api.clerk.io/v2/subscriber/unsubscribe \
  -H 'Content-Type: application/json' \
  -d '{
    "key": "your-public-api-key",
    "email": "customer@example.com",
    "list_id": "FSY27248"
  }'

Consulta la documentazione completa su docs.clerk.io/reference/subscribersunsubscribe.