Unless you're using the Shopify integration to connect your product feed directly, you'll need to prepare a file and manually upload it into your brand environment.
Before you begin
Know the questions and answers you will use for your experience and ensure they correspond to products and their differentiating qualities you'll add to the product feed.
Download the template
Navigate to Builder > Dynamic Product Feeds.
Click Add New Feed.
Select Download blank template.
Open the downloaded .CSV file.
Understand product feed requirements
Product feeds can be formatted in one of two ways:
Permutation-based: Each option is in a separate column. Every unique combination of options creates its own row.
Comma-separated values: All applicable options are listed in a single cell, separated by commas.
You must select one format and use that throughout the file.
When using comma-separated values within a field (Method 2), the formatting is critical. Inconsistent formatting, like capitalization differences (e.g., "Gluten-free" vs. "gluten-free"), will impact your ability to map the values once uploaded.
Required headers
The .CSV contains the following required headers.
ID: A unique alphanumeric identifier for each product (hyphens are not supported within the first hyphen).
Title: The product title that will be visible to customers.
Description: A product description that will be visible to customers. You may leave this blank if you will not display the description on your outcome screen.
Price: The product price that will be visible to customers. You may leave this blank if you will not display price on your outcome screen.
Redirect URL: The URL that the product will link to.
Image URL: The URL for the product image that will be visible to customers. Either add a URL from a hosting site or upload images to your media library and retrieve the image URL.
Brand: The brand of the product. Applicable if you have multiple brands, otherwise can be left blank.
Category: A category to which the product belongs. Optional, and allows you to display products as a group (like all products in a specific skincare regime.)
Important: Do not delete or reorder these headers. They are required and must remain in the exact order they appear when downloaded.
Custom headers
In addition to the required headers, you add custom headers. These act as the "filters" to match products to users responses in your experience. The values under each header will correspond to answers in the experience.
Prepare the feed
Add values for each required header you plan to utilize (note that you must add a unique value for the ID header). Add values based on the formatting style you'll use throughout the feed.
Add custom headers and their values. Pay special attention to the formatting of the feed. Inconsistent formatting, like capitalization differences (e.g., "Gluten-free" vs. "gluten-free"), will impact your ability to map the values.
Tip: If you're using a permutation-based file, we recommend applying filters to the headers and testing to see if the logic works as expected. When you add filters on the columns, you can pick and choose your responses, and you’ll see what product will show on the outcome screen.
Upload the product feed
Navigate to Builder > Dynamic Product Feeds.
Click Add New Feed.
Enter a name for your feed in the provided textbox.
Click on Upload new feed.
Follow the prompts to select and upload your .csv file.
Modify an existing product feed
Maintain feeds by modifying the file directly.
Navigate to Builder > Dynamic Product Feeds.
Click on the pencil icon associated with the feed you want to modify.
Select Download CSV.
Make edits.
Select Upload CSV to replace the existing feed with a new one.
Next steps
After uploading your product feed, test it to ensure accuracy.
FAQ
Do I need to include all eight required columns even if I won't use some of them?
Yes, all eight required columns must be present in your .csv file for successful upload. However, if you do not plan to display the data from certain columns (like "Price"), you can leave those values blank.
How do I generate a platform-approved image URL for my dynamic product feed?
Upload the image asset to your Media Library within the Jebbit platform. Right-click on the uploaded image and select "Open image in a new tab." Copy the URL from this new browser tab. Paste this URL into the appropriate column of your dynamic product feed.
My special characters are not displaying correctly. How can I fix this?
Special characters can cause issues with .csv files. Use the HTML version of the special character in your feed to ensure they display correctly. For example, use "é" instead of 'é'.
My product descriptions are very long. Can I shorten them?
Yes, when you have the Product Feed Display Container selected in the Screen Editor, you can check the Set Max Number of Lines option and specify the maximum number of lines to display for both the Product Title and Description.
How can I ensure the buttons in the Grid arrangement are aligned?
Select the Product Feed Display Container and check the Fix Button Alignment Vertically setting in the left-side menu.
Can I add line breaks or other formatting to the product details?
Yes, you can use HTML in your product feed, which Experiences by Jebbit will render. For line breaks, use the <br> tag.
Some of my product details (images, titles, etc.) are missing when I preview. What should I do?
First, verify that the values for the missing details were imported correctly in your product feed. It's possible that some cells for Image URL or Redirect URL, for example, might be blank.
Can I translate my Dynamic Product Feed?
Yes, when copying and translating a Jebbit campaign to a new language, you have the option to translate the associated product feed. You can select translation options, including formal or informal, and choose which variables to translate. The translated feed will be saved as a new product feed in your brand.
Why are some product images not displaying, or appearing as blank?
When uploading product images to the platform, ensure that the product name within the URL does not contain any parentheses
(). The platform's image source validation checks for these parentheses, which can cause the image to render as invalid and not display. As a best practice, always check product names for parentheses when uploading images to prevent this issue.