BlueStack.SDK.Maui 1.0.0-alpha1

BlueStack-SDK MAUI

Getting started

BlueStack-SDK MAUI library provides functionality to integrate native(Android and iOS) BlueStack SDK into MAUI project. Using this library developer can display ads on their application from Madvertise and other third-party ad networks.

Prerequisites

.NET:

• .NET 7.0

iOS:

• Xcode 14.3 or later
• Minimum iOS version 13.0

Android:

• Android 5.0 (API 21) or higher

Using BlueStackSDK MAUI library

Initialization

Initialize BlueStack sdk with appId, settings and a completion block.

public partial class MainPage : ContentPage
{
    private BannerAd _bannerAd;

    public MainPage() {
        Settings settings = new Settings(true);
        BlueStackAds.Initialize("YOUR_APP_ID_HERE", settings, OnAdSDKInitialized);
    }

    private void OnAdSDKInitialized(InitializationStatus initializationStatus)
    {
        Debug.Print("BlueStack SDK has been initialized");
    }
}

Showing Banner Ad

Step 1. Instantiate Banner Ad

You can instanstiate a Banner ad right after SDK finishes it's initialization. You have to pass the platform specific banner placement id and banner AdPosition in BannerAd constructor.

        _bannerAd = new BannerAd(adUnitId, AdPosition.Top);

Banner ad supports ad positions of following types:

Step 2. Register event listeners

BannerAd exposes the following events through it's lifecycle.

To register for banner ad events, add the following code after instantiating BannerAd.

    _bannerAd.OnBannerDidLoad += (sender, args) =>
    {
        Debug.Log("OnBannerDidLoad");
    };

    _bannerAd.OnBannerDidFailed += (sender, args) =>
    {
        Debug.LogError("OnBannerDidFailed: " + args.Message);
    };

    _bannerAd.OnBannerDisplay += (sender, args) => 
    { 
        Debug.Log("OnBannerDisplay"); 
    };
    _bannerAd.OnBannerHide += (sender, args) => 
    { 
        Debug.Log("OnBannerHide"); 
    };
    _bannerAd.OnAdClicked += (sender, args) => 
    { 
        Debug.Log("OnAdClicked"); 
    };
    _bannerAd.OnBannerDidRefresh += (sender, args) =>
    {
        Debug.Log("OnBannerDidRefresh");
    };
    _bannerAd.OnBannerDidFailToRefresh += (sender, args) =>
    {
        Debug.LogError("OnBannerDidFailToRefresh: " + args.Message);
    };

:::caution Make sure you only register event listener once. :::

Step 3. Load Banner ad

BannerAd takes AdSize to load banner. It also have another Load method that takes Preference instance along with AdSize. Banner Ad supports following ad sizes:

• Without Preference

_bannerAd.Load(AdSize.Banner);

• With Preference

private LoadBannerAdWithPreference() {

      Preference _preference = new Preference();
      Location myLocation = new Location(Location.NONE_PROVIDER)
      {
          Latitude = 35.757866,
          Longitude = 10.810547
      };
      _preference.SetAge(25);
      _preference.SetLanguage("en");
      _preference.SetGender(Gender.Male);
      _preference.SetKeyword("brand=myBrand;category=sport");
      _preference.SetLocation(myLocation, 1);
      _preference.SetContentUrl("https://madvertise.com/en/");

      _bannerAd.Load(AdSize.Banner, _preference);
  }

**Note 😗*

• The setLocation method takes the following parameters:

  • the Location instance.
  • the CONSENT_FLAG value (corresponds to a int : 0,1,2 or 3).
    • 0 = Not allow to send location.
    • 1 = When you managed location according to consent value.
    • 2 and 3 = Allow the SDK to managed location directly in accordance with the consent value use TCF v1 or TCF v2, see with the madvertise team it depends on your implementation.

Step 4. Show Banner ad

After loading the banner ad you can request it to be displayed.

_bannerAd.Show();

Hide Banner ad

Banner Ad can be set to be hidden also.

_bannerAd.Hide();

Change banner ad position

You can set banner ad position runtime.

_bannerAd.SetPosition(adPosition);

Destroy banner ad

Destroy banner ad if you want to create a new one.

_bannerAd.Destroy();