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: 039842

title

String (up to 200 characters)

A specific, relevant title for the item

Example: Brown

image_link

String (up to 2,000 characters)

The URL of the main image of the item. It should begin with https and follow RFC 2396 or RFC 1738.

Example: https://www.molocostore.com/100/bag.png

seller_id

String (up to 50 characters)

A unique seller/vendor ID. It is an Ad account ID for ad servicing & campaign management.

Example: 38840029

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: Moloco store

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.
KRW and JPY: Must be entered as whole numbers (integers). Including decimals for these currencies will cause the feed to be rejected.
Purpose: This price will be used for:

  • Selecting items within a specific price range for ads.
  • Ranking items based on their potential sales value in advertising.
    Missing Price: If the price field is left blank, your item may not be shown in ads.Examples:
    USD or EUR: 3.25
    KRW or JPY: 3000 (no decimals allowed)

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 > as a delimiter among depths and use; as a delimiter among multiple categories. Include the full path of the categories.

Examples:
Women>Clothing>T-shirts>V-neck
Coffee & Tea;Bakery
Men>Shoes>Running;Men>Shoes>Athletic>Track & Field

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:
in_stock, out_of_stock, preorder, backorder

When this field is set to out_of_stock the item can be added to new campaigns, but prevents the item from being advertised.

rating

Number (up to 4 characters)

The rating of the product.
Use a scale of 5 or 10.
Round it to one decimal place.
Always use a period (.) as the decimal point.

Example: 4.7

review_count

Number (up to 20 characters)

The number of product reviews (purchase reviews)

Example: 3850

brand

String (up to 70 characters)

The brand name

Example: Moloco

brand_id

String (up to 50 characters)

The brand id

Example: Moloco or 1AB234

location

String (up to 750 characters)

Locations where the product is eligible to sell. Provide the most specific product location possible from the list.
Use > as a delimiter among depths.
Use; as a delimiter among multiple locations.
Include the exact locations.
Include the full path of the location.

Example:
CA>Redwoodcity;CA>Menlopark
Seoul>Gangnamgu>Yeoksamdong

adult

String

Whether the item is not allowed for minors or contains adult content. It must be one of the following:
Y
N

created_time

String (up to 25 characters)

Created time of the item information.
The format should follow ISO 8601, such as the following:
YYYY-MM-DDThh:mm [+hhmm]
YYYY-MM-DDThh:mmZ

Example:
2023-02-24T11:07+0100

updated_time

String (up to 25 characters)

Last updated time of the item information.
The format should follow ISO 8601, such as the following:
YYYY-MM-DDThh:mm [+hhmm]
YYYY-MM-DDThh:mmZ

Example:
2023-02-24T11:07+0100

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: Sales Prohibited

link

String (up to 1,024 characters)

The link to your business’s website lets people learn more about or buy the item.
It should start with https.
It should formatted with RFC 2396 or RFC 1738.

Example:
https://www.molocostore.com/products/100

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.
It should start with https.
It should formatted with RFC 2396 or RFC 1738.

Example:
https://m.molocostore.com/products/100

additional_image_link

String (up to 1,024 characters)

Additional image URL for the item.
It should start with https.
It should formatted with RFC 2396 or RFC 1738.

Example:
https://www.molocostore.com/product/100/bag.png

shipping_charge

Number (up to 25 characters)

Shipping charge. Use the same format as the price field.

Example 16.00

reward_point

String (up to 100 characters)

Enter if reward points are paid when purchasing a product

Example: naverpaypoint^500

google_product_category

String (up to 750 characters)

Google product category.

Example
Apparel & Accessories > Clothing > Outerwear > Coats & Jackets or 371

item_group_id

String (up to 50 characters)

ID for a product group that comes in different versions (variants).

Example: 1234AB

color

String (up to 100 characters)

The main color of the item.

Example: Blue

gender

String

The gender your item is targeted towards. It must be one of the following values:
unisex
male
female

size

String (up to 100 characters)

The size of the item.

Example: XL

material

String (up to 200 characters)

The material the item is made from.

Example:
cotton
polyester\

denim 
 leather

pattern

String (up to 100 characters)

The pattern or graphic print on the item

Example:
Striped
Floral

condition

String

The condition of the item. You must use one of the following strings in lower case:
new
used
refurbished

age_group

String

The age group that the item is targeted towards. It must be one of the following:
all
adult
teen
kids
toddler
infant
newborn

class
(For Update Feed)

String

This field is only for the update feed.
Enter whether the item is new, updated, or sold out. It must be one of the following:
N - a new item.
U - an item to be updated with the provided information.
D - a deleted item. Only id and class fields are required.

delivery_option

String (up to 200 characters)

