Create a Product Catalog Dataset Schema

This content is only for clients with the one-click DATASETS option in the top navigation bar. If you click DATASETS and see Product Data and Customer Data listed as menu options, then this content doesn't apply to your account. Instead, see the alternate version of this documentation.

The first step of uploading a new product catalog to Monetate is creating a product catalog schema. A schema is the organization or structure of the data in the product catalog and must be present in the platform before you send a full catalog file. It can consist of two or three lines of sample data and does not need to be a full product catalog file.

Follow these steps to create a product catalog schema.

  1. Click DATASETS in the top navigation bar, and then click CREATE DATASET.

    Animated demonstration of a user clicking DATASETS in the top navigation bar and then clicking the 'CREATE DATASET' button

  2. Select Product Catalog and then click NEXT.

    Step 1 of the Create Dataset Schema wizard, with the 'Product Catalog' option selected and a callout of the NEXT button

  3. Name the product catalog and then click NEXT.

    The name must begin with a letter and can contain only letters, numbers, and underscores.

    Step 2 of the Create Dataset Schema wizard, with a product catalog name input in the appropriate field and a callout of the NEXT button

  4. Drag and drop the file into the upload area, and then wait for the platform to validate the data.

    The file must be in the CSV or TSV format. All the attributes required by the product catalog specification must appear in the file header, with the attribute name matching the exact spelling and case. Each product must include all the required attributes. Optional attributes that you don't want to include can remain blank. See the product catalog specification for more information.

    • If no errors are detected, then click NEXT.

      Step 3 of the Create Dataset Schema wizard, with a validation success message

    • If the file is missing information, an error message appears stating what data is missing. Revise the file, click RE-UPLOAD, and then drag and drop the revised file into the upload area.

      Step 3 of the Create Dataset Schema wizard, with a validation error message and a callout of the 'RE-UPLOAD' button

  5. Confirm that any custom attribute that you included in the file appears in the table and that the data type selected is correct, and then click CONFIRM AND CREATE.

    Step 3 of the Create Dataset Schema wizard, with a callout of the custom attributes in a table, the data type for each, and a callout of the CONFIRM AND CREATE button

Once the product schema and catalog upload to the platform, the new product catalog's details page loads. The PENDING status appears at the top-right of the file updates table until the platform finishes processing the product catalog.

Callout of the PENDING status on the Update History tab of a product catalog dataset's details page

Once processing is complete, the status shows how much time as elapsed since the product catalog was updated both at the top right of the table and in the UPLOAD DATE column of that table. The number of rows in the processed file also now appears in the table.

Callout of the last update timestamp on the Update History tab of a product catalog dataset's details page

When you need to modify the product catalog, you can upload full or partial updates using one of these three methods: