Follow us on Twitter

PropellerAds Full Integration


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

The full API integration gives you the following benefits:

  • Synchronize costs
  • Check the status of your campaigns.
  • Bid on: campaign, zone (available only for CPC and CPM campaigns)
  • Pause or resume: campaign, zone, banner
  • Create rules.

Back to top

Before You Start

Before you can add the integration, you need the following things:

  • An active Voluum account with the integration option enabled.
  • A PropellerAds API key. You can get it by performing the following steps:

    1. In PropellerAds, go to the Profile tab.
    2. Click the Create token button.

    3. Provide a name for the token and click the icon.

    4. Your API key has been created. Click the button to copy it to the clipboard.

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

Back to top

I. Setting up the Integration

In order to add an integration, perform 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 integrations button under the PropellerAds traffic source.

  5. Provide the API token that you have obtained from PropellerAds.
  6. (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 cost will be synchronized, estimated costs will be replaced with actual ones.
  7. (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.
  8. Click the Next button.

  9. Your accounts have been 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 PropellerAds. 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!