Shopify internationalization

Converge supports any internationalization setup you may have on your Shopify store. Whether you have multiple stores, or a single store serving multiple markets. Whether you have the same analytics and marketing setup for all countries or different setups for each country. You can set up the exact tracking and marketing setup to scale across borders.

To navigate the guide below, you need to understand the following:

• Do you want to break out the Converge data by market, or aggregate your revenue, spend, CPA, etc. across all markets?
• Do you have multiple Shopify stores for different markets, or a single Shopify store serving multiple markets?
• Do you have different ad accounts, analytics properties, etc. for each market?

​

Workspaces

Within Converge, you can decide to set everything up within a single workspace or create separate workspaces for each market. Separate workspaces allow you to keep the revenue, spending, CPA, etc. data separate. In a single workspace, all data is aggregated across your markets.

​

Shopify installation

You need to create different pixels and datasources for each market. If you decided to use a single workspace, you can create all of these within the same workspace. Otherwise, create a new pixel and datasource within each workspace, corresponding to its market.

​

Multiple Shopify stores serving different markets

This is the most common setup and easiest to configure. You have set up entirely different Shopify stores for different markets, for example, my-store-us.myshopify.com and my-store-uk.myshopify.com.

You can follow the regular Shopify setup guide here. Repeat the installation for each store and create a new pixel and datasource each time. If you added them to the same workspace, this can look like this:

​

Single Shopify store serving multiple markets

In this case, it’s a bit harder to separate your stores. You should still create separate pixels and datasources for each market, and decide whether to add these to the same workspace or different workspaces. Follow the regular Shopify setup guide here for each market, for the same Shopify store, but take into account the following modifications.

​

Server integration

Converge separates your markets by the shipping country. Each Shopify market has a different set of shipping countries. When creating the server integration, tick the Filter Shopify markets option. Select the markets for which you’re setting up this source.

​

Browser integration

Because you have a single Shopify store, you have only a storefront and theme. So you need to install multiple pixels in the same theme.liquid file.

You need to decide whether to split the pixels by domain, locale, or any other criteria. Please advise with the team that built your website and set up the different markets. They can help you decide the best way to split the pixels.

In the example below, we separate the .eu domain for the /de and /es subfolders from the others.

<!-- Start Converge Code -->
<script>
window['__cvg_shopify_info'] = {
    product: {{ product | json }},
    variant: {{ product.selected_or_first_available_variant | json }},
    currency: {{ shop.currency | json }},
    collection: {...{{ collection | json }}, products: {{ collection.products | json }}},
    search: {{ search.terms | json }},
};
</script>
<script>      
!(function (window, document) {
    const domain = document.location.hostname;
    const subfolder = document.location.pathname.split('/')?.[1]?.toLowerCase();
    
    // Your custom logic to decide the pixel public token for each market
    let cvgToken;
    if (
        domain == "mydomain.eu" &&
        ["de", "es"].includes(subfolder)
    ) {
        cvgToken = "xxxxxx";
    } else {
        cvgToken = "yyyyyy";
    }
    if (window['cvg']) return
    const one = window['cvg'] = function () {
        one.process ? one.process.apply(one, arguments) : one.queue.push(arguments)
    }
    one.queue = []
    const two = document.createElement('script')
    two.async = 1
    two.src = `https://static.runconverge.com/pixels/${cvgToken}.js`
    const three = document.getElementsByTagName('script')[0]
    three.parentNode.insertBefore(two, three)
})(window, document)
</script>
<!-- End Converge Code -->

    const loc = new URL(init.data.shop.storefrontUrl);
    const domain = loc.hostname;
    const subfolder = loc.pathname.split('/')?.[1]?.toLowerCase();

    // Your custom logic to decide the pixel public token for each market
    let cvgToken;
    if (
    domain == "mydomain.eu" &&
    ["de", "es"].includes(subfolder)
    ) {
    cvgToken = "xxxxxx";
    } else {
    cvgToken = "yyyyyy";
    }

!function(){
"use strict";
window.Shopify={shop:"<<TO FILL IN>>.myshopify.com"},
function(e,t,o,c,n,s,i){e.cvg||(e.shopify={analytics:analytics,browser:browser,init:init},n=e.cvg=function(){n.process?n.process.apply(n,arguments):n.queue.push(arguments)},n.queue=[],(s=t.createElement(o)).async=1,s.src=`https://static.runconverge.com/pixels/${cvgToken}.js`,(i=t.getElementsByTagName(o)[0]).parentNode.insertBefore(s,i))}(window,document,"script"),/\/checkouts/.test(init.context.document.location.href)&&cvg({method:"track",eventName:"$page_load"})
}();

​

Connections setup

​

Multiple workspaces

If you have broken out your markets into separate workspaces, you can create connections as usual within each workspace. In case a single ad account is served by multiple markets, you should recreate the connection in each workspace.

​

Single workspace

If you have a single workspace, you can create connections for each market within the same workspace. If an ad account is served by a single market, you can use the connection sources to specify the markets for which data should be forwarded.

See the below example to only send data for a UK store to the UK Facebook pixel.