Zum Hauptinhalt springen

BigCommerce-Integration: Blueprint-Snippets

Erfahre, wie du Blueprint-Codes zu deinem BigCommerce Webshop hinzufügst

Verfasst von Paulius

Omnisend-Snippets verbinden Ihren BigCommerce-Webshop mit Omnisend und ermöglichen Warenkorberholung, Verkaufsverfolgung, Anmeldeformulare, den Produktwähler und mehr.Omnisend fügt Snippets automatisch für neue Shops hinzu.Wenn Sie eine ältere Version verwenden, müssen Sie diese manuell mit dem Script-Manager von BigCommerce oder durch Bearbeiten der Theme-Dateien installieren.

Dieser Artikel erklärt, wie man Blueprint-Snippets hinzufügt, um die BigCommerce-Integration abzuschließen.

Verwenden Sie ein Stencil-Theme? Folgen Sie derBigCommerce Stencil Snippets Anleitung stattdessen.


Bevor Sie beginnen

  • Bevor Sie Snippets hinzufügen, müssen Sieverbinde deinen BigCommerce Webshop mit Omnisend

  • Sie können nur einen Snippet-Typ gleichzeitig verwenden: Stencil oder Blueprint.Die Mischung beider wird die Funktionalität beeinträchtigen.Wenn Sie sich nicht sicher sind, welches Theme Sie verwenden, überprüfen Sie den Leitfaden von BigCommerce.

  • Beim Wechseln der Themes müssen Sie die Snippets erneut hinzufügen. Theme-Änderungen entfernen vorhandenen Code.

  • Omnisend fügt Snippets automatisch für neue BigCommerce-Stores hinzu.Wenn Sie eine Fehlermeldung wie die folgende sehen, müssen Sie diese manuell mit den Schritten in diesem Leitfaden hinzufügen.

Hinzufügen der Snippets

Sie müssen fünf Snippets in verschiedenen Template-Dateien in Ihrem BigCommerce-Webshop hinzufügen.Jeder Ausschnitt verfolgt einen bestimmten Teil der Kundenreise – von Seitenaufrufen über Warenkorbanpassungen bis hin zum Abschluss der Bestellung.

Befolgen Sie jede Anweisung sorgfältig und stellen Sie sicher, dass Sie den Shop-ID-Platzhalter (XXXXXX) im Code aktualisieren.

Schritt 1. Finden Sie Ihre Webshop-ID

Um die Tracking-Snippets zu aktivieren, müssen Sie XXXXXX durch Ihre tatsächliche Shop-ID ersetzen.Wenn die korrekte ID nicht verwendet wird, funktioniert der Code nicht.

Sie können Ihre Shop-ID in der URL finden, wenn Sie in Ihr BigCommerce-Kontrollpanel eingeloggt sind. Sie erscheint typischerweise als: https://store-XXXXXX.mybigcommerce.com/

Webshop-Hash in der Adressleiste

Konnte die Shop-ID nicht finden? Überprüfen SieDie Anleitung von BigCommerce für Schritt-für-Schritt-Anweisungen.

Schritt 2. Füge Code-Snippets zu deinem BigCommerce Webshop hinzu

1. Google Analytics Tab-Skript

Standort: Erweiterte Einstellungen → Web-Analyse → Google Analytics-Tab

Wenn ein Google Analytics-Tracking-Code bereits vorhanden ist, fügen Sie den Omnisend-Code unter der GA-Markierung ein.

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


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

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

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

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

Kontakte synchronisieren

Alle Kontakte, die über BigCommerce hinzugefügt oder aktualisiert werden, werden automatisch zu Ihrer Omnisend Die ZielgruppeDie Liste hinzugefügt.Diese Kontakte erhalten ebenfalls die Markierung source: bigcommerce.

Dies ermöglicht es Ihnen, Kontakte, die von BigCommerce synchronisiert wurden, einfach zu filtern und zu segmentieren.Sie können ein Segment basierend auf Die Markierung ist Quelle:bigcommerce erstellen.Erfahren Sie hier mehr über Segmente.

Häufig gestellte Fragen

Warum wurden die Snippets nicht automatisch installiert, nachdem ich meinen Webshop verbunden habe?
Die automatische Snippet-Installation funktioniert für die meisten neuen BigCommerce-Stores, aber einige ältere Stores oder benutzerdefinierte Blueprint-Themen erfordern eine manuelle Installation.Überprüfen Sie den Skript-Manager innerhalb von 10 Minuten, nachdem Sie Ihren Webshop verbunden haben.Wenn keine Omnisend-Skripte angezeigt werden, folgen Sie den manuellen Installationsschritten in diesem Leitfaden.

Kann ich sowohl Blueprint- als auch Stencil-Snippets gleichzeitig verwenden?
Nein. Die Verwendung beider wird die Funktionalität beeinträchtigen.Verwenden Sie nur einen Snippet-Typ basierend auf Ihrem Theme.Wenn Sie von Blueprint zu Stencil (oder umgekehrt) wechseln, entfernen Sie zuerst die alten Snippets, und fügen Sie dann die richtigen hinzu.

Muss ich Blueprint-Snippets hinzufügen, wenn ich bereits Omnisend-Skripte im Script-Manager habe?

Nein. Wenn Sie Omnisend-Skripte in BigCommerce → Storefront → Script Manager sehen, wurden die Snippets automatisch hinzugefügt.Fügen Sie Snippets nicht manuell hinzu, da doppelte Skripte die Funktionalität beeinträchtigen.

Ich habe die Snippets hinzugefügt, aber Formulare/Pops-ups erscheinen immer noch nicht. Was sollte ich überprüfen?

  1. Bestätigen Sie, dass Sie XXXXXX in allen fünf Snippets durch Ihre tatsächliche Shop-ID ersetzt haben (nicht die vollständige URL, nur den Hash).

  2. Gehen Sie zu StorefrontScript Manager in BigCommerce.Stellen Sie sicher, dass Sie keine doppelten Skripte hinzugefügt haben.

  3. Löschen Sie den Cache Ihres Browsers und testen Sie im Inkognito-Modus.


Benötigen Sie Hilfe? Verbinden Sie sich mit unserem Support-Team über den In-App-Chat oder senden Sie uns eine E-Mail an [email protected]

Hat dies deine Frage beantwortet?