Voluum Documentation

Conversion Upload

Voluum TRK Features Conversion Upload

Conversion Upload is a feature that allows you to manually upload conversions that, for some reasons, occurred but weren't registered by Voluum. You can also use this feature to correct any discrepancies in revenue between Voluum and your affiliate network platform's reporting system. You can add additional parameters, such as conversion type or transaction ID to every upload.

Use Cases

Use case 1: Add conversions that occurred but were not registered by Voluum.

However unlikely, it may happen that there are some conversions visible in your affiliate network platform but not registered in Voluum. This may happen due to improper postback URL configuration or cookies were disabled on a visitor's web browser when a conversion tracking pixel was used to report a conversion.

In such a case, a click ID parameter was still associated with those visits. Locate those click IDs in your affiliate network platform's reports and upload each click ID with a correct payout value and, optionally, other parameters. The number of conversions and the overall revenue will increase to include those uploaded conversions. 

Use case 2: Correct your overall revenue by deducting a specific payout value.

If you have set a manual payout value in an offer's settings and that value was not correct, you will see a discrepancy in your revenue reported by your affiliate network platform and Voluum. Changing this value to the proper one fixes this issue for the future, but you have to correct this discrepancy as well. 

You can change your revenue by making a single conversion upload with a payout value that compensates this difference. You can provide a negative payout value as well to deduct from Voluum's reported revenue. Normally this would not only correct your revenue, but it also would increase a conversion count by one. Too keep your stats nice and tidy, we recommend adding a custom conversion event called "correction", "upload" or similar, without the Include in "Conversions" column box unchecked and then uploading a click ID value with this conversion type included. This will correct your revenue, but keep the conversion count unchanged.

How It Works

Uploading a conversion uses the same logic as receiving a postback from an affiliate network. It requires submitting a valid click ID. The click ID you submit has to match the click ID that was originally assigned to a visitor. So in order to perform a conversion upload you have to find click ID or click IDs in Voluum reports.

Where to find a click ID?

In order to find a click ID, perform the following steps:

  1. In Voluum, go to the Conversions category.

  2. Select a date range and click the Apply button.

  3. Locate a click ID to be submitted in the Click ID column and copy it to clipboard.

    click_ids.png

The values you upload will be permanently registered in Voluum in a form of increased conversions count and revenue.

Uploading unique click IDs

Each click ID value is unique and, by default, it can be registered only once. This means that if a click ID has already been used to report a conversion, it cannot be used to upload a conversion. So either you have to locate click IDs that were not used to report a conversion, or look to add additional parameters to the upload.

Uploading Conversions

In order to upload a conversion, perform the following steps:

  1. In Voluum, click the profile_settings.png icon in the top right corner. The Settings view will show up.

  2. Click the Conversion upload tab.

    Conversion_upload_tab.png
  3. Provide a one entry per line in the Conversion upload text field in the format:

    click ID , payout , transaction ID , conversion type

    where:

    • click ID is the value of a click ID that was originally associated with a visit. Incorrect click IDs will be rejected. Example of a correct click ID: c384EFV6JHQODRN70575OK6U. To learn more, read the Parameters in Postback URLs article.

    • payout (optional) is a value of payout for this conversion. It is provided in a numerical format without any additional characters. May be of a negative value. Example: 1.2. To learn more, read the Tracking Payouts article.

    • transaction ID (optional) is a value unique within a click ID that is helpful to recognize secondary conversion steps (called upsells). Example: abc123. To learn more, read the Upselling: Tracking Subsequent Conversions article.

    • conversion type (optional) is a value that helps to distinguish different conversions types in your reports from each other. Example: app_install or correction. To learn more, read the Custom Conversions article.

    Each value must be separated with a comma. You do not need to provide all values, but when you are adding some values, keep the commas for the missing values.

    • Example 1: Uploading a conversion without additional values:

      • Provide a click ID value only: c384EFV6JHQODRN70575OK6U

      • This increases a conversion count by 1 and adds a payout value to the revenue according to your settings in an offer element setup. If you have set payout tracking in your offer element setup to Manual and set a payout value to 1, it will add 1 to your revenue. If you have set payout tracking in your offer element setup to Auto, no value will be added to your revenue.

    • Example 2: Uploading a conversion with a payout value.

      • Provide a click ID value and a payout value, separated by a comma: c384EFV6JHQODRN70575OK6U,0.75

      • This increases a conversion count by 1 and adds 0.75 to the revenue.

    • Example 3: Correcting a payout value for a specific conversion type:

      • Provide a click ID value, payout value that corrects your total payout (can be a positive or negative value), and a conversion type name: c384EFV6JHQODRN70575OK6U,-50,,app_install

      • This subtracts 50 from your revenue for the "app_install" conversion type. If you have checked the Include in "Conversions" column box in this custom conversion event setup, the conversion count will increase by 1. If you have not checked the Include in "Conversions" column box in this custom conversion event setup, the conversion count will remain unchanged.

  4. Click the Save button.

    conversion_upload_text.png
  5. Confirm the upload in a pop-up window by clicking the Yes, upload conversions button.