Email

Setup

Tutto ciò che devi configurare prima che Clerk.io possa inviare email per tuo conto.

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

Si applica a campagne, flussi e trigger automatizzati come il Carrello Abbandonato. Se vuoi solo aggiungere raccomandazioni di prodotto personalizzate alle email inviate da Klaviyo, Mailchimp o un’altra piattaforma, vai invece su Embeds.

Ogni concetto elencato di seguito spiega cosa fa, quando è necessario e come gestirlo con Clerk.js o tramite l’API dove richiesto codice.

Scegli il giusto percorso di configurazione #

Usa la sezione che corrisponde al compito che devi completare:

La configurazione è basata sui compiti. Ad esempio, il Carrello Abbandonato richiede identificazione email e tracciamento del carrello, mentre una campagna singola richiede un dominio mittente, iscritti e un design dell’email.

Setup Status #

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

La trovi su Email > Configuration > Setup Status. Mostra se le parti necessarie sono configurate, se il tracciamento funziona e se le email vengono inviate correttamente.

Ogni elemento ha un pallino colorato. Verde significa che tutto è in ordine, rosso indica che manca qualcosa o ci sono problemi, e arancione è un avviso da verificare.

I controlli sono raggruppati in tre aree:

Configuration riguarda la configurazione di base. Include se l’invio email è attivo, quale dominio mittente è configurato, quanti destinatari iscritti sono disponibili e se i passaggi attivi del flusso hanno design email.

On-site tracking mostra se il tracciamento dei visitatori è attivo. Indica 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 di flusso sono in sospeso, quante email sono state inviate di recente e se la coda di invio è sana.

Inizia da qui se le email non vengono inviate come previsto. È la cosa più simile a una dashboard per la configurazione email che controlla silenziosamente il livello del carburante.

Sender Domain #

How Clerk.io sends emails from your domain — a three-step overview of DNS setup

Il sender domain è il dominio che Clerk.io utilizza per inviare email per il tuo negozio.

Prima che Clerk.io possa inviare da quel dominio, devi autenticarlo aggiungendo dei record DNS. Questi record comunicano ai server di posta destinatari che Clerk.io è autorizzato a inviare email per tuo conto.

Senza questa prova, le email potrebbero essere respinte o finite nello spam. I server di posta sono sospettosi per mestiere, e francamente hanno visto cose.

DNS Records #

Aggiungi i record DNS richiesti presso l’host del tuo dominio. Questo di solito coincide con dove gestisci il tuo dominio, come Cloudflare, GoDaddy, Route 53 o provider simili.

Clerk.io utilizza tre tipi di record DNS:

  • SPF dichiara quali servizi possono inviare email dal tuo dominio.
  • DKIM aggiunge una firma per permettere ai destinatari di verificare che l’email provenga effettivamente da te e non sia stata modificata in transito.
  • CNAME è usato per tracciare aperture e clic nelle tue campagne.
Record SPF: Un dominio può avere un solo record SPF di tipo TXT. Se ne hai già uno, integra la direttiva, es. include:mailgun.org, nel record esistente invece di crearne uno nuovo.

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

Dopo aver inserito il Sender Email e Sender Name, Clerk.io genera i valori esatti dei record. Aggiungili al tuo dominio, quindi torna a Email > Configuration > DNS Records e clicca Verify Now.

Subscribers #

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

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

Ci sono diversi modi per portare iscritti su Clerk.io:

  • Sincronizzarli da una piattaforma email esistente.
  • Importarli da un file CSV.
  • Includerli nel tuo data feed con subscribed: true.
  • Raccogliere nuove iscrizioni dal tuo sito tramite un form.

Sincronizzazione degli iscritti esistenti #

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

Collega prima la tua piattaforma email su Settings > Integrations. Poi vai su Email > Configuration > Sync Subscribers e attiva l’integrazione desiderata.

Sync Subscribers tab in Email Configuration

Per trovare la guida della 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 o includili nel tuo data feed usando subscribed: true nei record cliente.

Nuovi iscritti #

Ottenere nuovi iscritti significa raccogliere nuove iscrizioni direttamente dal tuo sito.

Questo è diverso dalla sincronizzazione: la sincronizzazione porta persone che si sono già iscritte altrove. Un form di iscrizione permette ai nuovi visitatori di iscriversi direttamente dal tuo negozio.

Usalo se Clerk.io è la tua piattaforma email principale o se desideri un modulo che iscriva direttamente su Clerk.io.

Con Clerk.js #

Usa Clerk.js quando un visitatore si iscrive direttamente dal sito.

L’esempio seguente iscrive globalmente l’indirizzo email inserito. Puoi inserire il form nel footer, nella homepage o in un popup e personalizzarne lo stile per adattarlo al negozio.

Subscriber sign-up form example
<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 lista specifica, aggiungi list_id. Gli ID lista si trovano su Email > Subscribers > Lists.

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

Per approfondire consulta Subscribers.

Con l’API #

Usa l’API se vuoi che il tuo form o backend gestisca direttamente le iscrizioni.

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 su una lista specifica, aggiungi 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.

