Setup

Denne guide dækker alt, hvad du skal sætte op, før Clerk.io kan sende emails på dine vegne.

Disse trin gælder kun, når du vil sende emails gennem Clerk.io — kampagner, flows og automatiske triggere som Abandoned Cart. Hvis du kun vil tilføje personlige produktanbefalinger til emails, du allerede sender gennem Klaviyo, Mailchimp eller en anden platform, er intet af dette nødvendigt. Gå i stedet direkte til Embeds.

Konfiguration #

Disse trin autoriserer Clerk.io til at sende emails fra dit domæne, giver det en liste over personer at sende til, og gør dit første email-design klar. Du skal have adgang til my.clerk.io, din domæneudbyders hosting, og din eksisterende email-platform.

DNS-opsætning #

DNS-opsætning er påkrævet for alle butikker, der bruger Clerk.io Email. Før Clerk.io kan sende nogen emails, skal du autentificere dit afsenderdomæne ved at tilføje DNS-records til din domæneudbyder.

Tænk på det sådan her: når Clerk.io sender en email på dine vegne, skal det bevise overfor modtagerens mailserver, at det faktisk er autoriseret til det. Uden det bevis ser emailen mistænkelig ud — ligesom nogen, der udgiver sig for at være dig uden ID. Mailservere kan ikke lide det og vil enten afvise emailen eller sende den direkte i spam.

DNS-records er din måde at give den autorisation på. Du tilføjer nogle få records til dit domænes indstillinger (hvor end du administrerer dit domæne — Route 53, Cloudflare, GoDaddy osv.), og de records fortæller internettet: “Clerk.io må sende emails som os.”

Der er tre record-typer, du skal tilføje:

• SPF — Angiver, hvilke tjenester der er autoriseret til at sende email fra dit domæne.
• DKIM — Tilføjer en kryptografisk signatur til udgående emails, så modtagere kan verificere, at de faktisk kommer fra dig og ikke er blevet ændret undervejs.
• CNAME — Bruges til at spore åbninger og klik i dine kampagner.

SPF-records: Et domæne må kun have én SPF TXT-record. Hvis du allerede har én, skal du flette direktivet, fx include:mailgun.org, ind i den, i stedet for at oprette en ny record.

For at finde dine DNS-records skal du gå til Email > Configuration > Domain Setup og følge den trin-for-trin guide for din hostingudbyder.

Når du har indtastet din Sender Email og Sender Name, genererer Clerk.io de præcise record-værdier, du skal tilføje. Når du har indsat dem hos din hostingudbyder, skal du vende tilbage til Email > Configuration > DNS Records og klikke på Verify Now. Clerk.io tjekker, at alle tre records er korrekt sat op.

Subscriber Sync #

Subscriber sync er påkrævet for alle butikker, der bruger Clerk.io Email. En subscriber er en emailadresse, der har givet samtykke til at modtage email-marketing. Clerk.io skal kende disse personer, før det kan sende kampagner.

Hvis du allerede har subscribers i en platform som Klaviyo eller MailChimp, kan du synkronisere dem direkte ind i Clerk.io. Så har du en komplet subscriber-liste fra dag ét.

For at sætte en sync op skal du gå til Settings > Integrations og forbinde din email-platform. Når integrationen er gemt, går du til Email > Configuration > Sync Subscribers og aktiverer togglen ud for den integration, du vil bruge.

For at finde opsætningsguiden til din specifikke email-platform, skal du finde den i integrations-menuen i sidebaren og følge dens Sync Data-guide.

Hvis du ikke bruger en ekstern email-platform, kan du importere subscribers via en CSV-fil eller inkludere dem i dit data feed med attributten subscribed: true på kunde-records.

Personalisering #

Personaliseringsfanen på Email > Configuration > Personalization giver dig mulighed for at sætte et butikslogo, som Clerk.io bruger på tværs af dine email-designs.

Du kan enten uploade et billede direkte eller bruge Auto-detect from website for at lade Clerk.io finde og hente logoet automatisk fra din webshop. Det er den hurtigste mulighed, hvis dit logo allerede er synligt på siden — Clerk.io finder det og bruger det uden manuel upload.

Logoet, du sætter her, bruges som standardlogo i Clerk.io-byggede email-designs. Hvis du bygger designet manuelt, kan du stadig bruge URL’en til logoet direkte i skabelonen.

Email Design #

Hver kampagne og automatiseret flow skal have et email-design — den visuelle skabelon, Clerk.io bruger, når den bygger den egentlige email.

Den nemmeste måde at lave et design er gennem Ask Clerk.io Design Studio. Beskriv, hvad du ønsker på almindeligt sprog — layout, farver, hvilke produkter der skal vises, hvordan udsalgspriser skal se ud — og den bygger et preview direkte i chatten, som du kan rette og gennemgå. Du kan også pege på dit site eller uploade et screenshot, og den matcher din eksisterende stil. Læs mere i Design Studio-guiden.

