横幅广告

横幅广告会占据应用布局中的一处位置，要么是设备屏幕的顶部，要么是底部。用户与应用互动时，这类广告会停留在屏幕上，并且可在一段时间后自动刷新。如果您刚开始接触移动广告，建议从横幅广告着手。

本指南介绍了如何将Ad Manager 横幅广告植入到 Android 应用中。除了提供代码段和说明之外，本指南还介绍了如何将横幅广告调整至合适的尺寸，且还提供了其他资源的链接。

前提条件

• 完成入门指南。

向布局中添加 AdManagerAdView

要展示横幅广告，首先要将 AdManagerAdView 放置到您希望用于展示广告的 Activity 或 Fragment 的布局中。最简单的方法是将相应的 XML 布局文件添加到相应的 XML 布局文件中。以下示例展示了 activity 的 AdManagerAdView：

# main_activity.xml
...
  <com.google.android.gms.ads.admanager.AdManagerAdView
      xmlns:ads="http://schemas.android.com/apk/res-auto"
      android:id="@+id/adManagerAdView"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_centerHorizontal="true"
      android:layout_alignParentBottom="true"
      ads:adSize="BANNER"
      ads:adUnitId="/6499/example/banner">
  </com.google.android.gms.ads.admanager.AdManagerAdView>
...

请注意以下必需的属性：

• ads:adSize - 将此属性设置为要使用的广告尺寸。如果您不想使用该常量定义的标准尺寸，可改为设置自定义尺寸。有关详情，请参阅下面的“横幅广告尺寸”部分。
• ads:adUnitId - 将此属性设置为您应用中用于展示广告的广告单元的唯一标识符。如果您在不同的活动中展示横幅广告，则其中每个都需要一个广告单元。

您也可以通过编程方式创建 AdManagerAdView：

AdManagerAdView adView = new AdManagerAdView(this);

adView.setAdSizes(AdSize.BANNER);

adView.setAdUnitId("/6499/example/banner");
// TODO: Add adView to your view hierarchy.

val adView = AdManagerAdView(this)

adView.adSizes = AdSize.BANNER

adView.adUnitId = "/6499/example/banner"
// TODO: Add adView to your view hierarchy.

务必用测试广告进行测试

在构建和测试应用时，请务必使用测试广告，而不是实际投放的广告。否则，可能会导致您的帐号被暂停。

对于 Android 横幅广告，加载测试广告最简便的方法就是使用下面的测试专用广告单元 ID：

该测试广告单元 ID 已经过专门配置，可为每个请求返回测试广告，您可以在自己应用的编码、测试和调试过程中随意使用该测试广告单元 ID。只需确保在发布应用前用自己的广告单元 ID 替换该测试广告单元 ID 即可。

如需详细了解移动广告 SDK 的测试广告如何运作，请参阅测试广告。

加载广告

AdManagerAdView 就绪后，下一步是加载广告。此步骤可使用 AdManagerAdView 类中的 loadAd() 方法完成。这需要 AdManagerAdRequest 参数，其中包含关于单个广告请求的运行时信息（如定位信息）。

以下示例展示了如何在 Activity 的 onCreate() 方法中加载广告：

MainActivity（节选）

package ...

import ...
import com.google.android.gms.ads.admanager.AdManagerAdRequest;
import com.google.android.gms.ads.admanager.AdManagerAdView;

public class MainActivity extends AppCompatActivity {
    private AdManagerAdView mAdManagerAdView;

    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        mAdManagerAdView = findViewById(R.id.adManagerAdView);
        AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder().build();
        mAdManagerAdView.loadAd(adRequest);
    }
}

package ...

import ...
import com.google.android.gms.ads.admanager.AdManagerAdRequest
import com.google.android.gms.ads.admanager.AdManagerAdView

class MainActivity : AppCompatActivity() {

    lateinit var mAdManagerAdView : AdManagerAdView

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        mAdManagerAdView = findViewById(R.id.adManagerAdView)
        val adRequest = AdManagerAdRequest.Builder().build()
        mAdManagerAdView.loadAd(adRequest)
    }
}

大功告成！您的应用现在就可以展示横幅广告了。

广告事件

要进一步自定义您广告的行为，您可以在广告生命周期内加入许多事件，如加载、打开、关闭等等。您可以通过 AdListener 类监听这些事件。

