Help Me Choose logoHelp Me Choose A.I.

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

If you already have a JSON product feed, you can directly use it in quizzes.

To connect a JSON product feed through a link:

  1. Choose JSON in the Product feed provider field of the product feed editor menu.
  2. 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:

  1. Choose JSON in the Product feed provider field of the product feed editor menu.
  2. Click the search feed button to the right of the Custom URL field.
  3. 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:

  1. Choose Shopify in the Product feed provider field of the product feed editor menu.
  2. 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:

  1. Choose Awin in the Product feed provider field of the product feed editor menu.
  2. 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 containing bundles.
  • 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.

Awin feed format
Field nameDescriptionSupported feed
id

Legacy feed field: merchant_product_id
Enhanced feed field: id

Both
title

Legacy feed field: product_name
Enhanced feed field: title

Both
image

Legacy feed field: merchant_image_url
Enhanced feed field: image_link

Both
large_image

Legacy feed field: large_image
Enhanced feed field: Not applicable

Only legacy
additional_image

Legacy feed field: Not applicable
Enhanced feed field: additional_image_link

Only enhanced
link

Legacy feed field: aw_deep_link
Enhanced feed field: aw_deep_link

Both
price

Legacy feed field: search_price
Enhanced feed field: price

Formatted product price

Both

priceAsNumber
price_as_number

Legacy feed field: search_price
Enhanced feed field: price

Both
description

Legacy feed field: description
Enhanced feed field: description

Both
short_description

Legacy feed field: short_description
Enhanced feed field: Not applicable

Only legacy
category

Legacy feed field: merchant_category
Enhanced feed field: google_product_category

Both
category_name

Legacy feed field: category_name
Enhanced feed field: Not applicable

Only legacy
product_type

Legacy feed field: product_type
Enhanced feed field: product_type

Both
brand_name

Legacy feed field: brand_name
Enhanced feed field: brand

Both
colour

Legacy feed field: colour
Enhanced feed field: color

Both
availability

Legacy feed field: Not applicable
Enhanced feed field: availability

Only enhanced
available

Legacy feed field: in_stock
Enhanced feed field: availability

true or false depending on in_stock being different from 0 or availability being different from out_of_stock.

Both
keywords

Legacy feed field: keywords
Enhanced feed field: Not applicable

Only legacy
fashion_size

Legacy feed field: Fashion:size
Enhanced feed field: size

Both

CJ Affiliate

The supported feed provider option for CJ Affiliate.

To connect a CJ Affiliate product feed:

  1. Choose CJ Affiliate in the Product feed provider field of the product feed editor menu.
  2. 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.

CJ Affiliate feed format
Field nameDescription
id

Source feed field: id

title

Source feed field: title

image

Source feed field: imageLink

link

Source feed field: linkCode.clickUrl

price

Source feed field: salePrice.amount

Formatted product price

priceAsNumber
price_as_number

Source feed field: salePrice.amount

brand

Source feed field: brand

description

Source feed field: description

itemListName

Source feed field: itemListName

customLabel0 - customLabel4

Source feed field: customLabel0 - customLabel4

condition

Source feed field: condition

color

Source feed field: color

ageGroup

Source feed field: ageGroup

productType

Source feed field: productType

Comma-separated product types

material

Source feed field: material

pattern

Source feed field: pattern

size

Source feed field: size

sizeSystem

Source feed field: sizeSystem

productHighlight

Source feed field: productHighlight

Comma-separated product highlights

Soicos

The supported feed provider option for Soicos.

To connect a Soicos product feed:

  1. Choose Soicos in the Product feed provider field of the product feed editor menu.
  2. 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.

Soicos feed format
Field nameDescription
id

Source feed field: id

sku

Source feed field: sku

title

Source feed field: name

image

Source feed field: img

alt_image

Source feed field: alt_image

link

Source feed field: url

price

Source feed field: price

Formatted product price

priceAsNumber
price_as_number

Source feed field: price

brand

Source feed field: brand

category

Source feed field: category

description

Source feed field: description

gender

Source feed field: gender

size

Source feed field: size

color

Source feed field: color

material

Source feed field: material

stock

Source feed field: stock

Tradedoubler

The supported feed provider option for Tradedoubler.

To connect a Tradedoubler product feed:

  1. Choose Tradedoubler in the Product feed provider field of the product feed editor menu.
  2. Provide the ID of your Tradedoubler program.
  3. 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.

Tradedoubler feed format
Field nameDescription
id

Source feed field: id

sourceId

Source feed field: sourceProductId

title

Source feed field: name

image

Source feed field: productImage.url

link

Source feed field: productUrl

price

Source feed field: priceHistory[0].price.value

Formatted product price

priceAsNumber
price_as_number

Source feed field: priceHistory[0].price.value

description

Source feed field: description

category

Source feed field: categories[0].name

tdCategory

Source feed field: categories[0].tdCategoryName

brand_name

Source feed field: brand

availability

Source feed field: availability

language

Source feed field: language

[custom field]

Source feed field: fields

Any custom fields that you have specified under the fields field will also be included under the same name.

On this page