A CSV Template with Edited Offers

All data provided in Voluum is stored in a structured way. This also applies to the Export/Import feature. When you download a CSV file with the existing offers to Voluum, you get them already set to a certain pattern. This pattern should be kept while modifying data in bulk. The first line in the CSV template that you can download from Voluum informs you which properties should be added to which columns.

Below you can take a look at an example of offer's data in the CSV file - keep in mind that the below offer's data refers only to one row in the CSV file:

# 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:

The file must be properly formatted CSV and saved using UTF-8 character encoding.
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.
One offer is represented on a separate row in the CSV file.
In the file, each row must end with a line break.
Each column must be separated with a semicolon.
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.
Offer's properties need to be added according to the following patterns:

A CSV Template with New Offers

Exporting/Importing Landers

Track & optimize
your campaigns with ease!

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.