BigCommerce

Seamlessly connect your BigCommerce stores to Voyage's powerful SMS marketing capabilities. Segment, personalize, and convert like you never have before with a Voyage / BigCommerce integration. In order to integrate Voyage with BigCommerce (BC), you must create an API account for Voyage. Follow along in this article to learn how.

 

 


Navigate and Create API Account

After logging into your BigCommerce account, look on the left main menu for Advance Settings:

Navigate-Advanced-Settings-BC-New

 

On the sub menu that expands, you'll need to click on API Accounts [1]. From there, click on the blue Create API Account button [2] and select "Create V2/V3 API Token" [3]:

Create-API-Accounts-in-BigCommerce

 

Name the API account "Voyage" at the top, then scroll down to set Customers [1], Orders [2], Products [3], and Carts [4] to read-only permissions. All others can remain on None. Then click Save [5]:

Set-Permissions-for-BigCommerce-Integration-Voyage

 

A text file will start downloading. Keep in mind, this text file will be the only copy BigCommerce will provide. Be sure to store it in a secure, reliable location. The same necessary integration details will be shown on screen. Leave this screen open for now (don't click on Done yet):

Big-Commerce-Integration-Details

 

Leave this BigCommerce browser tab open, and create a new browser tab window. Log in to your Voyage account to continue.

Back to Top

 


Connect Voyage and BigCommerce

Once inside your Voyage account, select Integrations from the main menu [1] and scroll down to BigCommerce [2]. Note that the Shopify integration can't be active at the same time as BigCommerce. If you do need to deactivate the Shopify integration, you may need to wait 15 minutes for the old integration to be fully disabled before continuing. Click on Activate [3] to continue:

Voyage-BigCommerce-Integration

 

On this screen, you'll need to populate these fields with values from BigCommerce. You can refer either to the BigCommerce tab you should still have open, or the .txt file that was downloaded earlier. The Store Hash field [1] is the string in the API Path URL just after "/stores/". For example, if your API Path is https://api.bigcommerce.com/stores/lmvgat835sn/v3/ your Store Hash would be "lmvgat835sn". Your Client ID [2], Client Secret [3], and Access Token [4] are all labeled the same in both Voyage and in BigCommerce so all you need to do is copy and paste each. When everything is filled in, click on Next [5]:

Big-Commerce-Populate-Integration-Fields-in-Voyage-New

 

When successful, you'll see this message:Big-Commerce-Integration-Success

 

If you run into any errors, please log out of Voyage then log back in and try the integration again. You may need to wait 15 minutes after disabling other conflicting integrations before the BigCommerce integration can be activated.

It could take up to 24 hours after successful activation for your BigCommerce data to fully import into Voyage. Afterwards you will have access to customer attributes and event triggers in your Voyage platform.

Back to Top

 


Install Voyage Tags

You will need to install the Global Voyage Tag and Purchase Tag to fully track customer events across your BigCommerce pages.

 

Global Tag

To begin, navigate in your BigCommerce dashboard to Storefront:

Storefront-Main-Menu-Big-Commerce

 

Then select Script Manager [1] and click Create a Script in the top right corner [2]:

BC-Storefront-Script-Manager-Create-a-Script

 

Give this script an appropriate name, such as "Voyage Global Tag" [1]. Ensure the following options are set as follows. Location on page should be set to Head [2], Select pages where script will be added should be on All pages [3], and the Script category should be set to Essential [4]. Chose Script for Script type [5], then copy and paste the code snipped below into the Script contents field [6]:

BC-Create-Script-Options-and-Code-Updated

 

 

Copy and paste this code snippet, but remember to replace 'Client ID' (keeping the quotes) in the code below with your own Client ID found in your Voyage dashboard under the Settings menu > Account > Client ID:

<script type="text/javascript">
/* <![CDATA[ */
(function(){if(window.voyage)return;window.voyage={q:[]};var fns=['init','event', 'track'];
for(var i=0;i<fns.length;i++){(function(fn){window.voyage[fn]=function(){
this.q.push([fn,arguments]);}})(fns[i])}})();voyage.init('Client ID', { popup: true });
/* ]]> */
</script>
<script async src="https://assets.voyagetext.com/voyage.production.js"></script>

 

Purchase Tag

Next you'll want to add Voyage's purchase tag to BigCommerce. Again navigate to Advanced Settings in BC as described above. Then click on Data Solution (formerly Web Analytics) [1]. Look for Affiliate Conversion Tracking near the bottom [2] and click on Connect [3]. Note that if you already have a connection, you'll see an option to Edit your connection instead:

BigCommerce-Affiliate-Conversion-Tracking-New

 

On the following screen you will paste the code found below into the Connection field [1]. Then click Save [2]:

Paste-Voyage-Code-into-BC

 

Here is the code you'll be pasting into the Connection field in BigCommerce. Note that you will need to replace 'Client ID' (keeping the quotes) in the code below with your actual Client ID string found in your Voyage dashboard under the Settings menu > Account > Client ID:

    <script type="text/javascript">
    /* <![CDATA[ */
    (function(){if(window.voyage)return;window.voyage={q:[]};var fns=['init', 'track'];
    for(var i=0;i<fns.length;i++){(function(fn){window.voyage[fn]=function(){
    this.q.push([fn,arguments]);}})(fns[i])}})();voyage.init('Client ID', { popup: false });
    /* ]]> */
    </script>
    <script async src="https://assets.voyagetext.com/voyage.production.js"></script>
    <script type="text/javascript">
    /* <![CDATA[ */
    var amount = '%%ORDER_SUBTOTAL_IN_CENTS%%'
    var orderId = "bc-" + "%%ORDER_ID%%"
    voyage.track("Purchase", { amountCents: +amount, orderId });
    /* ]]> */
    </script>

     

    After pasting and saving this code, you may receive a message saying the code is invalid. You can safely ignore this message.

    Back to Top

     


    FAQ

    Q. Why is the Voyage Global Tag not loading after adding to the Script Manager?
    A. Using Script Manager is only available for Stencil Themes with BigCommerce. If your theme is based on Stencil but you are still having issues, it may be helpful to follow these Fixing missing scripts steps when troubleshooting.

    Back to Top

     

     

    If you have any additional questions please contact us at service@voyagesms.com.