Skip to main content
Version: Next

Advertising

Advertising is configured and used via the Settings Inspector in Unity.

This module is Android-only. All settings below are marked 🤖.

Configuration is done via the Settings Inspector in Unity.

Configuration is applied automatically at build time for each platform.

Platform markers​

The following markers are used to indicate platform availability of parameters and features:

  • (no marker) — Shared parameter or feature
  • 🍏 — iOS-specific parameter or feature
  • 🤖 — Android-specific parameter or feature
  • ⚠️ — Not implemented in the Unity plugin yet

Ask your release manager for the required parameters before configuring the SDK.

Settings​

AdMob​

FieldDescription
AdMob Enabled 🤖Enables or disables AdMob integration
GMS Ad Application ID 🤖Google Mobile Services (AdMob) application ID
App Open Ad Unit ID 🤖Ad unit ID used for App Open ads
App Open Ad Time 🤖Delay (in minutes) between App Open ad impressions after app resume (first launch always shows)
App Open Ad Orientation 🤖Orientation for App Open ads
FieldDescription
Banner Ad Unit ID 🤖Ad unit ID for banner ads
Banner Ad Position Vertical 🤖Vertical banner placement
Banner Ad Position Horizontal 🤖Horizontal banner placement
Banner Ad Size 🤖Banner size preset

Banner Ad Size values:

  • Banner → 320×50
  • Large → 320×100 (AdMob) / 320×90 (IronSource)
  • Rectangle → 300×250
  • Smart → Smart / adaptive size (implementation-defined)

Interstitial Ads (AdMob / IronSource)​

FieldDescription
Interstitial Ad Unit ID 🤖Ad unit ID for interstitial ads

Rewarded Ads (AdMob / IronSource)​

FieldDescription
Reward Ad Unit ID 🤖Ad unit ID for rewarded ads

Rewarded Interstitial Ads (AdMob only)​

FieldDescription
Reward Interstitial Ad Unit ID 🤖Ad unit ID for rewarded interstitial ads

AdMob Targeting & Testing​

FieldDescription
Tag For Child Directed Treatment 🤖Child-directed treatment flag
Tag For Under Age Of Consent 🤖Under-age-of-consent flag
Max Ad Content Rating 🤖Maximum allowed ad content rating
AdMob Debug Geography 🤖Forces AdMob debug geography
Test Device Ids Enabled 🤖Enables test-device mode for ads
Test Device Ids 🤖Comma-separated list of test device advertising IDs

IronSource Settings​

FieldDescription
Iron Source Enabled 🤖Enables or disables IronSource mediation
IronSource App Key 🤖IronSource application key

Regulation & Privacy Settings​

FieldDescription
Is Do Not Sell 🤖US privacy compliance flag (CCPA)
Is Child Directed 🤖User-level child-directed flag

Usage​

Rewarded Ad​

LoadRewardedAd → OnRewardedAdLoadedEvent​

// Callback
void OnRewardedAdLoaded(RewardedAdLoadedResult result)
{
    // Success: string.IsNullOrEmpty(result.error)
    // Failure: result.error
}

P101XP.GetInstance().OnRewardedAdLoadedEvent += OnRewardedAdLoaded;

// Method
P101XP.GetInstance().LoadRewardedAd("rewarded_ad_unit_id");

RewardedAdLoadedResult signature:

public class RewardedAdLoadedResult
{
    public string error;
}

ShowRewardedAd → OnRewardedAdShowedEvent​

// Callback
void OnRewardedAdShowed(RewardedAdShowedResult result)
{
    // Success: string.IsNullOrEmpty(result.error)
    // Reward:
    //   result.amount
    //   result.name
    //
    // Failure:
    //   result.error
}

P101XP.GetInstance().OnRewardedAdShowedEvent += OnRewardedAdShowed;

// Method
P101XP.GetInstance().ShowRewardedAd();

RewardedAdShowedResult signature:

public class RewardedAdShowedResult
{
    public int amount;
    public string name;
    public string error;
}

IsRewardedVideoLoaded (IronSource only)​

// Method
var isLoaded = P101XP.GetInstance().IsRewardedVideoLoaded();

Interstitial Ad​

LoadInterstitialAd → OnInterstitialAdLoadedEvent​

// Callback
void OnInterstitialAdLoaded(InterstitialAdLoadedResult result)
{
    // Success: string.IsNullOrEmpty(result.error)
    // Failure: result.error
}

P101XP.GetInstance().OnInterstitialAdLoadedEvent += OnInterstitialAdLoaded;

