Los fragmentos de Omnisend conectan tu tienda de BigCommerce con Omnisend, habilitando la recuperación del carrito, el seguimiento de ventas, formularios de registro, el selector de productos, y más. Omnisend agrega fragmentos automáticamente para nuevas tiendas. Si estás utilizando una versión anterior, necesitarás instalarlas manualmente usando el Administrador de Scripts de BigCommerce o editando los archivos del tema.

Este artículo explica cómo agregar fragmentos de Blueprint para completar tu integración de BigCommerce.

¿Usando un tema Stencil? Sigue el Guía de fragmentos de Stencil de BigCommerce en su lugar.

Antes de empezar

Antes de agregar fragmentos, necesitas conectar tu tienda BigCommerce a Omnisend
Puedes usar 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 tema, debes volver a agregar los fragmentos. Los cambios de tema eliminan el código existente.
Omnisend añade fragmentos automáticamente para nuevas tiendas de BigCommerce. Si ves un mensaje de error como el de abajo, necesitarás agregarlos manualmente usando los pasos de esta guía.

Agregando los Fragmentos

Necesitarás agregar cinco fragmentos en diferentes archivos de plantilla en tu tienda de BigCommerce. Cada fragmento rastrea una parte específica del viaje del cliente – desde las vistas de página hasta las actualizaciones del carrito y la finalización del pedido.

Sigue cada instrucción cuidadosamente y asegúrate de actualizar el marcador de posición shop ID (XXXXXX) en el código.

Paso 1. Encuentra tu ID de tienda

Para activar los fragmentos de seguimiento, debes reemplazar XXXXXX con tu actual shop ID. Si no se utiliza el ID correcto, el código no funcionará.

Puedes encontrar tu ID de tienda en la URL cuando inicias sesión en tu panel de control de BigCommerce. Normalmente aparece como: https://store-XXXXXX.mybigcommerce.com/

Hash de la tienda en la barra de direcciones

¿No pudiste encontrar el shop ID? Consulta La guía de BigCommerce para instrucciones paso a paso.

Paso 2. Agrega fragmentos de código a tu tienda BigCommerce

1. Google Analytics Tab Script

Ubicación: Configuración Avanzada → Análisis Web → pestaña de Google Analytics

Si ya está presente un código de seguimiento de Google Analytics, pega el código de Omnisend debajo de la etiqueta GA.

<script type="text/javascript">
    // SOUNDEST-V6-1
    // Do not remove these comments, they are super important!
    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.eventsHost = "https://events.soundestlink.com/";
    (function(r,s,c){try{if(0<r.length&&0<s.length&&0<c.length){var u=!0,e=null,l=[],p=function(n){var e,t,o,a=document.cookie.split(";"),i=n+"=";for(/mybigcommerce.com/.test(location.hostname)&&(i=n+"-"+r+"="),t=0;t<a.length;t+=1)0===(o=a[t].trim()).indexOf(i)&&(e=o.substring(i.length,o.length));return e},n=function(){if(!u&&0<l.length){for(var n=0;n<l.length;n++){var e=document.createElement("img"),t=["timestamp="+(new Date).getTime(),"shopBaseURL="+window.location.protocol+"//"+window.location.hostname+"/","shopID="+r,"shopType="+s,"orderID="+l[n],"source=ga"],o=p("omnisendAnonymousID"),a=p("omnisendSessionID"),i=p("omnisendContactID"),d=p("omnisendAttributionID");void 0!==o&&t.push("anonymousID="+o),void 0!==a&&t.push("sessionID="+a),void 0!==i&&t.push("contactID="+i),void 0!==d&&t.push("attributionID="+d),e.src=c+"events/saveNewsletterOrder/?"+t.join("&"),document.body.appendChild(e)}l=[]}};if(void 0!==window.pageTracker){var t=window.pageTracker._addTrans,o=window.pageTracker._addItem,a=window.pageTracker._trackTrans;window.pageTracker._addTrans=function(n){e=n,t.apply(this,arguments)},window.pageTracker._addItem=function(n){e=n,o.apply(this,arguments)},window.pageTracker._trackTrans=function(){null!=e&&-1===l.indexOf(e)&&l.push(e),e=null,n(),a.apply(this,arguments)}}else window.pageTracker={_addTrans:function(n){e=n},_addItem:function(n){e=n},_trackTrans:function(){null!=e&&-1===l.indexOf(e)&&l.push(e),e=null,n()}};"loading"!==document.readyState?(u=!1,n()):document.addEventListener?document.addEventListener("DOMContentLoaded",function(){u=!1,n()}):document.attachEvent("onreadystatechange",function(){"loading"!==document.readyState&&(u=!1,n())})}}catch(n){}})(SOUNDEST.shopID,SOUNDEST.shopType,SOUNDEST.eventsHost);
</script>

2. Panels/Footer.html Script


