Los fragmentos de Omnisend conectan tu tienda Stencil de BigCommerce con Omnisend, habilitando características como recuperación de carritos, seguimiento de ventas, formularios de registro, el selector de productos, y más. Omnisend agrega estos fragmentos automáticamente para nuevas tiendas de BigCommerce. Si estás utilizando una versión antigua de la tienda o un tema Stencil personalizado, necesitarás agregarlos manualmente utilizando el Administrador de Scripts de BigCommerce.
Este artículo muestra cómo agregar manualmente fragmentos de Stencil para completar tu integración de BigCommerce.
¿Usando un tema de Blueprint? Sigue el Guía de BigCommerce Blueprint Snippets en su lugar.
Antes de empezar
Antes de añadir fragmentos, necesitas conectar tu tienda BigCommerce a Omnisend
Usa solo un tipo de fragmento a la vez: Stencil o Blueprint. Mezclar ambos romperá la funcionalidad. Si no estás seguro de qué tema estás usando, consulta la guía de BigCommerce
Al cambiar de temas, debes volver a añadir los fragmentos. Los cambios de tema eliminan el código existente.
Los fragmentos se añaden automáticamente para nuevas tiendas de BigCommerce. Si ves un mensaje de error como el de abajo, sigue los pasos de instalación manual en esta guía.
Añadiendo los fragmentos
Paso 1. Encuentra tu ID de tienda
Para activar los scripts de seguimiento, debes reemplazar XXXXX con tu ID de tienda actual. Sin él, el código no funcionará.
Puedes localizar tu shop ID en la barra de direcciones mientras estás conectado a tu panel de control de BigCommerce. Si necesitas ayuda para encontrarlo, consulta la guía de BigCommerce.
⚠️ Crítico: Reemplaza XXXXX con tu ID de tienda en los tres scripts antes de subir.
Paso 2. Sube scripts al BigCommerce Script Manager
A continuación, sube tres scripts a tu tienda utilizando el Administrador de Scripts de BigCommerce. Ve a Storefront → Script Manager en tu panel de administración de BigCommerce.
⚠️ Antes de subir, aplica estas configuraciones a cada script:
Ubicación: Pie de página
Categoría del script: Esencial
Tipo de script: Script
Repetirás estos pasos tres veces, pegando diferentes contenidos de script y seleccionando la Ubicación correcta para cada uno.
Script 1: Script de Omnisend
Este script rastrea el comportamiento de los visitantes y habilita formularios de registro, recuperación de carrito y el Selector de Productos en las páginas de tu tienda.
Nombre: script de Omnisend
Ubicación: Páginas de la tienda
Pega el siguiente script:
<script type="text/javascript">
// SOUNDEST-V6-SM
window.SOUNDEST = window.SOUNDEST || {};
// Do not forget to replace XXXXXX with your shop ID! You can find it in your shop's permanent address: https://store-XXXXXX.mybigcommerce.com/. How to find it: https://goo.gl/1XddvQ
SOUNDEST.shopID = "XXXXXX";
SOUNDEST.shopType = "bigcommerce";
SOUNDEST.baseURL = "https://omnisnippet1.com/";
SOUNDEST.jsFile = "bigcommerce-launcher.js";
SOUNDEST.version = new Date().toISOString().slice(0, 13);
SOUNDEST.pageType = "{{page_type}}";
SOUNDEST.productTitle = "{{product.title}}";
SOUNDEST.productID = "{{product.id}}";
SOUNDEST.categoryTitle = "{{category.name}}";
SOUNDEST.categoryID = "{{category.id}}";
SOUNDEST.token = "{{settings.storefront_api.token}}";
!(function (baseURL, version) {
for (
var t = document.getElementsByTagName("script"), o = !1, s = 0;
s < t.length;
s++
)
"string" == typeof t[s].src &&
0 < t[s].src.indexOf(SOUNDEST.jsFile) &&
(o = !0);
if (!o) {
var i = document.createElement("script");
(i.type = "text/javascript"),
(i.async = !0),
(i.src = baseURL + "inshop/" + SOUNDEST.jsFile + "?v=" + version);
var r = document.getElementsByTagName("script")[0];
r.parentNode.insertBefore(i, r);
}
})(SOUNDEST.baseURL, SOUNDEST.version);
</script>
Script 2: Script de seguimiento de ventas de Omnisend
Este script rastrea los pedidos completados y envía datos de ventas a Omnisend para el análisis del rendimiento de la campaña y la automatización.
Nombre: script de seguimiento de ventas de Omnisend
Ubicación: Confirmación de pedido
Pega el siguiente script:
<script type="text/javascript">
// SOUNDEST-V6-SM
window.SOUNDEST = window.SOUNDEST || {};
// Do not forget to replace XXXXXX with your shop ID! You can find it in your shop's permanent address: https://store-XXXXXX.mybigcommerce.com/. How to find it: https://goo.gl/1XddvQ
SOUNDEST.shopID = "XXXXXX";
SOUNDEST.shopType = "bigcommerce";
SOUNDEST.baseURL = "https://omnisnippet1.com/";
SOUNDEST.jsFile = "bigcommerce-launcher.js";
SOUNDEST.version = new Date().toISOString().slice(0, 13);
SOUNDEST.pageType = "{{page_type}}";
SOUNDEST.productTitle = "{{product.title}}";
SOUNDEST.productID = "{{product.id}}";
SOUNDEST.categoryTitle = "{{category.name}}";
SOUNDEST.categoryID = "{{category.id}}";
SOUNDEST.token = "{{settings.storefront_api.token}}";
!(function (baseURL, version) {
for (
var t = document.getElementsByTagName("script"), o = !1, s = 0;
s < t.length;
s++
)
"string" == typeof t[s].src &&
0 < t[s].src.indexOf(SOUNDEST.jsFile) &&
(o = !0);
if (!o) {
var i = document.createElement("script");
(i.type = "text/javascript"),
(i.async = !0),
(i.src = baseURL + "inshop/" + SOUNDEST.jsFile + "?v=" + version);
var r = document.getElementsByTagName("script")[0];
r.parentNode.insertBefore(i, r);
}
})(SOUNDEST.baseURL, SOUNDEST.version);
</script>
💡 Este script utiliza el mismo código que Script 1.
Script 3: Script de seguimiento de pago de Omnisend
Este script rastrea el comportamiento de pago para mejorar la precisión del abandono del carrito.
Nombre: script de seguimiento de pago de Omnisend
Ubicación: Pago
Pega el siguiente script:
<script type="text/javascript">
// SOUNDEST-V6-SM
window.SOUNDEST = window.SOUNDEST || {};
// Do not forget to replace XXXXXX with your shop ID! You can find it in your shop's permanent address: https://store-XXXXXX.mybigcommerce.com/. How to find it: https://goo.gl/1XddvQ
SOUNDEST.shopID = "XXXXXX";
SOUNDEST.shopType = "bigcommerce";
SOUNDEST.baseURL = "https://omnisnippet1.com/";
SOUNDEST.jsFile = "bigcommerce-checkout-launcher.js";
SOUNDEST.version = new Date().toISOString().slice(0, 13);
SOUNDEST.pageType = "{{page_type}}";
SOUNDEST.productTitle = "{{product.title}}";
SOUNDEST.productID = "{{product.id}}";
SOUNDEST.categoryTitle = "{{category.name}}";
SOUNDEST.categoryID = "{{category.id}}";
SOUNDEST.token = "{{settings.storefront_api.token}}";
!(function (baseURL, version) {
for (
var t = document.getElementsByTagName("script"), o = !1, s = 0;
s < t.length;
s++
)
"string" == typeof t[s].src &&
0 < t[s].src.indexOf(SOUNDEST.jsFile) &&
(o = !0);
if (!o) {
var i = document.createElement("script");
(i.type = "text/javascript"),
(i.async = !0),
(i.src = baseURL + "inshop/" + SOUNDEST.jsFile + "?v=" + version);
var r = document.getElementsByTagName("script")[0];
r.parentNode.insertBefore(i, r);
}
})(SOUNDEST.baseURL, SOUNDEST.version);
</script>
Nota: Este script utiliza un nombre de archivo diferente (bigcommerce-checkout-launcher.js) que Scripts 1 y 2.
Una vez que todos los scripts estén añadidos y guardados, tu tienda BigCommerce estará completamente conectada al seguimiento de Omnisend.
Sincronización de contactos
Todos los contactos añadidos o actualizados a través de BigCommerce se añadirán automáticamente a tu Audiencia → lista de Contactos. Estos contactos también recibirán la etiqueta "source: bigcommerce".
Esto te permite filtrar y segmentar fácilmente los contactos sincronizados desde BigCommerce. Puedes crear un segmento basado en Etiqueta es source:bigcommerce. Aprende más sobre Segmentación en Omnisend.
Preguntas Frecuentes
¿Por qué no se instalaron los fragmentos automáticamente después de conectar mi tienda?
La instalación automática de fragmentos funciona para la mayoría de las nuevas tiendas de BigCommerce, pero algunas tiendas más antiguas o temas personalizados de Stencil requieren instalación manual. Después de conectar tu tienda, verifica el Administrador de Scripts dentro de 10 minutos. Si no aparecen scripts de Omnisend, sigue los pasos de instalación manual en esta guía.
¿Cómo puedo comprobar si los fragmentos de Omnisend ya están instalados?
Ve a BigCommerce → Storefront → Script Manager. Busca tres scripts de Omnisend: "script de Omnisend" (Páginas de la tienda), "Script de seguimiento de ventas de Omnisend" (Confirmación de pedido), y "Script de seguimiento de pago de Omnisend" (Pago). Si los tres aparecen, los fragmentos están instalados.
Agregué fragmentos manualmente, pero los formularios y el Selector de Productos no funcionan. ¿Por qué?
You likely have duplicate snippets (automatic + manual).Ve a BigCommerce → Storefront → Script Manager. Si los scripts de Omnisend están listados allí, elimina cualquier fragmento que hayas añadido manualmente a los archivos de pie de página o encabezado de tu tema. Mantén solo los scripts en el Administrador de Scripts. Los fragmentos duplicados rompen la funcionalidad.
¿Puedo usar fragmentos de Blueprint y Stencil al mismo tiempo?
No. Usar ambos romperá la funcionalidad. Usa solo un tipo de fragmento según tu tema. Si cambias de Blueprint a Stencil (o viceversa), elimina primero los fragmentos antiguos, luego añade los correctos.
Actualicé/cambié mi tema de BigCommerce, y ahora los formularios no funcionan. ¿Qué pasó?
Las actualizaciones o cambios de tema eliminan scripts existentes de BigCommerce. Ve a BigCommerce → Storefront → Script Manager y verifica si los tres scripts de Omnisend todavía están allí. Si faltan, sigue los pasos de instalación manual que se enumeran arriba.
Veo "XXXXXX" en el código del script. ¿Qué debo hacer?
Reemplaza XXXXXX con tu actual BigCommerce shop ID en todos los scripts. Encuentra tu shop ID en la URL de administración de BigCommerce: https://store-XXXXXX.mybigcommerce.com/. Por ejemplo, si tu URL es https://store-abc123.mybigcommerce.com/, replace XXXXXX con abc123 en cada script antes de guardar.
La recuperación del carrito no está funcionando. ¿Podría ser un problema con el fragmento?
Sí. La recuperación del carrito requiere que los tres scripts funcionen correctamente. Verifica BigCommerce → Storefront → Script Manager y confirma:
El script de Omnisend está configurado para Páginas de la tienda (registra las adiciones al carrito).
El script de seguimiento de ventas de Omnisend está configurado para Confirmación de pedido (rastrea pedidos completados).
El script de seguimiento de pago de Omnisend está configurado para Pago (rastrea el abandono del pago).
Si falta algún script o está configurado en la ubicación incorrecta, la recuperación del carrito no se activará.
¿Quieres hablar con soporte? Usa el chat en la aplicación o envía tus preguntas a [email protected].