AdMob 插页式广告加载与显示：解决广告不显示问题-java教程-PHP中文网

AdMob 插页式广告加载与显示：解决广告不显示问题

本文旨在解决 AdMob 插页式广告在 Android 应用中无法显示的核心问题。通过深入剖析插页式广告的异步加载机制，教程将指导开发者如何正确地在应用生命周期中加载广告，并在适当的用户事件触发后安全地显示广告，避免因加载未完成而导致广告对象为空的常见错误，并提供详细的代码示例和最佳实践。

理解 AdMob 插页式广告的异步加载机制

在 android 应用中集成 admob 插页式广告时，开发者常遇到的一个问题是，尽管代码逻辑看似正确，但广告却无法显示，调试时发现广告对象为 null。这通常是由于未能正确理解 admob 广告的异步加载特性所致。

AdMob 插页式广告的加载是一个异步操作。这意味着当你调用 InterstitialAd.load() 方法时，广告并不会立即加载完成并返回一个可用的广告实例。相反，它会在后台进行网络请求、广告填充等操作，并在加载成功或失败时通过回调方法通知应用。如果在广告加载完成之前就尝试显示它，那么 InterstitialAd 对象很可能仍然是 null，从而导致广告无法显示。

正确的广告加载与显示流程

为了确保插页式广告能够成功加载并显示，应遵循以下核心原则：

尽早加载广告： 在需要显示广告的 Activity 或 Fragment 的生命周期早期（例如 onCreate() 或 onResume() 方法中）开始加载广告。这为广告提供了充足的加载时间。
等待加载完成： 只有在 InterstitialAdLoadCallback 的 onAdLoaded() 方法被调用后，才表明广告已成功加载并准备好显示。
在适当的时机显示： 不应在广告加载完成后立即显示。插页式广告旨在自然的用户流程中断点（如游戏关卡结束、任务完成、应用切换等）显示，以避免打扰用户体验。

示例代码：构建一个健壮的 AdsManager

为了更好地管理 AdMob 广告的加载和显示，建议创建一个专门的 AdsManager 类。以下是优化后的 AdsManager 及其在 Activity 中的使用示例。

1. AdsManager 类

import android.app.Activity;
import android.content.Context;
import android.util.Log;
import androidx.annotation.NonNull;
import com.google.android.gms.ads.AdError;
import com.google.android.gms.ads.AdRequest;
import com.google.android.gms.ads.FullScreenContentCallback;
import com.google.android.gms.ads.LoadAdError;
import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.admanager.AdManagerAdRequest; // For AdManager, use AdRequest for AdMob
import com.google.android.gms.ads.interstitial.InterstitialAd;
import com.google.android.gms.ads.interstitial.InterstitialAdLoadCallback;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;
import com.google.android.gms.ads.AdView; // For banner ads

public class AdsManager {

    private static final String TAG = "AdMobManager";
    // 推荐使用测试广告单元ID进行开发和测试
    // 正式发布时请替换为您的真实广告单元ID
    private static final String INTERSTITIAL_AD_UNIT_ID = "ca-app-pub-3940256099942544/1033173712";

    private Context context;
    private InterstitialAd mInterstitialAd;

    public AdsManager(Context context) {
        this.context = context;
        // 初始化 AdMob SDK
        MobileAds.initialize(context, new OnInitializationCompleteListener() {
            @Override
            public void onInitializationComplete(@NonNull InitializationStatus initializationStatus) {
                Log.d(TAG, "AdMob SDK initialized.");
            }
        });
    }

    /**
     * 加载插页式广告。此方法是异步的。
     * 广告加载成功后，mInterstitialAd 实例才会被赋值。
     */
    public void loadInterstitialAd() {
        if (mInterstitialAd != null) {
            Log.d(TAG, "Interstitial Ad is already loaded or being loaded.");
            return; // 避免重复加载
        }

        AdRequest adRequest = new AdRequest.Builder().build();

        InterstitialAd.load(context, INTERSTITIAL_AD_UNIT_ID, adRequest, new InterstitialAdLoadCallback() {
            @Override
            public void onAdFailedToLoad(@NonNull LoadAdError loadAdError) {
                // 广告加载失败
                Log.e(TAG, "Interstitial Ad failed to load: " + loadAdError.getMessage());
                mInterstitialAd = null; // 确保加载失败时广告对象为null
            }

            @Override
            public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
                // 广告加载成功
                Log.d(TAG, "Interstitial Ad loaded successfully.");
                mInterstitialAd = interstitialAd;

                // 设置全屏内容回调，监听广告的生命周期事件
                mInterstitialAd.setFullScreenContentCallback(new FullScreenContentCallback() {
                    @Override
                    public void onAdClicked() {
                        // 广告被点击时调用
                        Log.d(TAG, "Ad was clicked.");
                    }

                    @Override
                    public void onAdDismissedFullScreenContent() {
                        // 广告关闭时调用。此时可以考虑加载下一个广告。
                        Log.d(TAG, "Ad was dismissed.");
                        mInterstitialAd = null; // 广告关闭后，将其置为null，以便下次加载新广告
                        // loadInterstitialAd(); // 可选：立即加载下一个广告
                    }

                    @Override
                    public void onAdFailedToShowFullScreenContent(@NonNull AdError adError) {
                        // 广告显示失败时调用
                        Log.e(TAG, "Ad failed to show: " + adError.getMessage());
                        mInterstitialAd = null; // 显示失败后，将其置为null
                    }

                    @Override
                    public void onAdImpression() {
                        // 广告展示时调用
                        Log.d(TAG, "Ad recorded an impression.");
                    }

                    @Override
                    public void onAdShowedFullScreenContent() {
                        // 广告全屏显示时调用
                        Log.d(TAG, "Ad showed fullscreen content.");
                        // 广告显示后，mInterstitialAd 实例应该被视为已消费，置为null或重新加载
                        // 通常在 onAdDismissedFullScreenContent 中置为null并重新加载更合适
                    }
                });
            }
        });
    }

    /**
     * 显示插页式广告。只有当广告已成功加载时才能显示。
     *
     * @param activity 用于显示广告的 Activity 上下文。
     */
    public void showInterstitialAd(Activity activity) {
        if (mInterstitialAd != null) {
            Log.d(TAG, "Showing Interstitial Ad.");
            mInterstitialAd.show(activity);
        } else {
            Log.d(TAG, "Interstitial Ad is not ready yet or failed to load. Attempting to load again.");
            // 如果广告未准备好，可以尝试重新加载
            loadInterstitialAd();
            // 或者通知用户广告未准备好
        }
    }

    /**
     * 加载横幅广告（如果需要）。
     * @param adView 目标 AdView 实例。
     */
    public void createBannerAd(AdView adView) {
        AdRequest adRequest = new AdRequest.Builder().build();
        adView.loadAd(adRequest);
        Log.d(TAG, "Banner Ad loading initiated.");
    }
}

