Testing CPM Floor Ads Bidding System

We suggest running several A/B tests (but one at a time) to studios to see revenue increase.

Requirements

• The Standard Ad Unit IDs should be populated.

• The CPM Floor Ad Unit IDs should be populated.

• GrowthBook quick setup should be completed.

Getting Started

The CPM Floor system requires specific configuration values to function correctly. These values are normally retrieved from GrowthBook and provided to each studio by their studio manager.

However, for testing within the Unity Editor or in debug builds, you must use a custom configuration file (LionAdsTestRCSettings.json).

Creating a Test Configuration File

1. In your Unity project, navigate to: Assets/LionStudios/Resources

2. Create a new JSON file named: LionAdsTestRCSettings.json

3. Populate this file with the test data structure shown below.

   • Replace all AdUnitIDs with the CPM Floor ad unit IDs and coefficient values for your project. Please don't put Standard Ad Unit Ids in this case.

   • Set the appropriate CPMFloorCoefficients values for each ad unit. (Request it from studio manager.)

When you want to test GrowthBook data instead of local test json file, please remove this JSON file or clean data in it. LionAdsTestRCSettings.json always overrides GrowthBook Feature Flags in the Editor and debug build.

LionAdsTestRCSettings.json sample (You need to add all CPM Floor Ad Unit IDs, not Standard Ad Unit IDs):

{
  "IsUseCPMFloorAdIds": true,
  "CanInterstitialReplaceRewarded": false,
  "CPMFloorSettings": [
    {
      "AdUnitID": "6dd14d0cc03515ab",
      "CPMFloorCoefficients": [
        2,
        1.8,
        1.5
      ]
    },
    {
      "AdUnitID": "5ee2d4708357c9f4",
      "CPMFloorCoefficients": [
        1.2,
        0.9,
        0.8
      ]
    },
    {
      "AdUnitID": "dd97199fe7275224",
      "CPMFloorCoefficients": []
    }
  ]
}

Test Parameters:

• IsUseCPMFloorAdIds (boolean) : Switch on/off between Standard / CPM Floor Bidding systems. We use it to check if CPM Floor Bidding system works correctly or analyze the benefits.

• CPMFloorSettings (JSON) : Coefficient settings for adjusting bid request values. This will directly affect ad revenue and fill rates. Please provide these values from your studio manager.

• CanInterstitialReplaceRewarded (boolean) : At times, Interstitial Ads may generate higher revenue than Rewarded Ads. In such cases, we display Interstitial Ads in place of Rewarded Ads.

Please note the use of the LionAds.TryShowRewarded() function’s “onRewarded” callback. If you’re still using MaxSdkCallbacks.Rewarded.OnAdReceivedRewardEvent, update your implementation to use our callback instead.