Meta Pixel Tracking Setup

Meta Ads Pixel & Conversions API

by gmmh1 · MIT license

Meta Ads Pixel & Conversions API cover

Set up and troubleshoot Meta Pixel and Conversions API (CAPI) tracking, including deduplication and event match quality. Triggers on 'set up Meta Pixel', 'Conversions API setup', 'my Meta conversions aren't tracking', 'event match…

---
name: meta-ads-pixel-capi
description: "Set up and troubleshoot Meta Pixel and Conversions API (CAPI) tracking, including deduplication and event match quality. Triggers on 'set up Meta Pixel', 'Conversions API setup', 'my Meta conversions aren't tracking', 'event match quality is low', or 'iOS 14 tracking issues'. Prerequisite for any conversion-optimized Meta campaign."
---

# Meta Ads Pixel & Conversions API

> **Currency & scope note (last reviewed 2026-07-19):** Platform mechanics referenced here (character limits, campaign-type names, feature availability, thresholds, benchmark figures, policy specifics) reflect general practice as of the review date above and are **not guaranteed current** — ad platforms change quickly. Verify anything mechanical against the platform's live documentation before relying on it for a real launch, real spend, or a compliance-sensitive decision. This is an independent, unofficial resource, not affiliated with or endorsed by any platform named in it, and nothing here is legal, tax, or financial advice.

## Purpose
Get Meta Pixel and server-side Conversions API (CAPI) tracking installed, deduplicated, and reporting with good event match quality — without this, Advantage+/conversion-optimized campaigns are working blind, and every other Meta skill in this library is building on unreliable data.

## Trigger Conditions
- "Set up Meta Pixel for my website"
- "Set up Conversions API"
- "My Meta conversions aren't tracking / numbers look wrong"
- "My event match quality score is low"
- "iOS tracking issues with Meta Ads"

Overview

Set up and troubleshoot Meta Pixel and Conversions API (CAPI) tracking, including deduplication and event match quality. Triggers on 'set up Meta Pixel', 'Conversions API setup', 'my Meta conversions aren't tracking', 'event match quality is low', or 'iOS 14 tracking issues'. Prerequisite for any conversion-optimized Meta campaign.

What you get

  • Event tracking plan (event, trigger, parameters) mapped to business goals
  • CAPI integration status and method
  • Deduplication verification status
  • EMQ score and specific improvement recommendations
  • Test Events verification confirmation, or list of unresolved issues
Manual install (npx, ZIP)
Claude Codenpx skills add gmmh1/claude-paid-media-skills --skill meta-ads-pixel-capi -g -a claude-code
Claude Code (degit)npx degit gmmh1/claude-paid-media-skills/skills/meta-ads-pixel-capi#main ~/.claude/skills/meta-ads-pixel-capi
Claude.ai / desktopZip the folder and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md6.0 KB
Read SKILL.md here
gmmh1/main1 file shown
SKILL.md
Show the full text75 lines

Meta Ads Pixel & Conversions API

Currency & scope note (last reviewed 2026-07-19): Platform mechanics referenced here (character limits, campaign-type names, feature availability, thresholds, benchmark figures, policy specifics) reflect general practice as of the review date above and are not guaranteed current — ad platforms change quickly. Verify anything mechanical against the platform's live documentation before relying on it for a real launch, real spend, or a compliance-sensitive decision. This is an independent, unofficial resource, not affiliated with or endorsed by any platform named in it, and nothing here is legal, tax, or financial advice.

Purpose

Get Meta Pixel and server-side Conversions API (CAPI) tracking installed, deduplicated, and reporting with good event match quality — without this, Advantage+/conversion-optimized campaigns are working blind, and every other Meta skill in this library is building on unreliable data.

Trigger Conditions

  • "Set up Meta Pixel for my website"
  • "Set up Conversions API"
  • "My Meta conversions aren't tracking / numbers look wrong"
  • "My event match quality score is low"
  • "iOS tracking issues with Meta Ads"

Required Inputs

  • Website platform/CMS (affects deployment method: GTM, native e-commerce platform integration, custom implementation)
  • Conversion events to track (Purchase, Lead, AddToCart, ViewContent, CompleteRegistration, custom events)
  • Whether CAPI is already partially set up (many ecommerce platforms offer native CAPI integrations that need only configuration, not custom development)

Core Capabilities

Pixel Setup
  • Base pixel code and standard event tracking (PageView, ViewContent, AddToCart, InitiateCheckout, Purchase, Lead) mapped to actual business conversion points
  • Deployment via Google Tag Manager (coordinate with google-tag-manager if the business already uses GTM for other tracking) or native platform integration
  • Custom conversions and custom events for goals standard events don't cover
