Installing Justuno on Bigcommerce Stencil Themes

Covers installing Justuno on the Bigcommerce platform for Stencil themes

As of May, 30th 2018, all Bigcommerce Stencil Theme users that have Optimized one-page checkout enabled may now fully install Justuno via our Bigcommerce marketplace application. The Justuno app has been updated to automatically embed the cart code, the conversion tracking script, and the primary embed script in a single streamlined process.

 

At a glance:

1) Instructions for app installation

2) Manual method

Instructions for app installation

1. Go to your Bigcommerce store and find the apps section on the left then hit marketplace. Only the BigCommerce store owner will have access to install a new app.

LWR_Recording (9)

 



2. Enter the BigCommerce app Marketplace and search for the Justuno app. Once you have found it click 'install'. 
More details on installing an app within the BigCommerce app store can be found here:

Installing an app within the BigCommerce app Marketplace

 

3. You will then be prompted with the create account form.

If you already have an account, please click 'sign in' at the bottom and you can get logged in with your existing Justuno credentials. 


Here is what this page will look like:

BCinstall2


After signing up successfully, the app will auto install and you are all set!

 

Manual Installation

*Please note that this is not recommended as it becomes more difficult to use all of the Justuno features due to limitations of the BigCommerce cart variables. We recommend using the steps above for full functionality.

 

1. To install the general embed code in a stencil theme, please head to:

Storefront > Script Manager and create a new script.

Additional details on the BigCommerce Script Manager can be found - here

 

2. In the script manager, please add the parameters

Name of script / Description: Anything that you would like to be able to identify what this is and what it does

Location of page: Footer

Select pages where script will be added: All Pages

Script Category: Targeting; Advertising 

Script Type: Script

Here is what this will look like:

Stencil1

Then at the bottom copy and paste the general embed script from the Justuno dashboard. Details on how to get that can be found here: General embed instructions | Justuno

Finally, save and you are all setup with the manual Justuno embed method.

Adding Conversion tracking script (optional but recommended)

Please follow the below instructions to enable conversion tracking for use with promotion rules and analytics.

Copy the following code into the "Advanced Settings" > "Affiliate Conversion Tracking" section of your Bigcommerce dashboard underneath the code you just copied from above.

<script type="text/javascript">
window.juapp=window.juapp||function(){(window.juapp.q=window.juapp.q||[]).push(arguments)}
juapp(
'order',
'%%ORDER_ID%%',
{total:%%ORDER_AMOUNT%%,subtotal:%%ORDER_SUBTOTAL%%,currency:'USD'}
);
</script>

 

affiliate conversion tracking

 

Adding Cart tracking script

BigCommerce uses a different set of variables for Stencil and Blueprint themes, therefore, Blueprint variables will not work outside of its respective theme framework and all stencil variables will not work outside of the handlebars framework that Stencil themes are based on. 


For this reason, the cart code will not be able to installed manually with a script. A custom app will need to be made to get the cart data by using the BigCommerce API or by using the BigCommerce GraphQL. If you do not want to go this route, we recommend just installing the Justuno app through the BigCommerce marketplace and it will add this automatically.

 

More details on these can be found here:

BigCommerce GraphQL

BigCommerce Storefront API

 

 

 

tags: Bigcommerce, Stencil Theme, Install Justuno