(Beta Features) Taboola Full Integration

Danger

Integration in Beta version

Voluum and Taboola full integration is in the Beta stage and may change prior to its official release.

The full Voluum and Taboola integration connects the two platforms to the full possible extension. 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.

Table of Contents
How You Can Benefit From The Full Integration?

The full API integration gives you the following benefits:

  • Have your cost information automatically synchronized on all levels, from a placement level to the whole campaign.

  • Check the status of your campaigns.

  • Change bids for a single placement or for the whole campaign straight from Voluum.

  • Pause or restore your campaigns from within Voluum.

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.

    Caution

    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.

I. Setting up Integration

In order to integrate, do the following steps:

  1. In Voluum, click the profile_settings.png icon to go to the Settings view.

  2. Go to the Integrations tab.

  3. In the Traffic source integrations section, click the Add integration button.

    integration1.png
  4. Click the Add new integration link under the Taboola traffic source.

    taboola1.png
  5. Provide your client ID.

  6. Select which campaigns should have their costs integrated by removing or providing relevant Voluum campaign IDs.

  7. Select an integration status. If you keep the integration status as active, the cost update will be performed immediately after you finish the setup.

  8. Click the Finish button.

II. Working With Integrated Campaigns

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

  • Actions

  • Bids

  • Status

columns.png

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.

taboola2.png

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 pause.png button.

    taboola3.png
  • To restore a paused campaign, click the run.png button.

    taboola4.png

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 pause.png button next in a given table row.

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

    taboola6.png

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.

taboola10.png

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.

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

    taboola8.png