Skip to main content
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.
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.
  • 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: 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.

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

Still have questions or need a hand? We’re happy to help. Reach our team at support@cometly.com.