Which identifier is supported by the Emarsys Shopify plug-in for creating, updating and deleting contacts, triggering events and synchronizing orders?
Currently, only the email address
identifier is supported by the Emarsys Shopify plug-in for:
- Creating, updating and deleting contacts
- Triggering events
- Synchronising orders
This does not apply to Web behavior tracking, which uses the email
identifier that can be switched to Shopify ID
.
I have multiple Shopify stores. Can I map each one to the same Emarsys account?
No, if you have more than one Shopify store, you need to map each one to a separate Emarsys account.
How can I check that my Emarsys plug-in works properly?
To ensure that your Emarsys plug-in works as expected, follow the instructions in Emarsys plug-in for Shopify - Quality check of the plug-in.
Are bundle products supported by the Emarsys Shopify plug-in?
No, the Emarsys Shopify plug-in does not support bundle products currently.
Can go commands called multiple times cause problems?
The "Multiple calls of go command" error message is not relevant to the Shopify extension snippet. However, please always make sure that only one Web Extend implementation is present.
Custom Web Extend implementations
If you are using a custom Web Extend implementation in your Shopify shop, then please do not turn on the Web behavior tracking for the plug-in.
The following can indicate that custom implementations are used in your Shopify shop:
- Multiple views or user identification is displayed in the Predict Inspector and
- Duplicate Web Extend events are shown on the Live Events page.
- In this case, we recommend that you remove the custom implementation from your shop because the plug-in sends the product catalog as described in Product catalog and Web Extend events and it will recognize this format automatically. However, the custom implementation needs to be changed according to the product catalog upload data.
Product Catalog and Web Extend events
After turning on Product upload on the UI, our service sets up the customer's Predict account so that the upload configuration will be hidden (catalog URL, scheduling). In this case, the service handles catalog submission by uploading the CSV catalogs to a given address, then by triggering the Emarsys Platform to process the catalog.
Also, the grouped_catalog
option is enabled in the Predict configuration, so it can handle parent/child relations between product entities (i.e. parent products and their variants in Shopify).
In the case of parent products:
- the
item
field contains the ID/SKU preceded by theg/
prefix and - the
group_id
field contains the ID/SKU in the product catalog. - For example:
-
item
: g/PRODUCT-SKU -
group_id
: PRODUCT-SKU
-
In the case of child products:
- the
item
field contains the ID/SKU and - the
group_id
field contains the ID/SKU of the parent product in the product catalog. - For example:
-
item
: PRODUCT-SKU -
group_id
: PARENT-PRODUCT-SKU
-
The following output example shows you an example catalog that contains parent-child and single products:
Product in webshop (SKU) Lines in CSV

