Bulk Import: Updating Campaigns in Voluum

The bulk import feature enables you to edit and save many entities at once using the CSV table format. After downloading the CSV file, you can provide all required changes locally on your machine and next, upload the entities to Voluum. 

In case of bulk update of campaigns, you can modify the campaign entities with different properties and adjust them to your current needs: 

  • Campaigns with flows: You can update all properties of the campaigns except the redirect mode; you can simply change the Flow to Destination URL option by setting the appropriate values in the CSV file; however, you cannot set a path for the campaign
  • Campaigns with paths: You can update all properties of the campaign except the paths themselves; instead, you can simply change the Path to Flow or Destination URL option be setting the appropriate values in the CSV file
  • Campaigns with destination URLs: You can update all properties of the campaigns, for example you can simply change the Destination URL to Flow option by setting the appropriate values in the CSV file; however, you cannot set a path for the campaign

To sum up, you can change the campaign's destination property from the destination URL to the flow and the other way round. You cannot change the destination property of the campaigns with paths.


I.  Export (All or Selected) Campaigns from Voluum


To be able to update the existing campaigns, you need to download them from Voluum to your local machine.   



  
    
                     



To do so, perform the following steps:

1. Sign in to Voluum.

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

3. You might choose one of the available options:
  • To export all active campaigns, click the Bulk actions > Export all campaigns drop-down button. 
  • To export only those campaigns that you want to update, in the Campaigns view select checkboxes next to the campaigns you want to export and then, click the Bulk actions > Export selected campaigns drop-down button.


Voluum Tip:

 If you press and hold the Shift button on your keyboard and select two entities in the Campaigns view, all entities between them will be selected automatically.


The confirmation pop-up window will show up.

4. Click the Ok button to confirm that you want to export the campaigns from Voluum. 

5. Save the CSV file with the exported campaigns locally on your machine.


Voluum Note:

 Keep in mind that you should always save a copy of the originally exported CSV file locally, in case you would like to reverse changes after applying them to Voluum. There is no automated way of canceling the updates, so you would not be able to do this without the copy of the original CSV file. 
6. If the CSV file contains more than 250 campaigns, you need to split it into smaller files where each of them can contain maximum 250 rows with campaigns and one row (the first one) with a description.  




 



























II. Update the Exported Campaigns Locally


Once you have got the CSV file with the exported campaigns, you can update the campaigns' properties. While modifying the campaigns, you need to remember to keep the Voluum's data structure in the file. Otherwise, you wouldn't be able to upload the CSV file to Voluum.


 
  
    
                     

1. Open the downloaded Voluum template with a CSV editor that works best for you.

2. Modify entries for the exported campaigns following basic rules listed below:

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

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

2c. One campaign is represented on a separate row in the CSV file.

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

2e. Each column must be separated with a semicolon.

2f. Campaign's properties are added according to a certain pattern delivered within the Voluum template.


Before you start editing the CSV file, read more about the way how the Voluum's data should be stored:

Bulk Import: A CSV Template with Edited Campaigns

Each row in the CSV file might contain the listed pieces of information for one campaign. Note that only certain pieces of information are required and they are associated with the required fields in the campaign's setup in Voluum. Other properties might remain blank. 

Campaign ID
:
{campaign_ID_specific_for_Voluum} ; # Property required; the campaign ID is automatically available in the downloaded CSV file

Campaign name: {your_unique_custom_name} ; # Property required 

Traffic source: {traffic_source_ID_specific_for_Voluum} ;  # Property required 

Country: {two-letter_country_code} ;
# Property optional; if blank the Global value will be set 

Cost model: {cost_models_available_in_Voluum} ; # Property required unless Zeropark set as a traffic source (then it should be left blank); available options are: NOT_TRACKED, CPC, CPA, CPM, AUTO; 

Cost value: {value_related_to_the_provided_cost_model} ; # Property optional;  

