Follow us on Twitter

A CSV Template with Edited Offers


# 1. Offer’s ID;2. Offer’s name;3. Offer’s URL;4. Country code;5. Affiliate Network ID;6. Payout;7. Tags;8. Conversion cap enabled;9. Daily cap;10. Conversion cap time zone;11. Conversion cap redirect offer ID

93bc7176-7caf-4425-992e-d7d4cc6a3d9d;My Offer;http://voluum.com?subid={clickid};AF;5756a726-094b-4046-a9f4-121afaf0ebc2;10.00;local george;true;50;Pacific/Honolulu;0728007b-dd08-4d76-96c5-a67d42a9e91c

Moreover, there are basic rules that you need to follow to avoid issues with the file upload:

  1. The file must be properly formatted CSV and saved using UTF-8 character encoding.

  2. One CSV file can contain up to 250 offers. It means that there should be up to 251 rows in the file - the first row is dedicated for a description of columns.

  3. One offer is represented on a separate row in the CSV file.

  4. In the file, each row must end with a line break.

  5. Each column must be separated with a semicolon.

  6. Only certain pieces of information are required and they are associated with the required fields in the offer's form in Voluum. Other properties might remain blank.

  7. Offer's properties need to be added according to the following patterns:

1. Offer's ID

Property: Required

Description:

This is a unique offer’s ID specific for Voluum.

Voluum Info: The offer ID is automatically available in the downloaded CSV file.

Only if something got messed up with the ID, you can easily find it by performing the following steps:

a. Sign in to Voluum.

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

c. If the ID is not displayed in the Offers view, click the button and enable the appropriate column view.

e. Find the ID of your offer and copy it to your CSV file.

Example:

Offer's ID already available in the CSV file: 93bc7176-7caf-4425-992e-d7d4cc6a3d9d

2. Offer's name

Property: Required

Description:

This is a unique offer’s name.

If you are familiar with the Voluum offer’s name pattern, it should be the custom suffix of the offer’s name that you provide in the Name field in Voluum:

{selected_affiliate_network} - {country_label or Global} - {your unique custom name}

Example:

Offer's name that should be added to the CSV file: My Offer

3. Offer's URL

Property: Required

Description:

The offer’s URL that you have sourced from an affiliate network.

Example:

Offer's URL that should be added to the CSV file: http://voluum.com?subid={clickid}

4. Country code

Property: Optional

Description:

This is a two-letter country code. Voluum accepts the country codes provided according to a certain pattern - if required, you can download the file with codes for all countries: two-letter_country_codes.csv

If you leave the Country code property blank, then the Global value will be set for your offer.

Example:

Country code that should be added to the CSV file: AF

5. Affiliate network ID

Property: Optional

Description:

This is an ID of the affiliate network that is specific for Voluum.

Voluum Note: Keep in mind that the affiliate network entity needs to be created before you start creating bulk offers in Voluum.

You can easily get the affiliate network ID by performing the following steps:

a. Sign in to Voluum.

b. Go to Affiliate networks. The Affiliate networks view will show up.

c. If the ID is not displayed in the Affiliate networks view, perform the steps in the picture below:

d. After clicking the Apply button, the affiliate network ID should show up in one of the columns of the Affiliate networks view.

Example:

Affiliate network ID that should be added to the CSV file: 5756a726-094b-4046-a9f4-121afaf0ebc2

6. Payout

Property: Optional

Description:

This is a payout value for the offer that can be updated dynamically or manually. If you left the property blank, the value will be set to Auto.

Example:

Payout value that should be added to the CSV file: 10.00

7. Tags

Property: Optional

Description:

You can add one or more tags to your offer to easily search for the offer in Voluum. If you want to use more that one tag, they should be separated by spaces.

Example:

Tags that should be added to the CSV file: local george

8. Conversion cap enabled

Property: Optional

Description:

You can set up three values that have an impact on filling out next properties in the CSV file:

  • If you set it up to blank, all below properties should be left blank - conversion cap will be turned off

  • If you set it up to true, all below properties are required and conversion cap will be enabled

  • If you set it up to false, all below properties are required, but conversion cap will be disabled

Example:

Conversion cap value that should be added to the CSV file: true

9. Daily cap

Property: Required if Conversion cap enabled is set to true or false

Description:

This is a number of conversions per day, usually declared by the affiliate network. This should be an integer number > 0.

Example:

Daily cap value that should be added to the CSV file: 50

10. Time zone

Property: Required if Conversion cap enabled is set to true or false

Description:

This is a time-zone code that is specific for Voluum. Voluum accepts the time-zone codes provided according to a certain pattern - if required, you can download the file with codes for all time zones: time_zone_codes.csv

Example:

Conversion cap time zone code that should be added to the CSV file: Pacific/Honolulu

11. Redirect offer ID

Property: Required if Conversion cap enabled is set to true or false

Description:

This is an ID of the the offer to which the traffic should be redirected, after the daily conversion limit is exceeded. You can find the offer ID in the Offers view in Voluum:

a. Sign in to Voluum.

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

c. If the ID is not displayed in the Offers view, perform the steps in the picture below:

d. After clicking the Apply button, the offer ID should show up in one of the columns of the Offers view.

e. Find the ID of your offer and copy it to your CSV file.

Example:

Redirect offer ID that should be added to the CSV file: 0728007b-dd08-4d76-96c5-a67d42a9e91c

12. Currency code

Property: Required

Description: This is a code of currency of payouts. The default currency is USD.

Example: The selected payout currency is USD.

Track & optimize
your campaigns with ease!