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

# Configure the Taboola Conversion API

> Set up the Taboola Conversion API in Cometly to send the leads and sales attributed to your Taboola ads back to Taboola's conversion rules.

The Taboola Conversion API sends conversion events from Cometly to Taboola, server to server. An event is an action Cometly tracks, such as a lead or a purchase. You map each Taboola conversion rule to a Cometly event, and Cometly reports the conversion to Taboola whenever that event is attributed to one of your Taboola ads.

This matters because Taboola then receives the leads and sales that Cometly tied to a Taboola click, with revenue where the event has a value. The conversions counted against your Taboola conversion rules come from the same events you see attributed to Taboola in Cometly.

> [!NOTE]
>
> Taboola only supports attributed conversions: events with a valid Taboola click ID. There is no "send all events" option for Taboola.

## Before you start

* **Connect your Taboola ad account to the space** (a space is your workspace in Cometly). Taboola connects with a Client ID and Client Secret. See [Taboola ad integration](https://docs.cometly.com/integrations/ad-platforms/taboola.md).
* **Add the Cometly URL parameters to your Taboola ads**, so Cometly can attribute conversions to the right ad. The same guide covers this.
* **Have at least one event-based conversion rule in Taboola.** Cometly maps to the conversion rules that exist in your Taboola account and have an event name. Create them in Taboola before you start.
* Make sure your events are tracking accurately in Cometly. The Conversion API page recommends waiting at least 7 days after events start flowing before you turn data sharing on.

## Step 1: Turn on data sharing

1. In Cometly, click **Events Manager** in the sidebar, then open the **Conversion API** tab.
2. Click the **Taboola** row to expand it.
3. Under **Manage Data Sharing**, select **Turn on data sharing**. The change is saved straight away and the row's badge switches to **Active**.

## Step 2: Map Taboola conversion rules to Cometly events

1. Under **Select the Taboola account to map conversion rules**, choose your Taboola ad account. Cometly loads that account's conversion rules.

2. For each rule under **Taboola Conversion Rules**, pick the event to send under **Cometly Events**. Leave a rule on **Do not map** if you do not want Cometly to report to it.

3. Click **Save**.

If you see "Selected account doesn't contain compatible conversion rules.", the account has no conversion rule with an event name yet. Create one in Taboola, then select the account again.

Map each Cometly event to one conversion rule per account. If you have more than one Taboola ad account connected to the space, select each one in turn and map it separately.

## Check it worked

After you click **Save**, Cometly shows the message "Conversion rules saved." and the **Taboola** row on the **Conversion API** tab shows the **Active** badge. Select the Taboola account again and each conversion rule shows the event you mapped to it. From then on, Cometly reports each mapped event that is attributed to a Taboola ad about 15 minutes after it is tracked.

## What gets sent to Taboola

Cometly sends a conversion to Taboola when all of these are true:

* Data sharing is on.
* The event carries a Taboola click ID.
* Cometly attributed the event to a Taboola ad in one of the Taboola accounts connected to this space.
* The event is mapped to a conversion rule in that ad's account.

The conversion goes to the account of the attributed ad and includes:

| Data | Description |
| - | - |
| **Click ID** | The Taboola click ID from the ad click |
| **Event name** | The event name of the mapped Taboola conversion rule |
| **Revenue** | The monetary value of the event (if available) |
| **Currency** | Your space's currency, sent together with the revenue |

Cometly sends each conversion about 15 minutes after the event is tracked.

## Turn it off

To stop sending conversions to Taboola, expand the **Taboola** row on the **Conversion API** tab and select **Turn off data sharing**. Your mappings are kept, so you can turn it back on later without mapping again.

## Troubleshooting

If conversions aren't appearing in Taboola, check the following:

* **Is data sharing on?** The **Taboola** row should show the **Active** badge.
* **Is the event mapped?** Select the Taboola account and confirm the event is chosen next to the right conversion rule, then click **Save**.
* **Was the conversion attributed to a Taboola ad?** Unattributed conversions, and conversions without a Taboola click ID, are never sent. Check that your Taboola ads carry the Cometly URL parameters.
* **Is the account still connected?** The Taboola ad account must be connected and active in your space.

## Frequently asked questions

### Why does Taboola show fewer conversions than Cometly?

Cometly only sends Taboola the conversions that carry a Taboola click ID, are attributed to a Taboola ad in a connected account, and are mapped to a conversion rule. Cometly's own reports count every conversion it tracks, so its totals are usually higher than what Taboola receives.

### How do I stop one event from being sent to Taboola?

Set the conversion rule for that event to **Do not map** and click **Save**. Cometly keeps tracking the event but no longer reports it to Taboola. To keep individual conversions out of every ad platform (for example when a visitor opts out of data sharing), see [Exclude an event from the Conversion API](https://docs.cometly.com/guides/conversion-api/exclude-an-event.md).

### Does Cometly send past conversions to Taboola after I turn on data sharing?

No. Cometly decides whether to send each conversion shortly after it is tracked, using the data sharing setting and mappings in place at that moment. Conversions tracked before you turned data sharing on and saved your mappings are not sent afterwards.

## Next steps

* [Connect Taboola and add the Cometly URL parameters](https://docs.cometly.com/integrations/ad-platforms/taboola.md)
* [Learn how the Conversion API works across ad platforms](https://docs.cometly.com/guides/conversion-api/overview.md)
* [Exclude an event from the Conversion API](https://docs.cometly.com/guides/conversion-api/exclude-an-event.md)
* [Understand how events work in Cometly](https://docs.cometly.com/guides/events/how-events-work.md)

Still have questions or need a hand? We're happy to help. Reach our team at [support@cometly.com](mailto:support@cometly.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.