In this article, we will review the steps to set up the Facebook Pixel integration

Using the Permutive Facebook Pixel integration you can send rich cohort information over to Facebook for targeting. These audiences are passed to Facebook in real-time.

Adding the Integration

Before adding the Facebook Pixel integration, it's important to check that you have the Facebook Pixel live on your site.  Do this by searching for _fbq  in the console tab of the developer tools. If the following response is returned, the Facebook pixel is live.

If the below error message is returned, please refer to the Facebook implementation documentation and contact Facebook support if needed.

Once you've confirmed that you have the Facebook Pixel installed, setting up the integration can be completed in a few easy steps.

You can click this link to go directly to the integrations page or navigate from the Dash using the instructions below.

1. Visit the Permutive Dashboard and go to 'Settings > Integrations > + Add Integration'

2. Select 'Facebook Pixel' and you should then see this configuration screen:

3. Depending on the type of Facebook account that you have, you will need to select whether or not you have Core Setup or Non-Core Setup. This configuration will determine the type of pixel event that will be sent by the Facebook pixel. Your account administrator or your Facebook representative will be able to confirm what type of account you have.

Core Setup

If you have a Core Setup Facebook account, you will see two unique pixel events collected for every cohort: PermutiveSegmentEntry_<CohortCode> and PermutiveSegmentExit_<CohortCode>. For example, if a user is segmented into Permutive cohort 123, the following pixel event will fire: PermutiveSegmentEntry_123

Non-Core Setup

If you have a Non-Core Setup Facebook account, you will see two generalized pixel events for all cohorts — only one event named PermutiveSegmentEntry will represent all cohort entries and only one event named PermutiveSegmentExit will represent all cohort exists. An event property named segment_id stored within each of those generalized events will contain the Permutive cohort code.

4. Once you have selected your Facebook account type, click 'Add Integration' to add the Facebook Pixel.

The integration will be available for use in under 20 minutes. Once you've successfully added the integration, see this article for information about sending cohorts to Facebook.

Note: this integration works with multiple Facebook Pixels. Permutive will pick up whichever Facebook pixel is available on the page for the domain where it is running, so the integration works with multiple Pixel IDs. So for example https://www.sport.com/ has a pixel with an account ID which is different to the https://www.gamebyte.com/ account ID. Therefore, when a cohort in your project is sent to Facebook, the users who entered that cohort from https://www.sporf.com/ will be sent to the associated Facebook account, and those that entered the segment from https://www.gamebyte.com/ will be sent to the associated Facebook account.