集成适用于 Android 的广告品质 SDK
方便集成适用于 Android 的 LevelPlay Ad 品质 SDK，涵盖设置步骤和修改配置。
阅读时间6 分钟最后更新于 2 天前
Ad Quality 有助于监控和控制用户看到的广告内容，确保内容与应用程序的目标保持一致并增强用户体验。在投放吸引受众的相关广告的同时，最大限度发挥收入潜力。
注意
从版本 8.9.0 开始，Ad 品质 集成到 LevelPlay SDK 中，并在实现 LevelPlay 时自动初始化。如果未在构建中实现 LevelPlay，或使用早于 8.9.0 的 LevelPlay SDK 版本，则适用以下概述的步骤。
先决条件
按照我们的分步指南，在 LevelPlay 平台中配置应用程序。
步骤 1：将广告品质 SDK 导入 app
Gradle
- 将以下代码添加到您的应用级别 build.gradle 文件的 repository 部分中：
repositories { mavenCentral()}
- 然后将以下代码添加到 dependencies 部分中：
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'}
步骤 2：初始化 SDK
- 使用 LevelPlay app 密钥初始化广告品质 SDK（可在 Unity LevelPlay 平台中找到）。
- 将以下代码添加到app程序的主线程中，或与其他广告网络 SDK 位于同一线程中，以初始化 Ad 品质 SDK：
import com.ironsource.adqualitysdk.sdk.IronSourceAdQuality;protected void onCreate(Bundle savedInstanceState) { // Initialize IronSourceAdQuality.getInstance().initialize(this, appKey);}
步骤 3（可选）：高级 SDK 初始化
注意
要使用以下配置，请在初始化 LevelPlay SDK 之前初始化广告品质 SDK。
自定义集成设置，从而使用以下特殊配置获得更多功能：
- 用户 ID：使用您自己的用户 ID，而不是 Ad 品质 中的默认 ID
- 测试模式：测试 Ad Quality SDK 集成（默认值为 false）
- 日志级别：选择要调试代码问题的日志级别（默认值为 INFO）
使用以下代码，通过构建器创建配置对象。
ISAdQualityConfig.Builder adQualityConfigBuilder = new ISAdQualityConfig.Builder();
用户 ID
Ad Quality SDK 提供了两个选项来配置您的用户 ID：
- 使用您自己的用户 ID，并在初始化之前或期间添加它们：
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.
- 在初始化 Ad 品质 SDK 后更默认用户 ID，因为 ID 的情况稍后设置。
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.
测试模式
adQualityConfigBuilder.setTestMode(true); // The default is false - set to true only to test your Ad Quality integration
日志级别
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);
步骤 4（可选）：配置 SDK 回调事件
注意
如果使用 LevelPlay，请确保先初始化 Ad Quality，以便使用以下功能
ISAdQualityInitListener：
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);
注意
初始化 Ad Quality SDK 所需的时间取决于集成到应用中的广告网络 SDK 的数量。网络连接问题也可能导致延时。初始化平均需要 3 到 4 秒。
步骤 5（可选）：将广告展示级别的广告收入上报给 Ad Quality SDK
注意
如果使用 LevelPlay，请确保先初始化 Ad Quality，以便使用以下功能
注意
该功能仅支持全屏广告服务。对于 LevelPlay、MAX 和 DT FairBid，此数据会自动收集
广告品质 SDK 7.2.0+ 支持展示级别广告收入报告：
要在 Ad Quality SDK 中上报广告展示级别的广告收入，请将以下代码片段添加到 SDK 集成中。
重要
应在广告展示时调用 方法，在广告生命周期之外调用此方法将没有影响
sendCustomMediationRevenueISAdQualityCustomMediationRevenue.Builder builder = new ISAdQualityCustomMediationRevenue.Builder() .setMediationNetwork(ISAdQualityMediationNetwork.SELF_MEDIATED) .setAdType(ISAdQualityAdType.REWARDED_VIDEO) .setPlacement("placement") .setRevenue(0.12);IronSourceAdQuality.getInstance().sendCustomMediationRevenue(builder.build());
如果使用 AdMob 聚合，请按照以下步骤操作：
- 要求 AdMob 客户经理启用 AdMob 广告展示级别 LTV (iLTV)
- 验证您在 Android 或 iOS 上使用的是 GMA SDK 8.12.0 或更高版本，并且该版本支持 iLTV
- 将以下代码片段添加到 Ad Quality SDK 集成中：
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()); } });}