Taboola

How to connect Taboola to Roivenue, what the default setup downloads, and how the figures are put together.

Taboola native advertising. The Roivenue connector downloads daily impressions, clicks and spend per campaign, plus the conversions Taboola attributes to them.

Setting up the connector

Add a Taboola connector in Roivenue and choose Connect to Taboola. Roivenue sends you to Taboola to sign in and approve access. There are no keys to copy.

Setup options

Option	Default	What it does
Web source and Web medium	blank	The UTM source and medium that Taboola traffic should be recognised as.
Conversion Type name	blank	What Taboola conversions are called inside Roivenue.

What the default setup downloads

Three jobs. One brings impressions, clicks and spend per campaign and day, a second brings conversions and their value, and a third downloads a near real-time feed behind synthetic impressions.

Where the values land

Taboola field	Roivenue column
campaign_name	adCampaign
impressions	impressions
clicks	clicks
spent	cost
cpa_actions_num	conversions
conversions_value	conversionValue

Figures arrive broken down by campaign and publisher site, then aggregated to campaign and day.

Conversions are Taboola's CPA actions, which depend on how conversion tracking is configured on the Taboola side.

The jobs reprocess the last three days on every run.

Available columns

The table above is what the recommended template downloads. Every column this connector can bring back is listed on Taboola - Supported Columns.

Adding one means editing the connector in the Advanced Editor, which stops that connector receiving template updates.

Synthetic impressions

Alongside the daily figures, this connector downloads a conversion feed that Roivenue uses to build synthetic impressions.

Ad platforms report conversions that Roivenue never saw as a web session, because of ad blockers, cross-device journeys or conversions uploaded from a CRM. Left alone those orders look like they came from nowhere, and paid media gets undercounted. The synthetic impression stands in for the missing visit so path analysis and attribution see a complete journey.

There is nothing to configure. It comes with the connector, and it is why the setup creates more than one job.

How far back the data goes

The connector will request up to three years of history. How much arrives depends on what the platform holds for the account.

Troubleshooting

Conversions do not match Taboola

The connector reads CPA actions. If several conversion rules are configured in Taboola, all of them are counted together.