Get Started
Pon en marcha Clerk.io en tu tienda de Shopify en solo unos pocos pasos. Esta guía te guía a través de la conexión de tu tienda, la instalación del seguimiento y la sincronización de tus datos.
Antes de la configuración #
Shopify y Clerk.io tienen cada uno una parte en la configuración. El lado de Shopify proporciona el acceso, la aplicación y el seguimiento en el escaparate. El lado de Clerk.io conecta la tienda, configura la sincronización y comienza a importar los datos.
| Shopify | my.clerk.io |
|---|---|
| Crear e instalar la aplicación, agregar el seguimiento y proporcionar el dominio de Shopify para la sincronización. | Agregar la tienda, configurar la sincronización de Shopify, iniciar la primera sincronización y verificar los datos importados. |
Dominio de Shopify #
El dominio de Shopify es necesario al configurar la sincronización. Utiliza la dirección .myshopify.com incluso cuando la tienda use un dominio público personalizado.
- En Shopify, ve a Settings > Domains.
- Copia la dirección actual
.myshopify.comde tu tienda.
Shopify utiliza la dirección myshopify.com para identificar la tienda. Lee más en
la documentación de dominios de Shopify.
Conectando tu tienda #
El primer paso para instalar Clerk.io es conectar tu tienda con tu cuenta de Clerk.io.
Después de seguir estos sencillos pasos, podrás ver tu Live Demo Store, que te dará una visión general personal de cómo funcionará Clerk.io en tu tienda online.
Agregar tienda #
Inicia sesión en my.clerk.io. La primera vez que lo hagas, verás la página para agregar una nueva tienda.
Escribe el Nombre y el Dominio público de tu tienda online.
Elige Shopify como la Plataforma y selecciona tu Moneda.
Haz clic en Add Store.
El dominio .myshopify.com de Shopify se agrega más adelante en Data > Configuration cuando se configura la sincronización.
Instalar el seguimiento de visitantes #
En el backend de Shopify, ve a Online Store > Themes.
Haz clic en ... > Edit code para el tema que deseas modificar.
Bajo Layout, abre
theme.liquidy encuentra la etiqueta de cierre</head>.Pega el script completo de seguimiento de Clerk.io a continuación, justo antes de
</head>. ReemplazaINSERT_PUBLIC_API_KEYcon tu Public Key de 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 -->
- Haz clic en Save.
Instalar el seguimiento de pedidos #
En Shopify, ve a Settings > Customer Events.
Haz clic en Add custom pixel, ponle el nombre Clerk.io, luego haz clic en Add pixel.
Configura el requisito de permisos del pixel en Not required. Esta es la configuración recomendada para la configuración predeterminada de Clerk.io porque Clerk.io utiliza seguimiento sin cookies y no establece cookies persistentes. Por lo tanto, el pixel funcionará independientemente de si el visitante acepta cookies de marketing, analíticas o de preferencias. Lee más sobre la solución sin cookies de Clerk.io.
Si has configurado Clerk.io para usar identificadores persistentes de visitante, configura el requisito de permisos en Analytics en su lugar. Esto solo es necesario cuando tu configuración personalizada realmente usa cookies persistentes; no es necesario para la configuración predeterminada sin cookies.
Pega tu código de seguimiento de ventas de Clerk y haz clic en Save.
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,
}),
});
});
- Haz clic en Connect y confirma.
Sincronizar datos #
La aplicación y la sincronización se configuran en la
Guía de Sincronización de Datos. Sigue primero los pasos de Shopify y luego completa los pasos en my.clerk.io para conectar las credenciales, ingresar el dominio .myshopify.com y comenzar la primera sincronización.
Mercados y locales #
Si tu configuración de Shopify utiliza varios idiomas, mercados o dominios, configura esto antes de publicar la tienda.
- Finaliza primero la configuración base de esta guía.
- Abre my.clerk.io > Data > Configuration.
- Configura los ajustes específicos de mercado (
Shopify Market,Shopify Locale,Prefix URLs with Locale,Force Relative URLs). - Agrega ubicaciones de inventario si el stock debe gestionarse por ubicación.
- Inicia una nueva sincronización y verifica las URL de los productos en cada idioma/dominio de escaparate.
Shop Locale/Shopify Locale debe utilizar el código de idioma estándar de Shopify, por ejemplo da para Dinamarca y sv para Suecia.
Si no estás seguro de qué códigos de localización utiliza tu tienda, pide al asistente Sidekick de Shopify que enumere los locales configurados para la tienda.
Utiliza la guía de mapeo detallada aquí: Ajustes de integración de Shopify.
Recuerda traducir los Headlines en Element -> Edit -> Select Design para que coincidan con cada idioma.
Cambiar claves API #
Si tu configuración utiliza una tienda Clerk.io diferente por mercado, cada tienda tiene su propia clave API. Utiliza request.locale.iso_code de Shopify para asignar automáticamente la clave correcta en cada carga de página.
En theme.liquid, reemplaza el script de seguimiento que agregaste antes de </head> con el siguiente script completo. Agrega una entrada {% when %} para cada locale y establece {% else %} para la clave de la tienda predeterminada, luego guarda el archivo:
<!-- 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 -->
Configuración multi-tienda #
Si tu configuración abarca varias tiendas de Shopify (no solo múltiples idiomas dentro de una misma tienda), crea una tienda Clerk.io por cada tienda de Shopify:
- En my.clerk.io, haz clic en + Add new Store.
- Copia el contenido de la tienda principal durante la creación.
- Conecta y sincroniza cada tienda de Shopify por separado.
- Usa la clave pública correspondiente en el seguimiento por escaparate.
Esta página ha sido traducida por una IA útil, por lo que puede contener errores de idioma. Muchas gracias por su comprensión.