BigCommerce

Installation Instructions

Step 1 – Activate the Vextras app in BigCommerce

1. Login to your BigCommerce administration area
2. Select the ‘Apps’ tab from the toolbar on the left side
3. Search for ‘Vextras’ and install
4. Once installed, you will see your Bigcommerce store loaded in Vextras

Step 2 – Add installation snippet (Blueprint framework templates)

1. Copy the ‘Installation Script’ from Vextras. You can find this under the ‘Connection’ tab under your store’s dashboard.
2. Next,  go to your Bigcommerce store admin area to put in the Vextras installation script
3. Go to ‘Storefront Design’ > ‘My Themes’
4. Click the ‘Edit HTML/CSS’ link on the right side under ‘Advanced Options’, then choose the ‘HTMLHead.html’ file
5. Paste the installation script into the main Bigcommerce header template before the ending </head> tag.
6. Save, Close & Refresh

Step 2 – Add installation snippet (Stencil framework templates)

1. Copy the ‘Installation Script’ from Vextras. You can find this under the ‘Connection’ tab under your store’s dashboard.
2. Next,  go to your Bigcommerce store admin area to add the Vextras installation script
3. Go to ‘Storefront’ > ‘Script Manager’
4. Click the ‘Create a Script’ button on that page
5. Give the new script a name and description (this can be anything)
6. Select the location on the page to be ‘Footer’
7. Set the ‘Select pages where script will be added’ to be ‘All pages’
8. Set the ‘Script type’ to be ‘Script’
9. Paste the Vextras installation code in the ‘Script contents’ box
10. Save

Step 3 – Important! Install the conversion tracking snippet

1. Copy the ‘Conversion Tracking’ snippet from Vextras. This is also found in the ‘Connection’ tab under your store’s dashboard.
2. Paste into the ‘Affiliate Conversion Tracking’ area of your BigCommerce store. Locate this under the  ‘Advanced Settings’ -> ‘Web Analytics’ -> ‘Affiliate Conversion tracking’ -> `Conversion Tracking Code` input box
3. Save

Installation Script

The Vextras installation script is used to capture shopping cart data in real-time. Apps and workflows require this code to be present at all times in order to work properly.

Example Installation Script

<!-- BEGIN VEXTRAS CODE--><script src="https://s3-us-west-2.amazonaws.com/vextras/production_scripts/store_9VJ8P2PRHJ9JTB52G3M78Y7YGF.js"></script><!-- END VEXTRAS CODE-->

Conversion Tracking Script

The Vextras conversion tracking script is used to capture conversion tracking for various apps and workflows.

• It is not required for our services to function properly, but it is highly recommended. Without it, apps like MailChimp and/or any workflow conversions can’t be measured.
• If you have other tracking scripts in this area, place it before or after any existing tag. There are no known conflicts when using the Vextras script with any other conversion tracking tag.

Example Conversion Tracking Script

<!-- BEGIN VEXTRAS CODE--><script>vextras.submitOrder(%%ORDER_ID%%, %%ORDER_AMOUNT%%)</script><!-- END VEXTRAS CODE-->

Connection

When your Bigcommerce store is active with Vextras, the ‘Connection’ tab for your store will show key indicators about the installation.

• Status
• Platform
• Store Name
• Store URL
• Install Code Status
• Install Script (required) – paste the script into the Header area of your BigCommerce template before the ending </head> tag.
• Conversion Tracking (required) – paste the conversion tracking script in the ‘Conversions’ area of your BigCommerce template. It’s ok to have this code loaded with other types of conversion scripts.

Settings

• Store information – basic contact details for your store, this is required for CAN-SPAM compliance if you want to use any of our workflows.
• Social links -attach your social links to any of our workflow e-mail templates. When added, the URL’s will automatically link to your social profiles.
• Locale settings – set your country and currency.
• Google Analytics integration – activate Google Analytics to display key metrics in your store’s dashboard.

Removal Instructions

1. Login to your BigCommerce store admin area.
2. Remove your ‘Installation Code’ in the header template right before the ending </head> tag.
3. Go to ‘Storefront Design’ > ‘My Themes’.
4. Click the ‘Edit HTML/CSS’ link on the right side under ‘Advanced Options’, then choose the ‘HTMLHead.html’ file.
5. Remove the installation script into the main BigCommerce header template before the ending </head> tag.
6. Save, close and refresh.
7. Remove the ‘Conversion Tracking’ code in the BigCommerce. This can be found under the  ‘Advanced Settings’ menu > ‘Affiliate Conversion Tracking’.
8. Remove the ‘Conversion Tracking’ code and save.
9. Select the ‘Apps’ tab from the toolbar on the left side.
10. Look under ‘My Apps’ for Vextras.
11. Finally, choose ‘Uninstall’ and confirm.

More Information

Processing Times

• All new order data is processed in real-time through standard web checkout.
• Phone or manual orders are processed at 15-minute intervals.

Order Update Times

This platform’s API will send POST requests to Vextras on any order update. These updates will be queued and processed at the next refresh interval – typically about every 2-5 minutes.

Order Monitoring

We monitor orders for up to 90 days. After that period, they will be removed from our system.

Valid SSL Required

• If a store lacks a valid SSL certificate, we are unable to connect your store.
• If an SSL expires on your domain, Vextras apps and workflows will not function.
• An SSL can be purchased from the shopping cart provider or any 3rd party SSL vendor.
• Installation of an SSL will need to be facilitated with your shopping cart provider.

Localization

• All major currencies supported
• All time zones supported

Known Quirks

• Under each customer in BigCommerce, “Receive ACS/Review Emails” is related to BigCommerce’s internal notifications.
  • This setting does not apply to a customer’s newsletter subscriber preference chosen at checkout.
  • Currently, the subscriber preference is not shown in the BigCommerce admin area for a customer.
  • The subscriber preference is only visible through the API.

Limitations

Platform

• An order must be placed through the standard web checkout before any phone or manual orders will process.