Adding an Offer with a Postback URL

An offer is a basic entity that you add to Voluum. One of the scenarios of setting up a campaign funnel in Voluum is adding the traffic source, offer, and campaign entity to be able to run and track the campaign. This is not the shortest way of setting up the campaign funnel but it enables you to gain long-term benefits. Why? Because when you add the offer, you can collect a variety of data when it comes to campaign reporting. Moreover, you can analyze how the offer goes what in many cases allows to investigate the campaign's performance. Without adding the offer, it might happen that some information cannot be registered in Voluum, so you cannot get deeper insight into the campaign funnel when having only campaign reports.


It is quite straightforward to add the offer to Voluum. In the offer's form you paste a URL to your ad that you advertise over the Internet. The offer's URL might be sourced either from the affiliate network or it might be the link to a proprietary offer that you, for example, display on your website. 

The purpose of this guide is to give you basic information on an offer's setup in Voluum where you track conversions within the postback URL. 

In the offer's form you can find basic and advanced options that might be set depending on your business needs and what kind of information you would like to analyze in the offer's reports. To make it even more comprehensible you can find references to other articles that show different business aspects of adding the offer to Voluum.   


I. Create an Offer Entity in Voluum


In order to add the offer to Voluum platform, perform the following steps:



Voluum Note

Before starting adding the offer to Voluum, you need to have the offer URL accessible for quick reference.



1. Sign in to Voluum.

2. Go to Offers. The Offers view will show up.




3. Click the New offer button. The New offer form will show up.

4. Provide a unique name of your offer.


Voluum Info: The name of the offer in Voluum is based on the following pattern: 

{selected_affiliate_network} - {country_label or Global} - {your_unique_custom_name}


5. Provide the URL of your offer in the Offer URL field and append the corresponding tokens to a parameter within the offer URL. To be able to track conversions for your offer with a postabck URL, you need to add the {clickid} token to the offer's URL with a corresponding parameter from the affiliate network.


Voluum Note: One of the basic functionalities delivered by Vouum is tracking conversions. The conversion tracking method compatible with the offer will determine which parameters/tokens are required in the offer's URL. If you want to track conversions for your offers using the postback URL, you need to add the {clickid} token to the offer's URL with a corresponding parameter from the affiliate network.

   To learn more about tracking methods in Voluum, go to the Tracking Conversions in Voluum: S2S Postback URL or Tracking Pixel article.

6. (Optional) If the offer is geo-specific, select the Country from the drop-down menu. Otherwise, leave the Global option.


Voluum Info


  • This option is only used for organizational purposes and does not determine the traffic source geo-location in any way.
  • If your offer is intended for multiple geos, use the Global option by leaving the Country field blank. 

        
7. (Optional) If you want to associate the offer with a specific affiliate network, select it from the Affiliate network drop-down menu. 8. You can track the payout either dynamically or manually: 8a. Auto: You need to select this option, if you have added a payout parameter to the postback or pixel URL. Tracking values are sent via a postback URL/pixel request.
8b. Manual: You can also provide a fixed amount in the field in the offer’s configuration. Every time the conversion is recorded, the amount will be added to a total payout sum.

 

Voluum Info: To find out how to track payout for your offer, go to the Tracking Payout (Revenue) article.

9. To enhance search functionality, you can always add tags to the offer.


Voluum Info: Remember that tags can only contain letters, numbers, and underscores.

10. In the Conversion cap section turn on the toggle to activate the Conversion cap feature.


Voluum Info: This guide presents how to add a simple offer to Voluum, therefore it does not provide information on the Conversion cap feature in Voluum.  If you are interested in using the Conversion cap in Voluum, take a look at the below articles: 

  • If an affiliate network limits you somehow with a number of conversions per offfer, you can always set a conversion cap for the offer:
  • If you have the offer that is temporarily unavailable and you need to redirect your traffic to the new offer, you can set the Daily cap limit to 0. As a result, all traffic will be immediately redirected to the redirect offer and your visitors will only see the redirect offer without the primary offer.



11. Click the Save button. You have added the offer to Voluum.




II. Get the Postback URL


When you have added the offer to the Voluum platform, you need to define the postback URL that you are going to paste to the affiliate network. To do so, follow the steps:

1. Go back to your offer in the Offers view and select it.

2. Click the Edit button and and go to the Postback URL section.

3. Click the Copy link in the Postback URL section.

4. Paste the copied postback URL to any tool where you can edit and specify the URL parameters. You need to define the following parameters in the URL:


Voluum Info: Keep in mind that the postback URL parameters should be replaced with the corresponding values defined by your affiliate network. To find that values you need to refer to the affiliate network documentation.

If you want to use more than one affiliate network, you need to set up the postback URL for each of them.


   
4a. cid - This is a mandatory parameter used to record a conversion. It is dedicated to passing Voluum clickid.
   
4b. payout - This is an optional parameter used to pass the revenue amount per conversion.


4c. txid - This is an optional parameter that you can use to pass a unique transaction ID for each conversion.


5.  When you have defined all the parameters in the postback URL, paste the URL on the 
affiliate network side. 





III. Set up Your Campaign Funnel


Once the offer has been set, you need to set it with its campaign funnel in Voluum. Click a link below and learn how to create a campaign entity. Or if you still need to create a traffic source entity, choose one of the below guides.



  • Campaign setup:







Frequently Asked Questions:

Have more questions about adding the offer? You might find the answer below:

  • My affiliate network has sent me some documents describing sub-IDs and callbacks setup? Could you explain me how it is related to the offer configuration and what I am supposed to do?
Take a look at the above steps presented in the guide: briefly, you need to add a Voluum's token, {clickid}, to the offer URL (in the Offer URL field) with a corresponding parameter from the affiliate network to be able to register users' clicks. This allows you to identify them and store this information in the Voluum platform. Even more, it ensures that you will be able to track conversions of th offer. You might also add other tokens to the offer URL depending what kind of data is passed on by your affiliate network. You can take a look at an example of the offer's URL with a Voluum {clickid} token:

http://www.my_offer_URL.com/?s2={clickid}

where:

s2: sub-ID/affiliate network parameter
{clickid}: Voluum's token that enables you to track conversions
More information on the offer's tokens you can find in the Tokens Available in the Offer Setup article.
  • Can I add the offer even if I track ads on my own site?
Yes, of course you can. You need to follow the steps in the guide paste the URL to your ad in the Offer URL field.
  • My offer's URL looks as follows: http://www.my_offer_URL.com/?s2={clickid} As far as I understand when the offer is clicked, a unique value, that should be generated, is added at the end of the offer's URL replacing the {clickid} token. For example, upon a click I should get as follows: http://www.my_offer_URL.com/?s2=c384EFV6JHQODRN70575OK6UG5. But in my case the value is added twice. Could you explain why?

This is definitely incorrect. You should double-check the Voluum's affiliate network setup used by the offer. It is highly likely that while adding the affiliate network entity to Voluum, you have enabled the Append click ID to offer URLs option. This option adds the unique clickid value to the offer's URL, even though the value has been already added replacing the {clickid} token. If you want to use this option, your offer's URL should look as follows: http://www.my_offer_URL.com/?s2=












   Contact us







Feedback and Knowledge Base