<script type="text/javascript">
    // SOUNDEST-V6-2-B
    // Do not remove these comments, they are super important!
    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://omnisrc.com/";
    SOUNDEST.version = new Date().toISOString().slice(0, 13);
    SOUNDEST.productID = SOUNDEST.productID || "";
    SOUNDEST.additionalData = SOUNDEST.additionalData || {};
    SOUNDEST.additionalData.email = "%%GLOBAL_CurrentCustomerEmail%%";
    SOUNDEST.cartItems = "%%GLOBAL_CartItems%%";
    (function(t,e){try{if(t.length>0&&e.length>0&&window.location.hash.length>0&&"recoverCart"===JSON.parse(decodeURIComponent(window.location.hash.substring(1))).action){var i=document.createElement("div"),n=document.getElementById("soundest-container");i.id="soundest-cart";i.innerHTML='<div id="soundest-cart-overlay" style="position:fixed;top:0px;left:0px;width:100%;height:100%;background-color:#ffffff;z-index:1100000001;opacity:0.9;"></div><img id="soundest-cart-loader" style="position:fixed;top:50%;left:50%;margin-top:-20px;margin-left:-20px;width:40px;height:40px;z-index:1100000002;border-width:0px;" alt="" src="'+t+"inshop/images/loading.gif?v="+e+'" width="40" height="40" />';n.appendChild(i)}}catch(f){}})(SOUNDEST.baseURL,SOUNDEST.version);
    (function(e,t){try{if(e.length>0&&t.length>0){var n=document.createElement("script"),c=document.getElementById("soundest-container");n.type="text/javascript";n.id="soundest-launcher";n.src=e+"inshop/bigcommerce-launcher.js?v="+t;c.parentNode.insertBefore(n,c)}}catch(f){}})(SOUNDEST.baseURL,SOUNDEST.version);
</script>

3. Snippets/ProductAddToCart.html Script

<script type="text/javascript">
    // SOUNDEST-V6-3-B
    // Do not remove these comments, they are super important!
    window.SOUNDEST = window.SOUNDEST || {};
    SOUNDEST.productID = "%%GLOBAL_ProductId%%";
</script>

4. Snippets/FastCartThickBoxContent.html Script

<!-- SOUNDEST-V6-4-B -->
<!-- Do not remove these comments, they are super important! -->
<!-- SOUNDEST-FASTCART-QUANTITY:%%GLOBAL_fastCartQuantity%% -->
<!-- SOUNDEST-FASTCART-PRICE:%%GLOBAL_fastCartProdTotal%% -->
<!-- SOUNDEST-FASTCART-LINK-IMAGE:%%GLOBAL_fastCartProdImg%% -->
<!-- SOUNDEST-CART-ITEMS:%%GLOBAL_fastCartNumItemsTxt%% -->

5. Snippets/CartItem.html Script

<!-- SOUNDEST-V6-5-B -->
<!-- Do not remove these comments, they are super important! -->
<!-- SOUNDEST-ITEM-%%GLOBAL_CartItemId%%-ID:%%GLOBAL_ItemId%% -->
<!-- SOUNDEST-ITEM-%%GLOBAL_CartItemId%%-QUANTITY:%%GLOBAL_ProductQuantity%% -->
<!-- SOUNDEST-ITEM-%%GLOBAL_CartItemId%%-VARIATION:%%GLOBAL_VariationId%% -->
<!-- SOUNDEST-ITEM-%%GLOBAL_CartItemId%%-PRICE:%%GLOBAL_ProductPrice%% -->
<!-- SOUNDEST-ITEM-%%GLOBAL_CartItemId%%-LINK-IMAGE:%%GLOBAL_ProductImage%% -->
<!-- SOUNDEST-ITEM-%%GLOBAL_CartItemId%%-ATTRIBUTES:%%GLOBAL_ProductOptions%% -->
<!-- SOUNDEST-ITEM-%%GLOBAL_CartItemId%%-EVENT:%%GLOBAL_EventDate%% -->
<!-- SOUNDEST-ITEM-%%GLOBAL_CartItemId%%-WRAPPING:%%GLOBAL_GiftWrappingName%% -->
<!-- SOUNDEST-CART-ITEMS:%%GLOBAL_CartItems%% -->

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 segmentos aquí.

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 de Blueprint personalizados requieren instalación manual. Después de conectar tu tienda, verifica el Administrador de Scripts en 10 minutos. Si no aparecen scripts de Omnisend, sigue los pasos de instalación manual en esta guía.

¿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), primero elimina los fragmentos antiguos, luego agrega los correctos.

¿Necesito agregar fragmentos de Blueprint si ya tengo scripts de Omnisend en el Administrador de Scripts?

No. Si ves scripts de Omnisend en BigCommerce → Storefront → Script Manager, los fragmentos se añadieron automáticamente. No agregues fragmentos manualmente porque los scripts duplicados romperán la funcionalidad.

Agregué los fragmentos, pero los formularios/popups aún no aparecen. ¿Qué debo verificar?

Confirma que reemplazaste XXXXXX con tu actual shop ID en los cinco fragmentos (no la URL completa, solo el hash).
Ve a Storefront → Script Manager en BigCommerce. Asegúrate de no tener scripts duplicados agregados.
Limpia la caché de tu navegador y prueba en modo incógnito.

¿Necesitas ayuda? Conéctate con nuestro equipo de soporte a través del chat en la aplicación o envíanos un correo electrónico a [email protected].

Integración de BigCommerce: Fragmentos de Blueprint