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.
Link 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.
CSV link
If you already have a public CSV product feed link, you can directly use it in quizzes.
To connect a CSV product feed through a link:
- Choose CSV/TSV link 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.csv
.
XML link
If you already have a public XML product feed link, you can directly use it in quizzes.
To connect a XML product feed through a link:
- Choose XML link in the Product feed provider field of the product feed editor menu.
- Specify the path to the product element in the file in the Path to product field. The field is already field for Google feeds.
- Provide the publicly-accessible URL to your feed, for example
https://example.com/my-feed.xml
.
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 |
googleCategory | Source feed field: |
gender | Source feed field: |
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 product feed.
- 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 | 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 |
Impact
The supported feed provider option for Impact.
To connect an Impact product feed:
- Choose Impact in the Product feed provider field of the product feed editor menu.
- Provide the ID of your product feed (known as product catalog on Impact).
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: |
description | Source feed field: |
category | Source feed field: |
subcategory | Source feed field: |
product_type | Source feed field: Comma-separated advertiser categories |
brand | Source feed field: |
available | Source feed field:
|
age_group | Source feed field: |
gender | Source feed field: |
Rakuten Advertisting
The supported feed provider option for Rakuten Advertisting.
To connect an Rakuten Advertisting product feed:
- Choose Rakuten Advertisting in the Product feed provider field of the product feed editor menu.
- Provide the merchant ID associated with your product feed.
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 field.
- To only include products that contain a certain value, specify a search keyword in the Keyword search field. Every keyword has to be separated by a space and does not have to appear in the same order in the product information.
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: |
description | Source feed field: If the source field is empty, it will be the same as |
short_description | Source feed field: |
category | Source feed field: If the source field is empty, it will be the same as |
secondary_category | Source feed field: |
keywords | Source feed field: |
Prime Fashion Ads
The supported feed provider option for Prime Fashion Ads.
To connect an Prime Fashion Ads product feed:
- Choose Prime Fashion Ads in the Product feed provider field of the product feed editor menu.
- Provide the product feed ID associated with your product feed.
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
Artikelname
field containingbundles
.
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: If the source field is empty, it will be the same as |
title | Source feed field: |
image | Source feed field: |
link | Source feed field: If the source field is empty, it will be the same as |
price | Source feed field: Formatted product price If the source field is empty, it will be the same as |
price_as_number | Source feed field: If the source field is empty, it will be the same as |
description | Source feed field: |
category | Source feed field: |
secondary_category | Source feed field: If the source field is empty, it will be the same as |
available | Source feed field:
|
brand | Source feed field: |
gender | Source feed field: |
color | Source feed field: |
size | Source feed field: If the source field is empty, it will be the same as |
material | Source feed field: |
Ascend
The supported feed provider option for Ascend.
To connect an Ascend product feed:
- Choose Ascend in the Product feed provider field of the product feed editor menu.
- Provide the program ID associated with your product feed.
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
.
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 |
price_as_number | Source feed field: |
description | Source feed field: |
short_description | Source feed field: |
category | Source feed field: |
available | Source feed field:
|
features | Source feed field: |
functions | Source feed field: |
color | Source feed field: |
keywords | Source feed field: |
manufacturer | Source feed field: |
material | Source feed field: |