Shopify

Get Started

Installa Clerk.io su Shopify seguendo questi semplici passaggi

Configura Clerk.io e rendilo operativo sul tuo store Shopify in pochi semplici passaggi. Questa guida ti accompagna nella connessione del tuo store, nell’installazione del tracciamento e nella sincronizzazione dei tuoi dati.

Prima della configurazione #

Shopify e Clerk.io hanno ciascuno un ruolo nella configurazione. La parte Shopify fornisce l’accesso, l’app e il tracciamento sullo shop. La parte Clerk.io connette lo store, configura la sincronizzazione e avvia l’importazione dei dati.

Shopifymy.clerk.io
Crea e installa l’app, aggiungi il tracciamento e fornisci il dominio Shopify per la sincronizzazione.Aggiungi lo Store, configura la sincronizzazione Shopify, avvia la prima sincronizzazione e verifica i dati importati.

Dominio Shopify #

Il dominio Shopify è necessario quando si configura la sincronizzazione. Usa l’indirizzo .myshopify.com anche se il sito utilizza un dominio pubblico personalizzato.

  1. In Shopify, vai su Impostazioni > Domini.
  2. Copia l’attuale indirizzo .myshopify.com del negozio.

Shopify utilizza l’indirizzo myshopify.com per identificare lo store. Leggi di più nella documentazione sul dominio di Shopify.

Connessione del tuo store #

Il primo passo per installare Clerk.io è collegare il tuo Store al tuo account Clerk.io.

Dopo aver seguito questi semplici passaggi, potrai vedere il tuo Live Demo Store, che ti offre una panoramica personale di come Clerk.io funzionerà sul tuo sito.

Aggiungi store #

  1. Accedi a my.clerk.io. La prima volta che lo fai, vedrai la pagina Aggiungi Nuovo Store.

  2. Inserisci il Nome e il Dominio pubblico del tuo sito.

  3. Scegli Shopify come Piattaforma e scegli la tua Valuta.

  4. Clicca su Aggiungi Store.

Il dominio .myshopify.com di Shopify viene inserito più avanti in Dati > Configurazione quando viene configurata la sincronizzazione.

Installa il tracciamento dei visitatori #

  1. Nel backend di Shopify, vai su Negozio Online > Temi.

  2. Clicca su ... > Modifica codice per il tema che vuoi modificare.

  3. Sotto Layout, apri theme.liquid e trova il tag di chiusura </head>.

  4. Incolla qui sotto lo script completo di tracciamento Clerk.io subito prima di </head>. Sostituisci INSERT_PUBLIC_API_KEY con la tua Public Key da my.clerk.io > Sviluppatori > 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. Clicca su Salva.

Installa il tracciamento degli ordini #

  1. In Shopify, vai su Impostazioni > Eventi cliente.

  2. Clicca su Aggiungi pixel personalizzato, chiamalo Clerk.io, poi clicca su Aggiungi pixel.

  3. Imposta il requisito dei permessi del pixel su Non richiesto. Questa è l’impostazione raccomandata per la configurazione predefinita di Clerk.io perché Clerk.io utilizza un tracciamento senza cookie e non imposta cookie persistenti. Il pixel verrà quindi eseguito indipendentemente dall’accettazione o meno dei cookie di marketing, analitici o di preferenza da parte del visitatore. Leggi di più sulla soluzione senza cookie di Clerk.io.

    Se hai configurato Clerk.io in modo personalizzato per usare ID visitatore persistenti, imposta il requisito del permesso su Analytics. Questo è necessario solo quando la tua configurazione personalizzata utilizza effettivamente cookie persistenti; non è richiesto per l’impostazione predefinita senza cookie.

  4. Incolla il tuo codice di Tracciamento Vendite Clerk e clicca su Salva.

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. Clicca su Connetti e conferma.

Sincronizza i dati #

L’app e la sincronizzazione vengono configurati nella guida Sincronizza Dati. Segui prima i passaggi per Shopify, poi completa quelli su my.clerk.io per collegare le credenziali, inserire il dominio .myshopify.com e avviare la prima sincronizzazione.

Mercati e lingue #

Se la tua configurazione Shopify utilizza più lingue, mercati o domini, configura questi aspetti prima di andare online.

  1. Completa prima la configurazione di base in questa guida.
  2. Apri my.clerk.io > Dati > Configurazione.
  3. Configura le impostazioni specifiche per mercato (Shopify Market, Shopify Locale, Prefisso URL con Locale, Forza URL relativi).
  4. Aggiungi le sedi di inventario se lo stock deve essere limitato per sede.
  5. Avvia una nuova sincronizzazione e verifica gli URL dei prodotti in ogni lingua/dominio dello shop.

Shop Locale/Shopify Locale deve usare il codice della lingua standardizzato di Shopify, ad esempio da per Danimarca e sv per Svezia.

Se non sei sicuro di quali codici locale usa il tuo store, chiedi all’assistente Sidekick di Shopify di elencare i locali configurati per il negozio.

Usa la guida dettagliata di mapping qui: Impostazioni integrazione Shopify.

Ricordati di tradurre le intestazioni in Elemento -> Modifica -> Seleziona Design per adattarle a ogni lingua.

Cambia le API key #

Se la tua configurazione utilizza store Clerk.io distinti per mercato, ogni store ha la propria API key. Usa request.locale.iso_code di Shopify per assegnare automaticamente la chiave corretta a ogni caricamento di pagina.

In theme.liquid, sostituisci lo script di tracciamento che hai aggiunto prima di </head> con lo script completo qui sotto. Aggiungi una voce {% when %} per ogni locale e imposta {% else %} sulla chiave del tuo store predefinito, poi salva il file:

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

Configurazione multi-store #

Se la tua configurazione coinvolge più store Shopify (non solo più lingue all’interno di uno store), crea uno store Clerk.io per ciascun store Shopify:

  1. Su my.clerk.io, clicca su + Aggiungi nuovo Store.
  2. Copia il contenuto dallo store principale durante la creazione.
  3. Collega e sincronizza ogni store Shopify separatamente.
  4. Usa la Public Key corrispondente per ogni storefront nel tracciamento.

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