Google Admob 最新广告接入(一)（开屏广告）

作者: Ronrico_帅气 | 来源:发表于2021-01-25 18:09 被阅读0次

记录日常工作学习记录--Google Admob 广告接入（开屏类广告接入）。
首先得注册并登陆 Google Admob 账号。
121.png
创建Admob 应用和广告单元。
27.png
添加广告单元。
28.png
开屏广告单元创建成功后，我们开始接入广告。但是目前官方文档上面并没有开屏广告的接入指南更新。如下图：指南上只有横幅，插页，原生，激励。
30.png

我们可以通过创建广告单元的时候的提示，或者点击修改单元广告页面点击介绍，上面有跳转到开屏广告接入指南的代码路径。
Admob开屏广告接入指南developers.google.com

29.png

正式接入要求：
使用 Android Studio 3.2 或更高版本。
minSdkVersion 16 或更高版本。
compileSdkVersion 28 或更高版本。
通过使用指向Google Maven 代码库的Gradle依赖项，应用可以导入 Google 移动广告 SDK。首先，请确保在项目级build.gradle文件的allprojects部分引用了google()。

allprojects {
    repositories {
        google()
    }
}

接下来，请打开您应用的应用级build.gradle文件，并找到“dependencies”部分。
本文一步添加所有需要的依赖。也可看官方文档一步一步添加

dependencies {
    implementation 'com.google.android.gms:play-services-ads:19.6.0'
    def lifecycle_version = "2.0.0"
    implementation "androidx.lifecycle:lifecycle-extensions:$lifecycle_version"
    implementation "androidx.lifecycle:lifecycle-runtime:$lifecycle_version"
    annotationProcessor "androidx.lifecycle:lifecycle-compiler:$lifecycle_version"
}
在AndroidManifest.xml 文件application 节点下，添加你对应广告应用ID
<manifest>
    <application>
        <!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    </application>
</manifest>

初始化广告SDK ：开屏广告跟其他广告初始化不一样，必须创建Application类。
创建名为MyApplication的新类并添加以下代码：

package com.google.android.gms.example.appopendemo;

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

/** The Application class that manages AppOpenManager. */
public class MyApplication extends Application {
  private static AppOpenManager appOpenManager;
  @Override
  public void onCreate() {
    super.onCreate();
    MobileAds.initialize(
        this,
        new OnInitializationCompleteListener() {
          @Override
          public void onInitializationComplete(InitializationStatus initializationStatus) {}
        });
   appOpenManager = new AppOpenManager(this);
  }
}

接下来，将以下代码添加到您的AndroidManifest.xml中：

<application
    android:name="com.google.android.gms.example.appopendemo.MyApplication" ...>
...
</application>

实现实用工具类：广告应该要快速展示，因此最好先加载广告，以备需要展示时使用。这样一来，用户进入您的应用后，广告便可以立即展示。实现实用工具类，即可在您需要展示广告之前发出广告请求
创建名为AppOpenManager的新类并在其中添加相关代码，如下所示：
本文代码是创建好，完整的代码，可直接复制使用。详细步骤可查看官方文档一步一步创建。基本没有修改。
注意：应用没上线前，必须使用测试的广告ID 进行测试：否则，可能会导致您的帐号被暂停。

AD_UNIT_ID = "ca-app-pub-3940256099942544/3419835294";

package com.kadaj.clearpro;

import android.app.Activity;
import android.app.Application;
import android.os.Bundle;
import android.util.Log;

import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import androidx.lifecycle.LifecycleObserver;
import androidx.lifecycle.OnLifecycleEvent;
import androidx.lifecycle.ProcessLifecycleOwner;

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.appopen.AppOpenAd;

import java.util.Date;

import static androidx.lifecycle.Lifecycle.Event.ON_START;

public class AppOpenManager  implements LifecycleObserver, Application.ActivityLifecycleCallbacks{

    private static final String LOG_TAG = "AppOpenManager";
    private static final String AD_UNIT_ID = "ca-app-pub-3940256099942544/3419835294";
    private AppOpenAd appOpenAd = null;
    private AppOpenAd.AppOpenAdLoadCallback loadCallback;

    private final MyApplication myApplication;

    private Activity currentActivity;

    private static boolean isShowingAd = false;
    private long loadTime = 0;

