Named Locations

Last Update:
Show different ad campaigns at different points in your game and fine-tune your campaigns' behavior from your dashboard. Customize your game logic to match the right ad request with the right player at the right time.

 

 


// Show an interstitial tagged with a location denoting the end of a level
[Chartboost showInterstitial:CBLocationLevelComplete];
// Check if a rewarded video is cached that you want to show from your store
[Chartboost hasRewardedVideo:CBLocationIAPStore];
  Predefined locations for the iOS SDK are available at Chartboost.framework > Headers > Chartboost.h

Chartboost.showInterstitial(CBLocation.LOCATION_LEVEL_COMPLETE);
Chartboost.hasRewardedVideo(CBLocation.LOCATION_IAP_STORE);
  Predefined locations for the Android SDK are available at the CBLocation interface class in the docs folder.

Chartboost.showInterstitial(CBLocation.LevelComplete);
Chartboost.hasRewardedVideo(CBLocation.IAPStore)
  Predefined locations for the Unity SDK are available at Chartboost > Scripts > Chartboost.cs

Chartboost.getInstance().showInterstitial(CBLocation.LEVEL_COMPLETE);
Chartboost.getInstance().hasRewardedVideo(CBLocation.IAP_STORE);
  Predefined locations for the Adobe AIR SDK are available here.

▲ Back to top

 

  • Select one of your games and go to its Basic Settings.
  • Scroll down to Advanced Settings.

  • From this page you can determine how many ads are shown at a given location (e.g. Home Screen, Pause Screen, After Level 1, etc.) per hour or per day across all campaigns. You can also remove unused locations.
  • Alternatively, you can select a publishing campaign and scroll down to its Campaign Logic section.

  • Select By Location.

  • Choose how often a named location in your game will show an ad from one of your other games by giving each named location a campaign priority from Never Show to Highest.
  • Click Done.

▲ Back to top

 

  • Use your dashboard reporting tools to determine which ad campaigns perform best at which locations.
  • Make adjustments to your campaigns from your Chartboost dashboard.
  • Named locations don't have to correspond to actual locations in your game; they can also be defined by your game's logic. For example, if your player sets her gender as "female" in your game's profile, you can use named locations to serve up a publishing campaign that targets a female audience.

▲ Back to top

 

Create your own named locations with user-specified strings.


[Chartboost showInterstitial:@"CustomLocation"];
Chartboost.showInterstitial("CustomLocation");
Chartboost.showInterstitial(CBLocation.locationFromName("CustomLocation"));
Chartboost.getInstance().showInterstitial("CustomLocation");

▲ Back to top

 

  • We recommend a maximum of 5-7 named locations per game.
  • We recommend that you build the predefined locations into your game now to take advantage of future system improvements aimed at increasing eCPM.
  • Delegate methods pass the location of the event.
  • The Chartboost dashboard automatically detects the locations that your app uses and adds them to the relevant app and campaign settings pages.
  • All apps start with a Default location in the dashboard.
  • To control the number of times the ads show, set frequency caps for each location from the app's Basic Settings > Advanced Settings page.
  • Set the campaign frequency for each location in the Campaign Logic section of each publishing campaign.
  • Named locations do not work with the Fyber SDK. All static & video interstitial requests coming from the Fyber SDK will use named location fyber_interstitial and all rewarded video requests will use named location fyber_rewarded_video.
  • The AdMob adapter currently sets all named locations as Default if you do not set one in your AdMob console.

▲ Back to top

 


You might also like...