Back to BlogTechnical

What Is CAPI and Why Every Advertiser Needs It

CAPI sends conversion data server-to-server, bypassing ad blockers and cookie restrictions. Here's what it is, how it works, and why you need it.

Go Funnel Team7 min read

CAPI in One Sentence

CAPI (Conversions API) is a server-to-server connection that sends your conversion data directly from your web server to ad platforms, bypassing the browser-based pixel.

That's it. No browser involvement. No JavaScript dependency. No ad blockers in the way. Your server talks directly to Meta's servers (or Google's, or TikTok's) and says: "This user just bought something. Here's the hashed data to match them."

The result: you recover 20-35% of conversions that browser-based tracking misses, and your ad platform's optimization algorithms get better data to work with.

Why CAPI Exists

Browser-based pixels (the Meta pixel, Google tag, TikTok pixel) were the standard conversion tracking mechanism for 15+ years. They worked well when browsers freely allowed third-party tracking. That era is over.

The pixel failure points:

  • Ad blockers: 32% of desktop users block tracking scripts. When the pixel doesn't load, the conversion is invisible.
  • Safari ITP: JavaScript-set cookies expire after 7 days. Users who click an ad on Monday and buy on the following Tuesday (Day 8) look like new visitors.
  • iOS ATT: 75% of iOS users opt out of cross-app tracking, reducing the pixel's ability to match conversions to ad interactions.
  • JavaScript failures: Script conflicts, Content Security Policy blocks, and single-page app routing issues cause silent tracking failures in 3-5% of sessions.

CAPI was Meta's response to these losses. Google followed with Enhanced Conversions. TikTok built its own Events API. The underlying principle is the same across platforms: when the browser can't reliably track, move tracking to the server.

How CAPI Works (Step by Step)

The Flow

  1. User converts on your website. They complete a purchase, fill out a lead form, or take whatever conversion action you're tracking.

  2. Your server processes the event. Your backend records the transaction. At this point, you have the conversion data (event type, value, currency) and user data (email, phone, shipping address) in your own system.

  3. Your server sends an API call to the ad platform. The call includes:

    • Event name (Purchase, Lead, AddToCart, etc.)
    • Event timestamp
    • Hashed user data (SHA-256 hashed email, phone, name, address)
    • Event data (revenue value, currency, order ID)
    • Event ID (for deduplication with the pixel)
  4. The ad platform matches the event. Meta takes the hashed email and matches it against its user database. If the hash matches a Facebook/Instagram user who interacted with your ad, the conversion is attributed to that ad.

  5. Deduplication occurs. If the pixel also fired (for non-ad-blocked users), the matching event IDs tell the platform to count it as one conversion, not two. The platform merges data from both sources, keeping the richest data set.

