> ## Documentation Index
> Fetch the complete documentation index at: https://funnelfox.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# How to set up Meta Pixel

> Detailed guide to configuring Meta (Facebook) Pixel in your FunnelFox project. Track events, conversions, and optimize your ad spend.

[Meta Pixel integration](/integrations/tracking/meta-pixel) sends events like `Purchase` and `CompleteRegistration`
to Facebook Events Manager, enabling better ad optimization on Instagram and
Facebook.

Conversions API additionally sends events directly from FunnelFox server to Meta, bypassing browser limitations. This guide walks you through the complete setup process.

<Info>
  We strongly recommend using Conversions API. If you're unsure whether you need it, read our guide on
  [why use Conversions API](/integrations/tracking/meta-pixel#use-conversions-api).
</Info>

## Set up Meta Pixel

Follow these steps to create a Meta dataset, get your Pixel ID, and connect it to FunnelFox.

### 1. Create data source

1. Go to [Meta Events Manager](https://www.facebook.com/events_manager2/).
2. Click **Connect data**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/a4E1ukF5R4c4vnV-/assets/connect-data.png?fit=max&auto=format&n=a4E1ukF5R4c4vnV-&q=85&s=6433042c1939c4f30a2b0c8661588800" alt="Connect data source" width="1920" height="879" data-path="assets/connect-data.png" />
</Frame>

3. Select **Web**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/a4E1ukF5R4c4vnV-/assets/connect-web.png?fit=max&auto=format&n=a4E1ukF5R4c4vnV-&q=85&s=c1c6fbd4f1366a111d32f5bce747a618" style={{ width: '550px', height: 'auto' }} width="759" height="705" data-path="assets/connect-web.png" />
</Frame>

4. Click **Create new dataset**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/iDp3eGYrVbx2mH4v/assets/new-dataset.png?fit=max&auto=format&n=iDp3eGYrVbx2mH4v&q=85&s=4c776a7a766d216b9967dd05c56a8a07" style={{ width: '550px', height: 'auto' }} width="744" height="341" data-path="assets/new-dataset.png" />
</Frame>

5. Name your dataset and uncheck the demo request.
6. Click **Create**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/a4E1ukF5R4c4vnV-/assets/dataset-name.png?fit=max&auto=format&n=a4E1ukF5R4c4vnV-&q=85&s=fd63e5b6e2d187ef7a25b6ca81cd694a" style={{ width: '550px', height: 'auto' }} width="745" height="500" data-path="assets/dataset-name.png" />
</Frame>

<Check>Your dataset is created. Follow the steps below to set up your integration.</Check>

### 2. Access your Pixel ID

1. Go to [Meta Events Manager > Data sources](https://business.facebook.com/events_manager2/list).
2. Select the Pixel (data source) you've created.

<Frame>
  <img src="https://mintcdn.com/funnelfox/ujK5e8gnyLf5x0Vr/assets/select-pixel.png?fit=max&auto=format&n=ujK5e8gnyLf5x0Vr&q=85&s=a71bfd2cb9915678a2ee12c0dcb106e5" alt="Data source" width="1920" height="879" data-path="assets/select-pixel.png" />
</Frame>

3. Copy the **Dataset ID** on the right or by going to the **Settings** tab for the data source.

<Frame>
  <img src="https://mintcdn.com/funnelfox/kKYLAt1422hstKox/assets/dataset-id.png?fit=max&auto=format&n=kKYLAt1422hstKox&q=85&s=f0bf7d2cc9d5564904b792dfdb5902b1" alt="Dataset ID" width="1920" height="879" data-path="assets/dataset-id.png" />
</Frame>

### 3. Apply Pixel ID in FunnelFox

1. Go to [Integrations > Meta Pixel](https://app.funnelfox.com/integrations/meta) in FunnelFox.
2. Paste your Dataset ID (Pixel ID) into the **Meta Pixel ID** field.
3. Click **Save changes**.

<Check>Meta Pixel event tracking is now active! Republish your funnels, or enhance tracking with the Conversions API by following the next section.</Check>

<Frame>
  <img src="https://mintcdn.com/funnelfox/CL6JlZm0xbv0vPRH/assets/paste-id.png?fit=max&auto=format&n=CL6JlZm0xbv0vPRH&q=85&s=f538e4a1da843a2c1d89e781868d3af3" alt="Meta Pixel ID" width="1920" height="879" data-path="assets/paste-id.png" />
</Frame>

## Set up Conversions API

<Info>To set up the Conversions API, you must be an [admin or developer](https://www.facebook.com/business/help/442345745885606) for the Meta business portfolio.</Info>

Conversions API provides server-side backup for browser events, bypassing browser limitations. Learn more about [Meta Pixel vs Conversions API](/integrations/tracking/meta-pixel#meta-pixel-vs-conversions-api).

Complete these steps after [setting up Meta Pixel](/integrations/tracking/set-up-meta-pixel-integration#setup-meta-pixel):

### 1. Start your setup

1. Go to [Meta Events Manager > Data sources](https://business.facebook.com/events_manager2/list).
2. Select your Pixel (data source).

<Frame>
  <img src="https://mintcdn.com/funnelfox/ujK5e8gnyLf5x0Vr/assets/select-pixel.png?fit=max&auto=format&n=ujK5e8gnyLf5x0Vr&q=85&s=a71bfd2cb9915678a2ee12c0dcb106e5" alt="Data source" width="1920" height="879" data-path="assets/select-pixel.png" />
</Frame>

3. Click **Start your setup** on the Conversions API notification.

<Frame>
  <img src="https://mintcdn.com/funnelfox/ujK5e8gnyLf5x0Vr/assets/start-setup.png?fit=max&auto=format&n=ujK5e8gnyLf5x0Vr&q=85&s=2ed2216940a879884d38c83042f30e45" alt="Start setup" width="1920" height="879" data-path="assets/start-setup.png" />
</Frame>

### 2. Choose setup method

1. Click **See other ways to setup**.
2. Select **Set up manually**.
3. Click **Next**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/ujK5e8gnyLf5x0Vr/assets/set-up-manually.png?fit=max&auto=format&n=ujK5e8gnyLf5x0Vr&q=85&s=510d5449856238897c4d3214de191c02" alt="Set up manually" width="1920" height="879" data-path="assets/set-up-manually.png" />
</Frame>

### 3. Configure setup options

1. Select **Conversions API and Meta pixel**.
2. Click **Next**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/a4E1ukF5R4c4vnV-/assets/capi-pixel.png?fit=max&auto=format&n=a4E1ukF5R4c4vnV-&q=85&s=a275a648474ede6c6e6828ce11be35c7" alt="Conversions API and Meta Pixel" width="1920" height="879" data-path="assets/capi-pixel.png" />
</Frame>

3. Click **Start CAPI setup**.
4. Click **Finish**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/iDp3eGYrVbx2mH4v/assets/finish.png?fit=max&auto=format&n=iDp3eGYrVbx2mH4v&q=85&s=84a1171927ec10d3305f12f3b303801b" alt="Finish" width="1920" height="879" data-path="assets/finish.png" />
</Frame>

### 4. Manual implementation

1. Click **Continue** under **Manual implementation overview**.
2. Checkmark **Events sent using pixel code**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/iDp3eGYrVbx2mH4v/assets/events-sent-pixel.png?fit=max&auto=format&n=iDp3eGYrVbx2mH4v&q=85&s=587eb54adf0bba39cca49776c907377f" alt="Events sent with pixel" width="1920" height="879" data-path="assets/events-sent-pixel.png" />
</Frame>

3. Select [all events to track with Conversions API](/integrations/tracking/meta-pixel#tracked-events) under **Additional events**.
4. Click **Continue**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/a4E1ukF5R4c4vnV-/assets/additional-events.png?fit=max&auto=format&n=a4E1ukF5R4c4vnV-&q=85&s=796eef9b8c09b7c6342f71e24729d089" alt="Additional events" width="1847" height="852" data-path="assets/additional-events.png" />
</Frame>

5. Click **Continue** under **Select parameters**.
6. Click **Continue** under **Review setup**.
7. Click **Continue** under **See instructions**.

You will see the **Using the Conversions API** page.

<Frame>
  <img src="https://mintcdn.com/funnelfox/ujK5e8gnyLf5x0Vr/assets/using-capi.png?fit=max&auto=format&n=ujK5e8gnyLf5x0Vr&q=85&s=eaa147d939fc3fbaad89b25e4bf87cc5" alt="Using the Conversions API" width="1920" height="879" data-path="assets/using-capi.png" />
</Frame>

### 5. Generate access token

1. Go to the **Generate an access token** section and select **Set up without Dataset Quality API**.

<Info>This guide covers the setup flow without Dataset Quality API, but you can select any option under **Generate an access token**.</Info>

2. Click **Generate Access Token**.

3. Copy the access token.

<Frame>
  <img src="https://mintcdn.com/funnelfox/iDp3eGYrVbx2mH4v/assets/generate-token.png?fit=max&auto=format&n=iDp3eGYrVbx2mH4v&q=85&s=e2e1fd722f19524c1ffbc6ded09d0812" alt="Generate token" width="1920" height="879" data-path="assets/generate-token.png" />
</Frame>

4. Click **Finish**.

### 6. Apply token in FunnelFox

1. Go to [Integrations > Meta Pixel](https://app.funnelfox.com/integrations/meta) in FunnelFox.
2. Paste your access token into the **Conversion API Access Token** field.
3. Click **Save changes**.

<Check>Conversions API is now active! Republish your funnels and [test event tracking](/integrations/tracking/set-up-meta-pixel-integration#test-your-integration).</Check>

<Frame>
  <img src="https://mintcdn.com/funnelfox/CL6JlZm0xbv0vPRH/assets/paste-capi.png?fit=max&auto=format&n=CL6JlZm0xbv0vPRH&q=85&s=0b9bd72436824e6e682ac16213e75375" alt="Paste token" width="1920" height="879" data-path="assets/paste-capi.png" />
</Frame>

## Test your integration

Verify that event tracking works correctly by sending test events from your funnel:

1. Go to [Meta Events Manager > Data sources](https://business.facebook.com/events_manager2/list).
2. Select your Pixel (data source).
3. Go to **Test events** for the data source.

<Frame>
  <img src="https://mintcdn.com/funnelfox/ujK5e8gnyLf5x0Vr/assets/test-events.png?fit=max&auto=format&n=ujK5e8gnyLf5x0Vr&q=85&s=f546ea38b9d2e7955b9471e41eb09f9f" alt="Test events" width="1920" height="879" data-path="assets/test-events.png" />
</Frame>

4. Open your published funnel and interact with it. Events will appear in the **Test events** tab.

<Frame>
  <img src="https://mintcdn.com/funnelfox/ujK5e8gnyLf5x0Vr/assets/test-meta.gif?s=b7d5b9ffca5e98d16dd73e5e195756cb" alt="Test events" width="1920" height="880" data-path="assets/test-meta.gif" />
</Frame>

### Test Conversions API

Ensure that Conversions API is set up and sending events properly.

To check the integration status:

1. Click **Manage integrations** from the **Overview** tab of your data source.

<Frame>
  <img src="https://mintcdn.com/funnelfox/iDp3eGYrVbx2mH4v/assets/manage-integrations.png?fit=max&auto=format&n=iDp3eGYrVbx2mH4v&q=85&s=10d1b3d408db6b0aecb465fd710e51e0" alt="Manage integrations" width="1688" height="765" data-path="assets/manage-integrations.png" />
</Frame>

2. Check the status under **Conversions API**. **Active** or **Waiting for first event** statuses indicate successful setup.

<Frame>
  <img src="https://mintcdn.com/funnelfox/a4E1ukF5R4c4vnV-/assets/capi-status.png?fit=max&auto=format&n=a4E1ukF5R4c4vnV-&q=85&s=dd1970ef4adbd689f7da387c08749b0c" alt="CAPI status" width="1920" height="879" data-path="assets/capi-status.png" />
</Frame>

To test Conversions API events:

1. Complete the registration step on your published funnel.
2. Go to the **Overview** tab for the data source.
3. You will see the **Complete registration** event marked **Multiple** in the **Integrations** column.

Hover it over to see it's sent via Conversions API.

<Frame>
  <img src="https://mintcdn.com/funnelfox/ujK5e8gnyLf5x0Vr/assets/test-capi.png?fit=max&auto=format&n=ujK5e8gnyLf5x0Vr&q=85&s=733290c2a26d10ec37e4a1bf359c8c63" alt="Test CAPI" width="1920" height="879" data-path="assets/test-capi.png" />
</Frame>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Events are not tracked or missing in Meta Events Manager">
    Even if your setup matches the steps above, events may still not appear. This can happen if Meta blocks traffic from your domain.

    To fix this, add both your FunnelFox project [custom domain](/dashboard/settings#domains) and
    `https://app.funnelfox.com/` to the **domain allow list** for Pixel traffic in [Meta Events Manager](https://business.facebook.com/events_manager2/).

    Learn more about [managing Meta Pixel traffic permissions](https://www.facebook.com/business/help/278125336598935).
  </Accordion>
</AccordionGroup>