AdMob插页式广告加载与展示：异步机制深度解析与正确实践-java教程-PHP中文网

AdMob插页式广告加载与展示：异步机制深度解析与正确实践

本文深入探讨AdMob插页式广告无法显示的核心原因——异步加载机制。通过详细的代码示例和最佳实践，指导开发者如何正确地初始化、加载、监听广告状态并在恰当的时机展示插页式广告，确保广告能够顺利呈现，并提供完整的配置检查清单，帮助开发者避免常见错误。

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

在使用admob集成插页式广告时，开发者常遇到的问题是广告无法显示，调试时发现广告对象为null。这通常是由于对admob广告的异步加载机制理解不足导致的。与传统的同步操作不同，admob广告的加载是一个耗时操作，它会在后台进行网络请求，下载广告素材。在加载完成之前，尝试显示广告对象将导致nullpointerexception或广告不显示。

核心问题所在：

原始代码中的问题在于，在调用 adsManager.loadInterstatialAd() 之后，立即尝试通过 mInterstitialAd.show() 显示广告：

adsManager = new AdsManager(this);
mInterstitialAd = adsManager.loadInterstatialAd(); // 开始加载广告，但此时mInterstitialAd仍为null

if (mInterstitialAd != null) { // 此时mInterstitialAd几乎总是null
    mInterstitialAd.show(ColoringActivity.this);
}

登录后复制

loadInterstatialAd() 方法内部会启动一个异步加载过程，并通过 InterstitialAdLoadCallback 回调通知加载结果。在 onAdLoaded 被调用并将加载成功的 InterstitialAd 实例赋值给 mInterstitialAd 之前，外部的 mInterstitialAd 仍然是其初始值（null）。因此，条件判断 if (mInterstitialAd != null) 始终为假，广告自然无法显示。

正确思路： 广告必须先成功加载，然后才能显示。加载过程是异步的，这意味着我们不能立即显示，而必须等待加载完成的回调。

2. AdMob插页式广告的正确集成流程

为了确保插页式广告能够正确加载和显示，我们需要遵循以下步骤：

2.1 依赖配置与权限声明

在开始之前，请确保您的项目已正确配置AdMob SDK。

build.gradle (Module):

dependencies {
    implementation 'com.google.android.gms:play-services-ads:22.6.0' // 保持最新版本
}

登录后复制

AndroidManifest.xml:

落笔AI

AI写作，AI写网文、AI写长篇小说、短篇小说

查看详情

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<application
    <!-- ... 其他应用配置 ... -->
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/> <!-- 替换为您的AdMob应用ID -->
</application>

登录后复制

注意： 确保您的APPLICATION_ID与您在AdMob后台创建的应用ID一致。对于测试，可以使用Google提供的测试ID。

2.2 AdMob SDK初始化

在应用的启动阶段（例如，主Activity的onCreate方法中），初始化AdMob SDK。

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        MobileAds.initialize(this, new OnInitializationCompleteListener() {
            @Override
            public void onInitializationComplete(InitializationStatus initializationStatus) {
                // AdMob SDK 初始化完成
                Log.d("AdMob", "AdMob SDK initialized!");
            }
        });
    }
}

登录后复制

或者在Activity中：

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        MobileAds.initialize(this, initializationStatus -> {
            // AdMob SDK 初始化完成
            Log.d("AdMob", "AdMob SDK initialized!");
        });
    }
}

登录后复制

2.3 优化 AdsManager 类设计

