Catalog feed

Suggest Edits

Moloco uses item metadata to create the campaign manager and train our machine-learning algorithms. Integration of catalog item metadata is delivered via a catalog feed. Prepare your catalog feed to synchronize seller and item information.

Update Feed

Two methods of catalog feed update exist – a Full Update Feed and an Incremental Update Feed.

  • Full Update Feed: You must prepare .csv or a compressed file (.csv.gz)with a list of all items in your marketplace and associated metadata. The compressed format is preferred.
  • Incremental Update Feed (Optional): If you would like to update ad items in your marketplace more frequently, you can use an incremental update feed in addition to your full update feed. It should include a subset of items in the full update feed. These items are either recent additions or updated or deleted items. To use the Incremental Update Feed, prepare a .csv or a compressed file (.csv.gz).

Full Update Feed (Required)

Full Update Feed is a feed file with an entire list of all items and metadata on your platform. It is typically updated at a designated time (e.g., Daily at 9 AM) daily because the feed file size is comparatively large. However, you may request more frequent daily updates (e.g., Daily every 4 hours) if the file size is less than 10 GB. You may also utilize the Incremental Update Feed for more frequent updates.

Feed URL

You must provide a dedicated catalog feed URL to which Moloco can access your catalog feed. Contact your Moloco representative to add a Moloco-trusted IP address to access the URL provided.

Feed Export Time

Specify the feed export schedule so the Moloco team schedules the import time accordingly.

  • Daily Once Example: every 4 am UTC
  • Daily Multiple Example: every 4 hours starting at 00:00 am UTC

Incremental Update Feed (Optional)

The Incremental Update Feed may contain additional class and update_time fields.

Feed URL

Provide the URL for the feed. Contact your Moloco representative to add a Moloco-trusted IP address to access the feed.

Feed Export Time

Specify a time to export the feed regularly. This must be more frequent than the update interval for your Full Update Feed. For example, update every hour between 1 a.m. and 1 p.m. UTC.

📘

Note

See the sample incremental update feed file here.

Catalog Feed Specifications

The catalog feed specifications vary depending on whether SSPI (Single Seller Per Item) or MSPI (Multi Seller Per Item).

SSPI (Single Seller Per Item) refers to a 1:1 relationship between a seller and an item, where each item identifier corresponds to just one seller. MSPI (Multiple Sellers Per Item) indicates a many-to-many (n:m) relationship, where a single item ID within the platform can be associated with several seller IDs, not restricted to a single seller.

Use the below specification guides to format your catalog feeds. Submitting your item data to Moloco in the correct format is important for creating successful ads. Moloco uses this information to ensure that ad campaigns can be managed with proper catalog item information.

Updated about 2 months ago