Annulla iscrizione #

L’annullamento dell’iscrizione è il modo in cui i destinatari possono rinunciare alle email di marketing.

Ogni email marketing deve includere un modo per annullare l’iscrizione. La gestione può variare a seconda che il destinatario clicchi su un link nell’email o che l’opt-out venga gestito dal tuo backend.

Usi una piattaforma esterna — Continua a utilizzare il link di annullamento della tua piattaforma. Klaviyo, Mailchimp o l’altra piattaforma gestiscono il processo e tengono sincronizzata la lista iscritti.

Invii tramite Clerk.io — Aggiungi il link di annullamento di Clerk.io al design. Se usi Ask Clerk.io, chiedigli di includere un link di disiscrizione e lo farà automaticamente.

Per i design creati manualmente, usa il link sotto.

La variabile {{ email }} viene sostituita con l’indirizzo del destinatario al momento dell’invio. Sostituisci YOUR_PUBLIC_API_KEY con la tua 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 disiscriversi 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 pagina di conferma personalizzata 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>

Con l’API #

Usa subscriber/unsubscribe per annullare l’iscrizione di un indirizzo email in modo programmato.

È utile per pagine di disiscrizione personalizzate o processi 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 annulla l’iscrizione globale. Per annullare l’iscrizione solo da una lista specifica, 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.

Store Personalization #

Email Configuration Personalization tab with store logo settings

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

Vai su Email > Configuration > Personalization per impostare il logo del negozio. Puoi caricare un’immagine manualmente o usare Auto-detect from website per far trovare il logo a Clerk.io dal tuo sito.

Il logo impostato qui viene usato di default nei design email creati da Clerk.io. Se crei i tuoi design manualmente, puoi sempre usare direttamente l’URL del logo nel template.

Email Designs #

Ask Clerk.io Design Studio showing an email design preview with product recommendations

Un design email è il template visivo che Clerk.io utilizza per costruire l’email inviata.

Ogni campagna e flusso automatico richiede un design. Il design controlla layout, colori, testo, blocchi prodotto, link per la disiscrizione e tutto ciò che vede il destinatario.

Con Ask Clerk.io Design Studio #

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

Descrivi ciò che vuoi in linguaggio naturale, come layout, colori, quali prodotti mostrare e come visualizzare i prezzi scontati. Design Studio costruisce un’anteprima in chat che puoi rivedere e modificare.

Puoi anche indicare un sito o caricare uno screenshot come riferimento visivo, che è molto più veloce che descrivere la tua sfumatura di verde come se fosse un sospetto in un riconoscimento dalla polizia.

Leggi di più nella Design Studio guide.

Con MJML #

Usa il MJML editor integrato per maggior controllo sul markup.

MJML compila in HTML che viene sempre visualizzato correttamente su Gmail, Outlook, Apple Mail e altri client. Consulta la MJML Designs guide per una guida completa ed esempi.

Tutti i design email in Clerk.io sono responsive. 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 qui ricevono un riferimento template come {{ media.your-image }} da utilizzare in qualsiasi design.

Puoi anche allegare un’immagine direttamente in Ask Clerk.io e chiedere che venga caricata e usata nel design.

Email Identification #

L’identificazione email collega la sessione di un visitatore a un indirizzo email.

È richiesta per flussi automatici come abbandono navigazione, welcome series e Carrello Abbandonato. Senza, Clerk.io può sapere cosa ha fatto un visitatore ma non a chi inviare email relative.

Ogni visitatore del sito riceve un visitor ID. Inizialmente questo ID è anonimo. L’identificazione collega l’ID a un indirizzo email, quando il visitatore lo inserisce o effettua il login.

Con Clerk.js #

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

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

Per altre configurazioni, abilitalo nel config di Clerk.js:

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

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

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

Se il cliente è già loggato, registra l’email una 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 con l’indirizzo email reale dalla tua piattaforma. Rendi lo script solo quando è disponibile l’email.

Con l’API #

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

Chiamalo una volta per sessione quando hai disponibile l’email. Vale per login e per clienti già autenticati.

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.

Quando usi l’API, sei responsabile di generare e mantenere il visitor ID. Consulta la Tracking guide per maggiori dettagli.

Cart Tracking #

Il tracciamento del carrello informa Clerk.io su cosa un visitatore ha attualmente nel carrello.

È indispensabile per le email di Carrello Abbandonato. Quando il visitatore abbandona senza acquistare, Clerk.io può inviare il contenuto del carrello solo se lo stesso è stato tracciato.

Esegui il tracciamento ogni volta che il carrello cambia: quando aggiungi o rimuovi un prodotto, o quando lo aggiorni completamente.

Con Clerk.js #

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

Per altre configurazioni, notifica a Clerk.io il contenuto attuale del carrello con il metodo set. Ogni chiamata è legata alla sessione visitatore corrente.

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

Per approfondire consulta la Shopping Cart integration.

Con l’API #

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

Chiamalo ogni volta che il carrello cambia, passando la lista attuale 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 passare email invece di, oppure insieme a, visitor se l’indirizzo email è già noto.

Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.