# Ad Locations

_Boost your ad revenue by setting up Ad Locations for Chartboost on your mediation solutions._


## Before You Begin

For interstitial and rewarded placement types, Chartboost supports flat CPM.

-   Flat CPM means Chartboost guarantees to pay the exact amount of the specified CPM price, nothing more or less. For example, if you set up a $10 flat CPM for the interstitial inventory of your app in the US, Chartboost will pay $10 CPM.

For banner placement type, Chartboost supports CPM floor.

-   CPM Floor means Chartboost guarantees to pay no less than the specified CPM price. For example, if you set up a $2 CPM floor for the banner inventory of your app in the US, Chartboost might pay $2.50 CPM, but not under $2 CPM.

In addition to using the Chartboost platform to create and edit Ad Locations, you can also use the new Chartboost Publisher CPM Management API to achieve the same goal. If you are interested, please reach out to your Chartboost account manager or <support@chartboost.com>.



## Overview of Ad Locations

From the navigation menu, go to  **Monetization > Apps**  and you will see an overview of all existing apps that have ad location setup (including those set up by your account manager at Chartboost).

-   This overview will provide the total number of ad locations, earnings, requests, impressions, and show rate for each app.
-   You can also filter by the specific app store.

To edit the Ad locations and format type, click on the app you wish to make changes to.



## Create a New Ad Location

You can add up to 100 unique location names per app and location type.

1.  On your  **Monetization > Apps**  overview page, or within any app, click  **+ Create new Ad Location**.
2.  Select the  **app**  from the dropdown menu.
3.  Select the  **ad format**  for this ad location (Interstitial, Rewarded, or Banner).
4.  Create an  **ad location name**  for this ad location that helps you quickly identify it.
5.  Select an  **ad location type**  (Fixed CPM or Bidding).
6.  For  **Fixed CPM**, set a  **CPM rate**  and select the  **countries**  to apply this CPM.
7.  Click  **Create**  to complete.

Please note the restrictions and permitted characters for the naming of ad locations. All ad location names are case-sensitive.

-   Maximum of 80 characters
-   Upper or lower case
-   Numbers 0-9
-   Special characters allowed: $ & - _ , + / \
-   Spaces are not allowed



## Ad Location Type

### Fixed CPM

You can set up different countries with different flat CPM prices for the same location name. However, you can not set up different flat CPM prices for the same location name and the same country.

For any countries not set up with flat CPM or CPM floor prices, Chartboost will automatically optimize for the publisher's best yield.

-   For example, you filled in Interstitial Location One, only selected the United States (no other countries selected), and specified a $20 flat CPM. In this case, if Chartboost receives ad requests from Interstitial Location One in Canada, Chartboost will match the best ads possible and serve dynamic eCPM, which is not guaranteed to be at $20 CPM.

### Bidding

The  **Bidding**  ad location type is for publishers who wish to bid into the Chartboost Exchange using In-App Bidding, Chartboost’s Real Time Bidding solution. For partners who wish to inquire about bidding into the Chartboost Exchange via In-App Bidding, please email  [in-app-bidding@chartboost.com](mailto:in-app-bidding@chartboost.com).

  

## Advanced Monetization Settings

Use the features on the  [Monetization Settings](/en/monetization/publishing/monetization-settings/)  page for advanced advertising filtering.

### Monitor Ads Monetization Performance With Chartboost API

-   The best way to check your apps monetization performance is to use the Chartboost API of app analytics grouped by country, which provides location and country level impression, eCPM, and ad revenue data.
-   For more information about this API, check out the  **App analytics grouped by country**  section on the  [Analytics Methods](/en/advertising/reference/analytics-methods/)  documentation.

#### Chartboost platform

-   Go to  **Monetization > Analytics**  to see your ads earnings by app and ad location breakdown.
-   _Note: The campaign names you will see in the campaign analytics are automatically generated publishing campaigns by Chartboost._



## Create or Update Multiple Ad Locations by Uploading a CSV

1.  On your  **Monetization > Apps**  overview page, click on the  **three-dot icon** at the top right.
2.  Select  **Upload Ad Locations via .CSV**.
3.  Select the  **app**  to apply your bulk ad locations.
4.  Click  **Select**  and upload your .CSV file.

To update an existing ad location, the **name**, **type**, **ad type**, and **country** must match an existing entry. You will only be able to update the CPM **price**. Any other entries will create a new ad location entry.

We recommend using the provided sample file as the template. See below for specific formatting requirements. You can also download a CSV of the current existing ad locations.


### Formatting the CSV

Download the [sample file](/assets/files/sample_ad_locations.csv) provided in the **Upload ad locations via .csv** page. You can also download the **current list** to edit, add, or remove from the existing list.

Open the file in Excel, Numbers, or your preferred CSV editor. You must be able to save the file as a CSV to upload.

Add each ad location details per row:
- **Name**: Name of the ad location that helps you quickly identify it
	-   Maximum of 80 characters
	-   Upper or lower case
	-   Numbers 0-9
	-   Special characters allowed: $ & - _ , + / \
	-   Spaces are not allowed
- **Type**: This column must have `fixed_cpm` entered
- **Ad Type**: Enter `rewarded`, `interstitial`, or `banner`
- **Country**:
	- Only [valid country codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) are accepted.
	- If it targets all country, enter `default`.
	- if it targets multiple countries, enter `|` to separate the list. You do not need to include a space between the `|`. _(Example: `US|DE|CA`)_ 
- **Price**: Enter the CPM price. Do not include `$` symbol.
	- If it targets one country, enter one price. _(Example: 45.35)_
	- If it targets multiple countries, enter a `|` to separate the prices following the same order as the countries. _(Example: `35.5|11.55|13` will apply `35.5` to `US`, `11.55` to `DE`, and `13` to `CA`)_

You must save this file as a CSV to upload.


## Edit or Delete Existing Ad Locations

1.  On your  **Monetization > Apps**  overview page, click on any app.
2.  From here, you can edit the  **CPM price**  directly. Click the  **checkmark icon**  to save.
3.  Otherwise, click on the  **three-dot icon**  for the Ad Location you want to edit.
4.  Click on  **Edit**  or  **Delete**.
5.  Make sure to click  **Save**  after making any edit changes.


