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:
Learn more about connecting your Pixel to a commerce catalog with Blueprint.
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 Event | Required Object Properties |
---|---|
| Either |
| Either |
| Either |
Refer to the Object Properties section below to learn what values to assign to the required 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 }], });
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.