← Back to glossary

Custom Event

A custom event is an advertiser-defined conversion action you report to ChatGPT Ads when none of the platform's standard events matches the outcome you care about, such as a quote request. Standard events cover a fixed catalog of common actions like purchases and lead forms, while a custom event tracks something specific to your business.

If your real conversion falls outside that catalog, you either force your reporting into a generic event or define a custom event for the action you optimize toward. Get this wrong and your campaigns optimize toward the wrong signal, your return-on-ad-spend numbers describe the wrong outcome, and you cannot tell which clicks produced value.

What is a custom event?

Within ChatGPT Ads conversion tracking, a custom event is the event type you select when your conversion does not map to one of the platform's predefined standard actions. You give it a name, assign it the custom type, and report it like any built-in event, through the browser pixel, the server-side Conversions API, or both. The custom name you choose becomes the label the platform uses to group and report those conversions.

A custom event carries the same core parts as a standard one: an event type set to custom, a required custom event name, a data payload, and an identifier used to match and deduplicate records. Its name has to stay identical everywhere you send it, because the platform relies on that string to tie pixel and server reports to the same conversion.

A custom event sits alongside standard events in your conversion setup, but it carries one hard limit: it cannot serve as an automated bidding target on its own, so a conversions-optimized campaign still needs a standard event firing in parallel. AirOps helps marketing teams track which questions surface their brand inside ChatGPT.

Resources: a practical guide to structuring and launching effective ChatGPT Ads campaigns

How a custom event works

Setting up a custom event follows the same path as any ChatGPT Ads conversion, with one extra naming step. You define it, instrument it, send it, then confirm it matches across sources.

  1. Define the event. In Ads Manager, create a conversion event, choose the custom type, and give it a name describing the action to count.

  2. Place the code. Add the custom event call to the page or server action that fires only after the conversion happens. Keep it off the page where the action starts.

  3. Send the signal. Report the event through the browser pixel, the Conversions API, or both, passing the data payload and a stable identifier with each record.

  4. Match and deduplicate. Use the identical custom event name and shared identifier on both paths so the platform counts each conversion a single time.

  5. Pair with a standard event. Because a custom event cannot drive automated bidding, keep at least one standard event live so conversions-optimized campaigns still have a target.

Reporting then shows how often that custom action occurred and its attributed value. It does not confirm the pixel is firing correctly, so verify delivery separately before trusting the numbers.

The importance of Custom Event for marketers

The choice to define a custom event is really a choice about what your ad budget optimizes toward. ChatGPT Ads bids and reports against the conversions you feed it, so the events you define decide whether spend chases real business outcomes or convenient proxies.

  • Measure the outcome that actually matters: Standard events rarely map cleanly to niche conversions like a quote request, a configurator completion, or a specific account milestone, and a custom event lets you count exactly that action instead of an approximation.

  • Protect your optimization signal: If you shoehorn a meaningful conversion into a generic standard event, the platform learns from a blurred signal and your campaigns drift toward cheaper, lower-value clicks. That is the failure mode: budget spent optimizing toward the wrong action.

  • Keep reporting honest for stakeholders: A clearly named custom event produces return-on-ad-spend numbers that match how your business defines a win, which makes paid performance defensible in a budget review.

Marketer use cases

  1. Growth marketers use a custom event to track a product-qualified milestone, like reaching an activation threshold, that no standard conversion captures.

  2. Demand gen leads use a custom event to count high-intent actions such as a demo-request form that signals pipeline instead of raw traffic.

  3. SEO managers use a custom event to measure when AI-referred visitors complete a branded action, connecting ChatGPT ad spend to on-site behavior.

Key concepts

Custom event name

The exact string you assign to a custom event, which must stay identical across the pixel and the Conversions API so the platform can group and deduplicate the matching conversions.

Conversion data shape

The structured payload a custom event sends, carrying the fields the platform expects so the reported action can be validated and tied to a value.

Optimization eligibility

The rule that a custom event cannot act as an automated bidding target on its own, which forces you to keep a standard event live for conversions-optimized campaigns.

Benefits

  • Capture conversions that fall outside the ChatGPT Ads standard event catalog.

  • Feed cleaner signals into ChatGPT Ads bidding by matching the event to the real outcome.

  • Report return-on-ad-spend against actions your business genuinely counts as wins.

  • Reuse one consistent custom event name across the pixel and Conversions API for accurate deduplication.

  • Track niche milestones, like a configurator completion or trial upgrade, that standard events ignore.

Custom Event best practices

  • Name the event for the action it represents, keeping the label reusable across future ad groups.

  • Keep the custom event name identical on every path, because the platform matches pixel and server records on that exact string.

  • Fire the event only on the post-conversion page or action, so you count completed outcomes and avoid inflated counts.

  • Send a stable identifier with every record, because deduplication depends on it when you run the pixel and Conversions API together.

  • Always pair a custom event with at least one standard event, since custom events cannot drive automated bidding alone.

  • Document each custom event's name, data shape, and purpose, so colleagues can audit what is defined before trusting it.

Avoid treating a defined custom event as proof that tracking works. A setting existing in Ads Manager does not mean the pixel is installed or events are arriving, so verify delivery before you assign it to a conversions-optimized campaign.

