Shopify

Get Started

Installer Clerk.io på Shopify ved at følge disse nemme trin

Få Clerk.io sat op og kørende på din Shopify-butik på blot få trin. Denne guide guider dig igennem at forbinde din butik, installere tracking og synkronisere dine data.

Før opsætning #

Shopify og Clerk.io har hver deres rolle i opsætningen. Shopify-siden giver adgang, appen og butikstracking. Clerk.io-siden forbinder butikken, konfigurerer synkroniseringen og starter importen af data.

Shopifymy.clerk.io
Opret og installer appen, tilføj tracking og angiv Shopify-domænet til synkronisering.Tilføj butikken, konfigurer Shopify-synkronisering, start første synkronisering og verificér de importerede data.

Shopify-domæne #

Shopify-domænet skal bruges, når synkroniseringen konfigureres. Brug .myshopify.com-adressen, selv hvis webshoppen anvender et specialiseret offentligt domæne.

  1. Gå i Shopify til Indstillinger > Domæner.
  2. Kopiér butikkens nuværende .myshopify.com-adresse.

Shopify bruger myshopify.com-adressen til at identificere butikken. Læs mere i Shopifys domænedokumentation.

Forbind din butik #

Det første trin med at installere Clerk.io er at forbinde din butik med din Clerk.io-konto.

Efter disse enkle trin vil du kunne se din Live Demo Store, som giver dig et personligt overblik over, hvordan Clerk.io kommer til at fungere på din webshop.

Tilføj butik #

  1. Login på my.clerk.io. Første gang du gør dette, ser du siden Tilføj ny butik.

  2. Skriv webshopens Navn og offentlige Domæne.

  3. Vælg Shopify som Platform og vælg din Valuta.

  4. Klik på Tilføj butik.

Shopify-domænet .myshopify.com indtastes senere i Data > Konfiguration, når synkroniseringen konfigureres.

Installer besøgende-tracking #

  1. Gå i Shopify-backend til Online Store > Temaer.

  2. Klik på ... > Rediger kode for det tema, du vil redigere.

  3. Under Layout, åbn theme.liquid og find den afsluttende </head>-tag.

  4. Indsæt Clerk.io tracking scriptet herunder umiddelbart før </head>. Udskift INSERT_PUBLIC_API_KEY med din offentlige nøgle fra my.clerk.io > Developers > API Keys.

<!-- Start of Clerk.io E-commerce Personalisation tool - www.clerk.io -->
<script type="text/javascript">
  (function (w, d) {
    var e = d.createElement('script'); e.type = 'text/javascript'; e.async = true;
    e.src = (d.location.protocol == 'https:' ? 'https' : 'http') + '://cdn.clerk.io/clerk.js';
    var s = d.getElementsByTagName('script')[0]; s.parentNode.insertBefore(e, s);
    w.__clerk_q = w.__clerk_q || []; w.Clerk = w.Clerk || function () { w.__clerk_q.push(arguments) };
  })(window, document);
  const publicKey = 'INSERT_PUBLIC_API_KEY';
  Clerk('config', {
    key: publicKey,
    formatters: {
      currency_converter: function (price) {
        var converted_price = (price * Shopify.currency.rate);
        return (converted_price).toString();
      }
    },
    globals: {
      currency_iso: "{{ cart.currency.iso_code }}",
      currency_symbol: "{{ cart.currency.symbol }}"
    }
  });

  // Clerk.js Context
  Clerk('context', {
    product: {% if template.name == 'cart' %}[{% for item in cart.items %}{{ item.product_id | json }}{% unless forloop.last %}, {% endunless %}{% endfor %}]{% elsif product %}{{ product.id | json }}{% else %}null{% endif %},
    category: {% if collection %}{{ collection.id }}{% else %}null{% endif %},
    page: {% if product %}null
          {% elsif collection %}null
          {% elsif page %}{{ page.id }}
          {% elsif blog %}{{ blog.id }}
          {% elsif article %}{{ article.id }}
          {% elsif template.name == 'index' %}'homepage'
          {% else %}'{{ template.name }}'
          {% endif %}
  });

  {% if customer %}
    Clerk('call', 'log/email', { email: "{{ customer.email }}" });
  {% endif %}

  document.addEventListener('DOMContentLoaded', (e) => {
    (async function fetchVisitorId() {
      let visitorId = window.sessionStorage.getItem('visitor_id');
      try {
        if (!visitorId) {
          const response = await fetch(`https://api.clerk.io/v2/misc/visitor_id?key=${publicKey}&visitor=auto`);
          const data = await response.json();
          visitorId = data.visitor;
          window.sessionStorage.setItem('visitor_id', data.visitor);
        }
        Clerk('config', {
          visitor: visitorId,
        });
      } catch (error) {
        console.error('Error:', error);
      } finally {
        function publishClerkContext() {
          if (window.Shopify?.analytics?.publish) {
            window.Shopify.analytics.publish('clerk_pixel_context', {
              localeApiKey: publicKey,
              visitor: visitorId,
            });
          } else {
            setTimeout(publishClerkContext, 200);
          }
        }
        publishClerkContext();
      }
    })();
  });
