Ads Kit for Unity - Unified Open-Source Ad Integration Plugin

Monetize Your Unity Games with a Single API

Ads Kit is an open-source Unity plugin that simplifies ad integration across multiple ad networks. With a unified API, you can easily manage Banner, Interstitial, and Rewarded ads, reducing the complexity of handling different SDKs.

🚀 Currently Supported Ad Networks:
✅ Google AdMob
✅ AppLovin
✅ Unity Level Play

🔜 Coming Soon:
🔹 Facebook/Meta Audience Network
🔹 LiftOff

---

✨ Features

✅ One Unified API – Load and show ads from multiple networks using a single interface.
✅ Supports Banner, Interstitial, and Rewarded Ads – A complete solution for your monetization needs.
✅ Mediation & Prioritization – Optimize revenue by setting custom ad network priorities.
✅ Zero Extra Setup – Automatically configures required details in Info.plist and AndroidManifest.xml.
✅ Auto-Loading Ads – Ads can be preloaded in the background for seamless display.
✅ GDPR & Privacy Compliance – Uses Google’s UMP (User Messaging Platform) for consent management.
✅ No-Code Solution – Set up and manage ads without writing any code.

---

Feedback | Support | Documentation(In-Progress)

Setup

No-Code workflow

📌 Getting Started

1️⃣ Install Ads Kit

✅ Option 1: Unity Package

Download the latest .unitypackage from the GitHub Releases page and import it into your Unity project.

✅ Option 2: Git Clone (with CoreLibrary)

Clone the repository along with its dependency (CoreLibrary) using:

git clone --recurse-submodules https://github.com/voxelbusters/ads-kit.git

Copy the contents of the Assets folder into your Unity project.

If you cloned without submodules, run:

git submodule update --init --recursive

2️⃣ Import Required Namespaces

Before using Ads Kit, add the required namespaces:

using VoxelBusters.CoreLibrary; 
using VoxelBusters.AdsKit;

3️⃣ Initialize Ads Kit

To start using Ads Kit, initialize it with a consent form provider:

public  void  InitialiseAdsManager(IConsentFormProvider consentProvider)
{
  var operation = AdsManager.Initialise(consentProvider);
  operation.OnComplete += (operationHandle) =>
    {
      // Ads Kit is now ready!
    };
}

Get Consent Form Provider

You can implement your own consent provider if you don't want the default consent provider (UPM from Google AdMob). Retrieve the available provider using:

private IConsentFormProvider GetConsentFormProvider()
{
    IConsentFormProvider availableProvider = AdServices.GetConsentFormProvider();

    if (availableProvider == null)
    {
      throw  new Exception("No IConsentFormProvider found. Implement IConsentFormProvider or enable AdMob for default consent form provider.");
    }

    return availableProvider;
}

---

🎯 Using Ads Kit

🔹 Load an Ad

public  void  LoadAd(string placementId)
{
    AdsManager.LoadAd(placementId);
}

🔹 Show an Ad

public  void  ShowAd(string placementId)
{
    AdsManager.ShowAd(placementId);
}

📌 Ensure the ad is loaded before calling ShowAd if Auto Load is off.

🔹 Hide an Ad (For Banners Only)

public  void  HideAd(string placementId)
{
    AdsManager.HideAd(placementId);
}

📌 Destroy the ad only if it’s no longer needed (affects fill rate).

AdsManager.HideAd(placementId, destroy: true);

---

🎛️ Registering Ad Events

Track ad lifecycle events via IAdLifeCycleListener or attach callbacks to the AsyncOperation returned by API methods.

var operation = AdsManager.LoadAd("placementId");
operation.OnComplete += (operationHandle) =>
{   if (operationHandle.Error == null)
    {
        Debug.Log("Ad Loaded Successfully!");
    }
    else
    {
        Debug.LogError("Ad Failed to Load: " + operationHandle.Error);
    }
};

---

📢 No-Code Solution

If you prefer a no-code implementation, Ads Kit offers an easy way to integrate ads without writing a single line of code. Check the No-Code Solution section for more details.

---

👨‍💻 Authors

Ads Kit is created and maintained by Voxel Busters.

Core Authors & Maintainers:

Ashwin Kumar @itsashwinkumar

Ayyappa @manwithsteelnerves

🛠️ Contributing to Ads Kit

Ads Kit is a community-driven project, and we welcome all contributions!

💡 Ways to contribute:

• Fork the repo and submit a pull request

• Report bugs and suggest new features

• Improve documentation

🎉 A huge thanks to all our contributors who make Ads Kit better every day!

🔗 Start contributing today: GitHub Link

---

📄 License

Ads Kit is open-source and available under the MIT License.

📌 MIT License – Free to use, modify, and distribute!

---

📥 Download & Get Started

🚀 Download Ads Kit on GitHub and start monetizing your Unity game today!