// Method
P101XP.GetInstance().LoadInterstitialAd("interstitial_ad_unit_id");

RewardedAdShowedResult signature:

public class InterstitialAdLoadedResult
{
    public string error;
}

ShowInterstitialAd → OnInterstitialAdShowedEvent​

// Callback
void OnInterstitialAdShowed(InterstitialAdShowedResult result)
{
    // Success: string.IsNullOrEmpty(result.error)
    // Failure: result.error
}

P101XP.GetInstance().OnInterstitialAdShowedEvent += OnInterstitialAdShowed;

// Method
P101XP.GetInstance().ShowInterstitialAd();

RewardedAdShowedResult signature:

public class InterstitialAdShowedResult
{
    public string error;
}

IsInterstitialAdLoaded (IronSource only)​

// Method
var isLoaded = P101XP.GetInstance().IsInterstitialAdLoaded();

LoadBannerAd → OnBannerAdLoadedEvent​

// Callback
void OnBannerAdLoaded(BannerAdLoadedResult result)
{
    // Success: string.IsNullOrEmpty(result.error)
    // Failure: result.error
}

P101XP.GetInstance().OnBannerAdLoadedEvent += OnBannerAdLoaded;

// Method
P101XP.GetInstance().LoadBannerAd("banner_ad_unit_id");

RewardedAdShowedResult signature:

public class BannerAdLoadedResult
{
    public string error;
}

ShowBannerAd → OnBannerAdShowedEvent​

// Callback
void OnBannerAdShowed(BannerAdShowedResult result)
{
    // Success: string.IsNullOrEmpty(result.error)
    // Failure: result.error
}

P101XP.GetInstance().OnBannerAdShowedEvent += OnBannerAdShowed;

// Method
P101XP.GetInstance().ShowBannerAd();

RewardedAdShowedResult signature:

public class BannerAdShowedResult
{
    public string error;
}

HideBannerAd​

// Method
P101XP.GetInstance().HideBannerAd();

IsBannerAdLoaded (IronSource only)​

// Method
var isLoaded = P101XP.GetInstance().IsBannerAdLoaded();

Rewarded Interstitial Ad (AdMob only)​

LoadRewardedInterstitialAd → OnRewardedInterstitialAdLoadedEvent​

// Callback
void OnRewardedInterstitialAdLoaded(RewardedInterstitialAdLoadedResult result)
{
    // Success: string.IsNullOrEmpty(result.error)
    // Failure: result.error
}

P101XP.GetInstance().OnRewardedInterstitialAdLoadedEvent += OnRewardedInterstitialAdLoaded;

// Method
P101XP.GetInstance().LoadRewardedInterstitialAd("rewarded_interstitial_ad_unit_id");

RewardedAdShowedResult signature:

public class RewardedInterstitialAdLoadedResult
{
    public string error;
}

ShowRewardedInterstitialAd → OnRewardedInterstitialAdShowedEvent​

// Callback
void OnRewardedInterstitialAdShowed(RewardedInterstitialAdShowedResult result)
{
    // Success: string.IsNullOrEmpty(result.error)
    // Reward:
    //   result.amount
    //   result.name
    //
    // Failure:
    //   result.error
}

P101XP.GetInstance().OnRewardedInterstitialAdShowedEvent += OnRewardedInterstitialAdShowed;

// Method
P101XP.GetInstance().ShowRewardedInterstitialAd();

RewardedAdShowedResult signature:

public class RewardedInterstitialAdShowedResult
{
    public int amount;
    public string name;
    public string error;
}

App Open Ad (AdMob only)​

(Shown automatically by the SDK — no manual “Show” method in your list)

OnAppOpenAdLoadedEvent​

// Callback
void OnAppOpenAdLoaded(AppOpenAdLoadedResult result)
{
    // Success: string.IsNullOrEmpty(result.error)
    // Failure: result.error
}

P101XP.GetInstance().OnAppOpenAdLoadedEvent += OnAppOpenAdLoaded;

RewardedAdShowedResult signature:

public class AppOpenAdLoadedResult
{
    public string error;
}

OnAppOpenAdShowedEvent​

// Callback
void OnAppOpenAdShowed(AppOpenAdShowedResult result)
{
    // Success: string.IsNullOrEmpty(result.error)
    // Failure: result.error
}

P101XP.GetInstance().OnAppOpenAdShowedEvent += OnAppOpenAdShowed;

RewardedAdShowedResult signature:

public class AppOpenAdShowedResult
{
    public string error;
}

ResetConsentInformation​

// Method
P101XP.GetInstance().ResetConsentInformation();