Update a Product Catalog

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

If you need to add or revise rows of product information within a product catalog, you can perform a partial update through the Data API, via SFTP, or by using the Upload Data wizard in the platform.

If you need to add columns, also called attributes or fields, to a product catalog, you can only use the Data API. You cannot use the Upload Data wizard nor use SFTP. See Update a Product Catalog via the Data API for the steps to use that method.

When using the Upload Data wizard, you can either drag and drop a file directly into the wizard, or you can input a URL to a dataset file that you store on Amazon S3. Regardless of which of these two upload options you select, the file that you use must be in the CSV or TSV format.

Uploading a File Directly

Follow these steps to add rows to or update existing rows in a product catalog by uploading a dataset file directly to Monetate.

  1. Click DATASETS in the top navigation bar, and then select Product Data.
  2. Click Product Catalogs in the left-hand category listing on the All Datasets list page.

    Callout of the 'Product Catalogs' entry in the left-hand category listing on the 'All Datasets' list page

  3. Find the product catalog dataset that you want to update, click the upload icon for its entry on the Product Catalogs list page, and then select Data File Upload.

    Callout of the 'Data File Upload' option in the menu of the upload icon for a product catalog entry on the Product Catalogs datasets list page

  4. Select Partial Update and then click NEXT.

    The 'Upload Data' wizard, with 'Partial Update' selected and a callout of the NEXT button

  5. Select Manual File Upload and then click NEXT.

    Step 2 of the 'Upload Data' wizard, with 'Manual File Upload' selected and a callout of the NEXT button

  6. Drag and drop the file that you want to upload into the wizard.

    Step 3 of the 'Upload Data' wizard, with a callout of the file upload field

Monetate ingests the file and closes the Upload Data wizard. When the product catalog's details page loads, a message briefly appears that informs you that the file was successfully uploaded. Additionally, PENDING appears where the timeframe of the last update normally appears since the update is in progress.

A product catalog's details page, with a callout of the file upload success message and a callout of the 'PENDING' status

If the file failed to upload or the platform encountered other errors, you see messages indicating the problem. See Failed Updates in this documentation for more information.

Uploading a File Using an Amazon S3 URL

Follow these steps to add rows to or update existing rows in a product catalog by uploading a dataset file using an Amazon S3 pre-signed URL.

  1. Generate the pre-signed URL for the file you want to upload.

    Refer to Sharing objects using presigned URLs in the Amazon Simple Storage Service (S3) user documentation for more information about generating a URL for this purpose.

  2. Click DATASETS in the top navigation bar, and then select Product Data.
  3. Click Product Catalogs in the left-hand category listing on the All Datasets list page.

    Callout of the 'Product Catalogs' entry in the left-hand category listing on the 'All Datasets' list page

  4. Find the product catalog dataset that you want to update, click the upload icon for its entry on the Product Catalogs list page, and then select Data File Upload.

    Callout of the 'Data File Upload' option in the menu of the upload icon for a product catalog entry on the Product Datasets list page

  5. Select Partial Update and then click NEXT.

    The 'Upload Data' wizard, with 'Partial Update' selected and a callout of the NEXT button

  6. Select Upload File Using Pre-signed S3 URL and then click NEXT.

    The 'Upload Data' wizard, with 'Upload File Using Pre-signed S3 URL' selected and a callout of the NEXT button

  7. Paste the Amazon S3 URL into the field, and then click FINISH.

    The 'Upload Data' wizard, with a callout of the Amazon S3 presigned URL input field and of the FINISH button

The Upload Data wizard closes and Monetate ingests the file. When the product catalog's details page loads, a message briefly appears that informs you that the file was successfully uploaded from the Amazon S3 URL. Additionally, PENDING appears where the timeframe of the last update normally appears since the update is in progress.

A product catalog's details page with a callout of the file upload success message and of the 'PENDING' status

If the file failed to upload or the platform encountered other errors, you see messages indicating the problem. See Failed Updates in this documentation for more information.

Monetate retains dataset files for 180 days from the date it was uploaded. During this time you can download files successfully uploaded to the platform as well as files that resulted in one or more upload errors from a product catalog's Update History tab. Once a file is out of this retention period, it still appears on the Update History tab of the dataset's details page, but you cannot download it.

Failed Updates

If the platform encounters an error with an update, you see UPDATE FAILED in multiple places within the platform:

  • In the LAST UPDATED column for the product catalog's entry on the All Datasets list page and the Product Catalogs list page

    Callout of the 'UPDATE FAILED' message for a product catalog on the Product Catalogs list page

  • In place of the last update's timeframe on the product catalog's details page

    Callout of the 'UPDATE FAILED' message on a product catalog's details page

In the UPLOAD DATE column of the Update History table, the exact date and time of the failed update appears in red.

Callout of the date and time in red text in the 'UPLOAD DATE' column of the 'Update History' table, indicating the update failed

Click that text to view the File Upload Error modal, which contains a brief description of all errors that prevented the platform from performing the update.

The File Upload Errors modal for a failed product catalog dataset update. The first error listed is the invalid NULL value for the required 'image_link' attribute for multiple rows in the dataset. The second error listed is the invalid NULL value for the required 'description' attribute for multiple rows in the dataset.

Refer to Common Product Catalog Validation Errors for more information about specific errors and how to correct them.