Conversions API (Server-Side)
  • CAPI as the server-side complement to the browser pixel, sending the same events from the business's server — critical for resilience against browser tracking restrictions, ad blockers, and iOS App Tracking Transparency limits on browser-side signal
  • Native platform CAPI integrations (available on most major ecommerce platforms) as the fastest path — custom server-side implementation only where no native integration exists
  • Value-based events (passing actual order value) for ecommerce, not flat conversion counting
Deduplication
  • Sending both pixel and CAPI events for the same conversion requires deduplication (matching event_id/event_name/event_time) so Meta counts it once, not twice — misconfigured dedup silently inflates reported conversions and corrupts optimization
  • Verifying dedup status in Events Manager before trusting combined pixel+CAPI data
Event Match Quality (EMQ)
  • EMQ score reflects how well Meta can match incoming events to real users — driven by how much matching customer information (email, phone, name, address, external ID) is passed with each event
  • Improving EMQ by passing more/better-hashed customer parameters, especially via CAPI where first-party data (logged-in user info) can be included more reliably than browser-only signals
  • Higher EMQ directly improves attribution accuracy and optimization quality — framed as an ongoing lever, not a one-time setup task
Diagnostics
  • Events Manager Test Events tool for verifying events fire correctly before trusting them in reporting
  • Common failure causes: events firing on the wrong trigger (e.g., Purchase firing on page load instead of confirmed order), missing parameters, consent-gating blocking pixel fire

Workflow

  1. Identify every real conversion event for the business, not just the obvious top-of-funnel one.
  2. Set up base pixel with standard events matched to those conversion points.
  3. Set up CAPI via native platform integration where available; custom implementation otherwise.
  4. Configure deduplication between pixel and CAPI for shared events, and verify dedup status.
  5. Improve EMQ by ensuring rich customer parameters are passed via CAPI.
  6. Test every event in Events Manager Test Events before considering tracking complete.
  7. Set value-based tracking for ecommerce Purchase events.

Outputs

  • Event tracking plan (event, trigger, parameters) mapped to business goals
  • CAPI integration status and method
  • Deduplication verification status
  • EMQ score and specific improvement recommendations
  • Test Events verification confirmation, or list of unresolved issues

Rules

  • Never let a campaign be judged as underperforming without first confirming pixel/CAPI tracking is verified — bad data produces false optimization signals.

  • Always configure deduplication when running both pixel and CAPI for the same event — undeduplicated double-counting corrupts both reporting and the algorithm's optimization target.

  • Treat EMQ improvement as ongoing, not one-time; revisit it when performance degrades unexpectedly.

  • Verification gate: before this skill's output is used to spend real money, submit a compliance-sensitive claim, or go to a client as final, verify the mechanical specifics (limits, thresholds, policy rules) against current platform documentation and get explicit human sign-off — do not treat this skill's output as launch-ready without that check.

google-tag-manager (if deployment goes through GTM), meta-ads-audience-targeting (consumes this event data for Custom Audiences), meta-ads-optimization (relies on this data), meta-ads-catalog-feed (catalog-linked events for dynamic ads).

