Product Catalogue

Learn about product catalogues, their uses and how to set them up

Overview
JSON Feed
CSV Manual Upload
What Products to Use
History
Settings

Overview

In order for Duel to generate UGC Galleries and enable product tagging within the platform, it is necessary to have a product catalogue. A product catalogue serves as a central repository of information about your products, allowing Duel to retrieve and display relevant product details.

When logged into the Duel Dashboard > head to settings (top right dropdown) > Product Catalog 

JSON Product Feed

A JSON feed is best if your product catalogue changes frequently, the catalogue is updated daily. This approach ensures flexibility, scalability, and compatibility across different platforms.

Below is the JSON Schema that outlines the required structure and data types:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "sku": {
            "type": "string",
            "description": "The unique stock-keeping unit (SKU) for the product."
          },
          "name": {
            "type": "string",
            "description": "The product name as it should appear in campaigns."
          },
          "description": {
            "type": "string",
            "description": "A detailed description of the product, including features and benefits."
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "A direct URL to the product page on your eCommerce store."
          },
          "srcImg": {
            "type": "string",
            "format": "uri",
            "description": "A direct URL to the product image. The image should be in a web-friendly format (JPEG, PNG, or WebP)."
          },
          "price": {
            "type": "string",
            "description": "The product price, represented as a string to maintain formatting consistency."
          },
          "currency": {
            "type": "string",
            "description": "The currency code (e.g., USD, EUR, GBP) following the ISO 4217 standard."
          }
        },
        "required": ["sku", "name", "url", "srcImg"]
      }
    }
  },
  "required": ["items"]
}

CSV Manual Upload

A manual generation and upload process is required to update the catalogue, this can work if your product catalogue does not change very often. 

Data Field Mappings 

The following data fields are supported 

Examples

• JSON Feed
• CSV

What Products to Use?

Duel has the capability to support both ParentIDs and SUKs, but it is important to carefully consider and choose the best setup for your brand. It can be challenging to switch approaches once implemented, so it is advised to make the right choice from the beginning. There are primarily two approaches to consider:

1. Use of ParentIDs
2. Use of SKUs

This choice will effect two main areas:

UGC Galleries

The choice will effect what shows on product display pages.

1. ParentIDs: Various colours will be mixed up together in the UGC gallery.
2. SKUs: Colours will be specific for the SKU selected in the UGC Gallery.

 

Product Tagging

Any decisions you make in the product catalogue will also effect how end-users interact with the platform, including when they product tag and when they view the products featured in UGC.

 

History 

In the history tab, you have the ability to view all activities, updates, and any potential errors that may occur for troubleshooting purposes. This feature allows you to easily track and monitor the progress and performance of your product catalogue.

Settings

Brands have the ability to customise the default field mappings in the settings section. Changing the target field to what their catalogue shows.