Manage Placements

Add placements to your app

Basic Settings

  1. Click New Placement + to create a new Chartboost Mediation placement
  2. Select Ad Placement Type (Interstitial or Rewarded)
  3. Fill in the Ad Placement Name.
    1. Choose from the pre-defined placement names in the dropdown menu or fill in a custom placement name.
    2. Maximum of 50 characters. Only numbers, letters, and hyphens are allowed.
    3. Ad Placement Name will be used in Chartboost Mediation SDK integration.

Advanced Settings

Creative Types

  • All creative types are allowed by default. It allows static, video and interactive ads for interstitial placement. It allows video and interactive ads for rewarded placement.
  • Allowing all creative types will help maximize your earnings.
  • However, if you do have a strong preference on not allowing certain creative types, you can disable Allowed All Creative Types and select the creative types you want to allow.

A/B Test

  • This is for enabling A/B test for this Chartboost Mediation placement.
  • The best practice is to not enable A/B test until you finish setting up both Bidding and Waterfall in this Chartboost Mediation placement.

Rewarded Callbacks

When creating or editing a Rewarded placement, you will see a new toggle for configuring a rewarded callback under the Advanced Settings section as follows:

Click the toggle to enable rewarded callbacks on your placement:

Here you will be able to configure the following options:

OptionDefinition
MethodThe HTTP method to make the callback request with. Both GET and POST are supported
Max RetriesThe number of times Chartboost Mediation will retry the callback if your server does not respond with a 200 OK. min=0, max=10
URLThe URL to make the callback request to. Must be <https://>
BodyOptional field that is only available when the method is POST. Supports the same macros as URL

Supported Macros

The following macros can be appended to the URL or the Body when using the POST method.

MacroDefinitionRequired?
%%TRANSACTION_ID%%A unique impression ID associated with the rewarded eventRequired
%%SERVER_TIMESTAMP%%A UNIX timestamp set by the Chartboost Mediation server when the event is processedRequired
%%USER_ID%%A publisher specific user ID associatedRequired
%%VERIFICATION%%A SHA256 hash encrypted with your rewarded secret key by the Chartboost Mediation serverRequired
%%SDK_TIMESTAMP%%A UNIX timestamp set by the Chartboost Mediation SDK when the event is processedOptional
%%CPM_PRICE%%The CPM price of the ad unit that was servedOptional
%%AD_REVENUE%%The actual ad revenue value from the impression. CPM_PRICE / 1000Optional
%%CUSTOM_DATA%%A key value JSON payload provided via the SDK that contains custom dataOptional

Make sure all the required macros are present otherwise you will not be able to save the callback.

An example of a URL containing all the required macros:

https://myserver.com/page?id=%%TRANSACTION_ID%%&user=%%USER_ID%%&hash=%%VERIFICATION%%&ts=%%SERVER_TIMESTAMP%%

Creating a Rewarded Secret Key

To create or obtain your account’s secret key, it is available under Tools → General Settings

Verifying rewarded callbacks on the publisher server

When a rewarded ad is shown, Chartboost Mediation will ping your server’s endpoint. An example of a Body containing all the required macros:

{
   "tx": "%%TRANSACTION_ID%%",
   "usr": "%%USER_ID%%",
   "sdk": %%SDK_TIMESTAMP%%,
   "svt": %%SERVER_TIMESTAMP%%,
   "hash": "%%VERIFICATION%%"
}

When you receive the callback, you can verify that the request is authentic by regenerating the %%VERIFICATION%% hash with the following method:

message = %%SERVER_TIMESTAMP%% + %%TRANSACTION_ID%% + %%USER_ID%%
  SHA256(secret_key, message)

Note that the secret key will be the same value available from Tools in the Dashboard. You will then need to verify that the result of the operation above equals the value of the %%VERIFICATION%% hash.


Bidding Settings

eCPM Floor

  • If you are using bidding only in this Chartboost Mediation placement, you can enable eCPM floor by either setting a global floor or country-specific floors.
  • Country level eCPM floor takes precedence over the global eCPM floor. For any countries that don’t have country level eCPM floor, Chartboost Mediation will use the global eCPM floor.
  • If you are using both bidding and waterfall in this Chartboost Mediation placement, you should not enable eCPM floor, since you would want bidding partners to compete in all ad requests with non-bidding networks/line items.

⚠️

Warning

Setting higher eCPM floors will largely increase the risk of lowering the fill rate.


Bidding Networks

  • Chartboost Chartboost App ID and App Signature are automatically filled
  • Meta Audience Network You need to fill in the Meta Audience Network Placement ID.
  • AdColony You need to fill in the AdColony Zone ID.
  • Tapjoy You need to fill in the Tapjoy Placement Name.

📘

Notes:

Make sure the network partner credentials here exactly match the information in your account on each network dashboard.

Make sure all desired bidding networks are active.


Waterfall

  • You can add existing ad groups or create a new ad group.
  • Each ad group shows the line items from mediated networks.