Follow us on Twitter

NewsBreak Full Integration


The full Voluum and NewsBreak integration connects the two platforms in the maximum possible scope. It gives you the option to have full control over your NewsBreak 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 NewsBreak?

The full API integration gives you the following benefits:

  • Synchronize costs of campaigns, ad sets, ads
  • Check the status of your campaigns
  • Pause or resume: campaign, ad sets, ads
  • 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 NewsBreak ad account
  • NewsBreak API key. You can get it by following the steps below:
    1. In NewsBreak ad account, go to Resources / API key.
    2. Click the Generate token button.
    3. Copy the token to the clipboard and paste it to any text editing tool..

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 NewsBreak traffic source.

  5. Provide your API key.
  6. 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 NewsBreak. 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.

Track & optimize
your campaigns with ease!