Appodeal Placements


What are placements?

Placement is a tool that allows you to manage ad impressions at different moments/places in the app.

For example, you can display ads in the main menu of the app and after level completion using different parameters.

That way you can track impression statistics in detail, get a better understanding of your app logic, and take this information into account when monetizing.

After the SDK is initialized and the ad is loaded, the system checks whether the ad can be displayed with the conditions of a previously created placement (if you call the appropriate methods, see the documentation). As a result, the placement works with an already loaded ad.

How to separate stats of impressions by places (Placements) where it was shown

An ad can be shown in any place and at any moment within the app — such places are called placements. An exact placement is needed to distinguish the moments containing ads and to tracks the statistics (considering the logic of app usage).

We don’t know when and where to show the ads — so, in case the placements are not set up yet, the ads will be shown in “default placement”.

Additional ad management settings can be applied to a placement. E.g. you can set up different rewards for viewing rewarded videos. Moreover, you can turn the ads off completely, limit their timing, manage intervals between impressions and other settings (see the chart). Changes in placement settings are applied immediately — no need to update the app.

Interface guide

How to find the Placements section

You can create your own set of placements for each individual app. You need to go to the Placements menu for the selected app in the Actions section.

The main page interface

When you go to the main page of placements, you can see the following fields and buttons:

  1. Link to the Placements knowledge base.
  2. Export List button allows you to export all created segments as a csv table.
  3. Button for creating a new placement.
  4. This is an indicator of Placement status. Before the first call to the placement, you will see an inactive status; after the first call to the placement, the status will change to active.
  5. The placement name.
  6. The placement description specified at creation stage.
  7. With Changelog you can view the full history of changes for the placement parameters.
  8. The placement settings icon will take you to the settings menu.
  9. The delete button allows you to delete a placement.

In the list of placements, you will always see the default placement that is created automatically.

Created placement interface

When you create a new placement, you can see this page:

Placement name

Name — placement name indicating the moment when an ad will be shown. The name helps one to mark ads of the same type in different places throughout the app. This name must be sent with a calling of showing ads method in a source code.

Suppose you need to select the fullscreen ad that comes up when calling up pause menu.

Enter a name for such placement — e.g. InterstitialPauseMenu.
During the ad impression this name will be directed to pause menu., Appodeal.INTERSTITIAL, "InterstitialPauseMenu");

Placement description

Description lets you know when and how a placement is used. It’s not a required field and it doesn’t need code integration — it’s there only for your convenience.
List of placements (incl. Name and Description) can be exported to a specialist who takes care of Appodeal SDK integration.

Enabling Condition

Placement conditions under which the placement will be available for the show.


Determine the settings that will apply for an ad placement.

The most popular uses of placements

User reward 

You want to reward your users for viewing a rewarded videos in your app. For example, when a user loses a level, they can earn one extra life; they can also earn 50 coins for internal purchases in the menu.

In this case, you'll need to create 2 placements:

  1. Placement "extra life” with the Reward parameter; set the reward for 1 and name it "life".
  2. Placement "coins for the store” with the Reward parameter and set the reward for 50 and name it "coins".

According to the logic of your app, when a player loses, you suggest that they view the ad and call the method:

if(Appodeal.canShow(Appodeal.REWARDED_VIDEO, "extra attempt"){, Appodeal.REWARDED_VIDEO, "extra attempt"); 

After the ad ends in the callback method:

void onRewardedVideoFinished(double amount, String name)

you will take following parameters:

  • amount = 1
  • name = “life”

When a player is in your app store you can offer to view ads for a reward and call the method:

if(Appodeal.canShow(Appodeal.REWARDED_VIDEO, "coins for the store"){, Appodeal.REWARDED_VIDEO, "coins for the store");

After the ad ends in the callback method:

void onRewardedVideoFinished(double amount, String name)
you will take following parameters:

  • amount = 50;
  • name = “coins”;

User behaviour

Let's say you show Interstitial ads when users return to the main menu and rewarded videos after users complete each level. 

You can create multiple placements (for example, placement “main menu” and placement “level end”) without any settings.

As a result, you can generate statistics by splitting ads into placements and watch the performance of each placement.

You can track impression statistics in detail and understand the logic of your app better. This may be an important information for your monetization strategy.

Turning off ads

You may have users for whom you want to disable some or all of your ads. You can use the Segments tool to group these users together.

You can create a placement with the “Disable ad type" or “Disable ads" setting, and by calling this placement in the desired app place, you can restrict ads for a specific group of users.

Additionally, with A/B testing you can check which ad type brings you the most revenue in different places in the app.