The delivery option that is offered for the item. It must be one of the following:
one_day
same_day
regular
dawn

is_bundle

String

Used if the item is sold in a bundle. It must be one of the following:
Y
N

gtin

String (up to 200 characters)

The Global Trade Item Number (GTIN) assigned by the manufacturer

Example: 1234560012

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: Seasonal, Holiday, Black Friday

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: Seasonal, Holiday, Black Friday

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: Seasonal, Holiday, Black Friday

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: Seasonal, Holiday, Black Friday

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: Seasonal, Holiday, Black Friday

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 theseller_id.

Example: 039842

title

Syntax (up to 200 characters)

A restaurant title. If the seller has only one restaurant, use the same value with seller_title.

Example: Brown

image_link

String (up to 2,000 characters)

Main image URL of the restaurant.
It should start with https.
The format should follow the RFC 2396 or RFC 1738.

Example:

        https://www.molocostore.com/100/bag.png

seller_id

String (up to 50 characters)

A unique seller/vendor ID. It is used as an Ad account ID in the MCM.

Example: 38840029

seller_title

String (up to 200 characters)

Name of seller/vendor. It is used as an Ad account title in the MCM.

Example: Moloco store

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 (.) as the decimal point, which only supports up to two decimal places.
For KRW and JPY, the value must be set as an integer.

Example:
3.25 (for USD or EUR)
3000 (for KRW or JPY)

category

String (up to 750 characters)

Categories of the restaurant. Provide the most specific restaurant category possible from the list.
Use > as a delimiter among the depths.
Use ; as a delimiter among multiple categories.
Include the most relevant categories.
Include the full path of the category.

Example:
Women>Clothing>T-shirts>V-neck
Coffee and Tea;Bakery
Snack>Coffee and Tea;Snack>Bakery

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:
in_stock, out_of_stock, preorder, backorder

When this field is set to out_of_stock the item can be added to new campaigns, but prevents the item from being advertised.

rating

Number (up to 4 characters)

The rating of the product in a numeric scale.
Use a scale of 5 or 10.
Round to one decimal place.
Always use the period (.) as the decimal point.

Example: 4.7

review_count

Number (up to 20 characters)

The number of product reviews (purchase reviews).

Example: 3850

brand

String (up to 70 characters)

The brand name.

Example: Moloco

brand_id

String (up to 50 characters)

The brand id.

Example: Moloco or 1AB234

location

String (up to 750 characters)

Locations where the product is eligible to sell. Provide the most specific product location possible from the list.
Use > as a delimiter among the depths.
Use ; as a delimiter among multiple locations.
Include the exact locations.
Include the full path of the location.

Example:
Seoul>Gangnamgu>Yeoksamdong
CA>Redwoodcity;CA>Menlopark

created_time

String (up to 25 characters)

Created time of the item information. The data format should follow the ISO 8601 following:
YYYY-MM-DDThh:mm[+hhmm]
YYYY-MM-DDThh:mmZ

Example: 2016-02-24T11:07+0100

updated_time

String (up to 25 characters)

Last updated time of the item information.The data format should follow the ISO 8601 following:
YYYY-MM-DDThh:mm[+hhmm]
YYYY-MM-DDThh:mmZ

Example: 2016-02-24T11:07+0100

delivery_fee_avg

Number (up to 25 characters)

The average delivery fee per week for each order.

Example: 16.00

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:
Enjoy Korean cuisine, experience various fusion dishes (Korean + Chinese, Korean + Japanese).

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.
It should start with https.
It should follow the format of RFC 2396 or RFC 1738.

Example: https://www.molocostore.com/products/100

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.
It should start with https.
It should follow the format of RFC 2396 or RFC 1738.

Example: https://m.molocostore.com/products/10

additional_image_link

String (up to 1,024 characters)

Additional image URL for the restaurant.
It should start with https.
It should follow the format of RFC 2396 or RFC 1738.

Example: https://www.molocostore.com/product/100/bag.png

delivery_charge

Number (up to 25 characters)

Minimum delivery(shipping) charge of the restaurant.
Use the same formatting as the average_order_value field.

Example: 16.00

menus

String (up to 20,000 characters)

List of all restaurant menus.
Use ; as a delimiter among multiple menus.

Example: Taco;Burrito;Coffee;Coke

reward_point

String (up to 100 characters)

Enter if reward points are paid when purchasing from the restaurant

Example: naver_pay_point^500

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:
one_day
same_day
regular
dawn

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: Seasonal, Holiday, Black Friday

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: Seasonal, Holiday, Black Friday

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: Seasonal, Holiday, Black Friday

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: Seasonal, Holiday, Black Friday

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: Seasonal, Holiday, Black Friday