Meta Pixel & Conversions API
Set up Meta Pixel tracking and Conversions API to measure ad performance and retarget users.
title: "Meta Pixel & Conversions API" description: "Send click data and server-side conversions to Meta (Facebook) to optimize ad campaigns."
Meta Pixel & Conversions API
Nimriz offers two ways to send data to Meta:
- Ad Pixel Tracking Interstitial: A brief, optional redirect page that fires the client-side Meta Pixel.
- Conversions API (CAPI): A server-side integration that securely forwards conversion events directly to Meta's Graph API.
These can be used individually or together to maximize match rates for your ad campaigns.
Setup Meta Pixel (Tracking Interstitial)
The Ad Pixel Tracking Interstitial serves a lightweight HTML page containing your Meta Pixel script before redirecting the user to their final destination. This adds approximately 1.5 seconds of latency but allows the client-side pixel to load and fire.
- Navigate to Settings > Integrations in the Nimriz dashboard.
- Click Add Integration Destination and select Ad Pixel (Interstitial).
- Set the Platform Type to Meta.
- Enter your Pixel ID (found in your Meta Events Manager).
- Ensure the Enable Tracking Interstitial toggle is checked.
- Click Create Destination.
Note: This interstitial behavior applies to plain web redirects. For links resolving to a deep-link mobile app fallback, the interstitial is skipped to preserve deep-linking fidelity.
Setup Meta Conversions API
The Conversions API (CAPI) runs entirely server-side, meaning it doesn't affect redirect speed. When Nimriz receives a conversion event (e.g., from your backend via the Nimriz API), it forwards the payload to Meta.
- In Meta Events Manager, go to Settings and generate a System User Access Token for the Conversions API.
- In Nimriz, navigate to Settings > Integrations.
- Click Add Integration Destination and select Meta Conversions API.
- Enter your Pixel ID.
- Paste the System User Access Token.
- Click Create Destination.
Once configured, any recorded conversions in your workspace will automatically be formatted and dispatched to Meta's Graph API.
Frequently Asked Questions
Does the interstitial affect SEO?
Since the tracking interstitial introduces a brief HTML page with a meta refresh, it may affect how search engine crawlers index the final destination compared to a standard HTTP 301/302 redirect. It is recommended primarily for ad campaign links where attribution is the primary goal.
What data is sent to the Conversions API?
Nimriz forwards the conversion event name, value, currency, and the user's IP address and User-Agent (where permitted by your privacy settings) to help Meta match the event to a user.
Can I override the interstitial per link?
Yes. When creating or editing a link, you can explicitly opt-in or opt-out of the tracking interstitial, overriding the workspace default.