如需将 AdListener 与 AdManagerAdView 配合使用，请调用 setAdListener() 方法：

mAdManagerAdView.setAdListener(new AdListener() {
    @Override
    public void onAdClicked() {
      // Code to be executed when the user clicks on an ad.
    }

    @Override
    public void onAdClosed() {
      // Code to be executed when the user is about to return
      // to the app after tapping on an ad.
    }

    @Override
    public void onAdFailedToLoad(LoadAdError adError) {
      // Code to be executed when an ad request fails.
    }

    @Override
    public void onAdImpression() {
      // Code to be executed when an impression is recorded
      // for an ad.
    }

    @Override
    public void onAdLoaded() {
      // Code to be executed when an ad finishes loading.
    }

    @Override
    public void onAdOpened() {
      // Code to be executed when an ad opens an overlay that
      // covers the screen.
    }
});

mAdManagerAdView.adListener = object: AdListener() {
    override fun onAdClicked() {
      // Code to be executed when the user clicks on an ad.
    }

    override fun onAdClosed() {
      // Code to be executed when the user is about to return
      // to the app after tapping on an ad.
    }

    override fun onAdFailedToLoad(adError : LoadAdError) {
      // Code to be executed when an ad request fails.
    }

    override fun onAdImpression() {
      // Code to be executed when an impression is recorded
      // for an ad.
    }

    override fun onAdLoaded() {
      // Code to be executed when an ad finishes loading.
    }

    override fun onAdOpened() {
      // Code to be executed when an ad opens an overlay that
      // covers the screen.
    }
}

AdListener 中每种可替换的方法均对应广告生命周期内的一个事件。

横幅尺寸

下表列出了标准的横幅广告尺寸。

如需定义自定义横幅广告尺寸，请设置所需的 AdSize，如下所示：

AdSize adSize = new AdSize(300, 50);

val adSize = AdSize(300, 50)

自定义广告尺寸

除了标准广告单元之外，Google Ad Manager 允许您在应用中投放任意尺寸的广告单元。为广告请求设定的广告尺寸（宽度、高度）应与应用中所展示的广告视图（下例中的 AdManagerAdView）的尺寸一致。

例如：

// Define custom AdSize of 250x250 for AdManagerAdView

AdSize customAdSize = new AdSize(250, 250);
AdManagerAdView adView = new AdManagerAdView(this);
adView.setAdSizes(customAdSize);

// Define custom AdSize of 250x250 for AdManagerAdView

val customAdSize = AdSize(250, 250)
val adView = AdManagerAdView(this)
adView.setAdSizes(customAdSize)

有关 Android API Demo 应用中自定义广告尺寸的实现方式，请参阅 Ad Manager 多个广告尺寸示例。

多种广告尺寸

Ad Manager 允许您指定多个可能适合投放到 AdManagerAdView 的广告尺寸。在 SDK 中实现此功能之前，请先创建一个订单项，定位到与不同尺寸广告素材相关联的同一个广告单元。

在您的应用中，只需将多个 AdSize 参数传入 setAdSizes 即可：

AdManagerAdView adView = new AdManagerAdView(this);
adView.setAdSizes(AdSize.BANNER, new AdSize(120, 20), new AdSize(250, 250));

val adView = AdManagerAdView(this)
adView.setAdSizes(AdSize.BANNER, AdSize(120, 20), AdSize(250, 250))

如果 AdManagerAdView 在刷新时改变了尺寸，您的布局应该能够自动适应新的尺寸。

只需在应用中使用新尺寸列表调用 setAdSizes，即可随时更改支持的广告尺寸。

// Drop support for 120x20 ad size.
adView.setAdSizes(AdSize.BANNER, new AdSize(250, 250));

// Drop support for 120x20 ad size.
adView.setAdSizes(AdSize.BANNER, AdSize(250, 250))

AdManagerAdView 将默认采用第一个参数中传递的尺寸，直到返回下一个广告。

您还可以在 XML 布局文件中使用 ads:adSizes 属性指定多个广告尺寸：

<com.google.android.gms.ads.admanager.AdManagerAdView
   android:id="@+id/multiple_ad_sizes_view"
   android:layout_width="wrap_parent"
   android:layout_height="wrap_content"
   android:layout_alignParentBottom="true"
   android:layout_centerHorizontal="true"
   ads:adSizes="BANNER,120x20,250x250"
   ads:adUnitId="ad unit ID" />

