Les extraits Omnisend connectent votre boutique BigCommerce avec Omnisend, permettant la récupération de panier, le suivi des ventes, formulaires d'inscription, le product picker, et plus encore. Omnisend ajoute des extraits automatiquement pour les nouvelles boutiques. Si vous utilisez une version plus ancienne, vous devrez les installer manuellement en utilisant le Gestionnaire de Scripts de BigCommerce ou en modifiant les fichiers de thème.
Cet article explique comment ajouter des extraits de Blueprint pour compléter votre intégration BigCommerce.
Utilisez-vous un thème Stencil ? Suivez le Guide des extraits Stencil de BigCommerce à la place.
Avant de commencer
Avant d'ajouter des extraits, vous devez connecter votre boutique BigCommerce à Omnisend
Vous ne pouvez utiliser qu'un seul type d'extrait à la fois : Stencil ou Blueprint. Mélanger les deux cassera la fonctionnalité. Si vous n'êtes pas sûr du thème que vous utilisez, vérifiez le guide de BigCommerce.
Lors du changement de thèmes, vous devez réajouter les extraits. Les changements de thème suppriment le code existant.
Omnisend ajoute des extraits automatiquement pour les nouveaux magasins BigCommerce. Si vous voyez un message d'erreur comme celui ci-dessous, vous devrez les ajouter manuellement en utilisant les étapes de ce guide.
Ajouter les extraits
Vous devrez ajouter cinq extraits dans différents fichiers de modèle de votre boutique BigCommerce. Chaque extrait suit une partie spécifique du parcours du client – des vues de page aux mises à jour du panier jusqu'à la finalisation de la commande.
Suivez chaque instruction attentivement et assurez-vous de mettre à jour le placeholder ID de la boutique (XXXXXX) dans le code.
Étape 1. Trouvez l'ID de votre boutique
Pour activer les extraits de suivi, vous devez remplacer XXXXXX par votre véritable ID de boutique. Si le bon ID n'est pas utilisé, le code ne fonctionnera pas.
Vous pouvez trouver votre ID de boutique dans l'URL lorsque vous êtes connecté à votre panneau de contrôle BigCommerce. Il apparaît généralement comme : https://store-XXXXXX.mybigcommerce.com/.
Vous n'avez pas trouvé l'ID de la boutique ? Vérifiez Le guide de BigCommerce pour des instructions étape par étape.
Étape 2. Ajoutez des extraits de code à votre boutique BigCommerce
1. Script de l'onglet Google Analytics
Emplacement : Paramètres avancés → Web Analytics → onglet Google Analytics
Si un code de suivi Google Analytics est déjà présent, collez le code Omnisend sous le 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. Script Panels/Footer.html
<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. Script Snippets/ProductAddToCart.html
<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. Script Snippets/FastCartThickBoxContent.html
<!-- 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%% -->
Synchronisation des contacts
Tous les contacts ajoutés ou mis à jour via BigCommerce seront automatiquement ajoutés à votre Audience Omnisend → liste Contacts. Ces contacts recevront également le tag source: bigcommerce.
Cela vous permet de filtrer et de segmenter facilement les contacts synchronisés depuis BigCommerce. Vous pouvez créer un segment basé sur Tag is source:bigcommerce. En savoir plus sur les segments ici.
Foire aux questions
Pourquoi les extraits ne se sont-ils pas installés automatiquement après avoir connecté ma boutique ?
L'installation automatique des extraits fonctionne pour la plupart des nouveaux magasins BigCommerce, mais certains magasins plus anciens ou des thèmes Blueprint personnalisés nécessitent une installation manuelle. Après avoir connecté votre boutique, vérifiez le Gestionnaire de scripts dans les 10 minutes. Si aucun script Omnisend n'apparaît, suivez les étapes d'installation manuelle dans ce guide.
Puis-je utiliser à la fois des extraits Blueprint et Stencil en même temps ?
Non. Utiliser les deux cassera la fonctionnalité. Utilisez uniquement un type d'extrait en fonction de votre thème. Si vous passez de Blueprint à Stencil (ou vice versa), retirez d'abord les anciens extraits, puis ajoutez les bons.
Dois-je ajouter des extraits Blueprint si j'ai déjà des scripts Omnisend dans le Gestionnaire de Scripts ?
Non. Si vous voyez des scripts Omnisend dans BigCommerce → Storefront → Script Manager, les extraits ont été ajoutés automatiquement. Ne pas ajouter d'extraits manuellement car des scripts en double casseront la fonctionnalité.
J'ai ajouté les extraits, mais les formulaires/pop-ups n'apparaissent toujours pas. Que dois-je vérifier ?
Confirmez que vous avez remplacé
XXXXXXpar votre véritable ID de boutique dans les cinq extraits (pas l'URL complète, juste le hash).Allez à Storefront → Script Manager dans BigCommerce. Assurez-vous de ne pas avoir ajouté de scripts en double.
Videz le cache de votre navigateur et testez en mode incognito.
Besoin d'aide ? Contactez notre équipe de support via le chat intégré à l'application ou envoyez-nous un Email à [email protected].