SSPI Catalog feed specification
Note
There are two options for SSPI (Single Seller Per Item) catalog feeds, Common and Delivery. The Common Catalog Feed is designed for general e-commerce usage, while the Delivery Catalog Feed is tailored for food and grocery delivery companies.
Common catalog feed
The Common Catalog Feed guide is designed for commerce and marketplace platforms. For food and restaurant delivery, see the Delivery catalog feed guide.
This guide will help you format your catalog feed information to optimize your Retail Media Business, including sponsored ads and recommendations powered by Moloco. By submitting your item data in the correct format, you can ensure that Moloco effectively matches your products with the right queries, maximizing the success of your ads. Whether you're a large-scale marketplace or a growing commerce platform, this guide will provide the essential steps to create successful ads and drive your business forward.
Required fields
The following fields are required for each item in your catalog. If any required fields are missing or formatted incorrectly, items may not upload to your catalog and may be unavailable for ad serving.
Field | Data Type | Note |
---|---|---|
id | String (up to 50 characters) | A unique identifier for the item Example: |
title | String (up to 200 characters) | A specific, relevant title for the item Example: |
image_link | String (up to 2,000 characters) | The URL of the main image of the item. It should begin with Example: |
seller_id | String (up to 50 characters) | A unique seller/vendor ID. It is an Ad account ID for ad servicing & campaign management. Example: |
seller_title | String (up to 200 characters) | Name of seller/vendor. It is used as an Ad account title for ad servicing & campaign management. Example: |
price | Number (up to 25 characters) | Item unit price Format: Decimal number with a period (.) as the decimal point. Up to two decimal places are supported.
|
sale_price | Number (up to 25 characters) | Item unit price after discounts. If the item is not discounted, set this equal to the ‘price’ value. The format is same as that of price field. |
category | String (up to 750 characters) | Category of the product. Choose the most granular categories that describe the item. Use Examples: |
Recommended fields
The following fields are recommended to boost ad performance or filter out undesirable results.
Field | Data Type | Note |
---|---|---|
availability | String | The current availability of the item. You must use one of the following: When this field is set to |
rating | Number (up to 4 characters) | The rating of the product. Example: |
review_count | Number (up to 20 characters) | The number of product reviews (purchase reviews) Example: |
brand | String (up to 70 characters) | The brand name Example: |
brand_id | String (up to 50 characters) | The brand id Example: |
location | String (up to 750 characters) | Locations where the product is eligible to sell. Provide the most specific product location possible from the list. Example: |
adult | String | Whether the item is not allowed for minors or contains adult content. It must be one of the following: |
created_time | String (up to 25 characters) | Created time of the item information. Example: |
updated_time | String (up to 25 characters) | Last updated time of the item information. Example: |
Optional fields
You can also include many optional fields to share more item information with customers or control how items are displayed.
Field | Data Type | Note |
---|---|---|
description | String (up to 5,000 characters) | A short, relevant description of the item. Example: Lightweight fabric and a relaxed cut. A comfortable jacket that slips on like a shirt. |
blocked | String (up to 50 characters) | Use this field to block items from advertising while keeping them in the catalog feed. If it contains any text, the item can’t be added to new campaigns, and existing campaigns will exclude it from advertising. This field should explain why the item is blocked, otherwise leave this field empty. Example: |
link | String (up to 1,024 characters) | The link to your business’s website lets people learn more about or buy the item. Example: |
mobile_link | String (up to 1,024 characters) | The mobile link to your business’s website lets people learn more about or buy the item. Example: |
additional_image_link | String (up to 1,024 characters) | Additional image URL for the item. Example: |
shipping_charge | Number (up to 25 characters) | Shipping charge. Use the same format as the Example |
reward_point | String (up to 100 characters) | Enter if reward points are paid when purchasing a product Example: |
google_product_category | String (up to 750 characters) | Google product category. Example |
item_group_id | String (up to 50 characters) | ID for a product group that comes in different versions (variants). Example: |
color | String (up to 100 characters) | The main color of the item. Example: |
gender | String | The gender your item is targeted towards. It must be one of the following values: |
size | String (up to 100 characters) | The size of the item. Example: |
material | String (up to 200 characters) | The material the item is made from. Example:
|
pattern | String (up to 100 characters) | The pattern or graphic print on the item Example: |
condition | String | The condition of the item. You must use one of the following strings in lower case: |
age_group | String | The age group that the item is targeted towards. It must be one of the following: |
class | String | This field is only for the update feed. |
delivery_option | String (up to 200 characters) | The delivery option that is offered for the item. It must be one of the following: |
is_bundle | String | Used if the item is sold in a bundle. It must be one of the following: |
gtin | String (up to 200 characters) | The Global Trade Item Number (GTIN) assigned by the manufacturer Example: |
custom_label_0 | String (up to 200 characters) | Label that you assign to items to help organize bidding and reporting in sponsored ad campaigns. Example: |
custom_label_1 | String (up to 200 characters) | Label that you assign to items to help organize bidding and reporting in sponsored ad campaigns. Example: |
custom_label_2 | String (up to 200 characters) | Label that you assign to items to help organize bidding and reporting in sponsored ad campaigns. Example: |
custom_label_3 | String (up to 200 characters) | Label that you assign to items to help organize bidding and reporting in sponsored ad campaigns. Example: |
custom_label_4 | String (up to 200 characters) | Label that you assign to items to help organize bidding and reporting in sponsored ad campaigns. Example: |
Delivery catalog feed
The Delivery Catalog Feed is tailored specifically for food and grocery delivery companies. This comprehensive guide will assist you in formatting your catalog feed information to optimize your Retail Media Business with the power of Moloco. By submitting your restaurant/grocery data in the correct format, you can ensure that Moloco matches your delivery-related stores with relevant queries, enhancing the performance of your sponsored ads and recommendations. Whether you specialize in food delivery, grocery services, or both, this guide will provide the necessary steps to optimize your Delivery Catalog Feed and achieve success in the competitive delivery market.
Required fields
The following fields are required for each item in your catalog. If any required fields are missing or formatted incorrectly, items may not upload to your catalog and can be missing from your ads.
Field | Data Type | Note |
---|---|---|
id | String (up to 50 characters) | A unique restaurant ID. If the seller has only one restaurant, use the same value as the Example: |
title | Syntax (up to 200 characters) | A restaurant title. If the seller has only one restaurant, use the same value with seller_title. Example: |
image_link | String (up to 2,000 characters) | Main image URL of the restaurant. Example:
|
seller_id | String (up to 50 characters) | A unique seller/vendor ID. It is used as an Ad account ID in the MCM. Example: |
seller_title | String (up to 200 characters) | Name of seller/vendor. It is used as an Ad account title in the MCM. Example: |
average_order_value | Number (up to 25 characters) | Average order value (AOV) of the restaurant. Format the price as a number. Always use a period ( Example: |
category | String (up to 750 characters) | Categories of the restaurant. Provide the most specific restaurant category possible from the list. Example: |
Recommended fields
The following fields are recommended to boost ad performance or filter out undesirable results.
Field | Data Type | Note |
---|---|---|
availability | String | The current availability of the item. You must use one of the following: When this field is set to |
rating | Number (up to 4 characters) | The rating of the product in a numeric scale. Example: |
review_count | Number (up to 20 characters) | The number of product reviews (purchase reviews). Example: |
brand | String (up to 70 characters) | The brand name. Example: |
brand_id | String (up to 50 characters) | The brand id. Example: |
location | String (up to 750 characters) | Locations where the product is eligible to sell. Provide the most specific product location possible from the list. Example: |
created_time | String (up to 25 characters) | Created time of the item information. The data format should follow the ISO 8601 following: Example: |
updated_time | String (up to 25 characters) | Last updated time of the item information.The data format should follow the ISO 8601 following: Example: |
delivery_fee_avg | Number (up to 25 characters) | The average delivery fee per week for each order. Example: |
Optional fields
You can also include many optional fields to share more item information with customers or control how items are displayed.
Field | Data Type | Note |
---|---|---|
description | String (up to 5,000 characters) | A short, relevant description of the restaurant. Example: |
link | String (up to 1,024 characters) | The link to the restaurant’s specific page on your business’s website where shoppers can learn more about the restaurant. Example: |
mobile_link | String (up to 1,024 characters) | The mobile link to the restaurant’s specific page on your business’s website where shoppers can learn more about the restaurant. Example: |
additional_image_link | String (up to 1,024 characters) | Additional image URL for the restaurant. Example: |
delivery_charge | Number (up to 25 characters) | Minimum delivery(shipping) charge of the restaurant. Example: |
menus | String (up to 20,000 characters) | List of all restaurant menus. Example: |
reward_point | String (up to 100 characters) | Enter if reward points are paid when purchasing from the restaurant Example: |
delivery_option | String (up to 200 characters) | The delivery option that the Platform offers for the restaurant. It must be one of the following values: |
custom_label_0 | String (up to 200 characters) | Label that you assign to items to help organize bidding and reporting in sponsored ad campaigns. Example: |
custom_label_1 | String (up to 200 characters) | Label that you assign to items to help organize bidding and reporting in sponsored ad campaigns. Example: |
custom_label_2 | String (up to 200 characters) | Label that you assign to items to help organize bidding and reporting in sponsored ad campaigns. Example: |
custom_label_3 | String (up to 200 characters) | Label that you assign to items to help organize bidding and reporting in sponsored ad campaigns. Example: |
custom_label_4 | String (up to 200 characters) | Label that you assign to items to help organize bidding and reporting in sponsored ad campaigns. Example: |
Updated about 1 month ago