Adaptive Banners Beta

自适应横幅广告是新一代自适应广告,可针对每台设备优化广告尺寸,从而最大限度地提升广告效果。自适应横幅广告在智能横幅广告(仅支持固定高度)的基础上进行了改进,开发者可以指定广告宽度,进而确定最佳广告尺寸。

为了选择最佳广告尺寸,自适应横幅广告采用的是固定宽高比,而非固定高度。因此,横幅广告可在不同的设备上占据更为一致的屏幕区域,有机会提升广告效果。

请注意,使用自适应横幅广告时,如果给定设备类型和宽度,则返回的广告尺寸将始终固定不变。在给定设备上测试布局后,便可以确保广告尺寸不会发生变化。但横幅广告素材的尺寸在不同设备上可能会有所不同。因此,建议您确保广告布局可以适应各种广告高度。在极少数情况下,广告素材可能达不到自适应广告的全尺寸,标准尺寸的广告素材将居中显示在广告位中。

自适应横幅广告适用情形

自适应横幅广告旨在暂时取代符合行业标准的 320x50 横幅广告尺寸及智能横幅广告格式。

这种横幅广告的尺寸通常用于锚定横幅广告(通常被锁定在屏幕的顶部或底部)。对于此类锚定横幅广告,自适应横幅广告的宽高比类似于标准尺寸的 320x50 广告,如以下三个示例所示:


320x50 横幅广告

自适应横幅广告

智能横幅广告

自适应横幅广告可更好地利用可用的屏幕尺寸。此外,与智能横幅广告相比,自适应横幅广告是一种更好的选择,原因如下:

  • 这种广告采用提供的宽度(而非全屏宽度),这样您就可以将刘海屏考虑在内。

  • 它会为特定设备选择最优高度,而非针对不同尺寸的设备均使用固定高度,从而降低了设备屏幕尺寸造成的影响。

广告植入注意事项

在应用中植入自适应横幅广告时,请注意以下几点:

  • 确保您使用的是最新版 Google 移动广告 SDK。对于中介,请使用最新版中介适配器。
  • 考虑更新或创建新订单项,以采用自适应尺寸。 更多详情
  • 自适应横幅广告尺寸经过专门设计,占据整个可用屏幕宽度时效果最佳。在大多数情况下,这里指的是所用设备的屏幕全宽。请务必考虑适用的刘海屏。

  • 在 中给定宽度为AdSize

  • 获取自适应横幅广告尺寸的方法有以下三种:一种适用于横向屏幕,一种适用于纵向屏幕,还有一种适用于执行操作时的屏幕方向。如需了解详情,请参阅下面完整的 API 文档。

  • 在给定设备上针对给定宽度返回的尺寸始终相同,因此在给定设备上测试布局后,便可确保广告尺寸不会发生变化。

  • 锚定横幅广告的高度始终不会超过设备高度的 15%,也始终不小于 50 dp。

快速入门

要植入简单的自适应锚定横幅广告,请按照以下步骤操作:

  1. 创建a PublisherAdView对象并设置广告单元 ID。

  2. 获取自适应横幅广告尺寸。 您获取的尺寸将用于请求自适应横幅广告。要获取自适应广告尺寸,请务必执行以下操作:

    1. 获取所用设备的宽度,或者自行设置宽度(如果您不想使用屏幕的全宽)。
    2. 针对广告尺寸类使用相应的静态方法(例如AdSize.getCurrentOrientationBannerAdSizeWithWidth(context, width)),以获取所选屏幕方向的自适应AdSize对象。
    3. 针对横幅广告视图设置广告尺寸,可使用 PublisherAdView.setAdSizes() 完成此操作。

    请注意,Google 可能会投放尺寸小于自适应尺寸的预订型广告,如此处所述。返回的广告将居中显示在广告视图中。 下面列出了完整示例。

  3. 在预先准备的广告视图中使用loadAd()方法创建广告请求对象并加载横幅广告,其处理方式与常规横幅广告请求一样。

完整示例

以下是加载自适应横幅广告以适应屏幕宽度的 Activity 示例:

Java

import android.content.res.Configuration;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.util.DisplayMetrics;
import android.view.Display;
import android.widget.FrameLayout;

import com.google.android.gms.ads.AdRequest;
import com.google.android.gms.ads.AdSize;
import com.google.android.gms.ads.doubleclick.PublisherAdView;
import com.google.android.gms.ads.MobileAds;
/** Main Activity. Inflates main activity xml and child fragments. */
public class MyActivity extends AppCompatActivity {

  private FrameLayout adContainerView;
  private PublisherAdView adView;

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

    // Initialize the Mobile Ads SDK.
    MobileAds.initialize(this);
    adContainerView = findViewById(R.id.ad_view_container);
    // Step 1 - Create a PublisherAdView and set the ad unit ID on it.
    adView = new PublisherAdView(this);
    adView.setAdUnitId(getString(R.string.adaptive_banner_ad_unit_id));
    adContainerView.addView(adView);
    loadBanner();
  }

  private void loadBanner() {
    // Create an ad request. Check your logcat output for the hashed device ID
    // to get test ads on a physical device, e.g.,
    // "Use AdRequest.Builder.addTestDevice("ABCDE0123") to get test ads on this
    // device."
    PublisherAdRequest adRequest =
        new PublisherAdRequest.Builder().addTestDevice(PublisherAdRequest.DEVICE_ID_EMULATOR)
            .build();

    AdSize adaptiveSize = getAdSize();
    // Step 4 - Set the adaptive ad size on the ad view. Note that this sets
    // both the adaptive ad size for backfill inventory as well as the supported
    // reservation sizes.
    adView.setAdSizes(adaptiveSize, AdSize.BANNER);
    // Step 5 - Start loading the ad in the background.
    adView.loadAd(adRequest);
  }

  private AdSize getAdSize() {
    // Step 2 - Determine the screen width (less decorations) to use for the ad width.
    Display display = getWindowManager().getDefaultDisplay();
    DisplayMetrics outMetrics = new DisplayMetrics();
    display.getMetrics(outMetrics);

    float widthPixels = outMetrics.widthPixels;
    float density = outMetrics.density;

    int adWidth = (int) (widthPixels / density);

    // Step 3 - Get adaptive ad size and return for setting on the ad view.
    return AdSize.getCurrentOrientationBannerAdSizeWithWidth(this, adWidth);
  }
}

