# Bulk-Importing Placements

In some cases you might want to forgo setting up placement individually in the DT Console and import placement data from a file instead. This can be useful when you have a lot of placements to add/update or when working with data exported from other dashboards.

Complete the following steps to import placement data from a file:

{% stepper %}
{% step %}
[Download a base CSV file](#downloading-a-base-csv-file) from DT Console.
{% endstep %}

{% step %}
[Modify the downloaded CSV file](#modifying-the-base-csv-file) in an external tool.
{% endstep %}

{% step %}
[Upload the modified CSV file](#uploading-a-csv-file-with-multiple-placements) to the DT Console.
{% endstep %}
{% endstepper %}

## Downloading a Base CSV File

Start with a base CSV file. This could be either a blank DT template or your current placement settings downloaded from the DT Console.

To download a base CSV template:

1. Select your app from the [Apps Dashboard](/dt-console/app-management/apps-dashboard.md).
2. On the **Placements** tab of the **App Details** screen, click the **Add placement** drop-down.

<div align="left" data-with-frame="true"><img src="/files/b820bdea2650d53df2f3361d58be14667af412df" alt="Drop-down for CSV Uploads"></div>

2. To download your current placement settings, click **Download CSV**.
3. To download a blank template, click **Upload CSV**, and then click **Download CSV template** from the **Upload a CSV file** dialog box.

<div align="left" data-with-frame="true"><img src="/files/ba9a8574de7bd7ffe3df8e30fc427a51f80aba20" alt="CSV file download options"></div>

## Modifying the Base CSV File

Once you [download the base CSV file](#h_01J59CPBAA7TKMQBAMMNDKY2Z7) (either your existing placement configurations or the blank template), modify the CSV file for the placements you want to add or update. Each line in the CSV file represents a placement and its settings, and each placement setting is separated by a comma.

The following table provides a list of fields that you must provide in your CSV file.

<table><thead><tr><th width="166.19140625">SETTING</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><code>Placement ID</code></td><td>Unique identifier for the Placement. If you are creating a placement, leave this field blank. DT assigns a Placement ID when you upload the CSV file.<br>If you are updating an existing placement, enter the ID for the placement you want to modify.</td></tr><tr><td><code>Placement Name</code></td><td>The name of the placement. Placement names must be unique.</td></tr><tr><td><code>Placement Type</code></td><td>Enter one of the following ad formats:<br><code>Banner</code>. Placement is for a Banner ad format.<br><code>Interstitial</code>. Placement is for an Interstitial ad format.<br><code>MREC</code>. Placement is for a Medium Rectangle ad format.<br><code>Rewarded</code>. Placement is for a Rewarded ad format.</td></tr><tr><td><code>Status</code></td><td>Determines whether placement receives traffic. Indicate one of the following statuses:<br><code>Active</code>. Placement receives traffic<br><code>Inactive</code>. Placement does not receive traffic.</td></tr><tr><td><code>Floor Price</code></td><td>The country and floor price you want to apply to this placement. Use the following format: <code>CountryCode:FloorPrice</code><br>- <code>CountryCode</code>. Use the <a href="#country-codes">alpha-2 country code</a> for the country you want to specify a floor price. To specify a worldwide floor price, use <code>WW</code> as the country code.<br>- <code>FloorPrice</code>. Specify the floor price (0.01-500.00 USD) you want to apply for the country.<br>- Separate multiple entries by a space.</td></tr><tr><td><code>Targeting Mode</code></td><td>Mode in which you want to target the country specified in the <code>Targeting Country Codes</code> column. Specify one of the following modes:<br><code>Include</code>. Include the entity in the specified country.<br><code>Exclude</code>. Exclude the entity from the specified country.<br>If you leave this field blank, DT disables country targeting for the placement and targets all countries.</td></tr><tr><td><code>Targeting Country Codes</code></td><td>The <a href="#country-codes">alpha-2 country code</a> for the country you want to target as specified in the <code>Targeting Mode</code> column.<br>- Separate multiple countries by a space.<br>- If you leave this field blank, DT disables country targeting for the placement and targets all countries.</td></tr><tr><td><code>Child Directed</code></td><td>Indicate whether the target audience of this placement includes children or whether this placement may be accessed by children.<br><code>TRUE</code>. Children are the target audience for this placement or are likely to see this placement.<br><code>FALSE</code>. Children are not the target audience for this placement and are not likely to see this placement.</td></tr></tbody></table>

## Uploading a CSV File with Multiple Placements

To upload a CSV file:

1. On the **Placements** tab of the **App Details** screen, click the **Add placement** drop-down.

<div align="left" data-with-frame="true"><img src="/files/b820bdea2650d53df2f3361d58be14667af412df" alt="Drop-down for CSV Uploads"></div>

2. Click **Upload CSV**.\
   The **Upload a CSV file** dialog box displays.

<div align="left" data-with-frame="true"><img src="/files/25f6b34c7a89aa1680a2fcc7547310c3d413d539" alt="CSV Upload dialog box"></div>

3. Drag and drop your CSV file to the upload area, or, alternatively, click the upload area to browse to your CSV file.

<div align="left" data-with-frame="true"><img src="/files/4b070ad1dcb966e0c805bca0acf1ed578d644c07" alt="Active CSV Upload Button"></div>

4. Click **Upload**. A message displays to confirm the upload and the **Placements** tab of the **App details** screen gets updated.

{% hint style="info" %}
If you receive an error message instead of a confirmation message, then DT encountered an error while processing your file. Check your file for structure errors and missing or invalid settings, and then upload the corrected file.
{% endhint %}

#### **Country Codes**

<details>

<summary>List of country codes</summary>

* AF Afghanistan
* AX Aland Islands
* AL Albania
* DZ Algeria
* AS American Samoa
* AD Andorra
* AO Angola
* AI Anguilla
* AQ Antarctica
* AG Antigua & Barbuda
* AR Argentina
* AM Armenia
* AW Aruba
* AU Australia
* AT Austria
* AZ Azerbaijan
* BS Bahama
* BH Bahrain
* BD Bangladesh
* BB Barbados
* BY Belarus
* BE Belgium
* BZ Belize
* BJ Benin
* BM Bermuda
* BT Bhutan
* BO Bolivia
* BQ Bonaire, Sint Eustatius and Saba
* BA Bosnia and Herzegovina
* BW Botswana
* BV Bouvet Island
* BR Brazil
* IO British Indian Ocean Territory
* VG British Virgin Islands
* BN Brunei Darussalam
* BG Bulgaria
* BF Burkina Faso
* BI Burundi
* KH Cambodia
* CM Cameroon
* CA Canada
* CV Cape Verde
* KY Cayman Islands
* CF Central African Republic
* TD Chad
* CL Chile
* CN China
* CX Christmas Island
* CC Cocos (Keeling) Islands
* CO Colombia
* KM Comoros
* CG Congo
* CD Congo, Democratic Republic
* CK Cook Islands
* CR Costa Rica
* CI Côte d'Ivoire (Ivory Coast)
* HR Croatia
* CU Cuba
* CW Curaçao
* CY Cyprus
* CZ Czech Republic
* DK Denmark
* DJ Djibouti
* DM Dominica
* DO Dominican Republic
* TP East Timor
* EC Ecuador
* EG Egypt
* SV El Salvador
* GQ Equatorial Guinea
* ER Eritrea
* EE Estonia
* ET Ethiopia
* MK F.Y.R.O.M. (Macedonia)
* FK Falkland Islands (Malvinas)
* FO Faroe Islands
* FJ Fiji
* FI Finland
* FR France
* GF French Guiana
* PF French Polynesia
* TF French Southern Territories
* GA Gabon
* GM Gambia
* GE Georgia
* DE Germany
* GH Ghana
* GI Gibraltar
* GR Greece
* GL Greenland
* GD Grenada
* GP Guadeloupe
* GU Guam
* GT Guatemala
* GG Guernsey
* GN Guinea
* GW Guinea-Bissau
* GY Guyana
* HT Haiti
* HM Heard & McDonald Islands
* HN Honduras
* HK Hong Kong
* HU Hungary
* IS Iceland
* IN India
* ID Indonesia
* IQ Iraq
* IE Ireland
* IR Islamic Republic of Iran
* IM Isle of Man
* IL Israel
* IT Italy
* JM Jamaica
* JP Japan
* JE Jersey
* JO Jordan
* KZ Kazakhstan
* KE Kenya
* KI Kiribati
* KP Korea, Democratic People's Republic of
* KR Korea, Republic of
* KW Kuwait
* KG Kyrgyzstan
* LA Lao People's Democratic Republic
* LV Latvia
* LB Lebanon
* LS Lesotho
* LR Liberia
* LY Libyan Arab Jamahiriya
* LI Liechtenstein
* LT Lithuania
* LU Luxembourg
* MO Macau
* MG Madagascar
* MW Malawi
* MY Malaysia
* MV Maldives
* ML Mali
* MT Malta
* MH Marshall Islands
* MQ Martinique
* MR Mauritania
* MU Mauritius
* YT Mayotte
* MX Mexico
* FM Micronesia
* MD Moldova, Republic of
* MC Monaco
* MN Mongolia
* MS Monserrat
* ME Montenegro
* MA Morocco
* MZ Mozambique
* MM Myanmar
* NA Namibia
* NR Nauru
* NP Nepal
* NL Netherlands
* AN Netherlands Antilles
* NC New Caledonia
* NZ New Zealand
* NI Nicaragua
* NE Niger
* NG Nigeria
* NU Niue
* NF Norfolk Island
* MP Northern Mariana Islands
* NO Norway
* OM Oman
* PK Pakistan
* PW Palau
* PS Palestinian Territory
* PA Panama
* PG Papua New Guinea
* PY Paraguay
* PE Peru
* PH Philippines
* PN Pitcairn
* PL Poland
* PT Portugal
* PR Puerto Rico
* QA Qatar
* RE Réunion
* RO Romania
* RU Russian Federation
* RW Rwanda
* BL Saint Barthélemy
* LC Saint Lucia
* MF Saint Martin (French part)
* WS Samoa
* SM San Marino
* ST Sao Tome & Principe
* SA Saudi Arabia
* SN Senegal
* RS Serbia
* SC Seychelles
* SL Sierra Leone
* SG Singapore
* SX Sint Maarten (Dutch part)
* SK Slovakia
* SI Slovenia
* SB Solomon Islands
* SO Somalia
* ZA South Africa
* GS South Georgia and the South Sandwich
* SS South Sudan
* ES Spain
* LK Sri Lanka
* SH St. Helena
* KN St. Kitts and Nevis
* PM St. Pierre & Miquelon
* VC St. Vincent & the Grenadines
* SD Sudan
* SR Suriname
* SJ Svalbard & Jan Mayen Islands
* SZ Swaziland
* SE Sweden
* CH Switzerland
* SY Syrian Arab Republic
* TW Taiwan, Province of China
* TJ Tajikistan
* TZ Tanzania, United Republic of
* TH Thailand
* TL Timor-Leste
* TG Togo
* TK Tokelau
* TO Tonga
* TT Trinidad & Tobago
* TN Tunisia
* TR Turkey
* TM Turkmenistan
* TC Turks & Caicos Islands
* TV Tuvalu
* UG Uganda
* UA Ukraine
* AE United Arab Emirates
* GB United Kingdom (Great Britain)
* UM United States Minor Outlying Islands
* US United States of America
* VI United States Virgin Islands
* UY Uruguay
* UZ Uzbekistan
* VU Vanuatu
* VA Vatican City State (Holy See)
* VE Venezuela
* VN Viet Nam
* WF Wallis & Futuna Islands
* EH Western Sahara
* YE Yemen
* ZR Zaire
* ZM Zambia
* ZW Zimbabwe

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digitalturbine.com/dt-console/app-management/setting-up-an-existing-app/setting-up-placements/bulk-importing-placements.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
