Setup

Questa guida copre la configurazione necessaria prima che Clerk.io possa inviare email per tuo conto.

Si applica a campagne, flussi e trigger automatici come Carrello Abbandonato. Se desideri solo aggiungere consigli personalizzati sui prodotti alle email inviate da Klaviyo, Mailchimp o un’altra piattaforma, vai su Embeds.

Ogni concetto di seguito spiega a cosa serve, quando è necessario e come gestirlo con Clerk.js o tramite API laddove sia richiesto del codice.

Scegli il percorso di configurazione corretto #

Usa la sezione che corrisponde al compito che devi completare:

• Verifica la configurazione: Apri Setup Status per trovare configurazioni mancanti o tracciamenti non funzionanti.
• Invia dal tuo dominio: Configura il Sender Domain e verifica i suoi record DNS.
• Prepara i destinatari: Sincronizza gli iscritti esistenti, importali o raccogli nuove iscrizioni.
• Configura l’invio email: Imposta Store Personalization, Email Designs, Email Identification, e Cart Tracking.

La configurazione è basata sul compito. Per esempio, Carrello Abbandonato richiede l’identificazione email e il tracciamento del carrello, mentre una campagna occasionale richiede un dominio mittente, iscritti e un design email.

Setup Status #

La scheda Setup Status ti offre una panoramica in tempo reale della configurazione email.

La trovi in Email > Configuration > Setup Status. Mostra se le parti richieste sono configurate, se il tracciamento funziona e se le email vengono inviate come previsto.

Ogni voce ha un pallino colorato. Verde significa tutto in ordine, rosso significa che manca qualcosa o qualcosa è rotto, arancione è un avviso da controllare.

I controlli sono raggruppati in tre aree:

Configuration copre la configurazione principale: se l’invio email è abilitato, quale sender domain è configurato, quanti destinatari iscritti sono disponibili e se i passaggi attivi nei flussi hanno design email.

On-site tracking mostra se il tracciamento dei visitatori è attivo. Mostra anche quanti visitatori o carrelli sono stati collegati a un indirizzo email negli ultimi sette giorni.

Flows & sending mostra se i flussi attivi sono configurati, quanti eventi flow sono in attesa, quante email sono state inviate di recente e se la coda di invio è sana.

Inizia qui quando le email non vengono inviate come previsto. È la cosa più simile a una dashboard che la configurazione email abbia per monitorare la situazione.

Sender Domain #

Il sender domain è il dominio che Clerk.io usa quando invia email per il tuo store.

Prima che Clerk.io possa inviare da quel dominio, devi autenticarlo con i record DNS. Questi record dicono ai server di posta riceventi che Clerk.io è autorizzato a inviare email per tuo conto.

Senza questa prova, le email possono essere rifiutate o finite nello spam. I server di posta sono sospettosi per professione, e francamente ne hanno viste di tutti i colori.

DNS Records #

Aggiungi i record DNS richiesti nel tuo gestore di dominio. Solitamente è dove gestisci il dominio, come Cloudflare, GoDaddy, Route 53 o un provider simile.

Clerk.io usa tre tipi di record DNS:

• SPF dichiara quali servizi possono inviare email dal tuo dominio.
• DKIM aggiunge una firma così i destinatari possono verificare che l’email provenga da te e non sia stata modificata durante il transito.
• CNAME serve per tracciare aperture e clic nelle tue campagne.

SPF records: Un dominio può avere solo un record SPF TXT. Se ne hai già uno, unisci la direttiva, ad esempio include:mailgun.org, nel record esistente invece di crearne un secondo.

Per trovare i tuoi record, vai su Email > Configuration > Domain Setup e segui la guida per il tuo provider di hosting.

Dopo aver inserito la tua Sender Email e il Sender Name, Clerk.io genera i valori esatti dei record. Aggiungili nel gestore di dominio, poi torna su Email > Configuration > DNS Records e clicca su Verify Now.

Subscribers #

Un subscriber è un indirizzo email che ha acconsentito a ricevere email di marketing.

Clerk.io ha bisogno di subscribers prima di poter inviare campagne. Un flow può identificare un visitatore e sapere esattamente cosa ha visualizzato, ma non può comunque inviare un’email marketing a chi non si è iscritto.

Ci sono diversi modi per portare subscribers in Clerk.io:

• Sincronizza da una piattaforma email esistente.
• Importali da un file CSV.
• Includili nel tuo data feed con subscribed: true.
• Raccogli nuove iscrizioni dal tuo sito con un modulo.

Sincronizzazione degli iscritti esistenti #

La sincronizzazione degli iscritti è l’opzione migliore se hai già subscribers su una piattaforma come Klaviyo o Mailchimp.

