Skip to main content

How to Configure Meta Ads Conversion API (CAPI)

Updated today

The Conversion API Enhancer in WorkMagic allows you to send enriched customer and conversion data directly to Meta Ads (Facebook Ads). This improves event match quality, enhances campaign optimization, and ensures accurate attribution, even with browser tracking limitations.

This feature is still in Beta version, please contact your CSM to get your account whitelisted.

Why Use Conversion API Enhancer

The Meta Ads Conversion API Enhancer helps your campaigns perform more efficiently by:

  • Improving event match quality and data accuracy

  • Enhancing conversion attribution and ROAS optimization

  • Maintaining reliable data even with privacy restrictions

  • Reducing dependence on browser-based pixel tracking

What This Is For:

Its purpose is to improve Meta’s own event matching and optimization by giving the platform richer, more complete conversion data than what the Meta browser pixel alone can provide.

What This Is Not:

This is not a postback of WorkMagic-attributed events.

Events sent via CAPI Enhancer are raw, first-party conversions, not adjusted based on WorkMagic’s attribution models.

Step 1 - Connect Meta Ads

To begin, you need to connect your Meta Ads account.

  1. Go to Settings → Conversion API Enhancer.

  2. In the Platforms section, locate Meta Ads.

  3. Click Connect.

  4. Log in using your Meta Business account and grant the required permissions.

  5. Once the connection is successful, the status changes from Not connected to Connected.

    1. You’ll see the toggle enabled for Meta Ads.

Note: You must connect Meta Ads to activate the Conversion API Enhancer.

Step 2 - Configure Meta Pixel and Events

After connecting Meta Ads, configure your Meta Pixel and choose which events to send.

  1. Click Configure under the Meta Ads section.

  2. Select your Destination Meta Pixel from the dropdown menu.

  3. Choose the events you want WorkMagic to send to Meta, such as:

    1. Page View

    2. View Content

    3. Search

    4. Signup

    5. Add to Cart

    6. Initiate Checkout

    7. Add Payment Info

    8. Purchase

  4. If your store offers subscription products:

    1. Select Yes under “Do you offer subscription orders?”

    2. (Optional) Check Exclude recurring subscription orders to exclude repeat charges.

  5. Click Save and enable to activate data delivery to Meta Ads.

Tip: Select only the events relevant to your conversion funnel to maintain clean and actionable data.

Step 3 - Monitor Event Delivery

Once your setup is active, you can monitor event delivery and data health.

  1. Go to Settings → Conversion API Enhancer → Meta Ads → View Details.

  2. Review the Event Delivery Overview, which displays total event volume over time.

  3. Use the dropdown filter (top-right) to view delivery metrics for specific events.

  4. Scroll down to see the Event Delivery Summary, including:

    1. Total events sent

    2. Number of errors

    3. Last event timestamp

Note: Regularly monitor this section to confirm data delivery and identify potential tracking or permission issues early.

Platform Status States Explained

Each platform within the Conversion API Enhancer displays a status label to indicate its current connection or data flow state.

Status

Description

Action Required

Connected

The platform connection and event delivery function normally. Data is being sent to Meta as expected.

No action required.

Not Connected

The platform has not been connected yet. No data is being sent.

Click Connect and complete the Meta authentication process.

Need Reconnection

The connection to Meta has expired or lost authorization (e.g., token expired or permission revoked).

Click Reconnect to reauthorize your Meta account.

Pixel Deleted

The selected Meta Pixel no longer exists or was removed from your Meta Business account.

Select a new valid Pixel under the Configuration section and save.

Pixel Modified

The previously connected Pixel was changed or updated in Meta Business settings.

Review and confirm the new Pixel mapping, then click Save to re-enable delivery.

Did this answer your question?