Hvis du ønsker mere kontrol, kan du bruge Clerk.io’s indbyggede MJML-editor til at skrive designs som struktureret markup. MJML kompileres til HTML, der vises ens på tværs af Gmail, Outlook og Apple Mail. Se MJML Designs-guiden for en gennemgang og eksempler.

Alle email-designs i Clerk.io er responsive — de tilpasser sig automatisk alle skærmstørrelser, så de ser godt ud på desktop, tablet og mobil uden ekstra arbejde.

Hvis du vil inkludere statiske billeder i dine designs — bannere, logoer, sæson-headers — kan du hoste dem direkte på Clerk.io’s servere via Media Library. Billeder, du uploader der, får en skabelonreference som {{ media.your-image }}, som du kan indsætte direkte i ethvert design. Du kan også uploade et billede direkte i Ask Clerk.io og bede den om at uploade billedet og bruge det i designet — den klarer resten.

Afmeld-links #

Hver marketingmail skal indeholde en måde for modtagere at afmelde sig. Hvordan du håndterer dette, afhænger af, hvordan du sender emails.

Bruger du en ekstern platform (Klaviyo, Mailchimp osv.) — Bliv ved med at bruge din eksisterende platforms afmeld-link. Den håndterer afmelding og holder din subscriber-liste opdateret automatisk.

Sender du alle emails gennem Clerk.io — Tilføj Clerk.io’s afmeld-link til dit design. Hvis du bruger Ask Clerk.io til at bygge emailen, skal du blot fortælle den, at den skal inkludere et afmeld-link, så ordner den resten automatisk.

For designs, du bygger manuelt, bruger du linket nedenfor. Variablen {{ email }} erstattes med hver modtagers adresse ved afsendelse. Udskift YOUR_PUBLIC_API_KEY med Public Key fra Developers > API Keys.

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

For kun at afmelde fra en specifik liste, tilføj list_id:

<a href="https://api.clerk.io/v2/subscriber/unsubscribe?key=YOUR_PUBLIC_API_KEY&email={{ email }}&list_id=FSY27248&redirect=true">Afmeld fra denne liste</a>

For at omdirigere til din egen bekræftelsesside efter afmelding, tilføj 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">Afmeld</a>

On-Site Opsætning #

Disse trin kræver ændringer i din webshop og åbner op for personalisering, automatiske flows og Abandoned Cart. Ikke alle trin er nødvendige for alle shops — hvilke du skal bruge, afhænger af, hvad du vil sende.

Email-indsamling #

Påkrævet for alle automatiske flows — besøgsforlader, velkomstserier og Abandoned Cart.

Hver besøgende på din side får tildelt et besøgs-ID. Clerk.io bruger dette til at spore, hvad de ser, søger på og lægger i kurven.

Problemet er, at besøgs-ID’et starter anonymt — Clerk.io har ingen måde at emaile den besøgende på, medmindre den kender adressen. Email-indsamling er det trin, der forbinder de to.

Når en besøgendes email er knyttet til deres besøgs-ID, kan hele deres session-adfærd bruges til at trigge og personalisere emails.

Der er to situationer, hvor forbindelsen skal oprettes:

Når en besøgende indtaster sin email — Hvis en besøgende skriver sin email et sted på sitet (et checkoutfelt, et nyhedsbrevs-tilmeldingsfelt, en loginformular), kan Clerk.io opfange det og logge det automatisk. Dette håndteres af collect_email-funktionen, som kan aktiveres i din Clerk.js-konfiguration eller under Developers > Clerk.js Config i my.clerk.io.

Når en kunde allerede er logget ind — Hvis en kunde vender tilbage til sitet og allerede er autentificeret, er deres email tilgængelig med det samme. Her kan et lille script på hver side logge emailen én gang pr. session, så forbindelsen sker uden at kunden skal indtaste noget.

Kurv-tracking #

Påkrævet for Abandoned Cart.

Når en besøgende forlader uden at gennemføre et køb, kan Clerk.io sende dem en email, der viser de præcise produkter, de forlod — men kun, hvis den ved, hvad der var i kurven.

Kurv-tracking skal kaldes, hver gang kurven ændres: når et produkt tilføjes, fjernes, eller når kurven opdateres fuldt ud. Uden det har Abandoned Cart-flowet ingen produktdata at arbejde med.

Subscriber-forms #

Valgfrit — kun nødvendigt, hvis du indsamler nye tilmeldinger direkte via Clerk.io.

Hvis du bruger Clerk.io som din primære email-platform, skal du have en måde for nye besøgende at tilmelde sig direkte fra din side. Så kan din subscriber-liste vokse i Clerk.io uden, at du skal stole på en ekstern platform til tilmeldinger.

Hvis du hellere vil fortsætte med at indsamle subscribers i Klaviyo eller en anden platform, skal du lade subscriber-sync køre kontinuerligt, så nye tilmeldinger løbende hentes ind i Clerk.io. I så fald er subscriber-forms ikke nødvendig — du kan springe dette afsnit over.