Per prima cosa, collega la tua piattaforma email su Settings > Integrations. Poi vai su Email > Configuration > Sync Subscribers e attiva l’interruttore per l’integrazione.

Per trovare la guida per una piattaforma email specifica, usa il menu delle integrazioni nella sidebar e segui la sua guida Sync Data.

Se non usi una piattaforma email esterna, importa gli iscritti con un file CSV oppure includili nel tuo data feed utilizzando subscribed: true nei record customer.

Double opt-in #

Il double opt-in richiede ai nuovi iscritti di confermare il loro indirizzo email prima che Clerk.io invii loro newsletter. Questo è utile se la tua azienda opera in Germania o in un altro mercato dove è richiesta una conferma esplicita del consenso.

Per abilitarlo, vai su Email > Configuration > Sync Subscribers, attiva Double opt-in e salva le modifiche.

Dopo che un visitatore si iscrive, Clerk.io invia un’email di conferma. L’iscritto non riceverà newsletter finché non clicca sul link di conferma.

L’email di conferma include un’anteprima live durante la modifica. Puoi personalizzare Subject, Heading, Message e Button text. L’email usa il dominio mittente verificato del tuo store per impostazione predefinita e il link di conferma sicuro viene aggiunto automaticamente.

Lascia un campo vuoto per usare il valore sicuro predefinito per quella parte dell’email di conferma.

Ottenere nuovi iscritti #

Ottenere nuovi iscritti significa raccogliere nuove iscrizioni dal tuo sito.

Questo è diverso dalla sincronizzazione degli iscritti esistenti. La sincronizzazione importa persone che si sono già iscritte altrove. Un modulo di iscrizione consente ai nuovi visitatori di iscriversi direttamente dal tuo store.

Usa questa opzione se Clerk.io è la tua piattaforma email principale, o se vuoi un modulo che iscriva i visitatori direttamente a Clerk.io.

Usando Clerk.js #

Usa Clerk.js quando un visitatore si iscrive direttamente sul tuo sito.

L’esempio sottostante iscrive globalmente l’indirizzo email inserito. Puoi inserire il modulo nel footer, sulla homepage o in un popup, e poi personalizzarlo per abbinarlo al tuo store.

<div class="clerk-sign-up">
   <h2 class="clerk-sign-up-headline">Sign up now!</h2>
   <div class="clerk-sign-up-subtitle">Get personal offers and stay up-to-date with trends.</div>
   <div class="clerk-input-wrapper">
      <input type="text" id="clerk-add-subscriber-input" placeholder="Enter your email">
      <button id="clerk-add-subscriber-btn" onclick="add_subscriber()">Subscribe</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 = "You are now subscribed!";
         clerk_btn.innerText = "Subscribed!";
         clerk_btn.style.opacity = "0.5";
         clerk_btn.disabled = true;
      },
      function(response) {
         clerk_message.style.color = "#EE360E";
         clerk_message.innerText = "Could not subscribe. Please try again.";
      });
   }
</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 specifica lista, aggiungi list_id. Gli ID lista si trovano in Email > Subscribers > Lists.

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

Per saperne di più visita Subscribers.

Usando l’API #

Usa l’API quando il tuo modulo di iscrizione o il backend devono gestire direttamente gli iscritti.

Chiama subscriber/subscribe per aggiungere un indirizzo email come iscritto:

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 specifica lista, 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"
  }'

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

Unsubscribing #

La disiscrizione è come i destinatari si rimuovono dalle email di marketing.

Ogni email di marketing deve includere un modo per i destinatari di disiscriversi. Come gestirlo dipende se il destinatario clicca un link in un’email o se il tuo backend gestisce l’opt-out.

Usando una piattaforma esterna — Continua a usare il link di disiscrizione della piattaforma che già utilizzi. Klaviyo, Mailchimp o la tua piattaforma gestiscono l’opt-out e mantengono aggiornata la lista iscritti.

Invio tramite Clerk.io — Aggiungi il link di disiscrizione di Clerk.io al design. Se usi Ask Clerk.io, chiedi di includere un link di disiscrizione e ne aggiungerà uno per te.

Usare i link di disiscrizione #

Per i design che costruisci manualmente, usa il link qui sotto.

La variabile {{ email }} sarà sostituita con l’indirizzo del 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">Unsubscribe</a>

Per disiscrivere 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">Unsubscribe from this list</a>

Per reindirizzare a una tua pagina di conferma dopo la disiscrizione, 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">Unsubscribe</a>

Usando l’API #

Usa subscriber/unsubscribe per disiscrivere un indirizzo email in modo programmato.

Utile per pagine di disiscrizione personalizzate o flussi 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 specifica 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"
  }'

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

Store Personalization #

La personalizzazione dello store controlla i brand assets predefiniti che Clerk.io usa nei design email.

