Initialize the SDK in Android
Initialize the Unity Ads SDK in your Android app. Set your Game ID and configure a listener to handle initialization status and enable ad monetization.
Read time 1 minuteLast updated 2 months ago
Important
You must configure user consent before or during SDK initialization. Serving ads without consent configuration may violate privacy regulations in some regions.
To initialize the SDK, you need your app's Game ID for the target platform. To locate it, go to the Unity Monetization Dashboard, then navigate to Monetization > Apps > [your app] > Network.
Initialize the SDK early in your project's run-time life cycle before you need to load an ad. Refer to the following code sample to understand how to initialize the Unity Ads SDK.
SDK initialization example
Use to construct a configuration object with your Game ID, test mode flag, and mediation metadata, then pass it to along with an . The listener's callback receives a if initialization fails, or on success.
InitializationConfiguration.BuilderUnityAds.initialize()InitializationListeneronInitializationCompleteUnityAdsErrornullInitializationConfiguration config = new InitializationConfiguration.Builder("YOUR_GAME_ID") .withTestMode(true) .build();InitializationListener listener = error -> { if (error == null) { // Initialization successful } else { // Handle initialization error }};UnityAds.initialize(config, listener);
Next steps: To continue your integration, refer to the Implement interstitial ads in Android documentation.