Setup

Denne guide dækker alt, 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 automatiserede udløsere som Forladt Kurv. Hvis du kun ønsker at tilføje personaliserede 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 giver Clerk.io tilladelse til at sende emails fra dit domæne, tildeler en liste over personer, der skal sendes til, og gør dit første emaildesign klar. Du skal have adgang til my.clerk.io, din domæneudbyder og din eksisterende emailplatform.

Opsætningsstatus #

Fanen Setup Status under Email > Configuration > Setup Status giver dig et live overblik over, om din emailopsætning er komplet og sund.

Hvert punkt på listen viser en farvet prik — grøn betyder, at alt er i orden, rød betyder, at noget mangler eller er i stykker, og orange er en advarsel, der er værd at undersøge. Fanens overskrift viser desuden et antal manglende påkrævede trin, så du hurtigt kan se, om handling er nødvendig.

Tjekpunkterne er grupperet i tre områder:

Konfiguration dækker de grundlæggende opsætningskrav — om din butik og virksomhed er aktiveret, om emailadgang er aktiv, hvilket afsenderdomæne der er sat op, hvor mange tilmeldte modtagere der er tilgængelige, og om alle aktive flow-trin har tilknyttede emaildesign.

On-site tracking viser, om besøgs-tracking kører, og hvor mange besøgende eller kurve, der er blevet koblet til en emailadresse de sidste syv dage. Lave tal her tyder som regel på en manglende emailindsamling.

Flows & sending viser, om aktive flows er konfigureret, hvor mange flowevents der afventer, hvor mange emails der er blevet sendt for nylig, og om sendekøen er sund. Hvis emails ikke bliver afsendt som forventet, er dette det første sted at tjekke.

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 autenticere dit afsenderdomæne ved at tilføje DNS-poster hos din domæneudbyder.

Tænk på det sådan her: Når Clerk.io sender en email på dine vegne, skal den bevise over for modtagerens mailserver, at den faktisk er autoriseret til det. Uden det bevis virker mailen mistænkelig — som en, der udgiver sig for at være dig uden legitimation. Mailservere bryder sig ikke om det, og vil enten afvise mailen eller sende den direkte i spam.

DNS-poster er måden, du giver den godkendelse på. Du tilføjer nogle få poster til dine domæneindstillinger (hvor end du administrerer dit domæne — Route 53, Cloudflare, GoDaddy osv.), og de poster fortæller internettet: “Clerk.io har tilladelse til at sende emails som os.”

Der er tre posttyper, du skal tilføje:

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

SPF-poster: Et domæne kan kun have én SPF TXT-post. Hvis du allerede har én, skal du tilføje direktivet, f.eks. include:mailgun.org, til den i stedet for at oprette en ny post.

For at finde dine DNS-poster, gå til Email > Configuration > Domain Setup og følg trin-for-trin-guiden for din udbyder.

Når du har indtastet din afsender-email og afsendernavn, genererer Clerk.io de nøjagtige postværdier, du skal tilføje. Når du har tilføjet dem hos din udbyder, vender du tilbage til Email > Configuration > DNS Records og klikker Verify Now. Clerk.io tjekker, at alle tre poster er konfigureret korrekt.

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 emailmarkedsføring. Clerk.io skal vide, hvem disse personer er, før der kan sendes kampagner.

Hvis du allerede har subscribers i en platform som Klaviyo eller MailChimp, kan du synkronisere dem direkte til Clerk.io. Dette giver dig en fuld abonnentliste fra dag ét.

For at opsætte sync går du til Settings > Integrations og forbinder din emailplatform. Når integrationen er gemt, går du til Email > Configuration > Sync Subscribers og aktiverer knappen ud for den integration, du vil bruge.

For at finde opsætningsguiden for din specifikke emailplatform, slå den op i integrationsmenuen i sidebaren og følg dens Sync Data-guide.

Hvis du ikke bruger en ekstern emailplatform, kan du importere subscribers via en CSV-fil eller inkludere dem i dit data-feed ved at bruge attributten subscribed: true på kundeposter.

Personalisering #

Fanen Personalization under Email > Configuration > Personalization lader dig sætte en butiksl ogo, som Clerk.io vil bruge på tværs af dine emaildesigns.

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

