Agent skill

Meta Pixel and Conversions API Reference

by bighadj22 in bighadj22/codflow

Bundles Meta's official Pixel and Conversions API documentation so tracking changes, event deduplication and conversion events are checked against the real spec.

Apache-2.0Auto-check passedMarketing & SEO

Install Meta Pixel and Conversions API Reference

skills CLI
$ npx skills add bighadj22/codflow --skill meta-ads -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install bighadj22/codflow meta-ads --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/bighadj22/codflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/meta-ads .claude/skills/meta-ads && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
meta-ads
GitHub stars
350
Token cost
~1.8k tokens
SKILL.md length
688 words
Files
24 (incl. references)
Skills in repo
11
Repo updated
First seen
Licence
Apache-2.0

At a glance

Bundles Meta's official Pixel and Conversions API documentation so tracking changes, event deduplication and conversion events are checked against the real spec.

  • Works in 6 steps: Ground first. Read the relevant… → Never break the dedup equality (browser… → A new conversion-event mode must fire… → …
  • Adding or changing a Meta Pixel event on a storefront
  • SKILL.md covers The docs (all unaltered…, How CodFlow maps onto these…, Working rules for tracking… and Refreshing the docs
  • Reaches developers.facebook.com

What it does

This skill vendors Meta's official documentation, unaltered from developers.facebook.com, for CodFlow, a cash-on-delivery e-commerce platform whose tracking runs the Meta Pixel in the theme01 front end and the Conversions API in cod-server. The rule it sets is that any tracking change must be verified against these docs before review, and a reply to a tracking pull request should read and cite the relevant reference first.

References are split into browser-side Pixel files (overview, installing the base code, the standard events table, conversion tracking, advanced matching, single-page apps, custom audiences, GDPR and data processing options) and server-side Conversions API files (overview, getting started with tokens, using the API, parameters, server event fields such as event_name, event_id and action_source, deduplication, offline events, payload helper, verifying setup and best practices). The standard events table is named as the source of truth for which event an action maps to.

When your agent uses it

  • Adding or changing a Meta Pixel event on a storefront
  • Debugging duplicate conversions between Pixel and Conversions API events
  • Reviewing a pull request that touches Conversions API server events
  • Looking up which standard event fits a user action

Example prompts

  • “Check our Purchase event against Meta's standard events table and tell me if the parameters are right.”
  • “Conversions look double-counted. Review how event_id deduplication works between the browser and the server.”
  • “Review this PR that changes capi.ts and cite the Meta docs for anything you flag.”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Ground first. Read the relevant reference file(s) above before
  2. Never break the dedup equality (browser eventID === server
  3. A new conversion-event mode must fire from BOTH sides (browser +
  4. capi_event_log is the idempotency ledger — anything that can fire
  5. Test Mode (test_event_code) exists for verification — use
  6. Docs are read-only reference. These files are unaltered Meta

What it can do on your machine

Read from SKILL.md and the folder at commit ed79aa9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • developers.facebook.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Meta Pixel and Conversions API Reference loads about 1.8k tokens when it runs, and up to ~51k if it reads all its reference files. Until then it costs about 120 tokens; SKILL.md has 688 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~120
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~51k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from bighadj22/codflow at commit ed79aa9, republished under its Apache-2.0 licence (© bighadj22). 688 words, ~1,754 tokens.

Download SKILL.mdSave it as .claude/skills/meta-ads/SKILL.md (or your agent's skills folder). This skill also uses 23 other files; get the full folder from GitHub.
name
meta-ads
description
Official Meta (Facebook) Pixel and Conversions API reference docs for CodFlow's tracking stack — standard events, event parameters, deduplication, advanced matching, test events, and best practices. Use whenever working on Meta Pixel integration, CAPI server events, conversion tracking, event deduplication, attribution, or reviewing PRs that touch tracking (cod-server/src/workflows/capi.ts, capi-helpers.ts, capi_event_log, theme01 pixel scripts, store_pixel_config).

Meta Ads — Pixel & Conversions API Official Documentation

CodFlow's tracking stack (Meta Pixel in theme01 + Conversions API in cod-server) must always match Meta's official behavior. This skill vendors the official documentation so every change — ours or a contributor's — can be grounded against the real spec instead of guesses, blog posts, or AI memory.

Rule for agents and contributors: any tracking change must be verified against these docs before review. When replying to a tracking PR, read the relevant reference here first and cite it.

The docs (all unaltered official content, fetched from developers.facebook.com)

Pixel — browser side (fbq())
FileWhat it covers
references/pixel/pixel-overview.mdWhat the Pixel is, redundant setup with CAPI
references/pixel/pixel-get-started.mdInstalling the base code, the fbq queue
references/pixel/pixel-reference-standard-events.mdThe standard-event table — exact definitions of Purchase, Lead, InitiateCheckout, etc. + object properties. The source of truth for "which event is this action?"
references/pixel/pixel-conversion-tracking.mdFiring events on actions vs page load, purchase-confirmation-page pattern
references/pixel/pixel-advanced-matching.mdem, ph etc. customer params on fbq('init')
references/pixel/pixel-single-page-apps.mdSPA pitfalls (irrelevant to our full-page loads — know why)
references/pixel/pixel-custom-audiences.mdAudience creation from Pixel data
references/pixel/pixel-gdpr.mdGDPR/Limited Data Use reasoning
references/pixel/pixel-data-processing-options.md_fbp cookie + data processing options
Conversions API — server side (/events endpoint)
FileWhat it covers
references/conversions-api/capi-overview.mdWhat CAPI is, redundant setup recommendation
references/conversions-api/capi-get-started.mdSystem user tokens, access, first request
references/conversions-api/capi-using-the-api.mdEndpoint mechanics, payloads, batching, error handling
references/conversions-api/capi-parameters.mdParameters index
references/conversions-api/capi-server-event-parameters.mdevent_name, event_time, event_id, event_source_url, action_source — the per-event field contract
references/conversions-api/capi-customer-information-parameters.mdHashed ph, em, client_ip_address, client_user_agent, fbp, fbc — what we send and how it's normalized
references/conversions-api/capi-custom-data-parameters.mdvalue, currency, contents, content_ids, order_id, num_items
references/conversions-api/capi-original-event-parameters.mdOriginal-event dedup fields (aggregated/merged events)
references/conversions-api/capi-main-body-parameters.mddata[], test_event_code wrapper
references/conversions-api/capi-deduplication.mdPixel ↔ CAPI dedup: browser eventID must equal CAPI event_id AND names must match. The rule behind CodFlow's eventID = orderId pattern
references/conversions-api/capi-best-practices.mdMeta's recommended architecture, timing, and matching quality guidance
references/conversions-api/capi-verifying-setup.mdEvents Manager validation, Test Events
references/conversions-api/capi-offline-events.mdOffline conversion semantics (delayed events — the category our purchase-on-delivery model lives in)
references/conversions-api/capi-payload-helper.mdMeta's interactive payload builder (for debugging shapes)

How CodFlow maps onto these docs (quick orientation)

  • Browser: theme01's BaseHead.astro loads the canonical fbevents.js snippet (PageView on load); thank-you.astro fires the conversion event with { eventID: orderId } — the fourth fbq argument, per the dedup doc.
  • Server: cod-server/src/workflows/capi.ts (Cloudflare Workflow) sends the mirrored event via /events with event_id: orderId; capi-helpers.ts gates which status transitions trigger it; capi_event_log records what was sent (and powers idempotency).
  • Config: store_pixel_config (pixel id, access token, test event code, conversion event choice, test mode) — Settings → Tracking.
  • Dedup contract: browser eventID === CAPI event_id === orderId, same event_name on both sides. Any tracking change that breaks this equality double-counts conversions (see capi-deduplication.md).
  • Standard-event semantics: which CodFlow moment maps to which Meta event is governed by pixel-reference-standard-events.md — notably Purchase is defined as at-checkout ("lands on thank you or confirmation page") and Lead as a completed sign-up. COD purchase-on-delivery is an offline-style delayed Purchase (see capi-offline-events.md) — legitimate, but it must be a deliberate merchant choice, not a silent default.
Show full SKILL.md (213 more words)Show less

Working rules for tracking changes

  1. Ground first. Read the relevant reference file(s) above before writing or reviewing a single line of tracking code. Cite the doc in the PR/review when a decision hinges on Meta behavior.
  2. Never break the dedup equality (browser eventID === server event_id, matching names) — silent double-counting or double-sending is the #1 tracking bug class.
  3. A new conversion-event mode must fire from BOTH sides (browser + CAPI mirror) or from exactly ONE side deliberately, never accidentally. PR #103's lesson: a mode that exists only in the settings enum is not a feature.
  4. capi_event_log is the idempotency ledger — anything that can fire twice (webhook retries, status toggles) must be guarded through it.
  5. Test Mode (test_event_code) exists for verification — use capi-verifying-setup.md's flow before claiming an event works.
  6. Docs are read-only reference. These files are unaltered Meta content (only a source header is prepended). Never edit them to match code — if code and docs disagree, the CODE changes (or Meta did, and we re-fetch).

Refreshing the docs

Meta updates its docs; when a tracking question can't be answered from these files (or the content looks outdated), re-fetch with Firecrawl:

sh
firecrawl scrape "https://developers.facebook.com/documentation/<path>" --only-main-content

Keep the source header (URL + fetch date) on every file so staleness is auditable. Content below the header stays unaltered.

© bighadj22, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 23 other files (references) in .agents/skills/meta-ads of bighadj22/codflow.

  • SKILL.md
  • references/conversions-api/capi-best-practices.md
  • references/conversions-api/capi-custom-data-parameters.md
  • references/conversions-api/capi-customer-information-parameters.md
  • references/conversions-api/capi-deduplication.md
  • references/conversions-api/capi-get-started.md
  • references/conversions-api/capi-main-body-parameters.md
  • references/conversions-api/capi-offline-events.md
  • references/conversions-api/capi-original-event-parameters.md
  • references/conversions-api/capi-overview.md
  • references/conversions-api/capi-parameters.md
  • references/conversions-api/capi-payload-helper.md
  • references/conversions-api/capi-server-event-parameters.md
  • references/conversions-api/capi-using-the-api.md
  • references/conversions-api/capi-verifying-setup.md
  • references/pixel/pixel-advanced-matching.md
  • references/pixel/pixel-conversion-tracking.md
  • references/pixel/pixel-custom-audiences.md
  • … and 6 more

Open the folder on GitHubat commit ed79aa9

Compare with similar skills

Meta Pixel and Conversions API Reference next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Meta Pixel and Conversions API Reference compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Meta Pixel and Conversions API Reference this skillbighadj22/codflow350—~1.8kAutomated safety check: PassApache-2.0
Meta Ads AuditAgriciDaniel/claude-ads9.8k—~906Automated safety check: PassMIT
Meta Pixel Setupooiyeefei/ccc494—~2.4kAutomated safety check: PassMIT
Blog GoogleAgriciDaniel/claude-blog2.3k1 repos~3.3kAutomated safety check: NotesMIT
Apple Ads with the asc CLIrorkai/app-store-connect-cli-skills1.1k1 repos~3.3kAutomated safety check: PassMIT
Paid Ads AuditAgriciDaniel/claude-ads9.8k—~1.5kAutomated safety check: PassMIT

Similar skills

  • Meta Ads Audit

    AgriciDaniel/claude-ads

    Audits a Meta Ads account across Pixel and Conversions API, attribution, creative, audiences, placements, budgets and policy, and reports evidence-backed findings.

    9.8k GitHub stars~906 tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Meta Pixel Setup

    ooiyeefei/ccc

    Walks a site owner through installing the Meta Pixel, firing one conversion event and verifying it with the Pixel Helper before any ads run.

    494 GitHub stars~2.4k tokensUpdated 2 mo ago
    Marketing & SEOAuto-check passed
  • Blog Google

    AgriciDaniel/claude-blog

    Google API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity…

    2.3k GitHub starsUsed in 1 repo~3.3k tokens
    Marketing & SEOAuto-check: notes
  • Apple Ads with the asc CLI

    rorkai/app-store-connect-cli-skills

    Runs Apple Ads work through the asc CLI, covering auth profiles, ad-account discovery, campaigns, reports and guarded changes, plus the move from API v5 to Platform v1.

    1.1k GitHub starsUsed in 1 repo~3.3k tokens
    Marketing & SEOAuto-check passed
  • Paid Ads Audit

    AgriciDaniel/claude-ads

    Runs a source-grounded paid advertising audit across up to 12 ad platforms, with parallel platform workers, deterministic scoring and a versioned JSON bundle.

    9.8k GitHub stars~1.5k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Ads

    Cesarjoquin/Marketing-Skills

    When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms.

    201 GitHub starsUsed in 1 repo~3.5k tokens
    Marketing & SEOAuto-check passed

More from bighadj22/codflow

All 11 skills in this repo
  • Wires an app to the Yalidine (Guepex) Algerian courier API: parcels, zone lookups, delivery fees and verified delivery-status webhooks.

    350 GitHub stars~2.5k tokensUpdated 3 days ago
    Auto-check passed
  • CodFlow Change Workflow

    bighadj22/codflow

    A step-by-step workflow for changing the CodFlow repository: read the AGENTS.md contract, respect package boundaries, verify before claiming done and keep PRs small.

    350 GitHub stars~1.1k tokensUpdated 3 days ago
    Auto-check passed
  • Guides an agent through eight customer tools in a cash-on-delivery CRM for Algerian e-commerce: search, profiles, phone lookup, order history, groups, tags and deletion.

    350 GitHub stars~3.2k tokensUpdated 3 days ago
    Auto-check passed
  • Guides connecting and maintaining the EcoTrack courier adapter in CodFlow, one API shared by 82 Algerian couriers, using the official API reference and a rollout plan.

    350 GitHub stars~2.3k tokensUpdated 3 days ago
    Auto-check passed
  • defineRoute Route Builder

    bighadj22/codflow

    Creates new API endpoints, and converts older ones, with the defineRoute() pattern used in cod-server, including auth strategies, scopes and OpenAPI output.

    350 GitHub stars~924 tokensUpdated 3 days ago
    Auto-check passed
  • Runbook for deploying or redeploying the CodFlow Astro storefront to Vercel, with required environment variables, CLI or Git methods and checks afterwards.

    350 GitHub stars~2.2k tokensUpdated 3 days ago
    Auto-check passed

Works with

Questions about Meta Pixel and Conversions API Reference

What does Meta Pixel and Conversions API Reference do?

Bundles Meta's official Pixel and Conversions API documentation so tracking changes, event deduplication and conversion events are checked against the real spec. com, for CodFlow, a cash-on-delivery e-commerce platform whose tracking runs the Meta Pixel in the theme01 front end and the Conversions API in cod-server. The rule it sets is that any tracking change must be verified against these docs before review, and a reply to a tracking pull request should read and cite the relevant reference first.

When should I use Meta Pixel and Conversions API Reference?

Meta Pixel and Conversions API Reference fits situations like: adding or changing a Meta Pixel event on a storefront; debugging duplicate conversions between Pixel and Conversions API events; reviewing a pull request that touches Conversions API server events; looking up which standard event fits a user action.

How do I install Meta Pixel and Conversions API Reference in Claude Code?

Run `npx skills add bighadj22/codflow --skill meta-ads -a claude-code`. Or copy the skill folder (.agents/skills/meta-ads in bighadj22/codflow) into .claude/skills/meta-ads in your project. Claude Code loads it when a task matches its description.

How do I install Meta Pixel and Conversions API Reference in Codex?

Run `npx skills add bighadj22/codflow --skill meta-ads -a codex`. Or copy the skill folder (.agents/skills/meta-ads in bighadj22/codflow) into .agents/skills/meta-ads in your project. Codex loads it when a task matches its description.

Can I use Meta Pixel and Conversions API Reference in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bighadj22/codflow --skill meta-ads -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/meta-ads, .gemini/skills/meta-ads, .github/skills/meta-ads and .opencode/skills/meta-ads in your project.

What does Meta Pixel and Conversions API Reference need to run?

SKILL.md names no scripts, command-line tools or credentials: Meta Pixel and Conversions API Reference is instructions for the agent only.

Does Meta Pixel and Conversions API Reference access the network?

SKILL.md names 1 domain. In commands or code: developers.facebook.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Meta Pixel and Conversions API Reference safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Meta Pixel and Conversions API Reference use?

Meta Pixel and Conversions API Reference is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Meta Pixel and Conversions API Reference use?

About 1.8k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 50k tokens, read only when the agent opens those files.

What are the alternatives to Meta Pixel and Conversions API Reference?

Skills that share tags, products or a category with Meta Pixel and Conversions API Reference: Meta Ads Audit (AgriciDaniel/claude-ads, 9.8k stars), Meta Pixel Setup (ooiyeefei/ccc, 494 stars), Blog Google (AgriciDaniel/claude-blog, 2.3k stars) and Apple Ads with the asc CLI (rorkai/app-store-connect-cli-skills, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Meta Pixel and Conversions API Reference?

bighadj22 (a GitHub user) maintains it in bighadj22/codflow, which has 350 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 6, 2026.

Source: bighadj22/codflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.