Shopify

Get Started

Installieren Sie Clerk.io auf Shopify mit diesen einfachen Schritten

Bringen Sie Clerk.io in nur wenigen Schritten auf Ihrem Shopify-Shop zum Laufen. Dieser Leitfaden führt Sie durch das Verbinden Ihres Shops, die Installation des Trackings und die Synchronisierung Ihrer Daten.

Vor der Einrichtung #

Shopify und Clerk.io haben jeweils einen eigenen Anteil an der Einrichtung. Die Shopify-Seite bietet den Zugang, die App und das Storefront-Tracking. Die Clerk.io-Seite verbindet den Shop, konfiguriert die Synchronisierung und startet den Import der Daten.

Shopifymy.clerk.io
Erstellen und Installieren der App, Tracking hinzufügen und die Shopify Domain für die Synchronisierung angeben.Store hinzufügen, Shopify-Synchronisierung konfigurieren, die erste Synchronisierung starten und die importierten Daten überprüfen.

Shopify Domain #

Die Shopify-Domain wird bei der Konfiguration der Synchronisierung benötigt. Verwenden Sie die .myshopify.com-Adresse, auch wenn der Webshop eine eigene öffentliche Domain nutzt.

  1. Gehen Sie in Shopify zu Einstellungen > Domains.
  2. Kopieren Sie die aktuelle .myshopify.com-Adresse des Shops.

Shopify verwendet die myshopify.com-Adresse zur Identifizierung des Shops. Lesen Sie mehr in der Shopify Domain-Dokumentation.

Ihren Shop verbinden #

Der erste Schritt der Installation von Clerk.io ist das Verbinden Ihres Shops mit Ihrem Clerk.io-Konto.

Nachdem Sie diese einfachen Schritte befolgt haben, können Sie Ihren Live Demo Store sehen, der Ihnen eine persönliche Übersicht darüber gibt, wie Clerk.io in Ihrem Webshop funktioniert.

Store hinzufügen #

  1. Melden Sie sich bei my.clerk.io an. Beim ersten Login sehen Sie die Seite zum Hinzufügen eines neuen Shops.

  2. Geben Sie den Namen und die öffentliche Domain Ihres Webshops ein.

  3. Wählen Sie Shopify als Plattform und wählen Sie Ihre Währung.

  4. Klicken Sie auf Store hinzufügen.

Die Shopify .myshopify.com-Domain wird später unter Daten > Konfiguration eingetragen, wenn die Synchronisierung konfiguriert wird.

Besucher-Tracking installieren #

  1. Gehen Sie in Ihrem Shopify-Backend zu Online Store > Themes.

  2. Klicken Sie auf ... > Code bearbeiten für das Theme, das Sie anpassen möchten.

  3. Öffnen Sie unter Layout die Datei theme.liquid und suchen Sie das schließende </head>-Tag.

  4. Fügen Sie das komplette Clerk.io-Tracking-Script unten direkt vor </head> ein. Ersetzen Sie INSERT_PUBLIC_API_KEY durch Ihren Public Key aus 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. Klicken Sie auf Speichern.

Bestell-Tracking installieren #

  1. Gehen Sie in Shopify zu Einstellungen > Kundenereignisse.

  2. Klicken Sie auf Eigenes Pixel hinzufügen, benennen Sie es Clerk.io und klicken Sie dann auf Pixel hinzufügen.

  3. Setzen Sie die Berechtigungseinstellung des Pixels auf Nicht erforderlich. Dies ist die empfohlene Einstellung für das Standard-Setup von Clerk.io, da Clerk.io cookieloses Tracking verwendet und keine persistenten Cookies setzt. Das Pixel läuft daher unabhängig davon, ob der Besucher Marketing-, Analyse- oder Präferenz-Cookies akzeptiert. Mehr dazu im Artikel Clerk.io’s cookieless solution.

    Wenn Sie Clerk.io kundenspezifisch für persistente Besucher-IDs konfiguriert haben, setzen Sie die Berechtigung auf Analytics. Dies ist nur erforderlich, wenn Ihre individuelle Einrichtung tatsächlich persistente Cookies verwendet; für cookieloses Tracking ist es nicht nötig.

  4. Fügen Sie Ihren Clerk Sales Tracking Code ein und klicken Sie auf Speichern.

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. Klicken Sie auf Verbinden und bestätigen Sie.

Daten synchronisieren #

Die App und die Synchronisierung werden im Sync Data guide konfiguriert. Folgen Sie zuerst den Shopify-Schritten und führen Sie dann die my.clerk.io-Schritte aus, um die Zugangsdaten zu verbinden, die .myshopify.com-Domain einzutragen und die erste Synchronisierung zu starten.

Märkte und Sprachen #

Wenn Ihre Shopify-Einrichtung mehrere Sprachen, Märkte oder Domains verwendet, konfigurieren Sie dies, bevor Sie live gehen.

  1. Schließen Sie zuerst die Basiseinrichtung in diesem Leitfaden ab.
  2. Öffnen Sie my.clerk.io > Daten > Konfiguration.
  3. Konfigurieren Sie marktbezogene Einstellungen (Shopify Market, Shopify Locale, Prefix URLs with Locale, Force Relative URLs).
  4. Fügen Sie Lagerstandorte hinzu, wenn der Bestand nach Standort gefiltert werden soll.
  5. Starten Sie eine neue Synchronisierung und überprüfen Sie die Produkt-URLs in jeder Storefront-Sprache/Domain.

Shop Locale/Shopify Locale verwendet den standardisierten Shopify-Sprachcode, zum Beispiel da für Dänemark und sv für Schweden.

Wenn Sie unsicher sind, welche Locale-Codes Ihr Shop verwendet, bitten Sie den Shopify Sidekick-Assistenten, Ihnen die im Shop konfigurierten Locales anzuzeigen.

Nutzen Sie die ausführliche Mapping-Anleitung hier: Shopify integration settings.

Denken Sie daran, die Headlines in Element -> Bearbeiten -> Design auswählen für jede Sprache zu übersetzen.

API-Schlüssel wechseln #

Falls Ihre Einrichtung pro Markt getrennte Clerk.io-Stores verwendet, hat jeder Store einen eigenen API-Schlüssel. Nutzen Sie in Shopify request.locale.iso_code, um automatisch bei jedem Seitenaufruf den richtigen Schlüssel zu setzen.

Ersetzen Sie in theme.liquid das Tracking-Skript, das Sie vorher vor </head> eingefügt haben, durch das folgende vollständige Skript. Fügen Sie für jedes Locale einen {% when %}-Eintrag hinzu und setzen Sie {% else %} auf den Standard-API-Schlüssel. Speichern Sie anschließend die Datei:

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

Multi-Store-Setup #

Wenn Ihr Setup mehrere Shopify-Shops (nicht nur mehrere Sprachen innerhalb eines Shops) umfasst, erstellen Sie für jeden Shopify-Shop einen eigenen Clerk.io-Store:

  1. Klicken Sie in my.clerk.io auf + Neuen Store hinzufügen.
  2. Kopieren Sie beim Anlegen die Inhalte des Hauptshops.
  3. Verbinden und synchronisieren Sie jeden Shopify-Shop einzeln.
  4. Verwenden Sie für jeden Storefront den passenden Public Key im Tracking.

Diese Seite wurde von einer hilfreichen KI übersetzt, daher kann es zu Sprachfehlern kommen. Vielen Dank für Ihr Verständnis.