Logoet, der sættes her, bruges som standardlogo i Clerk.io-byggede emaildesigns. Hvis du bygger dine designs manuelt, kan du stadig referere til det ved at bruge dit logo-URL direkte i skabelonen.

Email Design #

Alle kampagner og automatiserede flows skal have et emaildesign — den visuelle skabelon, Clerk.io bruger til at bygge den faktiske email, der sendes.

Den nemmeste måde at oprette én på er gennem Ask Clerk.io Design Studio. Beskriv, hvad du ønsker, i almindeligt sprog — layout, farver, hvilke produkter, hvordan tilbudspriser skal vises — og den bygger et preview i chatten til vurdering og justering. Du kan også pege på din hjemmeside eller vedhæfte et screenshot, så den matcher din eksisterende stil. Læs mere i Design Studio guiden.

For mere kontrol giver Clerk.io’s indbyggede MJML editor dig mulighed for at skrive designs som struktureret markup. MJML kompileres til HTML, der vises korrekt i både Gmail, Outlook og Apple Mail. Se MJML Designs guiden for en fuld vejledning og eksempler.

Alle emaildesigns i Clerk.io er responsive — de tilpasser sig automatisk til enhver skærmstørrelse, 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æsonoverskrifter — kan du hoste dem direkte på Clerk.io’s servere via Media Library. Billeder uploadet her får et templatereference som {{ media.your-image }}, som du kan indsætte direkte i ethvert design. Du kan også vedhæfte et billede direkte i Ask Clerk.io og bede den om at uploade og bruge billedet i designet — så ordner den resten.

Afmeldingslinks #

Hver marketingemail skal indeholde en mulighed for at fravælge. Hvordan du håndterer dette afhænger af, hvordan du sender emails.

Bruger du en ekstern platform (Klaviyo, Mailchimp osv.) — Fortsæt med at bruge platformens eget afmeldingslink. Den håndterer fravalget og holder din abonnentliste opdateret automatisk.

Sender du alle mails via Clerk.io — Tilføj Clerk.io’s afmeldingslink til dit design. Hvis du bruger Ask Clerk.io til at bygge emailen, så bed den om at inkludere et afmeldingslink, og den ordner resten.

For designs, du bygger manuelt, anvend linket herunder. Variablen {{ email }} erstattes af modtagerens adresse under afsendelsen. Erstat 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">Unsubscribe</a>

For kun at afmelde 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">Unsubscribe from this list</a>

For at viderestille 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">Unsubscribe</a>

On-Site Opsætning #

Disse trin kræver ændringer på din webshop og åbner for personalisering, automatiserede flows og Forladt Kurv. Ikke alle er nødvendige for alle shops — hvilke du skal bruge afhænger af, hvad du vil sende.

Emailindsamling #

Påkrævet for alle automatiske flows — browse-afbrud, velkomstserier og Forladt Kurv.

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

Problemet er, at besøgs-ID starter anonymt — Clerk.io har ingen mulighed for at sende email til den besøgende, medmindre adressen kendes. Emailindsamling er trin, der forbinder de to.

Når en besøgendes email er koblet til deres besøgs-ID, kan al adfærd i sessionen bruges til at udløse og personalisere emails.

Der er to situationer, hvor denne forbindelse skal laves:

Når en besøgende selv indtaster sin email — Indtaster en bruger sin email et sted på siden (checkout-felt, nyhedsbrevstilmelding, login), kan Clerk.io opfange det og gemme det automatisk. Dette sker via funktionen collect_email, som aktiveres i din Clerk.js-konfiguration eller fra Developers > Clerk.js Config i my.clerk.io.

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

Kurvtracking #

Påkrævet for Forladt Kurv.

Forlader en besøgende siden uden køb, kan Clerk.io sende dem en mail med netop de produkter, der blev efterladt — men kun, hvis Clerk.io ved, hvad der er i kurven.

Kurvtracking skal kaldes, hver gang kurven ændres: når et produkt tilføjes, fjernes, eller når kurven opdateres helt. Uden dette har Forladt Kurv-flowet ingen produktdata at bruge.

