Meta Pixel for Advantage+ Catalog Ads

Advantage+ catalog ads are dynamically created by populating an ad template with product information found in a data feed. This allows you to create thousands of ads without having to configure each of them individually. You can also use Advantage+ catalog ads to target visitors based on how they have interacted with your website in the past.

The general steps for creating Advantage+ catalog ads are:

  1. Set up conversion tracking for the specific standard events and their parameter object properties listed below, then
  2. Use the Commerce Manager to set up a Advantage+ catalog ad set that targets those events

Requirements

  • You must have a Facebook Page for the business that your Advantage+ catalog ads will apply to.
  • The Pixel base code must already be installed.
  • You must have access to the Facebook Ads Manager.

Learn more about connecting your Pixel to a commerce catalog with Blueprint.

Standard Events

Before you can set up Advantage+ catalog ads, you must first be tracking the following standard events. You must also include a parameter object with specific object properties with each tracked event.

Required EventRequired Object Properties

AddToCart

Either content_ids or contents

Purchase

Either content_ids or contents

ViewContent

Either content_ids or contents

Refer to the Object Properties section below to learn what values to assign to the required object properties.

Object Properties

content_ids

If you are using the content_ids property in your parameter object, its value should correspond to the product ID or product IDs associated with the action. IDs must match the IDs found in your product catalog. Values can be either single IDs, or an array of IDs.

For example, here's how to track a visitor who has added products with the IDs 201 and 301 to a shopping cart. The IDs match the IDs for those products in the product catalog.

fbq('track', 'AddToCart',
  // begin required parameter object
  {
    value: .5,
    currency: 'USD',
    content_ids: ['201', '301'] // required property, if not using 'contents' property
  }
  // end required parameter object
);

contents

If you are using the contents property in your parameter object, in a sub-object, you must include the id property, with the product ID or product IDs as its value, and include the quantity property with a number of product items being added to cart or purchased. IDs must match the IDs found in your product catalog. contents property value must be an array of objects.

For example, here's how to track a visitor who has added a product with the ID 301, and two products with the ID 401, to a shopping cart. The IDs match the IDs for those products in the product catalog.

fbq('track', 'AddToCart', {
  value: .5,
  currency: 'USD',
  contents: [
    {
      id: '301',
      quantity: 1
    },
    {
      id: '401',
      quantity: 2
    }],
});

Commerce Manager

Once you have confirmed that the Events Manager is tracking your standard events correctly, use the Commerce Manager to set up your product catalog and Advantage+ catalog ad template, and target the standard events. Follow our Create an Advantage+ Catalog Ad help document to do this.

After you complete all of the steps outlined in the document, be sure to use the Commerce Manager to verify that your catalog recognizes your Pixel's events as a data source.

Note that it can take up to 24 hours for the Commerce Manager's Events Data Sources tab to recognize your tracked events.