为了更好地管理广告生命周期和异步回调，建议重新设计 AdsManager 类。它应该负责加载广告，并通过回调通知Activity广告的状态。

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.interstitial.InterstitialAd;
import com.google.android.gms.ads.interstitial.InterstitialAdLoadCallback;
import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class AdsManager {

    private static final String TAG = "AdsManager";
    private Context context;
    private InterstitialAd mInterstitialAd;
    private String interstitialAdUnitId;

    // 定义一个回调接口，用于通知Activity广告状态
    public interface InterstitialAdListener {
        void onAdLoaded();
        void onAdFailedToLoad(LoadAdError adError);
        void void onAdShowed();
        void onAdDismissed();
        void onAdFailedToShow(AdError adError);
    }

    private InterstitialAdListener adListener;

    public AdsManager (Context context, String adUnitId, InterstitialAdListener listener) {
        this.context = context;
        this.interstitialAdUnitId = adUnitId;
        this.adListener = listener;
        // AdMob SDK 初始化通常在Application类中进行，这里不再重复
        // MobileAds.initialize(context, new OnInitializationCompleteListener() { /* ... */ });
    }

    /**
     * 加载插页式广告。
     * 广告加载是异步的，结果通过 InterstitialAdListener 回调。
     */
    public void loadInterstitialAd () {
        if (mInterstitialAd != null) {
            Log.d(TAG, "Interstitial ad is already loaded. No need to load again.");
            if (adListener != null) {
                adListener.onAdLoaded(); // 告知已加载
            }
            return;
        }

        AdRequest adRequest = new AdRequest.Builder().build();
        InterstitialAd.load(context, interstitialAdUnitId, adRequest, new InterstitialAdLoadCallback() {
            @Override
            public void onAdFailedToLoad(@NonNull LoadAdError loadAdError) {
                super.onAdFailedToLoad(loadAdError);
                Log.d(TAG, "Interstitial ad failed to load: " + loadAdError.getMessage());
                mInterstitialAd = null; // 加载失败，确保置空
                if (adListener != null) {
                    adListener.onAdFailedToLoad(loadAdError);
                }
            }

            @Override
            public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
                super.onAdLoaded(interstitialAd);
                mInterstitialAd = interstitialAd;
                Log.d(TAG, "Interstitial ad loaded successfully.");

                mInterstitialAd.setFullScreenContentCallback(new FullScreenContentCallback() {
                    @Override
                    public void onAdClicked() {
                        super.onAdClicked();
                        Log.d(TAG, "Ad was clicked.");
                    }

                    @Override
                    public void onAdDismissedFullScreenContent() {
                        super.onAdDismissedFullScreenContent();
                        Log.d(TAG, "Ad was dismissed.");
                        mInterstitialAd = null; // 广告显示后即失效，需置空以便重新加载
                        if (adListener != null) {
                            adListener.onAdDismissed();
                        }
                        // 建议在此处重新加载下一个插页式广告
                        // loadInterstitialAd();
                    }

                    @Override
                    public void onAdFailedToShowFullScreenContent(@NonNull AdError adError) {
                        super.onAdFailedToShowFullScreenContent(adError);
                        Log.e(TAG, "Ad failed to show: " + adError.getMessage());
                        mInterstitialAd = null; // 显示失败，确保置空
                        if (adListener != null) {
                            adListener.onAdFailedToShow(adError);
                        }
                    }

                    @Override
                    public void onAdImpression() {
                        super.onAdImpression();
                        Log.d(TAG, "Ad recorded an impression.");
                    }

                    @Override
                    public void onAdShowedFullScreenContent() {
                        super.onAdShowedFullScreenContent();
                        Log.d(TAG, "Ad showed full screen content.");
                        if (adListener != null) {
                            adListener.onAdShowed();
                        }
                        // 广告显示后，mInterstitialAd会被置空，以便下次重新加载。
                        // 这里可以不立即置空，因为onAdDismissedFullScreenContent会处理。
                        // mInterstitialAd = null;
                    }
                });

                if (adListener != null) {
                    adListener.onAdLoaded();
                }
            }
        });
    }

    /**
     * 显示插页式广告。
     * 只有当广告已加载且不为null时才能显示。
     */
    public void showInterstitialAd (Activity activity) {
        if (mInterstitialAd != null) {
            mInterstitialAd.show(activity);
        } else {
            Log.d(TAG, "Interstitial ad is not ready yet. Please load it first.");
            // 可以在这里选择重新加载广告，或者提示用户
            // loadInterstitialAd();
        }
    }

    /**
     * 检查广告是否已加载。
     */
    public boolean isAdLoaded() {
        return mInterstitialAd != null;
    }
}

登录后复制

关键改进点：

loadInterstitialAd() 方法不再直接返回 mInterstitialAd，而是通过 InterstitialAdListener 接口通知调用者广告的加载状态。
mInterstitialAd 在 onAdLoaded 回调中被赋值，确保只有在广告真正加载成功后才持有实例。
在 onAdDismissedFullScreenContent 或 onAdFailedToShowFullScreenContent 中将 mInterstitialAd 置为 null，因为插页式广告是“一次性”的，每次显示后都需要重新加载。
提供了 isAdLoaded() 方法，允许Activity在显示广告前进行检查。