Redirect mode: {available_redirect_modes_in_Voluum} ; # Property optional; available options: REGULAR, HTML, DOUBLE_HTML 

Tags: {tags_separated_by_spaces} ; # Property optional

Flow: {flow_ID_specific_for_Voluum} ; # Property required if the Destination URL value is left blank (read also the Voluum Note below)

Destination URL: {campaign_destination_URL} ; # Property required if the Flow ID value is left blank (read also the Voluum Note below)


Voluum Note: If you want to update campaigns with paths, you need to remember to keep both properties, Flow ID and Destination URL, blank.

In the CSV file, you may find campaigns with all three destination options: flows, paths, and destination URLs. Properties of all of them can be modified, however you need to keep in mind that you cannot transform the campaigns with flows or destination URLs into the campaigns with paths. Or the other way round. The campaigns, where the paths are set, are those ones where the Flow ID and Destination URL properties are blank. This also means that you would not find the path ID property in the file.



3. Remove those entities that you have not modified what allows you to accelerate the process of uploading the file to Voluum. Only the campaigns available in the CSV file will be modified. Other entities with their properties will remain the same. 


Voluum Info: Every time when you upload entities (offers, landers, or campaigns) in bulk, only those ones will be updated that are stored in the CSV file. Other entities will neither be changed nor removed.

Bulk Import: A CSV Template with Edited Campaigns



4. Save the CSV files with the modified campaigns locally on your machine. 
The file must be properly formatted and saved using UTF-8 character encoding.


   

 















 



































III. Import the Updated CSV File to Voluum


When you have finished updating the campaigns in the CSV file, you only need to upload the file to the Voluum platform.
 
  
    
                      

To update the modified campaigns, go to the Voluum platform and upload the file:  

1. Sign in to Voluum.

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

3. Click the Bulk actions > Import edited campaigns drop-down button. The Import edited campaigns form will show up.

4. Click the Start importing button in the form (bottom right screen). The file upload screen will show up.


Voluum Tip: You need to follow a data pattern implemented in the Voluum platform to be able to upload many campaigns at once. It is highly recommended to always use the CSV template while importing campaigns in bulk.  


5. Select the prepared CSV file and upload it to Voluum.

6. Wait until the CSV file will upload to Voluum. If any data is provided inaccurately, a list of errors will get displayed in the bulk import form. Moreover, you will also find tips how to correct rows with the campaigns in the file to make it work properly.



7. Once the CSV file is uploaded to the Voluum platform, click the Import button (bottom right screen). You should see the message that the process of importing campaigns in bulk has finished successfully. The campaigns should be updated in Voluum. You might notice applied changes in the Campaigns view.

8. Click the Close button in the Import edited campaigns form. You have successfully updated the campaigns in the Voluum platform.  

    

 












































Frequently Asked Questions:


Have more questions about the bulk import of the edited campaigns? You might find the answer below:

  • What to do if I have more than 250 campaigns to be updated?

If you need to modify more than 250 campaigns to the Voluum platform, you first need to download the CSV file with all campaigns, then split it to the CSV files with a set of 250 campaigns per file, and next, update the campaigns. Once the campaigns are modified and saved in all the CSV files, you need to update the CSV files one by one to the Voluum platform.

  • Is there any maximum size of the CSV file that can be uploaded?
Yes, you can upload the file with a maximum size up to 5 MB.
  • Can I accidentally remove the campaigns while uploading the CSV file?
No, you cannot do it. In general, you cannot remove entities in Voluum. If you do not need to use the campaigns, you can always archive them.
  • Can I add any other entities in bulk to Voluum?
Yes, you can add/modify offers or landers. It allows you to work with up to 250 offers/landers at once. For more information, go to the Bulk Import Overview article.







 



    Bulk Import Overview                                                  Bulk Import: A CSV Template with Edited Campaigns    









   Contact us







Feedback and Knowledge Base