Integrate Ad Quality SDK for Android
Facilitate the integration of the LevelPlay Ad Quality SDK for Android, covering setup steps and modifying configurations.
読み終わるまでの所要時間 3 分最終更新 1日前
Ad Quality helps you monitor and control the ad content your users see, so you can ensure it aligns with your app's goals and enhances user experience. Maximize your revenue potential while serving relevant ads that engage your audience.
注
Starting with version 8.9.0, Ad Quality is integrated into the LevelPlay SDK and automatically initializes when LevelPlay is implemented. The steps outlined below apply if LevelPlay is not implemented in the build or if you are using a LevelPlay SDK version earlier than 8.9.0.
Prerequisites
Follow our step-by-step guide and configure your application in the LevelPlay platform.Step 1: Import the Ad Quality SDK to your app
Gradle
- Add the following to your app's build.gradle file inside repositories section:
repositories { mavenCentral()}
- Then add the following to the dependencies section:
dependencies { // Ad Quality SDK (standalone; from 8.9.0 Ad Quality is integrated in LevelPlay SDK) implementation 'com.unity3d.ads-mediation:adquality-sdk:9.3.1'}
Step 2: Initialize the SDK
- Initialize the Ad Quality SDK using your LevelPlay app key, which can be found in the Unity LevelPlay Platform.
- Add the following code to your app's main thread, or on the same thread as your other ad network SDKs to initialize the Ad Quality SDK:
import com.ironsource.adqualitysdk.sdk.IronSourceAdQuality;protected void onCreate(Bundle savedInstanceState) { // Initialize IronSourceAdQuality.getInstance().initialize(this, appKey);}
Step 3 (optional): Advanced SDK Initialization
注
To use the configuration below, initialize Ad Quality SDK before initializing LevelPlay SDK.
- User ID: Use your own user IDs, instead of the default IDs from Ad Quality
- Test mode: Test your Ad Quality SDK integration (default is false)
- Log level: Choose a log level to debug code issues (default is INFO)
ISAdQualityConfig.Builder adQualityConfigBuilder = new ISAdQualityConfig.Builder();
User ID
The Ad Quality SDK provides two options for configuring your user IDs:- Use your own user IDs, and add them before or during initialization:
adQualityConfigBuilder.setUserId(userId);// The default user id is Ad Quality internal id.// The user id cannot be null and must be between 2 and 100 characters, otherwise it will be blocked.
- Change the default user IDs after initializing the Ad Quality SDK, for cases for your IDs are set later.
IronSourceAdQuality.getInstance().changeUserId(userId);// The default user id is Ad Quality internal id. // The user id cannot be null and must be between 2 and 100 characters, otherwise it will be blocked.
Test Mode
adQualityConfigBuilder.setTestMode(true); // The default is false - set to true only to test your Ad Quality integration
Log level
adQualityConfigBuilder.setLogLevel(ISAdQualityLogLevel.INFO);// There are 5 different log levels:// ERROR, WARNING, INFO, DEBUG, VERBOSE// The default is INFOISAdQualityConfig adQualityConfig = adQualityConfigBuilder.build();IronSourceAdQuality.getInstance().initialize(this, appKey, adQualityConfig);
Step 4 (optional): Configure SDK callback events
注
If you're using LevelPlay make sure you've init Ad Quality first to use the following functionalities
ISAdQualityConfig.Builder builder = new ISAdQualityConfig.Builder().setAdQualityInitListener(new ISAdQualityInitListener() { @Override public void adQualitySdkInitSuccess() { Log.d("AdQualityInitListener", "adQualitySdkInitSuccess"); } @Override public void adQualitySdkInitFailed(ISAdQualityInitError error, String message) { Log.d("AdQualityInitListener", "adQualitySdkInitFailed " + error + " message: " + message); } }); ISAdQualityConfig adQualityConfig = builder.build();IronSourceAdQuality.getInstance().initialize(this, appKey, adQualityConfig);
注
The time it takes to initialize the Ad Quality SDK depends on the number of ad network SDKs integrated into your app. Network connectivity issues may also cause delays. On average, initializations take between 3 to 4 seconds.
Step 5 (optional): Report impression-level ad revenue to Ad Quality SDK
注
If you're using LevelPlay make sure you've init Ad Quality first to use the following functionalities
注
The feature is support for fullscreen ads only. For LevelPlay, MAX and DT FairBid this data is being collected automatically
重要
sendCustomMediationRevenueIf you're using AdMob mediation, follow these steps:ISAdQualityCustomMediationRevenue.Builder builder = new ISAdQualityCustomMediationRevenue.Builder() .setMediationNetwork(ISAdQualityMediationNetwork.SELF_MEDIATED) .setAdType(ISAdQualityAdType.REWARDED_VIDEO) .setPlacement("placement") .setRevenue(0.12);IronSourceAdQuality.getInstance().sendCustomMediationRevenue(builder.build());
- Ask your AdMob account manager to enable AdMob impression-level LTV (iLTV)
- Verify that you use GMA SDK 8.12.0 or higher for Android or iOS and that the version supports iLTV
- Add the following code snippet to your Ad Quality SDK integration:
RewardedAd mRewardedAd; @Overridepublic void onAdLoaded(@NonNull RewardedAd rewardedAd) { mRewardedAd = rewardedAd; // Set paid event listener mRewardedAd.setOnPaidEventListener(new OnPaidEventListener() { @Override public void onPaidEvent(AdValue adValue) { ISAdQualityCustomMediationRevenue.Builder builder = new ISAdQualityCustomMediationRevenue.Builder() .setMediationNetwork(ISAdQualityMediationNetwork.ADMOB) .setAdType(ISAdQualityAdType.REWARDED_VIDEO) .setPlacement(mRewardedAd.getAdUnitId()) .setRevenue(adValue.getValueMicros()/1000000.0); IronSourceAdQuality.getInstance().sendCustomMediationRevenue(builder.build()); } });}