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
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: “eCommerce“
    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.
It’s important to choose one of your stores to be “Rest of the world fallback“. Customers without a location country specified, or with a location country in Shopify that is not connected to a store in Engage, will be automatically connected to whatever Engage store is mapped as your “Rest of the world fallback“.
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 Engage“ app.
  2. Go to “Settings“ and the section “Voyado 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.
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: “eCommerce“
    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.Customers without a location country specified or with a different location than the chosen “Shipping Country” will be connected to the Voyado store mapped as “Rest of the world fallback“. In the example above, the Shopify store will be mapped to the Engage store “ecom SE“.Errors connected to store mapping can be seen on the “Dashboard“ page.
  1. Log into your Shopify store for Sweden and access the “Voyado Engage“ app.
  2. Go to “Settings“ and the section “Voyado 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 the world fallback“.
  8. Select “Save“ and the mapping should appear in the list.
  9. Now repeat steps 1-8 for the Shopify stores connected to the Netherlands to the the UK.