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 a day ago
To initialize the SDK, you must reference your Project's Game ID for the appropriate platform. You can locate the ID on the Unity Monetization Dashboard by selecting CURRENT PROJECT > Project Settings from the secondary navigation menu. In your game script, you need to implement an
IUnityAdsInitializationListenerNote
Unity Ads requires access to the currently running Activity, so the following example uses .
Because this might not be suitable for all implementations, some customization might be required (depending on the integration).
getApplicationContext()SDK initialization example
import android.os.Bundle;import androidx.appcompat.app.AppCompatActivity;import com.unity3d.ads.example.R;import com.unity3d.ads.IUnityAdsInitializationListener;import com.unity3d.ads.UnityAds;public class InitializeAdsScript extends AppCompatActivity implements IUnityAdsInitializationListener { private String unityGameID = "1234567"; private Boolean testMode = true; @Override protected void onCreate (Bundle savedInstanceState) { super.onCreate (savedInstanceState); setContentView (R.layout.activity_main); // Initialize the SDK: UnityAds.initialize(getApplicationContext(), unityGameID, testMode, this); } @Override public void onInitializationComplete() { } @Override public void onInitializationFailed(UnityAds.UnityAdsInitializationError error, String message) { }}
initializecontextContextunityGameIDIUnityAdsInitializationListenertrueNote
You must implement each of the callback methods in the listener interface, even if they are empty functions for now. You will populate them with the appropriate logic where needed in the following sections. For more information on each listener callback method, refer to the documentation on the API.
IUnityAdsInitializationListener