openai-ads-conversions-setup — Codex skill: how to install and use
Guides Codex in setting up OpenAI Ads Measurement Pixel and server-side Conversions API. Useful for tracking checkouts, leads, and purchases without leaking secrets.
npx skills add openai/plugins --skill openai-ads-conversions-setup -a codexWhat openai-ads-conversions-setup does
The skill guides AI coding agents through adding or auditing OpenAI Ads conversion tracking. It supports browser Pixel, backend Conversions API (CAPI), or a hybrid mode. The workflow inspects project structure first. It reuses existing analytics patterns instead of creating redundant layers.
Security constraints are strictly built in. CAPI tokens stay out of client bundles, using server secrets or environment variables instead. The setup handles deduplication via matching event_id tokens, passes the raw __oppref cookie, and validates source_url before sending events like order_created or lead_created.
Install this for OpenAI Ads conversion tracking. Without active campaigns, you can skip it.
What it helps with
- implement OpenAI Ads Measurement Pixel for browser events
- configure server-side tracking with Conversions API (CAPI)
- set up event deduplication using matching event_id values
- capture attribution context using __oppref and validated source_url
- audit existing ad tracking code for secret leakage and syntax errors
Example prompts for the agent
- Instrument OpenAI Ads Pixel and add tracking for checkout_started
- Set up server-side CAPI for order_created with event_id deduplication
- Review our codebase for OpenAI Ads conversion tracking and propose a patch
How to install openai-ads-conversions-setup
1Skills CLI (Vercel)
npx skills add openai/plugins --skill openai-ads-conversions-setup -a codex2Manually: put the files in place
.agents/skills/openai-ads-conversions-setup/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill openai-ads-conversions-setup -a claude-code2Manually: put the files in place
~/.claude/skills/openai-ads-conversions-setup/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/openai-ads-conversions-setup/
Manually: put the files in place
.cursor/skills/openai-ads-conversions-setup/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins openai-ads-conversions-setup2Manually: put the files in place
.github/skills/openai-ads-conversions-setup/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/openai-ads-conversions/skills/openai-ads-conversions-setupManually: put the files in place
.devin/skills/openai-ads-conversions-setup/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set201
The whole set →Similar
Questions about openai-ads-conversions-setup
How to install openai-ads-conversions-setup in Codex?
Run npx skills add openai/plugins --skill openai-ads-conversions-setup in your project terminal.
What does openai-ads-conversions-setup do?
It guides the agent through instrumenting OpenAI Ads Pixel and Conversions API with small diffs, deduplication, and credential safety.
How does event deduplication work between browser and server?
It links paired browser and server payloads using a shared event_id, while passing the raw __oppref cookie and matching source_url.