2.4 在Activity中正确使用 AdsManager

Activity现在需要实现 InterstitialAdListener 接口，并在适当的时机加载和显示广告。

import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import androidx.annotation.Nullable;
import androidx.appcompat.app.AppCompatActivity;

import com.google.android.gms.ads.LoadAdError;
import com.google.android.gms.ads.AdError;

public class ColoringActivity extends AppCompatActivity implements AdsManager.InterstitialAdListener {

    private static final String TAG = "ColoringActivity";
    private AdsManager adsManager;
    private Button showAdButton;

    // 使用Google提供的测试广告单元ID
    private static final String INTERSTITIAL_AD_UNIT_ID = "ca-app-pub-3940256099942544/1033173712";

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_coloring); // 假设您的布局包含一个按钮

        // 初始化 AdsManager
        adsManager = new AdsManager(this, INTERSTITIAL_AD_UNIT_ID, this);

        showAdButton = findViewById(R.id.show_ad_button); // 假设您有一个ID为show_ad_button的按钮
        showAdButton.setEnabled(false); // 默认禁用，直到广告加载完成

        // 在Activity生命周期的早期加载广告，例如 onCreate 或 onResume
        // 这样可以提前加载，提高用户体验
        adsManager.loadInterstitialAd();

        showAdButton.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                if (adsManager.isAdLoaded()) {
                    adsManager.showInterstitialAd(ColoringActivity.this);
                } else {
                    Log.d(TAG, "Interstitial ad is not yet loaded. Trying to load again.");
                    // 如果用户点击时广告未准备好，可以尝试重新加载
                    adsManager.loadInterstitialAd();
                    // 也可以给用户一个提示
                }
            }
        });
    }

    @Override
    protected void onResume() {
        super.onResume();
        // 可以在这里再次检查并加载广告，确保广告在用户重新进入Activity时准备就绪
        // adsManager.loadInterstitialAd();
    }

    // 实现 AdsManager.InterstitialAdListener 接口的方法
    @Override
    public void onAdLoaded() {
        Log.d(TAG, "Interstitial ad is ready to be shown!");
        // 广告加载成功，现在可以启用显示广告的按钮或触发显示逻辑
        if (showAdButton != null) {
            showAdButton.setEnabled(true);
        }
    }

    @Override
    public void onAdFailedToLoad(LoadAdError adError) {
        Log.e(TAG, "Interstitial ad failed to load: " + adError.getMessage());
        // 广告加载失败，可以禁用显示按钮或显示错误信息
        if (showAdButton != null) {
            showAdButton.setEnabled(false);
        }
    }

    @Override
    public void onAdShowed() {
        Log.d(TAG, "Interstitial ad showed.");
        // 广告已显示，通常在此处禁用按钮，因为广告显示后需要重新加载
        if (showAdButton != null) {
            showAdButton.setEnabled(false);
        }
    }

    @Override
    public void onAdDismissed() {
        Log.d(TAG, "Interstitial ad dismissed. Loading a new one.");
        // 广告被用户关闭，此时广告已失效，需要重新加载下一个广告
        adsManager.loadInterstitialAd();
        // 重新加载后，按钮会再次被 onAdLoaded 启用
    }

    @Override
    public void onAdFailedToShow(AdError adError) {
        Log.e(TAG, "Interstitial ad failed to show: " + adError.getMessage());
        // 广告显示失败，同样需要重新加载
        adsManager.loadInterstitialAd();
        if (showAdButton != null) {
            showAdButton.setEnabled(false);
        }
    }
}

登录后复制

3. 注意事项与最佳实践

异步加载的本质： 始终记住广告加载是异步的。不要在调用 load 方法后立即尝试 show，而应通过回调函数来处理广告加载完成的事件。
提前加载： 建议在用户可能看到广告之前（例如，在Activity的onCreate或onResume方法中）预加载插页式广告。这可以减少用户等待时间，提升用户体验。
一次性使用： 插页式广告在显示一次后就会失效。每次用户关闭广告或广告显示失败后，您都需要

以上就是AdMob插页式广告加载与展示：异步机制深度解析与正确实践的详细内容，更多请关注php中文网其它相关文章！