    /**
     * Constructor
     * 构造函数
     * */
    public AppOpenManager(MyApplication myApplication) {
        this.myApplication = myApplication;
        this.myApplication.registerActivityLifecycleCallbacks(this);

        ProcessLifecycleOwner.get().getLifecycle().addObserver(this);
    }
    /** Request an ad */
    public void fetchAd() {
        // We will implement this below.

        if (isAdAvailable()) {
            return;
        }


        loadCallback =
                new AppOpenAd.AppOpenAdLoadCallback() {
                    /**
                     * Called when an app open ad has loaded.
                     *当应用程序打开广告加载时调用。
                     * @param ad the loaded app open ad.
                     */
                    @Override
                    public void onAppOpenAdLoaded(AppOpenAd ad) {
                        AppOpenManager.this.appOpenAd = ad;
                        AppOpenManager.this.loadTime = (new Date()).getTime();
                    }

                    /**
                     * Called when an app open ad has failed to load.
                     *当app open广告加载失败时调用
                     * @param loadAdError the error.
                     */
                    @Override
                    public void onAppOpenAdFailedToLoad(LoadAdError loadAdError) {

                        // Handle the error.
                        Log.d(LOG_TAG, "onAppOpenAdLoaded: 加载广告失败，，" + loadAdError.toString());
                        Log.d(LOG_TAG, "onAppOpenAdFailedToLoad: 加载广告失败,,,," + loadAdError.getResponseInfo());
                        Log.d(LOG_TAG, "onAppOpenAdFailedToLoad: 加载广告失败,,,," + loadAdError.getMessage());
                        Log.d(LOG_TAG, "onAppOpenAdFailedToLoad: 加载广告失败,,,," + loadAdError.getCode());

                    }

                };
        AdRequest request = getAdRequest();
        AppOpenAd.load(
                myApplication, AD_UNIT_ID, request,
                AppOpenAd.APP_OPEN_AD_ORIENTATION_PORTRAIT, loadCallback);

    }
    /**
     * 为确保您不会展示过期的广告，请在 AppOpenManager 中添加一个方法，用于检查广告引用加载后经过了多长时间。然后，使用该方法检查广告是否仍然有效
     * */
    private boolean wasLoadTimeLessThanNHoursAgo(long numHours) {
        long dateDifference = (new Date()).getTime() - this.loadTime;
        long numMilliSecondsPerHour = 3600000;
        return (dateDifference < (numMilliSecondsPerHour * numHours));
    }

    /** Creates and returns ad request.
     * 创建并返回广告请求
     * */
    private AdRequest getAdRequest() {
        return new AdRequest.Builder().build();
    }

    /** Utility method that checks if ad exists and can be shown.
     * 检查ad是否存在并显示的实用方法
     * */
    public boolean isAdAvailable() {

        return appOpenAd != null && wasLoadTimeLessThanNHoursAgo(4);
    }

    /** LifecycleObserver methods
     *  监听前台事件 调用广告。
     * */
    @OnLifecycleEvent(ON_START)
    public void onStart() {

        showAdIfAvailable();

    }

    public void showAdIfAvailable() {
        // Only show ad if there is not already an app open ad currently showing
        // and an ad is available.
        //只显示广告如果没有一个应用程序打开广告当前显示
        //有一个广告。
        Log.d(LOG_TAG, "isShowingAd=="+isShowingAd);
        Log.d(LOG_TAG, "isAdAvailable=="+isAdAvailable());
        if (!isShowingAd && isAdAvailable()) {
            Log.d(LOG_TAG, "Will show ad.");

            FullScreenContentCallback fullScreenContentCallback =
                    new FullScreenContentCallback() {
                        @Override
                        public void onAdDismissedFullScreenContent() {
                            // Set the reference to null so isAdAvailable() returns false.
                            AppOpenManager.this.appOpenAd = null;
                            isShowingAd = false;
                            fetchAd();
                        }

                        @Override
                        public void onAdFailedToShowFullScreenContent(AdError adError) {}

                        @Override
                        public void onAdShowedFullScreenContent() {
                            isShowingAd = true;
                        }
                    };
            Log.d(LOG_TAG, "activity_name"+currentActivity.getClass().getName());
            appOpenAd.show(currentActivity, fullScreenContentCallback);

        } else {

            Log.d(LOG_TAG, "Can not show ad.");
            fetchAd();
        }
    }

    @Override
    public void onActivityCreated(@NonNull Activity activity, @Nullable Bundle savedInstanceState) {

    }

    @Override
    public void onActivityStarted(@NonNull Activity activity) {



        currentActivity = activity;


    }

    @Override
    public void onActivityResumed(@NonNull Activity activity) {


        currentActivity = activity;

    }

    @Override
    public void onActivityPaused(@NonNull Activity activity) {

    }

    @Override
    public void onActivityStopped(@NonNull Activity activity) {

    }

    @Override
    public void onActivitySaveInstanceState(@NonNull Activity activity, @NonNull Bundle outState) {

    }

    @Override
    public void onActivityDestroyed(@NonNull Activity activity) {
        currentActivity = null;
    }
}

运行APP 如图所示，闪屏广告已正常显示：

31.png

需要解决的问题：
冷启动和加载屏幕：到现在为止，本文档都假定您仅在以下情况下展示开屏广告：用户将在内存中挂起的应用切换为在前台运行。用户启动您的应用，但该应用之前未在内存中挂起，这种情况就称为“冷启动”。
例如，用户首次打开您的应用便属于冷启动。对于冷启动，您没有之前已加载的开屏广告可供立即展示。请求广告和收到相应广告之间的延迟会导致出现以下情况：用户能够暂时使用您的应用，然后突然看到一条无关广告。应避免出现这种情况，因为这会导致用户体验不佳。
在冷启动时使用开屏广告的首选方法是，使用加载屏幕来加载游戏或应用素材资源，并且仅在加载屏幕展示广告。如果您的应用已加载完毕，并且用户已经访问应用的主要内容，则不要展示广告。
官方的解决方案：
在用户使用几次您的应用后展示第一个开屏广告。
在用户等待您的应用加载时展示开屏广告。
如果开屏广告位于加载屏幕上，并且加载屏幕在用户关闭广告之前已加载完毕，您可能需要通过 onAdDismissedFullScreenContent() 方法关闭加载屏幕。
有大佬有更好的解决冷启动的方案，可留言告知，小弟不胜感激。（新手求指导）。

Google Admob 最新广告接入(一)（开屏广告）

AD_UNIT_ID = "ca-app-pub-3940256099942544/3419835294";

相关文章

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读