Create a Facebook pixel

1. Go to your Pixels tab in Events Manager.
2. Click Create a Pixel.
3. To finish creating your pixel, click Create in the box that appears.

Add the Facebook pixel to your website

Once you've created your pixel, you're ready to put the Facebook pixel code on your website. Choose the statement below that best fits how you make updates to your website's code for instructions:

1. ViewContent, to track viewing a vehicle detail page.
2. Search, to track interest in vehicles.
3. AddToWishlist, to track vehicles that have been favourited/starred or have experienced an intention to purchase.

4. Lead, to track submission of a lead.

These events should be accompanied by specific parameters that provide additional, useful information. Note: Required and recommended parameters are listed in the chart below; for a complete list of parameters, visit our developers' site.

On each page, add the appropriate standard events. These standard events must be added exactly as described below, with no variations in spelling or case. Make sure that you're looking at the standard events for the type of inventory you're using; in this case, you'd use the standard events for vehicles.

Standard events

Event parameters

On each page, add the appropriate standard events. These standard events must be added exactly as described below, with no variations in spelling or case. Make sure that you're looking at the standard events for the type of inventory that you're using; in this case, you'd use the standard events for automotive.

The content ID reported from the Facebook pixel must correspond to the ID column from the catalogue. You can also send multiple product IDs per page by sending an array.

Refer to the developers' site for definitions and additional formatting requirements for pixel parameters and/or more details on adding these four custom data events.

Refer to our developer site for definitions and additional formatting requirements for pixel parameters.

Many tag management providers have integrated with Facebook to make it easier to set up Custom Audiences from your website and dynamic ads. Please contact your tag management partner directly to learn how to modify your tag to work with Facebook dynamic ads. You can also place the Facebook pixel code directly on your site.

The Facebook Pixel Helper helps you to confirm that your Facebook pixels are working as expected. Learn how to install the Facebook Pixel Helper.

Using Pixel Helper, you can confirm if a Facebook pixel has been added to your website, what standard events are on which pages (e.g. Event ID: ViewContent) and which content_ids are being reported by clicking View Event Log.

Common issues uncovered while testing your pixel

• Matching your catalogue to your Facebook pixel: If you receive an error stating that the pixel couldn't find a catalogue, you will need to fix your event sources in the catalogue settings. Associating your pixel or app tells Facebook which pixel or app will match which catalogue. To associate your pixel, navigate to the Settings page in Business Manager, click Product Catalogues, select your catalogue and click Associate Sources. Select the pixel or app that you would like to map to this catalogue. If a different team member created the catalogue and then placed the Facebook pixel, you may need to grant admin access (required) to add/update a catalogue's settings.
• Matching IDs used in feeds and pixels or SDK: If you receive errors stating that products didn't match, it is likely that the product IDs being sent via the pixel for content_ids didn't match products in your catalogue. The content ID reported from the Facebook pixel must be exactly the same as the corresponding ID column from the catalogue.
• Associate your pixel with your catalogue: If you've set up your dynamic ad for automotive and there is no spend going through, double-check that you've associated an event source group (the pixel) with your catalogue.

  To do this:
  1. In the assets menu, click on Product catalogues. Select your catalogue.
  2. Click on Catalogue settings in the top menu.
  3. At event sources, click on Edit.
  4. Assign pixels and apps to your catalogue.

You need a Facebook app ID to use the Facebook SDK for iOS, Android or JavaScript (web). You can use an existing app if you already have one. If you do not have an existing app, use our Quick start to create a new one. If you need help, follow our guide on how to register and configure an app.

You will need to add the SDK to your app. Learn more in our getting started guide.

Prior to adding the SDK to your app, read the section below to also integrate the required app events for dynamic ads.

To dynamically retarget your app users with relevant products, the same four required events must be added to your app.

For more details on adding these four custom data events, visit our developer site.

To ensure that your app events are being sent correctly, you can check your recent events in Facebook Analytics for Apps.

After you've added your pixel and events, you need to associate an event source group (the pixel) with your catalogue. If your setup includes multiple catalogues and pixels, make sure that you properly connect the right pieces together. You can match the pixels with the corresponding vehicle catalogue through Facebook Business Manager:

1. In the assets menu, click on Catalogues.
2. Select your catalogue.
3. Click on Catalogue settings in the top menu.
4. At event sources, click on Edit.
5. Assign pixels and apps to your catalogue.

Note: If you are a developer, visit Facebook for Developers for more information on associating your pixel with your catalogue via Business Manager or the API.