I frammenti di Omnisend collegano il tuo negozio BigCommerce con Omnisend, abilitando il recupero del carrello, il tracciamento delle vendite, moduli di iscrizione, il selettore di prodotto e altro ancora. Omnisend aggiunge frammenti automaticamente per i nuovi negozi. Se stai utilizzando una versione precedente, dovrai installarli manualmente utilizzando il Script Manager di BigCommerce o modificando i file del tema.

Questo articolo spiega come aggiungere frammenti Blueprint per completare la tua integrazione con BigCommerce.

Stai utilizzando un tema Stencil? Segui il Guida ai BigCommerce Stencil Snippets invece.

Prima di iniziare

Prima di aggiungere i frammenti, devi collega il tuo negozio BigCommerce a Omnisend
Puoi utilizzare solo un tipo di frammento alla volta: Stencil o Blueprint. Mescolare entrambi romperà la funzionalità. Se non sei sicuro di quale tema stai utilizzando, controlla la guida di BigCommerce.
Quando cambi tema, devi riaggiungere i frammenti. Le modifiche al tema rimuovono il codice esistente.
Omnisend aggiunge automaticamente i frammenti per i nuovi negozi BigCommerce. Se vedi un messaggio di errore come quello qui sotto, dovrai aggiungerli manualmente seguendo i passaggi in questa guida.

Aggiunta dei Frammenti

Dovrai aggiungere cinque frammenti in diversi file di template email nel tuo negozio BigCommerce. Ogni frammento traccia una parte specifica del viaggio del cliente – dalle visualizzazioni di pagina agli aggiornamenti del carrello fino al completamento dell'ordine.

Segui attentamente ogni istruzione e assicurati di aggiornare il segnaposto shop ID (XXXXXX) nel codice.

Passaggio 1. Trova il tuo ID negozio

Per attivare i frammenti di tracciamento, devi sostituire XXXXXX con il tuo effettivo shop ID. Se non viene utilizzato l'ID corretto, il codice non funzionerà.

Puoi trovare il tuo ID negozio nell'URL quando sei connesso al tuo pannello di controllo BigCommerce. Di solito appare come: https://store-XXXXXX.mybigcommerce.com/

Hash del negozio nella barra degli indirizzi

Non riesci a trovare lo shop ID? Controlla Guida di BigCommerce per istruzioni passo-passo.

Passo 2. Aggiungi frammenti di codice al tuo negozio BigCommerce

1. Google Analytics Tab Script

Posizione: Impostazioni Avanzate → Web Analytics → scheda Google Analytics

Se è già presente un codice di tracciamento di Google Analytics, incolla il codice di Omnisend sotto il tag 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%% -->

Sincronizzazione Contatti

Tutti i contatti aggiunti o aggiornati tramite BigCommerce saranno automaticamente aggiunti alla tua Audience di Omnisend → Lista dei contatti. Questi contatti riceveranno anche il tag source: bigcommerce.

Questo ti consente di filtrare e segmentare facilmente i contatti sincronizzati da BigCommerce. Puoi creare un segmento basato su Tag is source:bigcommerce. Scopri di più sui segmenti qui.

Domande frequenti

Perché i frammenti non si sono installati automaticamente dopo aver collegato il mio negozio?
L'installazione automatica dei frammenti funziona per la maggior parte dei nuovi negozi BigCommerce, ma alcuni negozi più vecchi o temi Blueprint personalizzati richiedono un'installazione manuale. Dopo aver collegato il tuo negozio, controlla il Gestore Script entro 10 minuti. Se non appaiono script Omnisend, segui i passaggi di installazione manuale in questa guida.

Posso utilizzare sia frammenti Blueprint che Stencil contemporaneamente?
No. Utilizzare entrambi romperà la funzionalità. Usa solo un tipo di frammento in base al tuo tema. Se passi da Blueprint a Stencil (o viceversa), rimuovi prima i vecchi frammenti, poi aggiungi quelli corretti.

Devo aggiungere frammenti Blueprint se ho già script Omnisend nel Script Manager?

No. Se vedi gli script di Omnisend in BigCommerce → Storefront → Script Manager, i frammenti sono stati aggiunti automaticamente. Non aggiungere frammenti manualmente perché script duplicati romperanno la funzionalità.

Ho aggiunto i frammenti, ma i moduli/pop-up non appaiono ancora. Cosa dovrei controllare?

Conferma di aver sostituito XXXXXX con il tuo effettivo shop ID in tutti e cinque i frammenti (non l'URL completo, solo l'hash).
Vai a Storefront → Script Manager in BigCommerce. Assicurati di non avere script duplicati aggiunti.
Svuota la cache del tuo browser e prova in modalità incognito.

Hai bisogno di aiuto? Contatta il nostro team di supporto tramite la chat in-app o inviaci un'email a [email protected].

Integrazione BigCommerce: Frammenti Blueprint