Se implementeringssektionen nedenfor for en klar-til-brug tilmeldingsformular.

Med Clerk.js #

DNS-opsætning og subscriber sync gøres altid via Email > Configuration og Settings > Integrations i my.clerk.io — de kræver ikke kode.

Email-indsamling #

Auto-detektering af emailfelter — Hvis du bruger et af Clerk.io’s installerbare plugins (DanDomain Classic, Magento 1, Magento 2, PrestaShop, Shopware 6, VTEX eller WooCommerce), skal du aktivere collect_email direkte i plugin-indstillingerne. Ellers skal du aktivere det i din Clerk.js-konfiguration. Clerk.js overvåger så alle email-inputfelter på siden og logger automatisk adressen, når en besøgende indtaster den.

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

Dette virker for checkoutfelter, nyhedsbrevstilmeldinger, login-formularer og alle andre <input type="email">-felter på siden.

Loggede kunder — Hvis en kunde allerede er logget ind, når de ankommer til siden, skal deres email logges én gang pr. session. Brug sessionStorage for at undgå at udføre kaldet ved hver eneste sideindlæsning:

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

Udskift CUSTOMER_EMAIL med den faktiske emailadresse fra din platform. Sørg for kun at køre dette script på sider, hvor emailadressen er tilgængelig — spring det helt over for gæster.

Kurv-tracking #

Hvis du bruger Magento 1, Magento 2, PrestaShop eller WooCommerce-plugin, håndteres kurv-tracking automatisk — ingen ekstra kode kræves.

For alle andre setups skal du notificere Clerk.io om kurvens aktuelle indhold med metoden set. Kald den, hver gang kurven ændrer sig, og send listen over produkt-ID’er. Hvert kald knyttes automatisk til den aktuelle besøgs-session.

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

Læs mere om Shopping Cart-integrationen her.

Subscriber-forms #

Her er en klar-til-brug tilmeldingsformular, du kan indsætte på din side — fx i footeren, på forsiden eller i et pop-up vindue. Style den, som du ønsker.

<div class="clerk-sign-up">
   <h2 class="clerk-sign-up-headline">Tilmeld dig nu!</h2>
   <div class="clerk-sign-up-subtitle">Få personlige tilbud og hold dig opdateret med trends.</div>
   <div class="clerk-input-wrapper">
      <input type="text" id="clerk-add-subscriber-input" placeholder="Indtast din email">
      <button id="clerk-add-subscriber-btn" onclick="add_subscriber()">Tilmeld</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 = "Du er nu tilmeldt!";
         clerk_btn.innerText = "Tilmeldt!";
         clerk_btn.style.opacity = "0.5";
         clerk_btn.disabled = true;
      },
      function(response) {
         clerk_message.style.color = "#EE360E";
         clerk_message.innerText = "Kunne ikke tilmelde. Prøv igen.";
      });
   }
</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>

For at tilføje til en specifik liste i stedet for globalt, skal du tilføje en list_id til kaldet. Liste-ID’er finder du under Email > Subscribers > Lists.

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

Læs mere om håndtering af subscribers og lister her.

Med API’et #

Dette afsnit dækker den samme opsætning med direkte API-kald. Det er relevant for server-side integrationer, der ikke bruger Clerk.js.

Når du bruger API’et, er du selv ansvarlig for at generere og vedligeholde besøgs-ID’et for hver session. Se Tracking-guiden for detaljer om dette.

Log Email #

Brug log/email til at koble et besøgs-ID sammen med en emailadresse. Kald dette én gang pr. session, når en email er tilgængelig — både når kunden logger ind og når de vender tilbage allerede logget ind.

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"
  }'

Udskift SESSION_VISITOR_ID med det aktuelle besøgs-ID for sessionen. Spring dette kald helt over for gæster, hvor email ikke kendes.

Kurv-tracking #

Brug log/cart/update til at sætte kurven til dens aktuelle tilstand. Kald det, når kurven ændrer sig, og send hele listen over produkter, der er i kurven.

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}
    ]
  }'

Du kan også sende email i stedet for (eller i tillæg til) visitor, hvis emailadressen allerede er kendt ved kaldet.

Subscriber-forms #

Brug subscriber/subscribe til at tilføje en emailadresse som subscriber, når en besøgende tilmelder sig via din side.

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"
  }'

For at tilmelde til en bestemt liste, inkluder 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"
  }'

Læs hele referencen på docs.clerk.io/reference/subscriberssubscribe.

Afmelding #

Brug subscriber/unsubscribe for at afmelde en emailadresse programmatisk — fx fra en brugerdefineret afmeld-side eller et backend-workflow.

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"
  }'

Dette afmelder globalt. For kun at afmelde fra en specifik liste, inkludér 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"
  }'

Læs hele referencen på docs.clerk.io/reference/subscribersunsubscribe.