Catalogs

Introduction

An item catalog is a prerequisite for creating and using recommendations. It is a comprehensive list of all your business offerings with their relevant details, such as products, services, flights, articles properties, restaurants, dishes, and social media feeds.

Catalog

The Catalog feature allows you to create and manage item catalogs. You can connect their item catalog to MoEngage and utilize the item information in their campaigns.

Create Catalog

To create an item catalog, follow these steps:

  1. Go to Content > Catalogs from the left navigation. The Catalogs page is displayed.
  2. Click Create Catalog.
  3. In the Enter catalog name field, enter a name for the catalog.
  4. Click Create.

After creating the item catalog, you can start populating it with item information using feeds.

Feeds

Feeds act as the data source for item information in the catalog. Feeds allow you to upload, update, or sync item information. They contain a set of items fetched or uploaded from a source.

info

Note

Whether you have a single feed for all items or multiple feeds for different purposes, MoEngage offers the flexibility to fulfill your specific requirements.

Types of Feeds

Feeds provide detailed attributes of the items, such as ID, title, link, and image link. The following are the feed options:

  1. Manual Upload: The manual upload option in the Catalog feature allows marketers to upload a CSV file containing item listings. This method is suitable for situations where marketers want to perform a one-time upload of their item information.
  2. URL Upload: Marketers can establish a connection with their external catalog and sync it with MoEngage by defining the catalog source URL. This enables timely synchronization and updates of relevant item attribute information. With options such as daily, weekly, or hourly intervals, marketers can ensure their item information remains up-to-date in MoEngage, making it ideal for almost real-time or frequent updates to the item catalog.

Adding Feeds to Catalogs

To add feeds to catalogs, follow these steps:

  1. Go to Content > Catalogs from the left navigation. The Catalogs page is displayed.
  2. Click the Add feed button for the desired catalog.

  3. Choose one of the following feed upload options:
    1. Manual upload: To manually upload a CSV file, select the Manual upload option. Select the CSV file containing your item listings.
    2. URL upload: To sync your catalog file, define the file source URL of your catalog. MoEngage supports CSV, TSV, and XML files with any HTTP, HTTPS, FTP, and SFTP connection URL. You can choose from daily, weekly, or hourly sync options to keep your item information up-to-date in MoEngage.
warning

Warning

MoEngage expects the following mandatory attributes with every feed:

  • id
  • title
  • link
  • image_link

Feed Upload States

After you add a feed to a catalog, the feed upload action can have the following states:

  • Success: The Feed is uploaded successfully and is available for use in the Catalog.
  • Pending: The Feed is currently being processed.
  • Processed with Error: There are some errors with some of the items in the uploaded feed. The feed is uploaded partially.
  • Error: There was an error during the feed upload, and the feed is not uploaded.

After you upload a Feed to the Catalog, its name becomes hyperlinked. Clicking this link opens the Feed contents in a new browser tab, where you can view the item details of some sample lists of items.

Feed_Details.gif

Catalog Update Alerts [Early Access]

The alert management system meticulously tracks catalog updates, instantly updating marketers about the status of updates. It issues notifications for completed updates and provides insightful error messages for any failures. These error messages are critical in maintaining data quality and facilitating issue resolution. The catalog update alerts can be triggered for feed processing success or failure:

  • Whenever a feed file is successfully processed, the system sends an email indicating the completion of the process. Importantly, it includes detailed statistics about the processed items, such as the count of newly added, updated, or deleted items. Additionally, in instances where some items could not be processed, the system generates a report with the unprocessed items count and its primary reasons.
  • In case of any failure in processing, the alert management system provides error messages. These messages are important because they explain what went wrong during the file processing, thereby providing insight to help rectify the issue.

You can subscribe for the catalog update alerts from the Manage Alerts option in the catalog page.

Manage Alerts

  1. Go to Content > Catalogs from the left navigation. 
  2. Click the specific catalog you wish to configure update alerts for.
  3. In the catalog page, click Manage alerts at the top section. The Catalog update alerts pop-up window is displayed.
  4. In the Email address field, set up the desired email addresses to subscribe for the update alerts. Please ensure to press Enter after adding each email address. You can configure a maximum of 50 email addresses.
  5. Under Notify on, mark the checkboxes corresponding to the desired alerts type based on the preference.
  6. Click Save to save the subscription preferences.

Any feed processing undertaken after the 'Save' action will automatically trigger the stipulated email alerts to the subscribed email addresses.

info

Note

When you create a new catalog, your email address will be automatically subscribed for catalog update alerts. To modify these subscription preferences, visit the 'Manage alerts' section at the top section of the catalog page.

FAQs

arrow_drop_down What is the maximum number of items, catalogs, and feeds an account can have?

An account can have a maximum of one million items for a monthly tracked user (MTU) of less than one million or an account can have a maximum of five million items for an MTU of less than five million.
An account can have a maximum of 30 catalogs in an account.
A catalog can have a maximum of 200 feeds. There is no limit to the items a feed can have but the dashboard only displays 200 items in a feed.

arrow_drop_down Which feed file format types are supported?

We support feeds in CSV, TSV, and XML(RSS-compliant) formats.

arrow_drop_down What is the maximum number of columns a feed can have?

We support feeds having a maximum of 50 columns.

arrow_drop_down What is the maximum size of a feed that can be uploaded manually?

We support manual feed upload of file sizes up to 64MB.

arrow_drop_down What happens if my feed URL server is down?

The system makes an attempt every 10 minutes to fetch the feed and stops after five failed attempts.

arrow_drop_down Is there any limitation with respect to column names?

We do not support the period or dot operator in the column names.

arrow_drop_down Which types of feed URLs are supported?

We support feed upload via HTTP, HTTPS, FTP, or SFTP URLs.

arrow_drop_down Can we use Google Sheets to update Feeds?

Yes, we do support the upload of Feeds through Google Sheets.

1. Select Feed update through the Scheduled URL option

2. Keep the URL public in Google sheet sharing settings.

3. Add the Google sheet with the URL params as export?format=csv. For example https://docs.google.com/spreadsheets/d/Google_Sheet_ID/export?format=csv

Previous

Next

Was this article helpful?
1 out of 1 found this helpful

How can we improve this article?