Updating Ads Catalog to Commerce Catalog

Our recommendation is to use one catalog instead of many for all uses cases like ads, Instagram shopping, Page Shop, Marketplace e-commerce, etc. By focusing on one catalog integration, you can more easily justify investing the required resources as it will be one catalog you can use across, instead of managing a set of catalogs for each use case, as well as a better user experience and easier management of ads and commerce.

We require few essential things for one catalog like complete inventory with variants, creatives, description, etc.

In commerce surfaces we show variant selectors based on the variant grouping. We recommend to group by all possible dimensions to maximize sales (color/size, size/style, etc.). If we group items only by size and not by color, each group of items needs to be tagged in a separate post/story, etc.

Your pixel can be setup to send events with either product or product group ids.

Options

If your current catalog has complete set of variants that we can sell you can upgrade an existing catalog at any time. Read how to update your catalog in option 1.

If you are missing some dimension like size or color you can still upgrade your catalog, but would need to change your pixel and catalog. We can help you migrate your pixel historical data when you are done with catalog update. Read how to update your catalog in option 2.

Prerequisites

  • You are running ads on Facebook.
  • You might be using automatic pixel updates.
  • You might be using localized catalog that has different country overrides.
  • You want to start selling on Facebook or Instagram using the onsite checkout.

1. Catalog has complete variant set

Current catalog has complete variant set already (color, sizes, styles). Current ads campaigns would not be affected by new checkout fields required for the onsite checkout.

We do not recommend to create multiple catalogs in the long run. Splitting your ads and commerce catalog will prevent you from running checkout ads campaigns and compare results.

Update your catalog following our guidelines.

1.1. Pixel sends only product ids

Pixel sends only product ids from existing catalog (example tshirt_black_S and not tshirt_black, or tshirt). This is the perfect commerce case, just follow commerce requirements. Add grouping to match common id for ALL variants. Follow partner steps section to upgrade catalog.

1.2. Pixel uses group id, grouping is based on all dimensions

Pixel sends product ids and main product group id for all variants from existing catalog (example tshirt_black_S and tshirt, but not tshirt_black). Same case as #1.1, catalog is ready to be upgraded to commerce. Follow partner steps section to upgrade catalog.

1.3. Pixel uses group id, grouping is based on one dimension

Pixel sends product ids and main product group id for all variants from existing catalog (example tshirt_black_S and tshirt_black, but not tshirt). We recommend to update your pixel to send only product ids and not group ids or send group id for common product for all variants. If you do not want to update pixel or lose the pixel events with these group ids, the only option for you is to keep grouping to one level only and have IG experience without two dimensional selector. Follow partner steps section to upgrade your catalog.

Partner steps

  1. Add google_product_category/commerce_tax_category to enable correct tax calculation and other required fields like extended description, rich_text_description, additional_image_link, inventory, etc. More info can be found here.
  2. Check validation messages for updated catalog upload in the catalog manager. Address issues that are related to onsite checkout.

2. Adding variants is required to sell

You current catalog has all data for items without some field that is required to sell the time (example: missing sizes). Your pixel sends either product ids or group ids.

You can upgrade your catalog to commerce only with help from Facebook team. Note that your current pixel setup sends partial data for all products and are not recommended way to setting up pixel. Update your catalog following our guidelines for variants update.

2.1. No groups

You have only one item from variant list:

2.2. Partial variants

You have few items from variant list:

Partner steps

  1. Update existing items to have proper variant group id (if they do not have one yet). Group by all dimensions (color/size, example of group_id: tshirt).
  2. Add variants as new items (variants that have all required for selling fields like size/color/etc.) and make sure that group ids are matching existing items group id (example: tshirt).
  3. Add google_product_category/commerce_tax_category to enable correct tax calculation and other required fields like extended description, rich_text_description, additional_image_link, inventory, etc. More info can be found here.
  4. Check validation messages for updated catalog upload in the catalog manager. Address issues that are related to onsite checkout for newly added items.
  5. Contact your Facebook representative to migrate your pixel signals. Only after this step is done you can go live with the checkout solution.

Commerce catalog nuances

  • Availability field is more powerful than inventory, if an item is out of stock with a positive inventory, item will be shown as sold out for onsite checkout and ads. If Item in in stock, but inventory is 0, then the product will be available for ads, but sold out for the checkout.
  • Products with launch date setup in future for Instagram checkout are not visible for ads campaigns.
  • We do not support multi country onsite checkout yet, main feed will be used for onsite checkout commerce details.