</script>
<!-- End of Clerk.io E-commerce Personalisation tool - www.clerk.io -->
  1. Klik på Gem.

Installer ordresporing #

  1. Gå i Shopify til Indstillinger > Kunde-events.

  2. Klik på Tilføj brugerdefineret pixel, giv den navnet Clerk.io, og klik derefter Tilføj pixel.

  3. Sæt krav om tilladelser for pixlen til Ikke påkrævet. Dette er den anbefalede indstilling for standard Clerk.io-opsætning, da Clerk.io bruger cookieless tracking og ikke sætter vedvarende cookies. Dermed vil pixlen køre uanset, om besøgende accepterer marketing-, analyse- eller præference-cookies. Læs mere om Clerk.io’s cookieless løsning.

    Hvis du har konfigureret Clerk.io til at bruge vedvarende besøgs-ID’er, vælg da i stedet Analytics. Dette er kun nødvendigt, hvis du faktisk bruger vedvarende cookies i opsætningen; det er ikke nødvendigt for cookieless standardopsætning.

  4. Indsæt din Clerk Salgssporingskode og klik Gem.

analytics.subscribe("clerk_pixel_context", (event) => {
  browser.localStorage.setItem("clerkPixelContext", JSON.stringify(event.customData));
});

analytics.subscribe("checkout_completed", async (event) => {
  const pixelContextRaw = await browser.localStorage.getItem("clerkPixelContext");
  const pixelContext = await JSON.parse(pixelContextRaw);
  const checkout = event.data.checkout;
  fetch(`https://api.clerk.io/v2/log/sale/shopify`, {
    method: "POST",
    mode: "cors",
    body: JSON.stringify({
      sale: checkout.order.id,
      key: pixelContext.localeApiKey,
      visitor: pixelContext.visitor,
    }),
  });
});
  1. Klik på Forbind og bekræft.

Synkronisér data #

Appen og synk konfigureres i Synkronisér Data-guiden. Følg først Shopify-trinene, og gennemfør derefter my.clerk.io-trinnene for at forbinde legitimationsoplysninger, indtast .myshopify.com-domænet, og start den første synkronisering.

Markeder og sprogvarianter #

Hvis din Shopify har flere sprog, markeder eller domæner, skal det konfigureres før du går live.

  1. Gennemfør først grundopsætningen i denne guide.
  2. Åbn my.clerk.io > Data > Konfiguration.
  3. Konfigurer markeds-specifikke opsætninger (Shopify Market, Shopify Locale, Prefix URLs with Locale, Force Relative URLs).
  4. Tilføj lagerlokationer, hvis lagere skal opdeles pr. lokation.
  5. Start en ny synkronisering og validér produkt-URL’er for hvert sprog/domaene på din butik.

Shop Locale/Shopify Locale skal bruge Shopifys standardiserede sproglokationskode, fx da for Danmark og sv for Sverige.

Hvis du er i tvivl om, hvilke locale-koder din butik bruger, kan du spørge Shopifys Sidekick-assistent om at liste sprogvarianter for butikken.

Brug den detaljerede mapping-guide her: Shopify integration-indstillinger.

Husk at oversætte Headlines i Element -> Redigér -> Vælg design til at matche hvert sprog.

Skift API-nøgler #