1---
2name: meta-ads-pixel-capi
3description: "Set up and troubleshoot Meta Pixel and Conversions API (CAPI) tracking, including deduplication and event match quality. Triggers on 'set up Meta Pixel', 'Conversions API setup', 'my Meta conversions aren't tracking', 'event match quality is low', or 'iOS 14 tracking issues'. Prerequisite for any conversion-optimized Meta campaign."
4---
5 
6# Meta Ads Pixel & Conversions API
7 
8> **Currency & scope note (last reviewed 2026-07-19):** Platform mechanics referenced here (character limits, campaign-type names, feature availability, thresholds, benchmark figures, policy specifics) reflect general practice as of the review date above and are **not guaranteed current** — ad platforms change quickly. Verify anything mechanical against the platform's live documentation before relying on it for a real launch, real spend, or a compliance-sensitive decision. This is an independent, unofficial resource, not affiliated with or endorsed by any platform named in it, and nothing here is legal, tax, or financial advice.
9 
10## Purpose
11Get Meta Pixel and server-side Conversions API (CAPI) tracking installed, deduplicated, and reporting with good event match quality — without this, Advantage+/conversion-optimized campaigns are working blind, and every other Meta skill in this library is building on unreliable data.
12 
13## Trigger Conditions
14- "Set up Meta Pixel for my website"
15- "Set up Conversions API"
16- "My Meta conversions aren't tracking / numbers look wrong"
17- "My event match quality score is low"
18- "iOS tracking issues with Meta Ads"
19 
20## Required Inputs
21- Website platform/CMS (affects deployment method: GTM, native e-commerce platform integration, custom implementation)
22- Conversion events to track (Purchase, Lead, AddToCart, ViewContent, CompleteRegistration, custom events)
23- Whether CAPI is already partially set up (many ecommerce platforms offer native CAPI integrations that need only configuration, not custom development)
24 
25## Core Capabilities
26 
27### Pixel Setup
28- Base pixel code and standard event tracking (PageView, ViewContent, AddToCart, InitiateCheckout, Purchase, Lead) mapped to actual business conversion points
29- Deployment via Google Tag Manager (coordinate with `google-tag-manager` if the business already uses GTM for other tracking) or native platform integration
30- Custom conversions and custom events for goals standard events don't cover
31 
32### Conversions API (Server-Side)
33- CAPI as the server-side complement to the browser pixel, sending the same events from the business's server — critical for resilience against browser tracking restrictions, ad blockers, and iOS App Tracking Transparency limits on browser-side signal
34- Native platform CAPI integrations (available on most major ecommerce platforms) as the fastest path — custom server-side implementation only where no native integration exists
35- Value-based events (passing actual order value) for ecommerce, not flat conversion counting
36 
37### Deduplication
38- Sending both pixel and CAPI events for the same conversion requires deduplication (matching event_id/event_name/event_time) so Meta counts it once, not twice — misconfigured dedup silently inflates reported conversions and corrupts optimization
39- Verifying dedup status in Events Manager before trusting combined pixel+CAPI data
40 
41### Event Match Quality (EMQ)
42- EMQ score reflects how well Meta can match incoming events to real users — driven by how much matching customer information (email, phone, name, address, external ID) is passed with each event
43- Improving EMQ by passing more/better-hashed customer parameters, especially via CAPI where first-party data (logged-in user info) can be included more reliably than browser-only signals
44- Higher EMQ directly improves attribution accuracy and optimization quality — framed as an ongoing lever, not a one-time setup task
45 
46### Diagnostics
47- Events Manager Test Events tool for verifying events fire correctly before trusting them in reporting
48- Common failure causes: events firing on the wrong trigger (e.g., Purchase firing on page load instead of confirmed order), missing parameters, consent-gating blocking pixel fire
49 
50## Workflow
511. Identify every real conversion event for the business, not just the obvious top-of-funnel one.
522. Set up base pixel with standard events matched to those conversion points.
533. Set up CAPI via native platform integration where available; custom implementation otherwise.
544. Configure deduplication between pixel and CAPI for shared events, and verify dedup status.
555. Improve EMQ by ensuring rich customer parameters are passed via CAPI.
566. Test every event in Events Manager Test Events before considering tracking complete.
577. Set value-based tracking for ecommerce Purchase events.
58 
59## Outputs
60- Event tracking plan (event, trigger, parameters) mapped to business goals
61- CAPI integration status and method
62- Deduplication verification status
63- EMQ score and specific improvement recommendations
64- Test Events verification confirmation, or list of unresolved issues
65 
66## Rules
67- Never let a campaign be judged as underperforming without first confirming pixel/CAPI tracking is verified — bad data produces false optimization signals.
68- Always configure deduplication when running both pixel and CAPI for the same event — undeduplicated double-counting corrupts both reporting and the algorithm's optimization target.
69- Treat EMQ improvement as ongoing, not one-time; revisit it when performance degrades unexpectedly.
70 
71- **Verification gate:** before this skill's output is used to spend real money, submit a compliance-sensitive claim, or go to a client as final, verify the mechanical specifics (limits, thresholds, policy rules) against current platform documentation and get explicit human sign-off — do not treat this skill's output as launch-ready without that check.
72 
73## Related Skills
74`google-tag-manager` (if deployment goes through GTM), `meta-ads-audience-targeting` (consumes this event data for Custom Audiences), `meta-ads-optimization` (relies on this data), `meta-ads-catalog-feed` (catalog-linked events for dynamic ads).
75 
View all files on GitHub →

Details

License
MIT
Stars on the repo
★ 0
Checked
Source
gmmh1/claude-paid-media-skills ↗
Creator
gmmh1 · 39 listings
View creator

Similar skills

