Product Catalogue

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

Overview
Product Data Fields
Multi-Region Product Support
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.

Product Data Fields

The following data fields are supported when importing product data. Ensure consistency in field naming and values.

Custom Field Mappings

Brands can customise how their product data fields map into the platform by updating the Custom field mappings within the Settings section.

This allows you to match Duel’s expected fields to the structure used in your own product catalogue.

Multi-Region Product Catalogues

To support region specific product variations, the region field allows multiple SKUs to be listed for the same product across different regions. Each SKU can include unique links, pricing, and language content.

Once region-specific entries are added to the product feed an Operator can select the appropriate region(s) from the Members > Group Profiles > eStore settings for the group profile they want to target.

This enables brands to manage multiple regional versions of a product within a single, unified feed.

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. 

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.