Setting up a BigCommerce integration

Ometria’s integration with BigCommerce sends customer, subscriber, order and product data to Ometria in real time.

When you install the BigCommerce integration in Ometria, you are creating a new integration instance which will:

• inject Ometria JavaScript into BigCommerce for tracking visitors
• sync all of the existing customers, orders and products to Ometria
• create webhooks in BigCommerce to notify Ometria of changes to customers orders and products, and;
• sync all new and updated customers, orders and products.

Ometria's BigCommerce integration does not support:

• Transactional emails
• Multi-currency sites

BigCommerce customisations

You can customise both your customer and product records in BigCommerce for Ometria to retrieve. 

Customer fields 

If you have custom fields created in the Account Signup Form section in your BigCommerce account for customer data, they are automatically sent to Ometria. 

These fields won't display in your Ometria account until you create the corresponding custom fields in the platform. 

Product fields

When you send any of the following from BigCommerce:

• Variants
• Variant options
• Shared variant options

You are creating product variants in Ometria.

Variant options and shared variant options are stored as product attributes in Ometria, which can be used to filter and segment your contacts. 

E.g. You can use the customer filter to find all contacts who have ordered a product with a specific variant option. 

Product custom fields from BigCommerce are stored as properties in Ometria, which can be used in merge tags to personalise your campaign templates.

E.g. If you can have a product custom field for 'fancy hats’, you can use the {{ group.products[0].properties.fancy_hats }} merge tag in your email template to include only products with the 'fancy hats' property.

Setting up a BigCommerce integration

There are two steps to set up a successful BigCommerce integration:

1. Create a BigCommerce API key
2. Configure the BigCommerce connection in Ometria

Step 1: Create a BigCommerce API key

Log into your BigCommerce admin panel and go to: Advanced Settings > API Accounts.

Select Create API Account > Create V2/V3 API Token:

Choose the following settings for the API key:

BigCommerce automatically downloads the key details:

Keep these details for step 2.

Step 2: Configure the BigCommerce connection in Ometria

Before you begin, contact your technical project manager (TPM) and ask for your Ometria identification code.

Log into your Ometria account and go to account > Settings > Connections:

Select Add a new connection and choose the BigCommerce connection tile:

The BigCommerce sync screen displays:

Enter your Identification Code and then select New authentication.

The Create a new authentication window displays:

Enter an Ometria API key in the API key field, then complete the following fields using the information you downloaded from your BigCommerce account in Step 1.

Only users with administrator account permissions can access the API keys tab.

Select Create to connect your BigCommerce account to Ometria.

Back in the BigCommerce sync screen, scroll down to complete the remaining fields:

Select Next to add order mapping.

If you have created any custom order statuses in BigCommerce, add them at the bottom of this screen:

Select Next.

If you're updating an existing BigCommerce connection, you can choose to update the JavaScript tracking, or re-sync all of your products, orders and contacts.

If this is a new connection, ignore this page and click Next.

In the next screen, select Finish.

Your connection with BigCommerce is complete and the tile displays in your Connections screen:

This connection will automatically:

• inject the required JavaScript into BigCommerce, 
• register webhooks, and; 
• begin the bulk sync of data into Ometria.