Skip to content

docs(skills): vendor official Meta Pixel & Conversions API references - #104

Merged
bighadj22 merged 1 commit into
mainfrom
docs/meta-ads-official-references
Sep 8, 2026
Merged

docs(skills): vendor official Meta Pixel & Conversions API references#104
bighadj22 merged 1 commit into
mainfrom
docs/meta-ads-official-references

Conversation

@bighadj22

Copy link
Copy Markdown
Owner

What

Adds a meta-ads agent skill vendoring the official Meta documentation for
the Pixel and the Conversions API, so tracking changes (ours and from
contributors) are always grounded against the real spec.

Contents

  • references/pixel/ — 9 official docs: overview, get-started, the
    standard-events reference (Purchase/Lead/InitiateCheckout definitions),
    conversion tracking, advanced matching, single-page apps, custom
    audiences, GDPR, data processing options
  • references/conversions-api/ — 14 official docs: overview, get-started,
    using-the-api, the full parameters set (server-event,
    customer-information, custom-data, original-event, main-body),
    deduplication (browser eventID ↔ CAPI event_id), best practices,
    verifying setup, offline events, payload helper
  • SKILL.md — doc index, a map onto CodFlow's tracking stack (theme01
    pixel scripts, the CAPI workflow, capi_event_log, the dedup contract),
    working rules for tracking changes, and the refresh procedure

All reference files are unaltered official content — each carries only a
prepended source header (URL + fetch date). No code changes.

Adds the meta-ads skill: 23 unaltered official documentation pages from
developers.facebook.com (fetched with Firecrawl, source URL + date
prefixed on each file), organized as:

- references/pixel/ — 9 docs: overview, get-started, standard-events
  reference, conversion tracking, advanced matching, SPA, custom
  audiences, GDPR, data processing options
- references/conversions-api/ — 14 docs: overview, get-started,
  using-the-api, full parameters set (server-event,
  customer-information, custom-data, original-event, main-body),
  deduplication, best practices, verifying setup, offline events,
  payload helper

SKILL.md indexes the docs, maps them onto CodFlow's tracking stack
(theme01 pixel scripts, the CAPI workflow, capi_event_log, the
browser-eventID === server-event_id dedup contract), and sets working
rules for tracking changes: ground every change against these docs,
never break the dedup equality, a conversion mode must fire from both
sides deliberately, and the reference files themselves are read-only.
@bighadj22
bighadj22 merged commit 598b48a into main Sep 8, 2026
3 checks passed
@bighadj22
bighadj22 deleted the docs/meta-ads-official-references branch September 9, 2026 06:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant