Shopify internationalization - Converge Documentation

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.

To set up new workspaces for new markets, please contact Converge support.

Shopify installation

If you are not treating your markets as separate entities, you can follow the regular Shopify setup guide here.

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

This is an intricate setup. Please consult with your development or data team before proceeding.

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.

Your source will filter the orders based on the shipping countries that are part of the market when creating the source. Please take care to update your setup accordingly when your market configuration changes. Converge will display the following message in the Sources configuration when it detects that the filtered countries are not up to date with the current Shopify markets configuration:

The Received Refund event will no longer be tracked when the source is configured with the Filter Shopify markets option.

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.

Example Liquid snippet for multiple pixels by subdomain

<!-- 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 -->

Example customer events snippet for multiple pixels by subdomain

    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"})
}();

Destinations setup

Multiple workspaces

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

Single workspace

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

Select both the server and browser source you created for this market.

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

Guides

​Workspaces

​Shopify installation

​Multiple Shopify stores serving different markets

​Single Shopify store serving multiple markets

​Server integration

​Browser integration

​Destinations setup

​Multiple workspaces

​Single workspace

Workspaces

Shopify installation

Multiple Shopify stores serving different markets

Single Shopify store serving multiple markets

Server integration

Browser integration

Destinations setup

Multiple workspaces

Single workspace