Subscriber Forms #

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

Hvis du bruger Clerk.io som din primære emailplatform, skal du have mulighed for, at nye besøgende kan tilmelde sig direkte fra siden. Dette holder din abonnentliste voksende i Clerk.io uden afhængighed af en ekstern platform for tilmeldinger.

Foretrækker du at indsamle subscribers i Klaviyo eller en anden platform, skal du lade subscriber sync køre løbende, så nye tilmeldinger jævnligt føres ind i Clerk.io. I så fald er tilmeldingsformularer ikke nødvendige — du kan springe dette over.

Se implementeringssektionen nedenfor for en brugsklar tilmeldingsformular.

Med Clerk.js #

DNS-opsætning og subscriber sync håndteres altid via Email > Configuration og Settings > Integrations i my.clerk.io — ingen kode er påkrævet.

Automatisk registrering af emailfelter #

Bruger du et af Clerk.io’s installerbare plugins (DanDomain Classic, Magento 1, Magento 2, PrestaShop, Shopware 6, VTEX eller WooCommerce), aktiver collect_email direkte i pluginindstillingerne. Ellers aktiveres det i din Clerk.js-konfiguration. Clerk.js overvåger alle emailfelt på siden og logger adressen automatisk, når en besøgende indtaster den.

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

Dette virker for checkoutfelter, nyhedsbrevstilmeldinger, loginformularer og alle andre <input type="email"> elementer på siden.

Loggede kunder #

Er kunden allerede logget ind, når de ankommer, logges emailadressen én gang pr. session. Implementeringen afhænger af din platform, men vigtigt er at bruge Clerk('call', 'log/email') til at sende emailadressen til Clerk.io, så snart brugeren kan identificeres i sessionen.

Her er et eksempel via sessionStorage for at undgå kald på hver sidevisning:

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 adresse fra din platform. Render kun scriptet på sider, hvor emailadressen er tilgængelig — undlad på gæstebesøgende.

Kurvtracking #

Hvis du bruger plugin til Magento 1, Magento 2, PrestaShop eller WooCommerce, håndteres kurvtracking automatisk — ingen yderligere kode kræves.

For alle andre opsætninger skal du meddele Clerk.io om indholdet af kurven via set-metoden. Kald den, hver gang kurven ændres, og send listen af produkt-ID’er. Hvert kald knyttes automatisk til gældende sessionsbesøger.

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

Læs mere om Shopping Cart-integrationen her.

Subscriber Forms #

Herunder er en færdig tilmeldingsformular, du kan indsætte på din side — i footeren, forsiden, eller som pop-up. Style den, som du ønsker.

<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>

For at tilmelde til en specifik liste i stedet for globalt, tilføj en list_id til kaldet. Liste-ID’er findes i Email > Subscribers > Lists.

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

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

Med API #

Dette afsnit dækker samme opsætning via direkte API-kald. Relevant for server-side integrationer, som ikke bruger Clerk.js.

Bruger du API’en, er du selv ansvarlig for at generere og opretholde besøgs-ID for hver session. Se Tracking-guiden for detaljer om dette.

Log Email #

Brug log/email til at forbinde et besøgs-ID med en emailadresse. Kald dette én gang pr. session, når en emailadresse er tilgængelig — både når en kunde aktivt logger ind og når de returnerer 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 besøgs-ID for sessionen. Undlad kaldet helt for gæstebesøgende, hvor ingen email er kendt.

Kurvtracking #

Brug log/cart/update til at sætte kurven til dens nuværende tilstand. Kald den hver gang kurven ændres, og send den fulde liste af produkter 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 ud over) visitor, hvis emailadressen allerede kendes på kaldetidspunktet.

Subscriber Forms #

Brug subscriber/subscribe til at tilføje en emailadresse som subscriber, når en besøgende tilmelder sig på 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 specifik liste, tilføj 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 den fulde reference på docs.clerk.io/reference/subscriberssubscribe.

Afmelding #

Brug subscriber/unsubscribe til at afmelde en adresse programmæssigt — fx fra en tilpasset afmeldingsside 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 skal du tilføje 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 den fulde reference på docs.clerk.io/reference/subscribersunsubscribe.