Voluum Documentation

Clickdealer and Voluum

Clickdealer provides offers from a wide variety of verticals. Their focus is on convenience, risk-reduction and the ease of use. Clickdealer is fully integrated with Voluum, which means that browsing their content and setting up offers is as easy as it gets and it all can be done from within Voluum. Read the following guide to learn about the quickest and most efficient setup process, which utilizes Voluum's Offers Marketplace to find and set up Clickdealer offer in Voluum.

Table of Contents
Before You Start

Before you go any deeper, make sure you have the following:

  • An active Clickdealer account.

  • An active Voluum account.

Having those two allows you to do things described here while you read about them. That will make everything even easier. So, sign in to both accounts, find yourself a quiet place, 15 minutes of peace, and here we go!

I. Integrate Your Clickdealer Account With Voluum

Offers Marketplace is a Voluum feature that allows you to browse the content of various affiliate networks in one place. By default, it lists publicly available offers, but after integrating your Clickdealer account with Voluum, you will not only see private offers that are more personalized (and usually have bigger payouts or caps). In addition, you will be able to apply for an offer from within Voluum with just one click.

To perform the integration, you need to get an API key from Clickdealer and submit it to Voluum to authenticate your account. In order to do so, follow the steps below:

  1. Get an API key from Clickdealer.

    1. In Clickdealer, click the Tools option in the menu on the right and select the API option.

    2. Click the button Copy to Clipboard next to the API key value.

      clickdealer_api.png
  2. Integrate with Offers Marketplace

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

    2. Go to the Integrations tab.

    3. Click the Add integration button in the Marketplace API tokens section.

      vlm_integration1.png
    4. Select the Clickdealer affiliate network from the drop-down menu.

    5. Paste the copied API key in the API token text field.

    6. Click the Add API token button.

      clickdealer_api2.png

The integration has been performed. You can see your Clickdealer API token in the masked form:

clickdealer_api3.png
II. Find and Set Up A Clickdealer Offer in Voluum

After the integration has been performed, you can use Offers Marketplace to browse Clickdealer offers without leaving Voluum.

  1. In Voluum, go to the FIND OFFERS section.

    marketplace_tab.png
  2. In the All Offers tab select the Clickdealer option from the Affiliate network drop-down menu and optionally set other filtering criteria.

    clickdealer_marketplace1.png
  3. Locate an offer that you want to promote and go to the offer details by clicking on it.

  4. In the offer details window click the Apply button.

    clickdealer_marketplace2.png
  5. Confirm you agree to the promotion rules by clicking the Confirm application button.

    clickdealer_marketplace3.png
  6. The offer that you have applied for will appear in the My offers section. Once it is approved, you can add it to Voluum. Click the offer with the Accepted status to open offer details page.

    clickdealer_marketplace4.png
  7. Click the Add to tracker button.

    clickdealer_marketplace5.png

    The New offer form will appear.

  8. Add the tracking parameter to the offer URL. Parameters are used to pass information between servers. They consist of the parameter_name={token} pair, where:

    • parameter_name is a Clickdealer specific name that is used to pass a click ID value: a Voluum specific, unique visit identifier. Clickdealer uses the s2 parameter name to get the click ID value.

    • {token} is a Voluum specific token, that is automatically replaced with the concrete, click ID value. Voluum uses the {clickid} token to pass the click ID value.

    When a conversion occurs, the click ID value is sent back in a postback URL and matched with the value behind this visit. When this happens, the conversion counter increases by 1.

    Your final offer URL should look like this:

    https://mb-nplttpro.com/?a=80229&o=6601&c=0&s2={clickid}
  9. Click the Copy button next to it to copy it to the clipboard.

  10. Click the Save button.

    clickdealer_marketplace6.png
III. Configure Postback Settings

Postbacks are used to pass information about conversions that have occurred on an affiliate network platform's side. You have to get it from Voluum, edit it to include Clickdealer's token that stores a click ID value and Clickdealer's payout token for automatic payout tracking, and finally submit the edited postback URL to Clickdealer. In order to do that, perform the following steps:

  1. Get the postback URL:

    1. In Voluum, click the profile_settings.png button in the top right corner of the screen to go to Settings.

    2. Go to the Tracking URLs tab.

    3. Click the Copy button next to the secure postback URL.

      postback_url.png

      You can also copy the non-secure postback URL by clicking the Copy button in the Postback URL section, but using non-secure links is not recommended. Read the Secure Domain in a Campaign Funnel article to learn more.

  2. Edit it and submit it to Clickdealer

    1. In Clickdealer, go to the Tools option in the menu on the left and then select the Global postback option.

    2. Paste the copied postback URL into the Global S2S postback URL text field. Your postback URL looks like this:

      http://voluum_dedicated_domain.com/postback?cid=REPLACE&payout=OPTIONAL&txid=OPTIONAL

      If you have an SSL certificate enabled on your account, which is highly recommended, you need to change HTTP to HTTPS in this link. Read the Enabling SSL for a Dedicated Domain article to learn more.

      Replace the following text strings:

      • Replace the word REPLACE with Clickdealer's token that stores and passes a click ID value. This token is #s2#.

      • Replace the word OPTIONAL next to the payout parameter name with Clickdealer's token used to pass information about payouts. This token is #price#.

      • (Optional) If you want to track subsequent conversions, replace the word OPTIONAL next to the txid parameter name with Clickdealer's token used to uniquely identify a transaction . This token is #tid#. Read the Upselling: Tracking Subsequent Conversions article to learn more.

      Your edited postback URL should look like this:

      https://voluum_dedicated_domain.com/postback?cid=#s2#&payout=#price#&txid=#tid#
    3. Click the Save button.

      clickdealer_postback.png

Caution

Voluum Note: Testing your postback via the build in testing tool in Clickdealer will not work because Voluum rejects all postback request that do not contain a valid click ID value. And this tool is not able to generate one because this value is specific for Voluum. To test your postback settings and your whole campaign funnel, you must follow the visitor's journey from a campaign URL to a postback URL. Read the Step 4: Testing Your Campaign article to learn more.

You have now completed all the necessary steps to make Voluum and Clickdealer work together.