Android冷启动时展示AppLovin开屏广告的实现方案咨询

原实现存在的核心问题 #

• showAd方法参数错误：appOpenAd.showAd(ApplovinIntAndNative.getInstance(context).applovinAppOpenAdUnitId()) 中，showAd的String参数是Placement ID而非Ad Unit ID，开屏广告需要依附Activity展示，正确传参应为当前Activity实例。
• 冷启动广告时机不匹配：冷启动时AppLovin SDK初始化、广告加载都需要耗时，依赖ProcessLifecycleOwner.ON_START触发展示时，广告大概率未加载完成，无法在Splash页展示。
• 内存泄漏风险：AppOpen持有Activity上下文且被全局的ProcessLifecycleOwner持有，会导致SplashActivity无法被GC回收。
• 页面跳转逻辑缺失：未处理广告展示完成后的跳转逻辑，若Splash直接跳转主界面会覆盖开屏广告。
• 加载时机判断不严谨：构造函数直接调用loadAd()，未确保SDK初始化完成，可能导致加载失败。

优化实现方案 #

1. 重构AppOpen类 #

public class AppOpen implements LifecycleObserver, MaxAdListener {
    private MaxAppOpenAd appOpenAd;
    private final WeakReference<Context> contextRef;
    private AdCallback adCallback;
    private int loadRetryCount = 0;
    private static final int MAX_RETRY_COUNT = 3; // 最大重试次数

    public interface AdCallback {
        void onAdReady();
        void onAdLoadFailed();
        void onAdClosed();
    }

    public AppOpen(Context context) {
        contextRef = new WeakReference<>(context);
        ProcessLifecycleOwner.get().getLifecycle().addObserver(this);
        // 确保SDK初始化完成后再加载广告
        AppLovinSdk sdk = AppLovinSdk.getInstance(context);
        if (sdk.isInitialized()) {
            loadAd();
        } else {
            sdk.setInitializedListener(this::loadAd);
        }
    }

    public void setAdCallback(AdCallback callback) {
        this.adCallback = callback;
    }

    private void loadAd() {
        Context context = contextRef.get();
        if (context == null) return;

        appOpenAd = new MaxAppOpenAd(ApplovinIntAndNative.getInstance(context).applovinAppOpenAdUnitId(), context);
        appOpenAd.setListener(this);
        appOpenAd.loadAd();
    }

    // 对外提供展示方法，需传入当前Activity
    public void showAdIfReady(Activity activity) {
        if (RemovedAd.prouser) return; // 付费用户跳过广告

        if (appOpenAd != null && appOpenAd.isReady()) {
            appOpenAd.showAd(activity);
        } else {
            adCallback?.onAdLoadFailed();
            retryLoadAd();
        }
    }

    private void retryLoadAd() {
        if (loadRetryCount < MAX_RETRY_COUNT) {
            loadRetryCount++;
            loadAd();
        } else {
            adCallback?.onAdLoadFailed();
        }
    }

    @OnLifecycleEvent(Lifecycle.Event.ON_START)
    public void onStart() {
        // 处理应用从后台切前台的开屏广告，冷启动广告由Splash主动触发
        Context context = contextRef.get();
        if (context instanceof Activity) {
            showAdIfReady((Activity) context);
        }
    }

    @Override
    public void onAdLoaded(MaxAd ad) {
        LogUtils.LOGD("onAdLoaded Applovin Appopen");
        loadRetryCount = 0;
        adCallback?.onAdReady();
    }

    @Override
    public void onAdDisplayed(MaxAd ad) {
        LogUtils.LOGD("onAdDisplayed Applovin Appopen");
    }

    @Override
    public void onAdHidden(MaxAd ad) {
        appOpenAd.loadAd();
        adCallback?.onAdClosed();
    }

    @Override
    public void onAdClicked(MaxAd ad) {
        LogUtils.LOGD("onAdClicked Applovin Appopen");
    }

    @Override
    public void onAdLoadFailed(String adUnitId, MaxError error) {
        LogUtils.LOGD("onAdLoadFailed Applovin Appopen: " + error.getMessage());
        retryLoadAd();
    }

    @Override
    public void onAdDisplayFailed(MaxAd ad, MaxError error) {
        LogUtils.LOGD("onAdDisplayFailed Applovin Appopen: " + error.getMessage());
        appOpenAd.loadAd();
    }
}

2. 优化SplashActivity逻辑 #

冷启动时设置超时机制，避免因广告加载卡住页面：

public class SplashActivity extends AppCompatActivity {
    private static final long AD_LOAD_TIMEOUT = 3000; // 3秒超时
    private AppOpen appOpenManager;
    private Handler handler;
    private boolean isAdProcessed = false;

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

        handler = new Handler(Looper.getMainLooper());
        appOpenManager = new AppOpen(this);
        appOpenManager.setAdCallback(new AppOpen.AdCallback() {
            @Override
            public void onAdReady() {
                if (!isAdProcessed) {
                    handler.removeCallbacks(goToMainRunnable);
                    appOpenManager.showAdIfReady(SplashActivity.this);
                    isAdProcessed = true;
                }
            }

            @Override
            public void onAdLoadFailed() {
                if (!isAdProcessed) {
                    goToMainActivity();
                }
            }

            @Override
            public void onAdClosed() {
                goToMainActivity();
            }
        });

        // 超时兜底，避免无限等待
        handler.postDelayed(goToMainRunnable, AD_LOAD_TIMEOUT);
    }

    private Runnable goToMainRunnable = this::goToMainActivity;

    private void goToMainActivity() {
        startActivity(new Intent(this, MainActivity.class));
        finish();
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        handler.removeCallbacks(goToMainRunnable);
    }
}

3. 额外优化建议 #

• 适配横竖屏：在Ad Unit后台配置支持的方向，避免广告展示异常；
• 无网络处理：可在loadAd()前判断网络状态，无网络直接触发跳转；
• 频率控制：避免应用频繁前后台切换时重复展示广告，可添加时间间隔判断。

内容的提问来源于stack exchange，提问作者sejn