Hvis din opsætning bruger separate Clerk.io-butikker pr. marked, har hver butik sin egen API-nøgle. Brug Shopifys request.locale.iso_code til at tildele den korrekte nøgle automatisk ved hver sideindlæsning.

I theme.liquid, udskift det tracking script du tidligere tilføjede før </head> med det fulde script herunder. Tilføj en {% when %}-indgang for hver locale og sæt {% else %} til nøglen for dit standard-marked, og gem filen:

<!-- Start of Clerk.io E-commerce Personalisation tool - www.clerk.io -->
<script type="text/javascript">
  (function (w, d) {
    var e = d.createElement('script'); e.type = 'text/javascript'; e.async = true;
    e.src = (d.location.protocol == 'https:' ? 'https' : 'http') + '://cdn.clerk.io/clerk.js';
    var s = d.getElementsByTagName('script')[0]; s.parentNode.insertBefore(e, s);
    w.__clerk_q = w.__clerk_q || []; w.Clerk = w.Clerk || function () { w.__clerk_q.push(arguments) };
  })(window, document);
  {% case request.locale.iso_code %}
    {% when 'da' %}
      {% assign publicKey = 'YOUR_DANISH_KEY' %}
    {% when 'sv' %}
      {% assign publicKey = 'YOUR_SWEDISH_KEY' %}
    {% else %}
      {% assign publicKey = 'YOUR_DEFAULT_KEY' %}
  {% endcase %}
  const publicKey = '{{ publicKey }}';
  Clerk('config', {
    key: publicKey,
    formatters: {
      currency_converter: function (price) {
        var converted_price = (price * Shopify.currency.rate);
        return (converted_price).toString();
      }
    },
    globals: {
      currency_iso: "{{ cart.currency.iso_code }}",
      currency_symbol: "{{ cart.currency.symbol }}"
    }
  });

  // Clerk.js Context
  Clerk('context', {
    product: {% if template.name == 'cart' %}[{% for item in cart.items %}{{ item.product_id | json }}{% unless forloop.last %}, {% endunless %}{% endfor %}]{% elsif product %}{{ product.id | json }}{% else %}null{% endif %},
    category: {% if collection %}{{ collection.id }}{% else %}null{% endif %},
    page: {% if product %}null
          {% elsif collection %}null
          {% elsif page %}{{ page.id }}
          {% elsif blog %}{{ blog.id }}
          {% elsif article %}{{ article.id }}
          {% elsif template.name == 'index' %}'homepage'
          {% else %}'{{ template.name }}'
          {% endif %}
  });

  {% if customer %}
    Clerk('call', 'log/email', { email: "{{ customer.email }}" });
  {% endif %}

  document.addEventListener('DOMContentLoaded', (e) => {
    (async function fetchVisitorId() {
      let visitorId = window.sessionStorage.getItem('visitor_id');
      try {
        if (!visitorId) {
          const response = await fetch(`https://api.clerk.io/v2/misc/visitor_id?key=${publicKey}&visitor=auto`);
          const data = await response.json();
          visitorId = data.visitor;
          window.sessionStorage.setItem('visitor_id', data.visitor);
        }
        Clerk('config', {
          visitor: visitorId,
        });
      } catch (error) {
        console.error('Error:', error);
      } finally {
        function publishClerkContext() {
          if (window.Shopify?.analytics?.publish) {
            window.Shopify.analytics.publish('clerk_pixel_context', {
              localeApiKey: publicKey,
              visitor: visitorId,
            });
          } else {
            setTimeout(publishClerkContext, 200);
          }
        }
        publishClerkContext();
      }
    })();
  });
</script>
<!-- End of Clerk.io E-commerce Personalisation tool - www.clerk.io -->

Opsætning af flere butikker #

Hvis din opsætning inkluderer flere Shopify-butikker (ikke kun flere sprog i én butik), skal du oprette én Clerk.io-butik pr. Shopify-butik:

  1. Klik på + Tilføj ny butik i my.clerk.io.
  2. Kopiér indholdet fra hovedbutikken under oprettelsen.
  3. Forbind og synkronisér hver Shopify-butik separat.
  4. Brug den tilhørende offentlige nøgle til tracking for hvert butikslayout.

Denne side er oversat af en hjælpsom AI, og der kan derfor være sproglige fejl. Tak for forståelsen.