Product feeds
Learn how to connect a product feed to your quiz
Introduction
Product recommendations for quizzes are taken from your connected product feed. The product feed can be set either in the AI-generation quiz form or from the quiz editor's Product feed tab.
Product matching is done through the available product information, so try to include any relevant fields, such as a description, size, and color. For more information on product matching, refer to the product matchers guide.
JSON feeds
JSON link
If you already have a JSON product feed, you can directly use it in quizzes.
To connect a JSON product feed through a link:
- Choose JSON in the Product feed provider field of the product feed editor menu.
- Provide the publicly-accessible URL to your feed, for example
https://example.com/my-feed.json
.
We assume that the feed contains a list of products. If your products are nested inside of a specific field, specify it in the Product field key field.
Uploaded JSON feed
If you don't have a feed that fits any of the options on this page, you can upload a custom feed for your organization.
To upload a feed, click Feeds in the Organization section of the sidebar and then click New feed at the top of the page. You will be redirected to a new page where you can either manually create products or import them from a JSON, CSV, or XML file.
All products require at least an ID, title, and link field.
Once you have at least one uploaded feed, you can use it as a JSON feed in quizzes.
To connect a JSON product feed through an upload:
- Choose JSON in the Product feed provider field of the product feed editor menu.
- Click the search feed button to the right of the Custom URL field.
- Select your feed from the dropdown list.
Shopify feeds
If have a Shopify store, you can directly use its product feed in quizzes.
To connect a Shopify product feed:
- Choose Shopify in the Product feed provider field of the product feed editor menu.
- Provide the domain of your store, for example
https://example.com
.
If your quiz isn't relevant to the whole store, you can limit the feed to specific collections from the Shopify collection handles field.
By default only the base Shopify products are used in recommendations. If you want to split their variants into separate products, turn on the Use product variants switch.
Shopify feeds will not work on development stores, as they are not publicly accessible.
Affiliate feeds
If you have an affiliate program with one of our supported affiliate networks, you can directly its product feed.
You must accept Help Me Choose AI into your affiliate program to be able to use its affiliate feed.
Awin
The supported feed provider option for Awin.
To connect an Awin product feed:
- Choose Awin in the Product feed provider field of the product feed editor menu.
- Provide the ID of your product feed. Both legacy and enhanced feeds are supported.
For better control over the recommended products, you can filter products out of the feed:
- To only include products that contain a certain value, specify the original field name and a filter value in the Product filter field. Only products matching the filter will be used by the feed, for example products with a
description
field containingbundles
. - To remove duplicate products from your feed, specify a deduplication original field name in the Remove duplicate products by attribute field. If there are multiple products with the same value in that field, for example product variants with a duplicate
title
field, only the first product will be added to the feed.
The connected feed will be formatted to better fit Help Me Choose quizzes. You can see the feed format in the table below.
If you want to include additional fields from your original feed for product matching, add their names to the Custom attributes field in the feed editor.
Field name | Description | Supported feed |
---|---|---|
id | Legacy feed field: | Both |
title | Legacy feed field: | Both |
image | Legacy feed field: | Both |
large_image | Legacy feed field: | Only legacy |
additional_image | Legacy feed field: Not applicable | Only enhanced |
link | Legacy feed field: | Both |
price | Legacy feed field: Formatted product price | Both |
priceAsNumber | Legacy feed field: | Both |
description | Legacy feed field: | Both |
short_description | Legacy feed field: | Only legacy |
category | Legacy feed field: | Both |
category_name | Legacy feed field: | Only legacy |
product_type | Legacy feed field: | Both |
brand_name | Legacy feed field: | Both |
colour | Legacy feed field: | Both |
availability | Legacy feed field: Not applicable | Only enhanced |
available | Legacy feed field:
| Both |
keywords | Legacy feed field: | Only legacy |
fashion_size | Legacy feed field: | Both |
CJ Affiliate
The supported feed provider option for CJ Affiliate.
To connect a CJ Affiliate product feed:
- Choose CJ Affiliate in the Product feed provider field of the product feed editor menu.
- Provide the ID of your product feed.
The connected feed will be formatted to better fit Help Me Choose quizzes. You can see the feed format in the table below.
Field name | Description |
---|---|
id | Source feed field: |
title | Source feed field: |
image | Source feed field: |
link | Source feed field: |
price | Source feed field: Formatted product price |
priceAsNumber | Source feed field: |
brand | Source feed field: |
description | Source feed field: |
itemListName | Source feed field: |
customLabel0 - customLabel4 | Source feed field: |
condition | Source feed field: |
color | Source feed field: |
ageGroup | Source feed field: |
productType | Source feed field: Comma-separated product types |
material | Source feed field: |
pattern | Source feed field: |
size | Source feed field: |
sizeSystem | Source feed field: |
productHighlight | Source feed field: Comma-separated product highlights |
Soicos
The supported feed provider option for Soicos.
To connect a Soicos product feed:
- Choose Soicos in the Product feed provider field of the product feed editor menu.
- Provide the ID of your Soicos program.
If your quiz isn't relevant to the whole store, you can limit the feed to a specific category by providing a category ID in the Category ID field.
The connected feed will be formatted to better fit Help Me Choose quizzes. You can see the feed format in the table below.
Field name | Description |
---|---|
id | Source feed field: |
sku | Source feed field: |
title | Source feed field: |
image | Source feed field: |
alt_image | Source feed field: |
link | Source feed field: |
price | Source feed field: Formatted product price |
priceAsNumber | Source feed field: |
brand | Source feed field: |
category | Source feed field: |
description | Source feed field: |
gender | Source feed field: |
size | Source feed field: |
color | Source feed field: |
material | Source feed field: |
stock | Source feed field: |
Tradedoubler
The supported feed provider option for Tradedoubler.
To connect a Tradedoubler product feed:
- Choose Tradedoubler in the Product feed provider field of the product feed editor menu.
- Provide the ID of your Tradedoubler program.
- Provide the country of your Tradedoubler program.
For better control over the recommended products, you can filter products out of the feed:
- To limit products to a specific category, specify a category name in the Category name field.
- To only include products that contain a certain value in the title or description, specify a search term in the Search term field.
The connected feed will be formatted to better fit Help Me Choose quizzes. You can see the feed format in the table below.
Field name | Description |
---|---|
id | Source feed field: |
sourceId | Source feed field: |
title | Source feed field: |
image | Source feed field: |
link | Source feed field: |
price | Source feed field: Formatted product price |
priceAsNumber | Source feed field: |
description | Source feed field: |
category | Source feed field: |
tdCategory | Source feed field: |
brand_name | Source feed field: |
availability | Source feed field: |
language | Source feed field: |
[custom field] | Source feed field: Any custom fields that you have specified under the |