CSV Uploader

Introduction

The CSV Upload tool enables you to create multiple Placements and Instances for a particular App at once. Once you have added an App and enabled your set of choice of mediated networks in the Console, the CSV Upload button is displayed on the Placements page of that app.

Note

Currently, no changes can be carried out to existing Placements. You cannot add Instances to existing Placements, change any of the settings of existing Placements or Instances, or create Multi-tests. 

Uploading a CSV File

Follow the steps below to successfully upload your CSV file:

  1. On the Fyber FairBid Console on the App Placements page, click Upload CSV



  2. Select the CSV file you want to upload

The CSV file you upload can rely either on the existing Placement setups with the addition of the new Placements and Instances, or using the template file. Both files can be uploaded directly from this window.

  1. Verify the uploaded contents

After uploading the file, in the lower section of the window, all the new Placements and Instances to be created are displayed.

Note

If an error is found in the uploaded file, it is displayed in this section with the reason for the error. Fix the error and upload the file again.

4. Click Confirm to complete content creation

The new contents are successfully created a notification message appears in the top-right corner of the screen.

CSV File Structure

Each row in the file represents a Placement or an Instance. Each column represents a required field for the creation of a Placement or Instance.

To create a new Placement or Instance, add a new row and enter the relevant information. An Instance cannot be created on its own. It must be created in conjunction with the Placement of which it is a part.

File Columns

Column Name Placement/Instance Description

Placement Name

Placement

The name of the Placement you want to create. 

Placement ID

Placement

The unique identifier created by Fyber for the Placement. Leave this field empty when creating a new Placement or Instance

Placement Type

Placement

The ad format of the Placement. It can be one of the following: Banner, Interstitial or Rewarded. For Marketplace Placements, you can also set MREC ad format.

Entity Type

Both

The type of entity this row refers to. It can be either Placement or Instance.

Entity Status

Both

The Status of the created entity. It can be either Active or Inactive.

Placement Floor Price Country Name

Placement

The country for which the Floor Price value in the next column is set. 

If you are setting different Floor Prices for different countries, or setting several countries for the same floor price, add an additional row for each country.

For the list of countries, click here

Placement Floor Price Value ($)

Placement

The Floor Price you want to set for the Placement and for the specific country if you chose to set one in the previous column. The value can be between 0.01 and 500. 

If you are setting different Floor Prices for different countries, add an additional row for each country.

Instance Name

Instance

The name of the Instance you want to create.

Mediated Network

Instance

The name of the Mediated Network to which the Instance is connected. You can only set networks that were already activated for this app in the Console. The network name must be written the same as in the Console. 

Instance ID

Instance

The unique identifier created by the Mediated Network for the Instance while creating it in the networks' dashboard.

Instance CPM Country Name

Instance

The country for which the predicted CPM value in the next column is set. 

If you are setting different CPM values for different countries, or setting several countries for the same CPM value, please add an additional row for each country.

For the list of countries, click here

Instance CPM Value ($)

Instance

The predicted CPM value you want to set for the Instance and for the specific country.  If you  chose to set one in the previous column. 

The value can be either between 0.01 and 500 for Manual CPM value, or to be set as AUTO while leaving the previous country column field empty.

If you are setting different predicted CPM values for different countries, add an additional row for each country.

File Examples

Creation of a Banner Placement with two instances. The Placement has a Worldwide Floor Price of $0.01, and the Instances have Worldwide Manual CPM values. One of $0.5$, and the other of $0.7.

Creation of an Interstitial Placement with two Instances. The Placement has a Floor Price for a specific country (in addition to the Worldwide $0.01 Floor Price which is automatically created for the Placement), and one of the Instances has several Manual CPM values for different countries.

Creation of two Placements with three Instances each.

List of Supported Countries

Anonymous Proxy Central African Republic Gibraltar Lebanon New Zealand Chad
Satellite Provider Congo Greenland Saint Lucia Oman French Southern Territories
Andorra Switzerland Gambia Liechtenstein Panama Togo
United Arab Emirates Côte d'Ivoire (Ivory Coast) Guinea Sri Lanka Peru Thailand
Afghanistan Cook islands Guadeloupe Liberia French Polynesia Tajikistan
Antigua & Barbuda Chile Equatorial Guinea Lesotho Papua New Guinea Tokelau
Anguilla Cameroon Greece Lithuania Philippines Timor-Leste
Albania China South Georgia and the South Sandwich Luxembourg Pakistan Turkmenistan
Armenia Germany Guatemala Latvia Poland Tunisia
Netherlands Antilles Djibouti Guam Libyan Arab Jamahiriya St. Pierre & Miquelon Tonga
Angola Denmark Guinea-Bissau Morocco Pitcairn East Timor
Asia/Pacific Region Dominica Guyana Monaco Puerto Rico Turkey
Antarctica Dominican Republic Hong Kong Moldova, Republic of Palestinian Territory Trinidad & Tobago
Argentina Algeria Heard & McDonald Islands Montenegro Portugal Tuvalu
American Samoa Ecuador Honduras Saint Martin (French part) Palau Taiwan, Province of China
Austria Estonia Croatia Madagascar Paraguay Tanzania, United Republic of
Australia Egypt Haiti Marshall Islands Qatar Ukraine
Aruba Western Sahara Hungary F.Y.R.O.M. (Macedonia) Réunion Uganda
Aland Islands Eritrea Indonesia Mali Romania United States Minor Outlying Islands
Azerbaijan Spain Ireland Myanmar Serbia United States of America
Bosnia and Herzegovina Ethiopia Israel Mongolia Russian Federation Uruguay
Barbados Europe Isle of Man Macau Rwanda Uzbekistan
Bangladesh Finland India Northern Mariana Islands Saudi Arabia Vatican City State (Holy See)
Belgium Fiji British Indian Ocean Territory Martinique Solomon Islands St. Vincent & the Grenadines
Burkina Faso Falkland Islands (Malvinas) Iraq Mauritania Seychelles Venezuela
Bulgaria Micronesia Islamic Republic of Iran Monserrat Sudan British Virgin Islands
Bahrain Colombia Iceland Malta Sweden United States Virgin Islands
Burundi Costa Rica Italy Mauritius Singapore Viet Nam
Benin Cuba Jersey Maldives St. Helena Vanuatu
Saint Barthélemy Cape Verde Jamaica Malawi Slovenia Wallis & Futuna Islands
Bermuda Curaçao Jordan Mexico Svalbard & Jan Mayen Islands Samoa
Brunei Darussalam Christmas Island Japan Malaysia Slovakia Worldwide
Bolivia Cyprus Kenya Mozambique Sierra Leone Yemen
Bonaire, Sint Eustatius and Saba Czech Republic Kyrgyzstan Namibia San Marino Mayotte
Brazil Faroe Islands Cambodia New Caledonia Senegal Yugoslavia
Bahama France Kiribati Niger Somalia South Africa
Bhutan France, Metropolitan Comoros Norfolk Island Suriname Zambia
Bouvet Island Gabon St. Kitts and Nevis Nigeria South Sudan Zaire
Botswana United Kingdom (Great Britain) Korea, Democratic People's Republic of Nicaragua Sao Tome & Principe Zimbabwe
Belarus Grenada Korea, Republic of Netherlands El Salvador  
Belize Georgia Kuwait Norway Sint Maarten (Dutch part)  
Canada French Guiana Cayman Islands Nepal Syrian Arab Republic  
Cocos (Keeling) Islands Guernsey Kazakhstan Nauru Swaziland  
Congo, Democratic Republic Ghana Lao People's Democratic Republic Niue Turks & Caicos Islands  

 

Back to Top ⇧