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 for ad campaign measurement. Review your Meta setup, notices, legal basis, and consent requirements before enabling either path.
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).
- Enable the tracking interstitial only after confirming your campaign disclosure and consent flow where required.
- 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 fields configured for the action, such as event name, value, currency, click attribution identifiers where applicable, and redacted link context. Nimriz does not forward original IP addresses or complete User-Agent strings in the canonical server-side payload.
Standard privacy may include daily-salted pseudonymous hashes where supported. Strict privacy omits visitor hashes and selected granular fields such as city. You are responsible for confirming that Meta, your event mapping, and your campaign disclosures have the right legal basis and consent where required.
What should I avoid putting in campaign fields?
Do not place personal data, secrets, access tokens, or sensitive data in destination URLs, short-link paths, UTM fields, custom query parameters, pixel settings, or conversion payloads unless you have an appropriate basis and understand downstream processing.
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.
Related next steps
Ready to test this setup?
Create an account to try the workflow, or compare plans when the setup needs higher limits, integrations, or team controls.