Follow us on Twitter

Taboola Full Integration


The full Voluum and Taboola integration connects the two platforms in the maximum possible scope. It gives you the option to have full control over your Taboola campaign in Voluum and make use of Voluum's vast reporting and optimization options at the same time. The following article describes the scope of the integration, the setup, and how to work with integrated campaigns.

 
How Can You Benefit From The Full Integration With Taboola?

The full API integration gives you the following benefits:

  • Synchronize costs.
  • Check the status of your campaigns and creatives (campaign_item_id in Voluum reports).
  • Bid on: campaign
  • Change bid factor: site
  • Pause or resume: campaign, site, creative
  • Create rules

Back to top

Before You Start

Before you perform an integration, make sure that you have the following:

  • An active Voluum account.
  • An active Taboola account
  • An API key to authenticate Voluum's requests in your traffic source's account. You can get it by contacting their support. Note that getting an API key is not instantaneous and it may take several days before you get it, so plan in advance.

    Write an email to with the following message:

    Hello

    I would like to request the client ID and client secret for my account.

    Kind regards,

  • At least one campaign in Taboola running and tracked by Voluum. Read the Taboola as a Traffic Source article to learn more.

    Voluum Note: In order for the integration to work, you need to have the same campaign URL under all creatives in Taboola.

Once you have everything ready, read the further part of this guide.

Back to top

I. Setting up Integration

In order to integrate, do the following steps:

 
  1. In Voluum, go to the AUTOMIZER module.
  2. Go to the Traffic sources tab.
  3. Click the Add traffic source button.

  4. Click the Add integration link under the Taboola traffic source.

  5. Provide your client ID.
  6. Provide your client secret.
  7. (Optional) Decide if you want to see cost estimations for periods between data synchronization. The estimations are based on the last 24 hours data set. When the cost is synchronized, estimated costs will be replaced with actual ones.
  8. (Optional) Decide if you want to have your campaigns automatically matched. If you turn this off, you will have to use Integration Manager to manually match campaigns.
  9. Click the Add integration button.

Your accounts are now integrated.

Voluum Note: With the full API traffic source integrations, the cost information passed via the integration will OVERRIDE any cost value set in a campaign setup in Voluum. Analogically, if you have turned on cost estimations, they will also override cost settings set in a campaign form. Without cost estimations, values passed in a cost token will be used between cost updates. When an update occurs, it will replace values passed in a token.

Back to top

II. Working With Integrated Campaigns

The integrated campaigns are marked with the icon. To make use of the integration, make sure that you have the following columns visible by clicking the button and ticking the appropriate boxes:

  • Actions
  • Bids
  • Status

Each change you make in Voluum will have an instantaneous effect in Taboola. Find out what you can do with integrated campaigns:

Check the status of integrated campaigns:

You can observe the status of your integrated campaign in the Status column.

Pause or restore an integrated campaign:

You can pause or restore an entire integrated campaign in the Campaigns view, in the Actions column:

  • To pause a running campaign, click the button.

  • To restore a paused campaign, click the button.

Pause or restore a single custom variable of an integrated campaign:

To pause or restore a single custom variable, create a specific campaign report and group data by a given custom variable. Then you will be able to take actions in the Actions column:

  • To pause a running variable, click the button next in a given table row.

  • To restore a paused variable, click the button next in a given table row.

Change bids for an integrated campaign:

You can change bids of the whole campaign in the Campaigns view, in the Bids column. Every bid adjustment is automatically saved.

Change bid for a single custom variable of an integrated campaign:

To change a bid on a single custom variable level, create a specific campaign report and group data by a given custom variable, Then you will be able to change bids in the Bid column.

  • To change a bid on a single custom variable level, click the Default button and provide a bid value. Every bid adjustment is automatically saved.

  • To change your custom bid back to a default one, click the button.

Back to top

Track & optimize
your campaigns with ease!