Kotlin

import android.os.Bundle
import android.util.DisplayMetrics
import androidx.appcompat.app.AppCompatActivity
import com.google.android.gms.ads.AdRequest
import com.google.android.gms.ads.AdSize
import com.google.android.gms.ads.AdView
import com.google.android.gms.ads.MobileAds
import kotlinx.android.synthetic.main.activity_my.*

/** Main Activity. Inflates main activity xml and child fragments.  */
class MyActivity : AppCompatActivity() {
  private lateinit var adView: PublisherAdView

  // Determine the screen width (less decorations) to use for the ad width.
  // If the ad hasn't been laid out, default to the full screen width.
  private val adSize: AdSize
    get() {
      val display = windowManager.defaultDisplay
      val outMetrics = DisplayMetrics()
      display.getMetrics(outMetrics)

      val density = outMetrics.density

      var adWidthPixels = ad_view_container.width.toFloat()
      if (adWidthPixels == 0f) {
        adWidthPixels = outMetrics.widthPixels.toFloat()
      }

      val adWidth = (adWidthPixels / density).toInt()
      return AdSize.getCurrentOrientationBannerAdSizeWithWidth(this, adWidth)
    }

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

    // Initialize the Mobile Ads SDK.
    MobileAds.initialize(this) { }

    adView = PublisherAdView(this)
    ad_view_container.addView(adView)
    loadBanner()
  }

  private fun loadBanner() {
    adView.adUnitId = ad unit id

    adView.adSize = adSize

    // Create an ad request. Check your logcat output for the hashed device ID to
    // get test ads on a physical device, e.g.,
    // "Use AdRequest.Builder.addTestDevice("ABCDE0123") to get test ads on this device."
    val adRequest = PublisherAdRequest
        .Builder()
        .addTestDevice(PublisherAdRequest.DEVICE_ID_EMULATOR).build()

    // Start loading the ad in the background.
    adView.loadAd(adRequest)
  }

  companion object {
    // This is an ad unit ID for a test ad. Replace with your own banner ad unit ID.
    private val AD_UNIT_ID = "/6499/example/banner"
  }
}

在本示例中,函数 AdSize.getCurrentOrientationBannerAdSizeWithWidth 用于获取适用于当前界面方向的锚定位置横幅广告的尺寸。要按给定屏幕方向预加载锚定横幅广告,请使用 AdSize.getPortraitBannerAdSizeWithWidthAdSize.getLandscapeBannerAdSizeWithWidth 中的相关函数。

自适应横幅广告尺寸 API

以下所列相关 API 可用于为自适应横幅广告创建AdSize

public final class AdSize {
...
  /**
   * Returns an AdSize with the given width and a Google-optimized height
   * to create a banner ad. The size returned will have an aspect ratio
   * similar to that of an AdSize.BANNER, suitable for anchoring near the top or
   * bottom of your app. The height will never be larger than 15% of the
   * device's height in landscape mode and never smaller than 50px.
   * This function always returns the same height for any width / device
   * combination. If the context is null or we cannot determine the device
   * height from the context, an AdSize.INVALID object will be returned.
   *
   * @return An Ad Size object. If the context is null or we cannot determine
   * the device height from the context, an AdSize.INVALID object will be
   * returned.
   */
  public static AdSize getLandscapeBannerAdSizeWithWidth(Context context, int width);

  /**
   * Returns an AdSize with the given width and a Google-optimized height
   * to create a banner ad. The size returned will have an aspect ratio
   * similar to that of an AdSize.BANNER, suitable for anchoring near the top or
   * bottom of your app. The height will never be larger than 15% of the
   * device's portrait height and never smaller than 50px. This function always
   * returns the same height for any width / device combination.
   *
   * @return An Ad Size object. If the context is null or we cannot determine
   * the device height from the context, an AdSize.INVALID object will be
   * returned.
   */
  public static AdSize getPortraitBannerAdSizeWithWidth(Context context, int width);

 /**
  * Returns an AdSize with the given width and a Google-optimized height
  * to create a banner ad. The size returned will have an aspect ratio similar
  * to that of an AdSize.BANNER, suitable for anchoring near the top or bottom
  * of your app. The height will never be larger than 15% of the device's
  * current orientation height and never smaller than 50px. This function always
  * returns the same height for any width / device combination. If the context
  * is null or we cannot determine the device height from the context, an
  * AdSize.INVALID object will be returned.
  *
  * @return An Ad Size object. If the context is null or we cannot determine the
  * device height from the context, an AdSize.INVALID object will be returned.
  */
 public static AdSize getCurrentOrientationBannerAdSizeWithWidth(Context context, int width);

}