Integration

The integration feature builds upon the standard campaign setup and, depending on the level of integration and type of a platform, enables Voluum to do some or all things listed below:

  • Fetch cost information for a given campaign or for every custom variable. You can get cost information even if a traffic source platform does not support sending cost information via the standard cost token.

  • Record conversion information with additional data points. You can get conversion information without using the standard postback or pixel methods.

  • Get campaign status information for a given traffic source. You can see if your campaigns are running or if there are problems with them.

  • Send conversion information to a traffic source. You can enable your traffic source to get information about conversions and payouts.

  • Pause or restore a campaign or selected custom variables. You can work from within one interface.

  • Change bids for the whole campaign or for selected custom variables. You can control your campaign on the most granular level without leaving Voluum.

The scope of this functionality differs between traffic source platforms. Read the specific guides for each traffic source platform (provided at the end of this article) to learn more.

Table of Contents
How Does Integration Work?

With this feature enabled and set up, Voluum will call traffic sources' API to ask about the costs and statuses of your campaigns and update your stats in Voluum with data received in the response. The first cost update starts with yesterday's data and from now on costs will be updated on a regular basis.

When it comes to controlling your campaigns from Voluum, every change you make in Voluum (for example, bid up, pause, or other) will be instantly requested on your behalf in a given traffic source. This saves you from jumping between Voluum and traffic source panels.

Levels of Integrations

Traffic sources may be integrated on different levels. The full integration fetches all information and allows for controlling campaigns from Voluum UI. However, some traffic sources are integrated on lower levels and allow only to synchronize cost information. Refer to the specific articles to learn about the scope of the integration.

When it comes to affiliate networks, the integration usually allows sending conversion data along with additional pieces of information, such as payout or conversion type.

Campaign Matching

The match between a Voluum campaign and a campaign from an integrated traffic source is based Voluum campaign ID. When an integration process is performed, you will have an option to select either automatic campaign matching or manual.

integration2.png

Automatic campaign matching

With auto-matching enabled, Voluum searches integrated traffic sources for campaigns that have a Voluum campaign ID in their campaign URL. Additionally, Voluum will perform these searches to find new campaigns on a regular basis.

The typical Voluum campaign URL looks something like this:

https://voluum_dedicated_domain.com/8284c355-090b-427c-930f-5311427e28c4?campid={campaign_id}source={src_hostname}&keyword={keyword}

The Voluum campaign ID in this URL is: 8284c355-090b-427c-930f-5311427e28c4

If it hasn't been altered in any way, Voluum should easily identify its campaigns in a traffic source and match them.

Manual campaign matching

Sometimes you may want to match only selected campaigns. Or it may happen that some campaigns were not matched correctly. To manually match campaigns, use the Integration Manager.

Caution

Voluum Note: Due to Outbrain's complex campaign structure, it is recommended to manually match each campaign. Because of that, the auto campaign matching for Outbrain is turned off by default.

Integration Manager

The Integration Manager allows you to manually match campaigns from a traffic source and Voluum. If you want to learn more, read the Integration Manager article.

Integrated Campaigns Statuses

You can observe the integrated campaign statuses to know about the current state of integrations. To learn more, read the Integrated Campaign Statuses article.

Integrated Affiliate Network
Integrated Traffic Sources