Vai su Email > Configuration > Personalization per impostare il logo dello store. Puoi caricare manualmente un’immagine oppure usare Auto-detect from website per lasciare che Clerk.io la trovi sul tuo sito.

Il logo impostato qui viene utilizzato come logo predefinito nei design email creati con Clerk.io. Se crei i design manualmente, puoi sempre usare l’URL del logo direttamente nel template.

Email Designs #

Un design email è il template visivo usato da Clerk.io per creare l’email da inviare.

Ogni campagna e ogni flow automatico necessita di un design. Il design controlla layout, colori, testo, blocchi prodotto, link di disiscrizione e tutto ciò che il destinatario vede.

Con Ask Clerk.io Design Studio #

Il modo più semplice per creare un design è con Ask Clerk.io Design Studio.

Descrivi cosa desideri in linguaggio naturale, come layout, colori, quali prodotti mostrare e come visualizzare i prezzi in saldo. Design Studio costruisce un’anteprima in chat che puoi rivedere e perfezionare.

Puoi anche inserire il link del tuo sito o allegare uno screenshot. Sarà usato come riferimento visivo, molto più veloce che descrivere la tua sfumatura di verde come se fosse un sospettato in un confronto all’americana.

Approfondisci nella guida a Design Studio.

Con MJML #

Usa l’MJML editor integrato per avere più controllo sul markup.

MJML compila in HTML che si visualizza in modo coerente su Gmail, Outlook, Apple Mail e altri client. Consulta la guida ai design MJML per walkthrough ed esempi.

Tutti i design email in Clerk.io sono responsive e si adattano automaticamente a desktop, tablet e mobile.

Immagini statiche #

Usa la Media Library per immagini statiche come banner, loghi e header stagionali.

Le immagini caricate ricevono un riferimento in template come {{ media.your-image }} che puoi usare in qualsiasi design.

Puoi anche allegare un’immagine direttamente in Ask Clerk.io e chiedergli di aggiungerla al design caricandola.

Email Identification #

L’email identification collega una sessione visitatore a un indirizzo email.

È richiesta per i flussi automatici come carrello abbandonato, serie di benvenuto e Carrello Abbandonato. Senza questo, Clerk.io può sapere cosa fa il visitatore ma non a chi inviare l’email.

Ogni visitatore del sito riceve un visitor ID. All’inizio è anonimo. Email identification lo collega a un indirizzo email quando il visitatore lo inserisce o ritorna già autenticato.

Usando Clerk.js #

Usa collect_email per far rilevare a Clerk.js i campi email automaticamente.

Se usi uno dei plugin installabili di Clerk.io, attiva collect_email dalle impostazioni del plugin. Vale per DanDomain Classic, Magento 1, Magento 2, PrestaShop, Shopware 6, VTEX e WooCommerce.

Per altre configurazioni, abilitalo nel config Clerk.js:

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

Clerk.js monitorerà i campi email e registrerà l’indirizzo quando digitato da un visitatore.

Funziona per campi checkout, iscrizioni newsletter, login e altri elementi <input type="email">.

Se un cliente è già autenticato, registra la sua email una sola volta per sessione con Clerk('call', 'log/email').

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

Sostituisci CUSTOMER_EMAIL col reale indirizzo email della tua piattaforma. Esegui lo script solo quando l’indirizzo email è disponibile.

Usando l’API #

Usa log/email per associare un visitor ID a un indirizzo email.

Chiamalo una volta per sessione quando un indirizzo email è disponibile. Vale se un cliente fa login o ritorna 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 il visitor ID della sessione corrente.

Usando l’API sei responsabile di generare e gestire il visitor ID. Vedi la guida Tracking per dettagli.

Cart Tracking #

Cart tracking comunica a Clerk.io quali prodotti ci sono attualmente nel carrello del visitatore.

È richiesto per le email Carrello Abbandonato. Quando un visitatore abbandona senza acquistare, Clerk.io può inviare il contenuto del carrello solo se esso è stato tracciato.

Chiama il tracciamento carrello ogni volta che il carrello cambia: aggiunta, rimozione prodotto o aggiornamento totale.

Con Clerk.js #

Se usi i plugin Magento 1, Magento 2, PrestaShop o WooCommerce, il tracciamento carrello è gestito automaticamente.

Per altri setup, notifica a Clerk.io il contenuto attuale del carrello usando il metodo set. Ogni chiamata si riferisce alla sessione visitatore corrente.

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

Scopri di più nell’ integrazione Shopping Cart.

Con l’API #

Usa log/cart/update per impostare lo stato attuale del carrello.

Chiamalo ogni volta che il carrello cambia, passando la lista completa dei prodotti correnti.

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 passare email invece di, o oltre a, visitor se l’indirizzo email è già noto.