- 记录日常工作学习记录--Google Admob 广告接入(开屏类广告接入)。
- 首先得 注册并登陆 Google Admob 账号 。
121.png
创建Admob 应用和广告单元。
27.png
添加广告单元。
28.png
开屏广告单元创建成功后,我们开始接入广告。但是目前官方文档上面并没有开屏广告的接入指南更新。如下图:指南上只有横幅,插页,原生,激励。
30.png
我们可以通过创建广告单元的时候的提示,或者点击修改单元广告页面点击介绍,上面有跳转到开屏广告接入指南的代码路径。
Admob开屏广告接入指南developers.google.com
- 正式接入要求:
- 使用 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() 方法关闭加载屏幕。
有大佬有更好的解决冷启动的方案,可留言告知,小弟不胜感激。(新手求指导)。
网友评论