Please note that this structure is validated by Predict and it should comply with it. The Recommender can be configured to display simple products, groups or both.
As a result of this, tracking events contain products in the following format:
- View event: g/PARENT-PRODUCT-SKU - As customers usually view parent products, view events are sent with the g/ prefix.
- Cart event: PRODUCT-SKU - Customers put configured products or variants into their cart, so cart events contain child product identifiers.
- Purchase event: PRODUCT-SKU - Customers purchase configured products or variants, so purchase events contain child product identifiers.
What happens if I activate Web behavior tracking without synchronizing my product catalog?
Web behavior tracking relies on the product catalog that has to be synchronized to Emarsys in a specific way. As the Emarsys Shopify plug-in synchronizes product data in the expected format and structure, we strongly recommend that you activate the plug-in's Web behavior tracking along with product data synchronization only.
If you activate Web behavior tracking without synchronizing the product data, then you need to integrate your product catalog by ensuring that its structure is appropriate. Please note that Emarsys cannot be held responsible for the consequences resulting from such cases.
Product catalog from other sources
Each catalog upload will replace the entire catalog in Predict, so if the customer previously uploaded the catalog from another source, then decides to use the connector "middleware", then as a result, the previous catalog will be overridden by the one coming from the plug-in.
Sample Shopify order CSV
In the following example, you can see how a sample order CSV file from Shopify looks like:
item,price,order,timestamp,email,quantity
10604114575403,150.52,336347136043,2018-02-16T10:33:00Z,first@customer.com,3
10604114608171,143.75,336347136043,2018-02-16T10:33:00Z,first@customer.com,2
10604114640939,137,336347136043,2018-02-16T10:33:00Z,first@customer.com,1
10604114640940,100,336347136042,2018-02-17T10:33:00Z,second@customer.com,1
Sample Shopify product CSV
In the following example, you can see how a sample product catalog CSV file from Shopify looks like:
item,group_id,link,title,image,price,available,brand,description,zoom_image,category,msrp
g/1245168861226,1245168861226,https://lifestyle-labels-production.myshopify.com/products/aback-pull-flagrant-drum-37860,AbackPull Flagrant Drum 37860,https://lifestyle-labels-production.myshopify.com/products/image/random.jpg,952.00,true,America,<p>Aback Pull Flagrant Drum 37860 L-Aquamarine</p>,https://lifestyle-labels-production.myshopify.com/products/image/random.jpg,Over$100 | More than 100 left,900
11785312731178,1245168861226,https://lifestyle-labels-production.myshopify.com/products/aback-pull-flagrant-drum-37860?variant=11785312731178,AbackPull Flagrant Drum 37860 L-Aquamarine,https://lifestyle-labels-production.myshopify.com/products/image/random.jpg,952.00,true,America,<p>Aback Pull Flagrant Drum 37860 L-Aquamarine</p>,https://lifestyle-labels-production.myshopify.com/products/image/random.jpg,Over$100 | More than 100 left,
g/1243273134122,1243273134122,https://lifestyle-labels-production.myshopify.com/products/abaft-dress-changeable-wool-4675,AbaftDress Changeable Wool 4675,https://lifestyle-labels-production.myshopify.com/products/image/random.jpg,714.00,true,Porsche,<p>Abaft Dress Changeable Wool 4675 XL-LawnGreen</p>,https://lifestyle-labels-production.myshopify.com/products/image/random.jpg,Over$100 | More than 100 left,
11778836856874,1243273134122,https://lifestyle-labels-production.myshopify.com/products/abaft-dress-changeable-wool-4675?variant=11778836856874,AbaftDress Changeable Wool 4675 XL-LawnGreen,https://lifestyle-labels-production.myshopify.com/products/image/random.jpg,714.00,true,Porsche,<p>Abaft Dress Changeable Wool 4675 XL-LawnGreen</p>,https://lifestyle-labels-production.myshopify.com/products/image/random.jpg,Over$100 | More than 100 left,
g/1243415576618,1243415576618,https://lifestyle-labels-production.myshopify.com/products/abandoned-convert-sedate-children-7825,AbandonedConvert Sedate Children 7825,https://lifestyle-labels-production.myshopify.com/products/image/random.jpg,414.00,true,Panasonic,<p>Abandoned Convert Sedate Children 7825 XXL-Plum</p>,https://lifestyle-labels-production.myshopify.com/products/image/random.jpg,Over$100 | More than 100 left,
11779434741802,1243415576618,https://lifestyle-labels-production.myshopify.com/products/abandoned-convert-sedate-children-7825?variant=11779434741802,AbandonedConvert Sedate Children 7825 XXL-Plum,https://lifestyle-labels-production.myshopify.com/products/image/random.jpg,414.00,true,Panasonic,<p>Abandoned Convert Sedate Children 7825 XXL-Plum</p>,https://lifestyle-labels-production.myshopify.com/products/image/random.jpg,Over$100 | More than 100 left,
g/1244939780138,1244939780138,https://lifestyle-labels-production.myshopify.com/products/abandoned-graduate-straight-rule-33425,AbandonedGraduate Straight Rule 33425,https://lifestyle-labels-production.myshopify.com/products/image/random.jpg,543.00,true,Red,<p>Abandoned Graduate Straight Rule 33425 XXL-Sienna</p>,https://lifestyle-labels-production.myshopify.com/products/image/random.jpg,Over$100 | More than 100 left,
11784535900202,1244939780138,https://lifestyle-labels-production.myshopify.com/products/abandoned-graduate-straight-rule-33425?variant=11784535900202,AbandonedGraduate Straight Rule 33425 XXL-Sienna,https://lifestyle-labels-production.myshopify.com/products/image/random.jpg,543.00,true,Red,<p>Abandoned Graduate Straight Rule 33425 XXL-Sienna</p>,https://lifestyle-labels-production.myshopify.com/products/image/random.jpg,Over$100 | More than 100 left,
Field matching in Shopify
For more information on limitations related to field matching and data synchronization, see Field matching and data synchronization.
Does order data include taxes when it is synchronized to Emarsys?
Order data does not contain taxes when it is synchronized to Smart Insight, Emarsys changed the sales data processing method on 10 March 2021, as a result, Emarsys synchronizes order data including all details (i.e. the price with and without tax and the delivery cost) and Smart Insight calculations use gross values. If it is required, you can set further purchase filters on the Smart Insight settings page.
I want to reload my sales data in Smart Insight. Can I do that without any preparation?
To successfully reload your sales data, when using the Shopify plug-in, please contact Emarsys Support first.