Skip to main content
To get Engage working with Shopify you’ll need to map your Shopify markets to Engage stores.

​
Markets, countries and locales

In Shopify you can create markets for your store. Each market is a way to divide up your customers into useful segments in order to target specific countries or regions, or just to group countries and regions together to simplify your expansion efforts. Let’s say, for example, you create a market and call it “BeNeLux”:
  • Market: BeNeLux:
  • Countries: Belgium, Netherlands, Luxembourg
  • Languages: French (fr), Dutch (nl), German (de)
If you have the language selector for your Shopify store, this means that customers in these countries can pick their language. Combining these 3 countries and 3 languages in all possible ways gives you a total of 3 x 3 = 9 locales (a locale being a combination of a language with a country) for your “BeNeLux” market.
Some of these combinations (nl-LU, fr-NL, de-NL) aren’t in the standard so can’t be used. Only locale names following the .NET standard can be used to configure product feeds in Engage.
This shows how countries and languages combine into locales:
Markets, countries and locales

Markets, countries and locales

Now removed the invalid locales. This leaves us with:
  • fr-BE
  • fr-LU
  • nl-BE
  • nl-NL
  • de-BE
  • de-LU
There needs to be a product feed configured for each of these locales in Engage. However, since product feed is defined by language, only three product feed URLs are actually needed, since we have three languages here. So each product feed URL can be used in multiple locales when configuring them in Engage, as long as they use the same language. For example, nl-NL and nl-BE can both use the same product feed URL. If you don’t have the language selector enabled for your e-com, the language used for a customer will just be the default one set up for their country.
In a nutshell, you’ll have to send to your Voyado team the locales you will use, following the standard above. They will them use these to configure the required product feeds in Engage, for use in email send-outs etc.
With this in mind, here are two ways you can map your Engage store to a country in Shopify:
Imagine that you are a Shopify user selling to three different countries: Sweden, Netherlands and the UK. You have these shipping countries collected within the same Shopify store. When setting up the Voyado Engage app in Shopify, follow the steps below.First, you’ll need to create the stores in Voyado Engage:
  1. Log into Voyado Engage.
  2. In the left-hand menu, select “Administration” and then “Stores”.
  3. In the top right corner, select “New store“.
  4. Input your store’s details, for example:
    1. Store: “ecom SE“
    2. Time zone: “(+02:00) Europe/Stockholm“
    3. External Id: “ecom-se“
    4. Store type: “ECOMM“
    5. Active: “Yes”
  5. Select “Save” in the top right corner.
  6. You’ve created your Sweden store. Repeat step 3-5 for the Netherlands and the UK.
When all your stores have been created in Engage, you can start mapping them to your Shopify stores within the Voyado Engage app’s configuration area.
Tick “Rest of world fallback“ on one of your mappings. Customers without a location country specified, or with a location country in Shopify that is not connected to a store in Engage, will then be automatically connected to that Engage store. The fallback is optional, but without one, orders from unmapped countries will not sync.
Errors connected to store mapping can be seen on the “Dashboard“ page.These are the steps to follow:
  1. Log into your Shopify store and access the “Voyado: AI Marketing & Loyalty“ app.
  2. Go to “Settings“ and the section “Store to country mapping“.
  3. Select “Add Mapping“.
  4. The mapping type should be “Shipping country“.
  5. In the “Voyado Store” drop-down list, choose the store you want to start mapping. In our current example, it’s the first of our three countries, Sweden, so choose the “ecom SE“ store.
  6. In the “Shipping Country“ list to the right, choose the country “Sweden“.
  7. Select “Save“ and the mapping should appear in the list.
  8. Repeat steps 3-7 for the Netherlands and the UK.
  9. On one of the three mappings, tick “Rest of world fallback“.
Imagine again that you sell to three different countries: Sweden, Netherlands and the UK. You have a separate Shopify store for each country. When setting up the Voyado Engage app in Shopify, follow the steps below.The first thing you have to do is create the stores in Voyado Engage:
  1. Log into Voyado Engage.
  2. In the left-hand menu, select “Administration” and then “Stores”.
  3. In the top right corner, select “New store“.
  4. Input your store’s details, for example:
    1. Store: “ecom SE“
    2. Time zone: “(+02:00) Europe/Stockholm“
    3. External Id: “ecom-se“
    4. Store type: “ECOMM“
    5. Active: “Yes”
  5. Select “Save” in the top right corner.
  6. You’ve created your Sweden store. Now repeat step 3-5 for the Netherlands and the UK.
When all your stores have been created in Engage, you can start mapping them to your Shopify stores within the Voyado Engage app’s configuration area.Each Shopify store is configured separately, in its own copy of the app. So in this example you map the Swedish Shopify store to “ecom SE“, the Dutch store to “ecom NL“, and the UK store to “ecom UK“ — one mapping in each.Within a single Shopify store, customers whose shipping country is missing, or is not the chosen “Shipping Country”, are connected to whichever Engage store is ticked as “Rest of world fallback“ in that store’s app.Errors connected to store mapping can be seen on the “Dashboard“ page.
  1. Log into your Shopify store for Sweden and access the “Voyado: AI Marketing & Loyalty“ app.
  2. Go to “Settings“ and the section “Store to country mapping“.
  3. Select “Add Mapping“.
  4. The mapping type should be “Shipping country“.
  5. In the “Voyado Store” drop-down list, choose the store you want to map. In our current example, it’s the first of our three countries, Sweden, so choose the “ecom SE“ store.
  6. In the “Shipping Country“ list to the right, choose the country “Sweden“.
  7. Tick the box “Rest of world fallback“, so that customers with a missing or unmapped country in this Shopify store still reach an Engage store.
  8. Select “Save“ and the mapping should appear in the list.
  9. Now repeat steps 1-8 in the Shopify stores for the Netherlands and the UK, choosing that country’s Engage store each time.
Only one mapping per Shopify store can be the fallback. Ticking “Rest of world fallback“ on a second mapping in the same store moves the flag rather than adding another.