Introduction
The Parent/Child catalog feature in Predict allows you to handle two-tier product structure. Previously, only flat product structure was supported in Emarsys, but currently, we are working on a solution that enables you to handle product catalogs containing product variants.
The Parent/Child catalog feature comes in handy when your product catalog contains items that belong to a product variant group (e.g., color variants of the same kitchen appliance). In this case, it is important to ensure that the data collection process (i.e. catalog processing, Web behavior data collection) takes the parent-child structure into account. Simultaneously, recommendations also have to take the product groups into consideration:
- Predict has to work with item data on SKU level and has to avoid displaying a variation of the same product in the recommendations (e.g., when a customer views a size S shirt, then the Predict recommendation should not show the size L version of the same shirt).
- Revenue attribution data and the Click Through Rate (CTR) have to be collected on SKU level.
- ABANDONED CART recommendation: variants have to be displayed with their proper links (instead of the item group’s link of an abandoned product).
The Parent/Child catalog feature also meets the following requirement:
- Providing maximum compatibility with Smart Insight
Terminology
Item group | Group | Parent | Product (Shopify) | Configurable product (Adobe Commerce) |
Variant | SKU-level item | Child | Product Variant (Shopify) | Product Variation (Adobe Commerce) |
Siblings | SKU-level items from the same group | Children of the same parent |
|
|
First-born child | Default variant | Oldest Child |
|
|
Use cases for two- or multi-tier product catalog structure and workarounds
You can use the Parent/Child catalog feature in the following cases:
- Attire: it is customer specific. For example: size (customers do not use variants for a different color version of the same T-shirt)
- FMCG: amount. For example: 50g/100g or six-pack/twin-pack/carton
- Consumer electronics: color variants.
- Product catalog updates campaigns: For more information, see What is the ideal product catalog structure for Product catalog updates campaigns?
The use cases mentioned above are never mixed with each other. Although you might get the impression that certain fashion retail sites use product/style-based product structure according to their navigational setup, however, different color shirts cannot be used as variants in product data.
Requirements
If you would like to use the Parent/Child catalog feature, then you need to fulfill the following requirements:
1. Currently, the feature supports only two-tier/layer product structure (e.g., size variations in retail OR color variations in electronics).
Three-tier/layer product structure (e.g. both color and size variations in retail) is supported only with a workaround including limitations. For more information, see Use cases for two- or multi-tier product structure and workarounds.
2. Your product data file and website structure have to meet the following requirements:
- Each Child product (SKU, variant) needs to have its own individual page on the website, including individual URLs that change dynamically when visitors click a variant on the UI.
- If you are using the Emarsys CSV format: the
group_id
column andparent item
row (per product) have to be added to the product data file.- This feature also works with standalone items; just add the item as its own parent (that is basically a duplication, except the parent item will have the g/id and the child a regular one).
The CSV formatting rules and guidelines also apply to your product data file. For more information, see:
- If you are using the Google Product Feed (GPF) format: the
item_group_id
field has to be populated.
Item IDs and group IDs are handled as a single pool by some of the product data file validation checks, therefore, the item IDs and group IDs should be unique, or "namespace clash" warnings will appear in Predict Data Sources > Product Data. Warnings will also appear in the detailed Health Status after Manage product data is clicked.
The standard GPF rules also apply to your product data file. For more information, see Product data specification.
3. Please contact your Client Success Manager to make sure that you are aware of the capabilities and limitations of the Parent/Child catalog feature.
If you have further questions, please contact your Client Success Manager.
Enabling the Parent/Child catalog feature
Enabling the feature for clients using the Emarsys plug-in for Shopify and Adobe Commerce
If you are using the Emarsys Shopify or Adobe Commerce plug-in, then the Parent/Child catalog feature is enabled automatically, so you don't need to turn it on.
Enabling the feature for clients using Google Product Feed (GPF)
Here is what you need to do to turn on the Parent/Child catalog feature:
1. Go to the Predict Data Sources page and click Manage product data.
2. On the Product Data Settings page, click Edit.
3. Turn on the Enable the Parent/Child Catalog Feature toggle and click Save.
Enabling the feature for clients uploading CSV files
If you upload your product catalog in CSV format, make sure to add the product group fields to your catalog. When you are ready with that, you have nothing else to do, your Predict recommendations will work based on the Parent/Child catalog feature.
Product catalog structure
Google Product Feed (GPF)
The GPF product catalog structure does not require further actions on your side. Predict generates a CSV file based on the provided GPF product catalog file and slightly modifies it (it adds a row for the parent items that the original GPF product catalog structure does not contain).
CSV upload
The Parent/Child product catalog structure is configured by Emarsys. The structure of the CSV file has to comply with the example in section Example product catalog.
If you are using the Emarsys plug-in for Shopify or Adobe Commerce
After Product Upload is turned on the UI, our service sets up your Predict account so that the upload configuration is hidden (catalog URL and scheduling). The service handles product catalog submissions as follows:
- It uploads the CSV catalogs to a given address.
- It triggers the Emarsys Platform that processes the product catalog.
The grouped_catalog
option is enabled in Predict, so it can handle parent/child relations between product entities (i.e. parent product and its variants in Shopify and configurable products and their configured simple product SKUs in Adobe Commerce).
Parent products
- The
item
field contains the ID/SKU with theg/
prefix. - The
group_id
field contains the ID/SKU in the product catalog. - For example:
-
item
:g/PRODUCT-SKU
-
group_id
:PRODUCT-SKU
-
Child products
- The
item
field contains the ID/SKU. - 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
-
Adobe Commerce
Simple products exist on their own in Adobe Commerce. In this case, two lines will be included: one that contains the product as a group and another where the product is the member of the group.
Product catalog examples
Here you can see two examples of product catalogs that contain parent-child and single products:
Important:
- Even single products should have a unique
item ID
. If theitem ID
is identical with thegroup_id
, then the following error message will be displayed: “Parse error: Namespace clash, same id is used for both variants and groups.” -
item ID
s may only contain letters, numbers, underscore and dash characters except for the special character in theg/
prefix that can be included in the parent identifier'sitem ID
.
Product in webshop (SKU) |
Lines in CSV |
||
---|---|---|---|
Parent/child products | item |
group_id | title |
T-shirt |
g/T-SHIRT |
T-SHIRT |
T-shirt |
T-shirt Blue L |
T-SHIRT-BL-L |
T-SHIRT |
T-shirt Blue L |
T-shirt Blue XL |
T-SHIRT-BL-XL |
T-SHIRT |
T-shirt Blue XL |
Single product |
item |
group_id |
title |
Sport Bag |
g/SPRT-BG |
SPRT-BG |
Sport Bag |
SPRT-BG |
SPRT-BG |
Sport Bag |
Product in webshop (SKU) |
Lines in CSV |
||
---|---|---|---|
Parent/child products | item |
group_id | title |
Manuka honey 500g |
g/1000 |
1000 |
Manuka honey 500g |
Manuka honey 500g |
1001 |
1000 |
Manuka honey 500g |
Manuka honey 1000g |
1002 |
1000 |
Manuka honey 1000g |
Manuka honey 1500g |
1003 |
1000 |
Manuka honey 1500g |
Single product |
item |
group_id |
title |
Honey Pot with Dipper |
g/2000 |
2000 |
Honey Pot with Dipper |
2000 |
2000 |
Honey Pot with Dipper |
This product catalog structure has been validated by Emarsys. Please make sure that you follow this structure. The Recommender can be configured to display simple products, groups or both. As a result, tracking events will contain products in the following format:
- View event:
PRODUCT-SKU
org/PARENT-PRODUCT-SKU
- For some use cases, like Abandoned Browse,PRODUCT-SKU
is needed. It is recommended to always send thePRODUCT-SKU
, to make your Web Extend events future-proof, even if you do not plan to build on these use cases currently. - Cart event:
PRODUCT-SKU
- Customers add configured products or variants to 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.
Product history
The product catalog contains every product that came from Shopify or Adobe Commerce. The plug-in stores every product and each sync starts with setting the product’s exists
flag to false
. The flag will be set to true
if the product is included in the sync again. This way, the product will be present in any product catalog but its availability
field will be set to false
if it does not exist anymore in Shopify and Adobe Commerce.
Multi-store Adobe Commerce instances
For more information on multi-store Adobe Commerce instances, please contact your Client Success Manager.
Adding single products to the product feed with parent-child structure
When you implement a product feed using the parent-child structure and it contains single products (e.g. a bag available in only one color and size), you can choose from the following options when you would like to add them to the product feed:
- You can add the product in two lines to the product feed:
Please use this option only if the parent ID (starting with the prefix g/
) is sent via the view Web Extend command.
a. The parent product is specified in the first line with the prefix g/
(e.g. g/shirt1234
) and its group_id
.
b. The child product is specified in the second line without the prefix g/
(e.g. shirt1234
) and with its group_id
.
- You can add the product in one line to the product feed without specifying the prefix
g/
(e.g.shirt1234
) and the product'sgroup_id
.
Please use this option only if the child ID is sent (without the prefix g/
) via the view Web Extend command.
Recommendations
Predict handles parent-child products in recommendations by using a filtering mechanism to keep the recommender modeling logic intact, robust and configurable. The recommended item list may contain SKU-level items (children) and groups (parents). The filtering mechanism filters out serially all siblings of each item from the list to avoid displaying items from the same group in the recommendation which would lead to a less desirable shopping experience.
You can see how the recommendations work in the following table:
Raw recommendation | Red T-Shirt size S | Red T-Shirt size L | Blue Pants size S | XYZ Fancy Bag Blue | Blue T-Shirt size S | Nice Pants | Some other thing | Fancy Bag | More recommendations |
Filtering | Keep and recommend | Remove (it belongs to the same group) | Keep and recommend | Keep and recommend | Keep and recommend | Remove (it belongs to the same group) | Keep and recommend | Remove (it belongs to the same group) | ... |
To check which recommendation widgets support the Parent/Child Catalog, see Predict Web and Email Recommender widgets supported by the Parent/Child catalog feature.
When a visitor views a product, the Parent/Child catalog feature captures only the parents. As a result, the RELATED recommendations will be fed only by parent products. It means that child products will disappear from the recommendations after a while (not immediately but the recommendation will update the models after several days depending on the traffic). As there are no new views for child products, they will disappear from the recommendations.
The effect of the Parent/Child catalog feature on Predict
When enabling the Parent/Child catalog feature, Predict is configured to use a grouped catalog and will work as expected (for more information on how post-filtering is applied to recommendations, see Recommendations) except for a few limitations. For more information on limitations, please contact your Client Success Manager.
Known issues and limitations
For more information on the limitations of the Parent/Child catalog feature, please contact your Client Success Manager.
Known issues:
- It is possible that instead of the expected three column recommendation format, you will see only a single recommended product.
This can be caused by:- A recently activated parent-child feature
- Singificant changes in the product catalog or its reload
If the product catalog is uploaded in the correct format, Predict will resolve the issue in 1-2 days on its own.
For more information, please contact your Client Success Manager.
FAQ
When is it recommended to turn on the Parent/Child catalog feature?
We recommend turning on the Parent/Child catalog feature if:
- You are using eCommerce platforms because this feature is essential due to the inherent two-tier product data structure.
- You are using Emarsys and Predict recommendations via the Shopify or Adobe Commerce plug-in where the product catalog structure is parent-child grouped by default.
Is it recommended to use the Parent/Child catalog feature with Tactics based on the view event?
Currently, we do not recommend using the Parent/Child catalog feature with Tactics that work based on the view
event (i.e. Price drop and Back in stock).
Which products are recommended by the POST_PURCHASE Email Recommender logic when it’s used with the Parent/Child feature?
Items are recommended based on the purchased child items. Among the recommended items, contacts can find both parent- and child-level items, however, multiple items belonging to the same parent are filtered out. If possible, Predict will recommend only child items.