Configure your Shopify store for website personalisation – Ometria Help Centre

This article explains how to set up your Shopify store to integrate with Ometria's website personalisation features.

Before you begin

Get in touch with your Customer Success Representative (or your Technical Projects Manager if you're still onboarding).

They can help guide you through the process and make sure Shopify is properly integrated with Ometria's website personalisation features.

Create a custom app

First, you'll need to create a custom app in your Shopify store.

Shopify documentation: Create and install a custom app

Note: For the App developer field, you should provide the email address of the developer on your team responsible for website personalisation.

Configure Admin API scopes

Once you've created your custom app, define the API permissions.

Shopify documentation: Update admin API scopes for a custom app

Website personalisation requires the following scopes:

Scope	Required?
read_products	Required.
read_product_listings
read_inventory
read_content
write_content
read_themes
write_themes
read_orders
read_translations	Optional - required if you use more than one language in Shopify.
read_locales	Optional - required if you have more than one locale.
read_locations	Optional - required if you want to include stock for specific locations.
read_companies	Optional - required if you use B2B Pricing.
read_customers	Optional - required if you have customer specific pricing.
read_gift_cards	Optional - required if you use gift cards.
read_product_feeds	Optional - for synchronising product data.

Save your changes.

Install the app and get your API access tokens

Next, click Install app and get the API access tokens.

Shopify documentation: Install the app and get the API access tokens

Warning: You can only reveal your API access token once.

Store the following details in a secure place:

Access token
API key
API secret key

Ometria requires these pieces of information to configure our website personalisation features for authentication, data access and webhook verification.

Adding credentials to Ometria

Finally, you can add your API access tokens to Ometria.

Go to: Website personalisation > Administration > Shopify integration

From the Shopify Integration screen, click Credentials:

Enter the credentials from your Shopify custom app:

Field	Description
Shopify URL	Enter your myshopify domain.
API Key	Enter your Shopify API key.
Admin Access Token	Enter your Shopify access token.
Shared Secret	Enter your API secret key from Shopify.

Scopes

In the Scopes table you can see which of your Admin API scopes from Shopify are currently enabled.

Data validation

In the Data screen you can check to see if data is syncing correctly between Shopify and Ometria.

Update Shopify Themes

In the next screen you'll see a list of your Shopify themes.

We recommend making a clone/copy of your current site theme in Shopify and then checking the status and making any necessary changes.

Please get in touch with your Customer Success Representative or Technical Projects Manager for further guidance on this step.

Version control

By default, all new custom apps will use the latest API version.

If you require a specific version, please get in touch with your Ometria Technical Projects Manager.