登录后复制

2. 在 Activity 中使用 AdsManager

import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import androidx.appcompat.app.AppCompatActivity;

public class ColoringActivity extends AppCompatActivity {

    private AdsManager adsManager;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_coloring);

        adsManager = new AdsManager(this);

        // 在 Activity 创建时尽早加载插页式广告
        // 这为广告提供了充足的加载时间
        adsManager.loadInterstitialAd();

        // 示例：通过按钮点击事件来显示广告
        Button showAdButton = findViewById(R.id.show_ad_button); // 假设您有一个ID为show_ad_button的按钮
        if (showAdButton != null) {
            showAdButton.setOnClickListener(new View.OnClickListener() {
                @Override
                public void onClick(View v) {
                    // 当用户点击按钮时，尝试显示广告
                    adsManager.showInterstitialAd(ColoringActivity.this);
                }
            });
        }

        // 实际应用中，您可能会在其他逻辑点显示广告，例如：
        // if (gameLevelCompleted) {
        //     adsManager.showInterstitialAd(ColoringActivity.this);
        // }
    }

    @Override
    protected void onResume() {
        super.onResume();
        // 可以在 onResume 中再次检查并加载广告，确保广告随时可用
        // 例如，当用户从后台返回应用时
        // adsManager.loadInterstitialAd(); // 如果AdsManager内部没有判断是否已加载，可以在这里再次调用
    }
}

登录后复制

关键配置与注意事项

除了代码逻辑，还有一些必要的配置和最佳实践需要遵循：

1. AndroidManifest.xml 配置

确保您的 AndroidManifest.xml 文件包含必要的权限和 AdMob 应用 ID。

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.your.package.name">

    <!-- 访问网络状态的权限，AdMob 必需 -->
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <!-- 互联网访问权限，AdMob 必需 -->
    <uses-permission android:name="android.permission.INTERNET" />
    <!-- 震动权限，部分广告可能用到 -->
    <uses-permission android:name="android.permission.VIBRATE" />

    <application
        ...
        android:usesCleartextTraffic="true" > <!-- 如果您的应用目标API级别为28或更高，且需要HTTP流量，请添加此项 -->

        <!-- AdMob 应用 ID，替换为您的真实 ID -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-8673003336752212~XXXXXXXXXX"/> <!-- 替换为您的真实应用ID -->

        <!-- AdMob SDK 的 Activity 声明 -->
        <activity
            android:name="com.google.android.gms.ads.AdActivity"
            android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize"
            android:exported="false"
            android:theme="@android:style/Theme.Translucent" />

        ...
    </application>
</manifest>

登录后复制

注意： android:value 中的 ca-app-pub-8673003336752212~XXXXXXXXXX 应该替换为您的实际 AdMob 应用 ID。对于测试，可以使用 Google 提供的测试应用 ID ca-app-pub-3940256099942544~3347511713。

MagicStudio

图片处理必备效率神器！为你的图片提供神奇魔法

102

查看详情

2. build.gradle (Module) 依赖

确保您的 build.gradle (Module: app) 文件中包含了 AdMob SDK 的依赖。

dependencies {
    // ... 其他依赖
    implementation 'com.google.android.gms:play-services-ads:21.3.0' // 使用最新稳定版本
}

登录后复制

请始终检查 AdMob 官方文档，以获取最新推荐的 play-services-ads 版本。

3. 测试广告单元 ID

在开发和测试阶段，务必使用 Google 提供的测试广告单元 ID。这可以避免您的真实 AdMob 账户因无效点击或展示而受到影响。

插页式广告测试 ID: ca-app-pub-3940256099942544/1033173712
应用 ID 测试 ID: ca-app-pub-3940256099942544~3347511713

4. 用户体验考量

广告频率： 不要过于频繁地显示插页式广告，这会严重影响用户体验。
自然中断点： 在用户任务完成、游戏关卡过渡或应用切换等自然中断点显示广告。
预加载： 提前加载广告，确保在需要显示时广告已准备就绪，减少用户等待时间。

总结

解决 AdMob 插页式广告不显示问题的关键在于理解其异步加载机制。通过在 Activity 生命周期早期启动广告加载，并在 onAdLoaded 回调成功触发后才尝试显示广告，同时结合健壮的 AdsManager 类管理广告生命周期，可以有效避免 mInterstitialAd 为 null 的常见错误。遵循正确的配置和最佳实践，将有助于您成功集成 AdMob 插页式广告，并为用户提供良好的体验。

以上就是AdMob 插页式广告加载与显示：解决广告不显示问题的详细内容，更多请关注php中文网其它相关文章！