Tools and technologies

  • AirOps: builds and tracks content workflows that keep your brand visible inside ChatGPT, so the audience clicking your ads already recognizes you.

  • Google Tag Manager: fires your custom event tags on the right post-conversion page and passes the deduplication identifier from the data layer.

  • Google Analytics 4: cross-checks the on-site actions behind a custom event so you can validate that the conversions you report actually happened.

Getting started with Custom Event

  1. Map your conversions. This week, list every meaningful action a ChatGPT ad could drive and mark which ones a standard event already covers. The gaps are your custom event candidates.

  2. Name each event. Choose a clear, durable name for every gap action, following the platform's naming rules, and write it down so it stays identical everywhere.

  3. Instrument the trigger. Place the custom event code on the exact page or server action that fires after the conversion completes, using your tag manager where possible.

  4. Wire deduplication. Send a shared identifier and the matching custom event name through both the pixel and the Conversions API so each conversion counts once.

  5. Pair and verify. Keep a standard event live for bidding, then confirm your custom event is actually arriving in reporting before you rely on it for decisions.

Key takeaways

  • A custom event is an advertiser-defined ChatGPT Ads conversion for actions the standard event catalog does not cover.

  • You measure it by sending a named event through the browser pixel, the Conversions API, or both.

  • The main constraint is that a custom event cannot serve as an automated bidding target by itself.

  • The main risk is optimizing campaigns toward a poorly defined event and wasting budget on low-value clicks.

  • The leverage is matching the event precisely to your real outcome, which sharpens both bidding and reporting.

Frequently asked questions about custom events

How is a custom event different from a standard event in ChatGPT Ads?

A custom event is one you define and name yourself for an action that falls outside ChatGPT Ads' fixed catalog of standard events, while a standard event is a predefined type the platform already recognizes, such as a purchase or a lead submission. The practical difference is where each one can be used. Standard events are eligible to act as automated bidding targets, so a conversions-optimized campaign can optimize directly toward them. A custom event can be reported, counted, and attributed, but it cannot drive automated bidding on its own, which means you still need at least one standard event firing if you want outcome-based bidding. Choose a standard event when one genuinely matches your conversion, because it keeps your setup simpler and bidding-eligible. Reach for a custom event when your real outcome has no honest match in the standard catalog, so your reporting describes the action you actually care about.

When should I create a custom event instead of using a standard event?

Create a custom event only when none of the standard events honestly represents the conversion you are trying to count. Work through the standard catalog first, because standard events are simpler to maintain and can serve as bidding targets, which a custom event cannot. If your conversion is a common action like a purchase, lead, registration, or trial start, map it to the matching standard event and stop there. Reach for a custom event when the action is specific to your business, such as a configurator completion, a quote request, or an in-product milestone that no standard label fits. As for how many, keep the set small and deliberate: every custom event you define is something you have to name consistently, instrument correctly, and verify, so define them for actions that will genuinely inform bidding or reporting decisions, and retire ones you no longer use.

Why do my custom event conversion counts vary between the pixel and the Conversions API?

Custom event counts usually diverge across the pixel and the Conversions API because each path captures a different slice of reality and because deduplication depends on exact matching. The browser pixel misses events blocked by ad blockers, privacy settings, or cookie limits, so it tends to undercount. The server-side Conversions API fires independently of the browser, so it catches conversions the pixel never sees. When you run both without a shared identifier and an identical custom event name, the platform cannot tell that two reports describe the same conversion, so it counts them separately and your totals inflate. Variation can also come from modeled or estimated conversions where the platform fills attribution gaps. To reduce the gap, send the same identifier and the exact same custom event name from both sources, confirm both report the same pixel, and check that your event is firing only on the completed-conversion step.

Can I use a custom event to directly optimize my ChatGPT Ads bidding?

No, you cannot use a custom event as a direct automated bidding target in ChatGPT Ads. The platform restricts optimized cost-per-conversion bidding to standard events, so a custom event on its own cannot tell the system what to bid toward. What you can do instead is run a conversions-optimized campaign on a standard event that sits close to your real outcome, while reporting the custom event alongside it for measurement and analysis. That way the system optimizes against an eligible signal, and you still see the specific business action your custom event captures. If the action you care about has no suitable standard counterpart, the practical move is to instrument both: a standard event near enough to guide bidding, and the custom event to measure the precise outcome. Treat the custom event as your reporting truth and the standard event as your bidding lever, and keep both firing reliably.

What counts as a well-configured custom event in ChatGPT Ads?

A well-configured custom event is one that fires only on the completed conversion, carries the correct data shape, uses a clear and durable name, and matches exactly across the pixel and the Conversions API. The first test is placement: the event should trigger after the action finishes, so you count real outcomes and avoid inflated numbers from premature firing. The second test is consistency: the custom event name has to be identical everywhere you send it, because the platform relies on that string for deduplication. The third test is verification: a defined event in Ads Manager is only inventory, so good configuration means you have confirmed the event is actually arriving in reporting. Finally, a well-configured custom event is paired with at least one standard event so your campaigns stay bidding-eligible. If all four hold, your reporting and optimization both rest on a signal you can trust.