> ## Documentation Index
> Fetch the complete documentation index at: https://docs.theoptimizer.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Events

> Import any custom event — and its revenue — from Facebook, Outbrain, and Taboola into TheOptimizer to use in reporting, rules, and custom metrics.

TheOptimizer can import **any custom event** — and the revenue generated by it — from **Facebook, Outbrain, and Taboola**. Once imported, custom events are available across the product: as columns in reporting, as conditions in rules, and as inputs to your own custom metrics (formulas).

Previously TheOptimizer only pulled the standard events for Facebook, and only the single main conversion event for Taboola and Outbrain — no custom events at all. That left many advertisers optimizing on incomplete data. Custom events close that gap, so you can optimize and scale on the KPIs that actually drive your business.

<iframe width="100%" height="420" src="https://www.youtube.com/embed/0JIKOobS9uE" title="Custom Events in TheOptimizer" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

***

## Where to find it

Custom events are configured from the **Custom Events** tab inside the integration section of each ad network:

**Integrations → (Facebook / Outbrain / Taboola) → Custom Events**

Each ad network is configured independently, so you can import a different set of events per network.

***

## Sync your events

Click **Sync** and TheOptimizer queries the ad network for every available custom event. To give you a sensible starting point, it **automatically selects all events that had activity in the last 30 days**. You can then customize the selection — deselect events you don't need, or add events that were inactive in the last 30 days but that you still want to track.

<Steps>
  <Step title="Open the Custom Events tab">
    Go to **Integrations**, open the ad network you want (Facebook, Outbrain, or Taboola), and select the **Custom Events** tab.
  </Step>

  <Step title="Click Sync">
    TheOptimizer pulls in all available custom events for that network and pre-selects the ones with activity in the last 30 days.
  </Step>

  <Step title="Customize the selection">
    Add or remove events so the list reflects only the events you plan to use. Save your selection when done.
  </Step>
</Steps>

<Note>
  Each ad network allows a maximum of **60 custom events**. Because slots are limited, only select the events you actually plan to use in reporting, rules, or custom metrics.
</Note>

***

## Native networks: Taboola & Outbrain

Custom events are a brand-new capability for Taboola and Outbrain. Until now, TheOptimizer could only import each network's single main conversion event. You can now sync any custom event these networks expose — along with its revenue — and use it exactly like a Facebook custom event: in reporting, as a rule condition, or inside a custom metric. This closes a long-standing gap for native media buyers who optimize on downstream events (leads, deposits, upsells) rather than the top-line conversion.

***

## Using custom events

Once synced, your custom events (and their revenue) are available everywhere metric data is used:

* **Reporting** — add custom events as columns and compare campaigns on the KPI that matters to you, not just the default conversion.
* **Rules** — use a custom event as a condition (for example, pause ad sets that spend without generating a "Purchase" event).
* **Custom metrics** — build your own formulas from custom events and their revenue (for example, cost per lead or return on ad spend based on a downstream event).

***

## Next Steps

* [Ad Network Integrations](/integrations/ad-networks) — connect Facebook, Outbrain, and Taboola
* [Rules Guide](/automation/rules-guide) — use custom events as conditions in automation
* [Custom Metrics](/campaign-manager/custom-metrics) — build formulas from your imported custom events
