跳转到主要内容

BigCommerce 集成: Stencil Snippets

了解如何将新的 Stencil 代码片段添加到您的 BigCommerce 店铺

作者:Paulius
更新于今天

Omnisend 代码片段将您的 BigCommerce Stencil 店铺与 Omnisend 连接起来,启用基本功能,例如购物车找回、销售跟踪、注册表单产品选择器等等。对于较新的店铺,这些代码片段会自动添加。如果您使用的是较旧的店铺版本,您需要使用 BigCommerce 的 Script Manager 手动添加代码段。

本文提供了关于添加 Stencil 代码片段以完成您的 BigCommerce 集成的说明。

正在使用 Blueprint 主题吗? 请按照而是参考 BigCommerce Blueprint Snippets 指南。


开始之前

  • 在添加代码片段之前,您需要将您的 BigCommerce 店铺连接到 Omnisend

  • 您一次只能使用一种代码片段类型:StencilBlueprint。混合两者会导致功能失效。如果您不确定您正在使用哪个主题,查看 BigCommerce 的指南

  • 当您切换主题时,您必须重新添加代码片段。主题更改会移除现有代码。

  • 代码片段会自动添加到新的 BigCommerce 店铺。如果您看到如下所示的错误消息,您需要使用本指南中的步骤手动添加它们。

添加代码片段

步骤 1. 查找您的店铺 ID。

要激活跟踪脚本,您必须XXXXX 替换为您的实际店铺 ID。没有它,代码就无法运行。

当您登录到您的 BigCommerce 控制面板时,您可以在地址栏中找到您的店铺 ID。如果您需要帮助查找,请参阅 BigCommerce 的指南

地址栏中的店铺哈希

步骤 2.将脚本上传到 BigCommerce 脚本管理器

接下来,上传三个脚本到您的店铺,使用BigCommerce 的 Script Manager。前往您的 BigCommerce 后台中的 Storefront Script Manager

⚠️ 在上传之前,请确保以下设置已应用于每个脚本:

  • 位置:页脚

  • 脚本类别:基本

  • 脚本类型:脚本

您将重复这些步骤三次,粘贴不同的脚本内容,并为每个选择正确的位置

脚本 1: Omnisend 脚本

  • 名称:Omnisend 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>

脚本 2: Omnisend 销售跟踪脚本

  • 名称: Omnisend Sales Tracking 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>

💡 这个脚本使用与 Omnisend Script 相同的代码

Script 3: Omnisend 结账 Tracking Script

  • 名称: Omnisend 结账跟踪脚本

  • 位置: 结账

粘贴以下脚本:

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

请务必在每个脚本中将 XXXXX 替换为您的实际 shopID。如果您在查找时需要帮助,请参阅 步骤 1

一旦所有脚本都已添加并保存,您的 BigCommerce 店铺将完全连接到 Omnisend 追踪。

联系人同步

所有通过 BigCommerce 添加或更新的联系人将自动添加到您的 Omnisend 受众Contacts 联系人名单。这些联系人也将收到标签 "source: bigcommerce"

这使您能够轻松筛选和细分(Segment)从 BigCommerce 同步的联系人。您可以创建一个细分(Segment),基于标签是source:bigcommere在此处了解更多关于细分(Segment)的信息

常见问题

为什么在我连接您的店铺后,snippets 没有自动安装?
自动代码片段安装适用于大多数新的 BigCommerce 店铺,但一些较旧的店铺或自定义 Stencil 主题需要手动安装。连接您的店铺后,请在 10 分钟内检查 Script Manager。如果没有出现 Omnisend 脚本,请按照本指南中的手动安装步骤操作。

如何检查 Omnisend snippets 是否已安装?
前往 BigCommerce → Storefront → Script Manager.查找三个 Omnisend 脚本:Omnisend 脚本" (店铺页面), "Omnisend 销售跟踪脚本" (订单确认),以及 "Omnisend 结账追踪脚本" (结账)。如果这三者都出现,则代码片段已安装

我手动添加了代码片段,但表单和产品选择器不起作用。为什么?
You likely have duplicate snippets (automatic + manual).前往 BigCommerce → Storefront → Script Manager.如果 Omnisend 脚本在那里列出,请移除您手动添加到主题页脚或页眉文件中的任何片段。仅保留 Script Manager 中的脚本。重复的代码片段会导致功能失效。

我可以同时使用 Blueprint 和 Stencil 代码片段吗?
编号同时使用两者会破坏功能。根据您的主题,仅使用一种片段类型。如果您从 Blueprint 切换到 Stencil(或反之),请首先移除旧的 snippets,然后添加正确的 snippets。


想联系客服吗?使用应用内聊天或发送您的问题至[email protected]

这是否解答了您的问题?