有关 Android API Demo 应用中多个广告尺寸的实现方式，请参阅 Ad Manager 多个广告尺寸示例。

手动统计展示次数

如果您针对应在何时记录展示次数设置了特殊条件，则可以手动向 Ad Manager 发送展示 ping。为此，请在加载广告之前为手动展示启用 AdManagerAdRequest：

AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
    .setManualImpressionsEnabled(true)
    .build();

val adRequest = AdManagerAdRequest.Builder()
    .setManualImpressionsEnabled(true)
    .build()

当您确定广告已成功返回并展示在屏幕上时，您可以手动记录一次展示：

mAdManagerAdView.recordManualImpression();

mAdManagerAdView.recordManualImpression()

应用事件

借助应用事件，您可以制作能够向应用代码发送消息的广告，然后，应用便可根据这些消息执行操作。

您可以使用 AppEventListener 监听 Ad Manager 所特有的应用事件。这些事件可能会发生在广告生命周期内的任何时间，甚至是调用 onAdLoaded() 之前。

public interface AppEventListener {
  void onAppEvent(String name, String info);
}

interface AppEventListener {
    fun onAppEvent(name: String, info: String)
}

当广告中发生应用事件时，系统会调用 void onAppEvent(String name, String info)。

此接口可由您的 activity 或任何其他对象实现：

import com.google.android.gms.ads.admanager.*;

public class BannerExample extends Activity implements AppEventListener {
}

import com.google.android.gms.ads.admanager.*

class BannerExample : Activity(), AppEventListener {
}

然后传递给 AdManagerAdView：

mAdManagerAdView.setAppEventListener(this);

mAdManagerAdView.appEventListener = this

以下示例说明了如何根据名称为颜色的应用事件更改应用的背景颜色：

@Override
public void onAppEvent(String name, String info) {
  if ("color".equals(name)) {
    if ("green".equals(info) {
      // Set background color to green.
    } else if ("blue".equals(info) {
      // Set background color to blue.
    } else {
      // Set background color to black.
    }
  }
}

override fun onAppEvent(name: String?, info: String?) {
    if (name == "color") {
        when (info) {
            "green" -> {
                // Set background color to green.
            }
            "blue" -> {
                // Set background color to blue.
            }
            else -> {
                // Set background color to black.
            }
        }
    }
}

另外，下面是向监听器发送颜色应用事件消息的相应广告素材：

<html>
<head>
  <script src="//www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script>
  <script>
    document.addEventListener("DOMContentLoaded", function() {
      // Send a color=green event when ad loads.
      admob.events.dispatchAppEvent("color", "green");

      document.getElementById("ad").addEventListener("click", function() {
        // Send a color=blue event when ad is clicked.
        admob.events.dispatchAppEvent("color", "blue");
      });
    });
  </script>
  <style>
    #ad {
      width: 320px;
      height: 50px;
      top: 0px;
      left: 0px;
      font-size: 24pt;
      font-weight: bold;
      position: absolute;
      background: black;
      color: white;
      text-align: center;
    }
  </style>
</head>
<body>
  <div id="ad">Carpe diem!</div>
</body>
</html>

有关 Android API Demo 应用中应用事件的实现方式，请参阅 Ad Manager 应用事件示例。

视频广告的硬件加速

为了确保视频广告在横幅广告视图中成功展示，必须启用硬件加速。

硬件加速默认处于启用状态，但有些应用可能会选择将其停用。如果您的应用存在此类问题，建议您为使用广告的 Activity 类启用硬件加速。

启用硬件加速

如果全局启用硬件加速后，您的应用无法正常运行，则您也可以针对各个 activity 控制硬件加速。如需启用或停用硬件加速，您可以针对 AndroidManifest.xml 中的 <application> 和 <activity> 元素使用 android:hardwareAccelerated 属性。以下示例展示了如何为整个应用启用硬件加速，但为一个 activity 停用硬件加速：

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>

如需详细了解用于控制硬件加速的选项，请参阅硬件加速指南。请注意，如果针对 activity 停用了硬件加速，则无法针对单个广告视图启用，因此相应 activity 本身必须启用硬件加速。

其他资源

GitHub 上的示例

• 横幅广告的最小实现示例： Java | Kotlin

• 高级功能演示：Java | Kotlin

“Mobile Ads Garage”视频教程

• 横幅广告植入
• 横幅广告最佳做法