What Gets Sent (and What Doesn't)

You control exactly what data is sent through CAPI. The minimum useful event includes:

Required:

  • Event name
  • Event time
  • At least one user identifier (hashed email is the most effective)

Recommended for better matching:

  • Hashed email (SHA-256)
  • Hashed phone number
  • Hashed first and last name
  • City, state, zip code, country (hashed)
  • External ID (your user ID)
  • Client IP address
  • Client user agent

Event data:

  • Purchase value and currency
  • Content IDs (product SKUs)
  • Content type
  • Number of items

Never sent: Raw (unhashed) personal data. All personal identifiers must be SHA-256 hashed before transmission.

The Impact of CAPI on Ad Performance

CAPI doesn't just improve measurement -- it improves actual campaign performance. Here's why:

More Conversion Data = Better Optimization

Ad platform algorithms optimize based on conversion signals. Every conversion the platform observes helps it identify patterns: which users convert, which placements work, which time of day performs. When 30% of conversions are invisible (lost to ad blockers and privacy restrictions), the algorithm learns from an incomplete picture.

CAPI fills those gaps. More observed conversions mean more accurate optimization signals, which mean better targeting and lower CPAs.

Meta's published benchmarks: Advertisers implementing CAPI alongside the pixel see an average 13% reduction in cost per result. Individual results range from 8-25%, with the highest improvements for advertisers who had the worst tracking coverage before CAPI.

Better Audience Quality

When CAPI captures conversions the pixel missed, those conversions feed into:

  • Lookalike audiences: Built on a more complete customer list
  • Retargeting audiences: Include ad-blocked visitors who would otherwise be missed
  • Exclusion audiences: More accurately exclude existing customers from prospecting

More Accurate Reporting

With CAPI filling tracking gaps, the discrepancy between platform-reported and actual conversions shrinks. You still won't get a perfect match (platform attribution mechanics still cause some inflation), but the gap narrows from 30-50% to 10-25%.

Implementation Options

Option 1: Platform Partner Integrations

The fastest path for ecommerce brands:

Shopify: Built-in CAPI integration through Shopify's settings. Navigate to Settings > Customer Events > Meta, enable server-side tracking. Takes 15 minutes.

WooCommerce: Meta's official WooCommerce plugin includes CAPI configuration. Install the plugin, connect your Meta account, enable CAPI.

Third-party tools: Elevar, Littledata, and Stape offer pre-built CAPI integrations for major ecommerce platforms with enhanced data quality features.

Pros: Fast setup, managed maintenance, automatic updates Cons: Less control, potential data quality limitations, monthly cost

Option 2: Google Tag Manager Server-Side

For brands using GTM:

  1. Set up a GTM server-side container (hosted on Google Cloud or another provider)
  2. Configure the Meta CAPI tag in the server container
  3. Route conversion events from your browser-side GTM to the server container
  4. The server container sends events to Meta's CAPI endpoint

Pros: Centralized management, visual configuration, multi-platform support Cons: Hosting cost ($50-200/month), some reliance on browser-side event collection

Option 3: Direct API Integration

For brands with development resources:

Write backend code that calls Meta's Graph API when conversion events occur. This gives you maximum control and the highest data quality.

Meta CAPI endpoint: POST https://graph.facebook.com/v19.0/{PIXEL_ID}/events

The API call includes an array of events, each with user data, event data, and metadata. Your backend code generates the hashed identifiers, constructs the payload, and sends it.

Pros: Maximum data quality and control, no third-party dependencies Cons: Requires development resources (20-40 hours), ongoing API maintenance

Event Match Quality: The Metric That Matters

After implementing CAPI, the single most important metric to monitor is Event Match Quality (EMQ) in Meta's Events Manager.

EMQ measures how well Meta can match your server events to Facebook/Instagram users. It's scored on a 1-10 scale:

| EMQ Score | Interpretation | Typical Match Rate | |-----------|---------------|-------------------| | 1-3 | Poor -- missing key identifiers | 15-30% | | 4-5 | Below average -- need more data | 30-50% | | 6-7 | Good -- solid implementation | 50-70% | | 8-10 | Excellent -- optimal data quality | 70-90% |

How to improve EMQ:

  1. Send email with every event (biggest single impact)
  2. Add phone number when available
  3. Include first name, last name (helps disambiguate common emails)
  4. Send geographic data (city, state, zip)
  5. Pass external_id (your internal user ID)
  6. Send client IP address and user agent (helps match anonymous sessions)

Most well-implemented CAPI setups achieve EMQ of 6-8. Getting above 8 requires high email capture rates and multiple identifiers per event.

Common CAPI Mistakes

Mistake 1: Forgetting deduplication. Without matching event IDs between pixel and CAPI, every conversion is counted twice. Double your reported conversions overnight. Always pass the same event_id in both the pixel fire and the CAPI call.

Mistake 2: Sending unhashed data. Personal data must be SHA-256 hashed before sending. Sending raw email addresses violates both Meta's policies and privacy regulations.

Mistake 3: Not normalizing before hashing. "John@Gmail.com" and "john@gmail.com" produce different SHA-256 hashes. Always lowercase and trim whitespace before hashing. Remove phone number formatting (parentheses, dashes, spaces).

Mistake 4: Setting it and forgetting it. CAPI can break silently -- API token expiration, server errors, data format changes. Monitor daily event volume and set up alerts for drops greater than 20%.

Mistake 5: Only sending Purchase events. CAPI supports the full event funnel: PageView, ViewContent, AddToCart, InitiateCheckout, Purchase. Sending upper-funnel events through CAPI gives the platform more optimization signals.

Frequently Asked Questions

Do I still need the Meta pixel if I implement CAPI?

Yes. Meta recommends running both pixel and CAPI simultaneously (with deduplication). The pixel provides real-time event data with rich browser context (referrer URL, screen size, etc.). CAPI fills the gaps where the pixel fails. Together, they provide the most complete data set. The pixel also handles events that are harder to send server-side (like PageView and ViewContent for every page load) while CAPI ensures high-value events (Purchase, Lead) are never missed.

How long does CAPI take to impact campaign performance?

Expect 2-4 weeks for the optimization impact to materialize. In the first week, you'll see improved event tracking and potentially higher reported conversions (as CAPI captures what the pixel missed). By weeks 2-4, Meta's algorithm begins incorporating the improved data into its optimization models, leading to better targeting and gradually lower CPAs. The full impact typically stabilizes by week 6-8 as the algorithm fully adjusts to the improved signal quality.

Does CAPI work for lead generation, not just ecommerce?

Absolutely. CAPI supports Lead, CompleteRegistration, SubmitApplication, and custom events alongside ecommerce events. For lead gen, the key difference is that you're typically sending the lead's email and phone number (which they provided on your form) through CAPI, which usually provides high match quality since the data is fresh and directly provided by the user. Lead gen advertisers often see even higher EMQ scores than ecommerce because form submissions naturally collect rich identity data.


Go Funnel uses server-side tracking and multi-touch attribution to show you which ads actually drive revenue. Book a call to see your real numbers.

Want to see your real ROAS?

Connect your ad accounts in 15 minutes and get attribution data you can actually trust.

Book a Call

Related Articles