See all →
SkillAPI Interface Designaddyosmani/agent-skills · by addyosmaniGuides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when creating REST or GraphQL endpoints, defining type contracts between modules, or establishing boundaries between frontend and backend.★ 98.7k GitHub starsAgentVersion-Specific Docs Lookupupstash/context7 · by upstashPulls up-to-date, version-specific library docs and code examples into the prompt so the AI stops inventing old APIs.★ 62.3k GitHub starsSkillAdaptyv Bio Foundry APIK-Dense-AI/scientific-agent-skills · by K-Dense-AIHow to use the Adaptyv Bio Foundry API and Python SDK for protein experiment design, submission, and results retrieval. Use this skill whenever the user mentions Adaptyv, Foundry API, protein binding assays, protein screening experiments, BLI/SPR assays, thermostability assays, or wants to submit protein sequences for experimental characterization. Also trigger when code imports `adaptyv`, `adaptyv_sdk`, or `FoundryClient`, or references `foundry-api-public.adaptyvbio.com`.★ 46k GitHub starsSkill.NET Backend Developerwshobson/agents · by wshobsonMaster C#/.NET backend development patterns for building robust APIs, MCP servers, and enterprise applications. Covers async/await, dependency injection, Entity Framework Core, Dapper, configuration, caching, and testing with xUnit. Use when developing .NET backends, reviewing C# code, or designing API architectures.★ 39.9k GitHub starsSkillGemini Agent API Guidegoogle/skills · by googleGuides the usage of Gemini Interactions API on Gemini Enterprise Agent Platform. Use when the user wants to use the stateful, server-managed Interactions API for multi-turn conversations, background execution, streaming, structured output, and function calling on the Agent Platform.★ 20.9k GitHub starsSkillGemini Notebook Automationteng-lin/notebooklm-py · by teng-linInstall, authenticate, troubleshoot, and operate Gemini Notebook through the notebooklm-py CLI or typed async Python API. Use for notebook and source management, grounded chat and research, and artifact generation or download when the user mentions Gemini Notebook, notebooklm-py, the notebooklm CLI, or its Python API. Do not use for the generic Gemini API or unrelated content creation.★ 19.6k GitHub stars

More from gmmh1

SkillCross-Platform Voice Adaptergmmh1/claude-paid-media-skills · by gmmh1Adapt one core brand voice coherently across every ad platform's native register — professional on LinkedIn, native/casual on TikTok, conversational on Meta, direct on Google Search. Triggers on 'does this still sound like us', 'adapt our brand voice for TikTok', 'keep our voice consistent across ad platforms', or 'this ad doesn't sound on-brand'. Cross-platform consistency layer feeding every platform's copywriting skill.New listingSkillAd Creative Refresh Plannergmmh1/claude-paid-media-skills · by gmmh1Detect creative fatigue signals and plan refresh cadence across any advertising platform. Triggers on 'my ad performance is declining', 'creative fatigue', 'when should I refresh my ads', or 'frequency is rising and results are dropping'. Platform-agnostic fatigue detection — platform-specific optimization skills apply this with their own metrics and typical fatigue timelines.New listingSkillAd Performance Analyzergmmh1/claude-paid-media-skills · by gmmh1Diagnose why a specific ad creative is winning or losing using the generalized hook-hold-click-convert funnel, applicable across any platform. Triggers on 'why is this ad underperforming', 'diagnose my creative', or 'where in the funnel is this ad failing'. Platform-agnostic diagnostic framework — platform-specific versions (meta-ads-creative-analytics) apply this with platform-native metrics.New listingSkillProduct Ad Creative Systemgmmh1/claude-paid-media-skills · by gmmh1Build product-forward creative patterns reusable across ad platforms — product hero shots, lifestyle imagery, comparison/demo formats, and catalog-scale creative systems. Triggers on 'ecommerce ad creative', 'product photography for ads', 'creative system for my catalog', or 'how should I show this product across platforms'. Cross-platform ecommerce creative patterns feeding platform-specific execution.New listingSkillAI Max Search Configgmmh1/claude-paid-media-skills · by gmmh1Configure AI Max for Search — Google's AI-powered enhancement layer on Search campaigns adding broader query matching, AI-generated text customization, and final URL expansion. Triggers on 'set up AI Max for Search', 'should I turn on AI Max', 'AI Max text customization', or 'AI Max brand controls'. Sits on top of an existing Search campaign built via google-ads-campaign-builder — it's a feature layer, not a standalone campaign type.New listingSkillApp Campaign Buildergmmh1/claude-paid-media-skills · by gmmh1Build App campaigns for install and in-app action goals across Search, Display, YouTube, Discover, and Google Play. Triggers on 'set up an App campaign', 'get more app installs', 'app engagement campaign', or 'App campaigns for engagement'. Fully automated app-promotion format — distinct from web-focused campaign types.New listing