Facebook Product Feed

You specify whether to include products on a site in the Facebook product feed when you configure your Facebook product feed.

To specifically include or exclude a particular product from the product feed:

  1. Select site > Merchant Tools > Products and Catalogs > Products.
  2. Search for and select the product.
  3. To change the default for this product, click All Site Values.
  4. Specify the default value for this product for all sites.
  5. To change the default for this product on an individual site, unselect Use Default and select the value to use for that site.
  6. Click Apply.

The following fields can be included in the product feed for any item for sale on Facebook. The values in the Commerce Cloud Value column represent what is copied into your feed by default without custom code.

Note: Salesforce B2C Commerce doesn't uploads an empty Facebook catalog feed export file; the Facebook export logs indicate when the catalog feed export job resulted in an empty file. This can occur if no products are enabled for Facebook. Data from the catalog feed that were known to be invalid, for example, products missing a title, description, or images, are now included in the feed export file. The Facebook Business Manager product shows which data are missing from which products in the feed. The B2C Commerce export logs for the Facebook feed contains warnings about products missing data required by Facebook.
Note: To consistently import products, Facebook requires the quote (") characters in feed content, such as product names and descriptions, be doubled ("") and surrounded by single quotes. Commerce Cloud automatically does this for Facebook catalog feed exports.
Table 1. Catalog Feed
Facebook Column Commerce Cloud Value Description
id Product.getSKU() Unique identifier for this item Not customizable. Required.
availability

FacebookProduct.AVAILABILITY_PREORDER

FacebookProduct.AVAILABILITY_IN_STOCK

FacebookProduct.AVAILABILITY_IN_STOCK

Whether the item is in stock. Acceptable values are: in stock, out of stock, preorder, available for order, and discontinued. Required.
condition FacebookProduct.CONDITION_NEW Accepted values are new, refurbished, or used. Required.
description Product.getShortDescription() Falls back to master product value for variant with null value. Line breaks, tab characters, and HTML tags are removed. Required.
image_link Product.getImageModel().getImages(viewType).get(0)

null

viewType is the configured product_image_view_type in the Facebook configuration. If there is no image_link, the product is excluded from the catalog feed. Required.
additional_image_link Product.getImageModel().getImages(viewType)

null

viewType is the configured product_image_view_type in the Facebook configuration.
link Absolute URL to __SYSTEM__Facebook-ProductRedirect pipeline with parameter pid=Product.getSKU() Customer can customize the r parameter value, not the rest of the URL. Because an r parameter isn't provided by default the redirect is to Cart-Show. Required.
title Product.getName() Falls back to master product value for variant with null value. Required.
price Product.getPriceModel().getPrice().getValue()

null

The cost of the item and currency. Currency should be specified as the ISO 4217 currency code, for example, 9.99 USD. If the price is null, the product is excluded from the catalog feed. Required.
gtin Product.getUPC() The Global Trade Item Number (GTINs) can include UPC, EAN, JAN, and ISBN.

gtin, mpn, or brand is required.

mpn Product.getManufacturerSKU() The number which uniquely identifies the product to its manufacturer.

gtin, mpn, or brand is required.

brand Product.getBrand() The name of the brand.

gtin, mpn, or brand is required.

color Product.getVariationModel().getVariationValue(product, variationAttribute).getDisplayValue()

null

variationAttribute is the attribute with ID color_variation_attribute_id in the Facebook configuration. If color is null, the value is blank in the feed.
size Product.getVariationModel().getVariationValue(product, variationAttribute).getDisplayValue()

null

variationAttribute is the attribute with ID size_variation_attribute_id in the Facebook configuration. If size is null, the value is blank in the feed.
expiration_date Product.getValidTo() Expiration date of the product in the catalog. Optional.
gender null Acceptable values are male, female, and unisex.
item_group_id Product.getMasterProduct().getSKU()

null

If this item a variant of a product, all of the items in a group should share an item_group_id. If null, the value is blank in the feed. Optional.
google_product_category null Predefined values from Google's product taxonomy. For example, Apparel & Accessories > Clothing > Dresses. If null, the value is blank in feed. Optional.
material Product.getVariationModel().getVariationValue(product, variationAttribute).getDisplayValue()

null

The material or fabric that a product is made out of. If null, the value is blank in the feed. Optional.
pattern Product.getVariationModel().getVariationValue(product, variationAttribute).getDisplayValue()

null

The pattern or graphic print featured on a product. If null, the value is blank in the feed. Optional.
product_type  

Category path from child of root to product category:

Mens>Clothing>Shorts

If product is assigned to root category, its name alone is used:

Apparel

sale_price null
sale_price_effective_date null
shipping null
shipping_weight null
shipping_size null
custom_label_0 null
custom_label_1 null
custom_label_2 null
custom_label_3 null
custom_label_4 null

Related Links

Configuring Facebook Product Feed

Facebook Integration