AppLovin Support

横幅和 MREC 广告

横幅和 MREC 广告均为矩形的广告格式,会占据应用版面中的一部分,通常位于屏幕顶部或底部,有时也内嵌在可滚动的内容中。 用户与应用互动时,横幅和 MREC 广告始终可见,既不会干扰或打断游戏和使用体验,也可以在指定时间周期后自动刷新。

以下各节将向您介绍如何加载、显示和隐藏横幅或 MREC 广告。

加载横幅或 MREC

如果您的集成需要在信息流中显示 MREC 广告,AppLovin 建议采用以下技术:

  1. 创建尽可能少的实例。
  2. 停止自动刷新。
  3. 通过调用 loadAd 手动刷新内容 (重新使用 MAAdView 实例)。

您可以在 AppLovin 演示应用 (Objective-C, Swift) 中找到实施示例。

横幅

要加载横幅,请创建与广告单元相对应的 MAAdView 对象并调用其 loadAd 方法。 要展示该广告,请将 MAAdView 对象添加为视图层级的子视图。 实现 MAAdViewAdDelegate 以便在广告就绪时收到通知。 这也会提醒您其他的广告相关事件。

#import "ExampleViewController.h"
#import <AppLovinSDK/AppLovinSDK.h>

@interface ExampleViewController()<MAAdViewAdDelegate>
@property (nonatomic, strong) MAAdView *adView;
@end

@implementation ExampleViewController

- (void)createBannerAd
{
  self.adView = [[MAAdView alloc] initWithAdUnitIdentifier: @"«ad-unit-ID»"];
  self.adView.delegate = self;

  // Banner height on iPhone and iPad is 50 and 90, respectively
  CGFloat height = (UIDevice.currentDevice.userInterfaceIdiom == UIUserInterfaceIdiomPad) ? 90 : 50;

  // Stretch to the width of the screen for banners to be fully functional
  CGFloat width = CGRectGetWidth(UIScreen.mainScreen.bounds);

  self.adView.frame = CGRectMake(x, y, width, height);

  // Set background color for banners to be fully functional
  self.adView.backgroundColor = «background-color»;

  [self.view addSubview: self.adView];

  // Load the ad
  [self.adView loadAd];
}

#pragma mark - MAAdDelegate Protocol

- (void)didLoadAd:(MAAd *)ad {}

- (void)didFailToLoadAdForAdUnitIdentifier:(NSString *)adUnitIdentifier withError:(MAError *)error {}

- (void)didClickAd:(MAAd *)ad {}

- (void)didFailToDisplayAd:(MAAd *)ad withError:(MAError *)error {}

#pragma mark - MAAdViewAdDelegate Protocol

- (void)didExpandAd:(MAAd *)ad {}

- (void)didCollapseAd:(MAAd *)ad {}

#pragma mark - Deprecated Callbacks

- (void)didDisplayAd:(MAAd *)ad { /* DO NOT USE - THIS IS RESERVED FOR FULLSCREEN ADS ONLY AND WILL BE REMOVED IN A FUTURE SDK RELEASE */ }
- (void)didHideAd:(MAAd *)ad { /* DO NOT USE - THIS IS RESERVED FOR FULLSCREEN ADS ONLY AND WILL BE REMOVED IN A FUTURE SDK RELEASE */ }

@end

MREC

要加载 MREC 广告,请创建与广告单元相对应的 MAAdView 对象,并调用其 loadAd 方法。要展示广告,请将 MAAdView 对象添加为视图层级的子视图。实现 MAAdViewAdDelegate以便在广告就绪时收到通知。这也会通知您其他广告相关事件。

#import "ExampleViewController.h"
#import <AppLovinSDK/AppLovinSDK.h>

@interface ExampleViewController()<MAAdViewAdDelegate>
@property (nonatomic, strong) MAAdView *adView;
@end

@implementation ExampleViewController

- (void)createMRecAd
{
  self.adView = [[MAAdView alloc] initWithAdUnitIdentifier: @"«ad-unit-ID»" adFormat: MAAdFormat.mrec];
  self.adView.delegate = self;

  // MREC width and height are 300 and 250 respectively, on iPhone and iPad
  CGFloat width = 300;
  CGFloat height = 250;

  // Center the MREC
  CGFloat x = self.view.center.x - 150;

  self.adView.frame = CGRectMake(x, y, width, height);

  // Set background color for MREC ads to be fully functional
  self.adView.backgroundColor = «background-color»;

  [self.view addSubview: self.adView];

  // Load the ad
  [self.adView loadAd];
}

#pragma mark - MAAdDelegate Protocol

- (void)didLoadAd:(MAAd *)ad {}

- (void)didFailToLoadAdForAdUnitIdentifier:(NSString *)adUnitIdentifier withError:(MAError *)error {}

- (void)didClickAd:(MAAd *)ad {}

- (void)didFailToDisplayAd:(MAAd *)ad withError:(MAError *)error {}

#pragma mark - MAAdViewAdDelegate Protocol

- (void)didExpandAd:(MAAd *)ad {}

- (void)didCollapseAd:(MAAd *)ad {}

#pragma mark - Deprecated Callbacks

- (void)didDisplayAd:(MAAd *)ad { /* DO NOT USE - THIS IS RESERVED FOR FULLSCREEN ADS ONLY AND WILL BE REMOVED IN A FUTURE SDK RELEASE */ }
- (void)didHideAd:(MAAd *)ad { /* DO NOT USE - THIS IS RESERVED FOR FULLSCREEN ADS ONLY AND WILL BE REMOVED IN A FUTURE SDK RELEASE */ }

@end

销毁横幅和 MREC 广告

您可能不再需要 MAAdView 实例。 例如,当用户购买了去广告服务时,就会发生这种情况。 释放此类 MAAdView 实例以释放资源。

如果您使用多个具有相同广告单元 ID 的实例,请不要释放 MAAdView 实例。

[self.adView removeFromSuperview];
self.adView.delegate = nil;
self.adView = nil;

自适应横幅广告

Google 竞价、Google AdMob、Google Ad Manager、Liftoff Monetize、Pangle 和 Yandex 支持自适应横幅。 MAX 会按常规方式处理来自其他渠道的横幅尺寸。

Google 建议开发者在横幅位置和应用内容之间留出 50 px 的内边距。 这可以降低用户意外点击横幅的可能性。 请参考 Google “关于确认点击” 的政策,了解更多信息和最佳实践。

自适应横幅广告是响应式广告,可根据设备类型和可用宽度动态调整其尺寸。 自适应横幅可以是锚定式或内嵌式,每种类型都适用于特定的集成需求。

从 MAX SDK 13.2.0 版本开始,您可以通过在构建时设置了 adaptiveType 的 MAAdViewConfiguration 对象来初始化 MAAdView,从而集成自适应横幅。

广告平台适配器对自适应横幅功能的支持

以下适配器支持特殊的自适应横幅功能:

广告网络适配器版本特殊功能
Google Ad Manager11.7.0.1+内嵌自适应横幅
11.13.0.1+内嵌自适应 MREC 广告
10.2.0.1+设置自定义宽度
Google 竞价和 Google AdMob11.7.0.1+内嵌自适应横幅
11.13.0.1+内嵌自适应 MREC 广告
10.2.0.2+设置自定义宽度
InMobi11.3.0.1+
Liftoff Monetize7.4.5.1+
Pangle7.1.0.8.0+
Yandex7.12.2.1+

锚定式自适应横幅

锚定式自适应横幅是指固定在屏幕顶部或底部的广告形式。 它们根据设备类型和横幅宽度动态调整高度。

您必须将 MAAdView 的高度设置为 MAAdFormat.banner.adaptiveSize.height 返回的值,而不是使用 50 或 90 等常量值。

- (void)createAnchoredAdaptiveBannerAd
{
  // Stretch to the width of the screen for banners to be fully functional
  CGFloat width = CGRectGetWidth(UIScreen.mainScreen.bounds);

  // Get the anchored adaptive banner height
  CGFloat height = MAAdFormat.banner.adaptiveSize.height;

  MAAdViewConfiguration *config = [MAAdViewConfiguration configurationWithBuilderBlock:^(MAAdViewConfigurationBuilder *builder) {
    builder.adaptiveType = MAAdViewAdaptiveTypeAnchored;
  }];

  self.adView = [[MAAdView alloc] initWithAdUnitIdentifier: @"«ad-unit-ID»" configuration: config];
  self.adView.delegate = self;

  self.adView.frame = CGRectMake(x, y, width, height);

  // Set background color for banners to be fully functional
  self.adView.backgroundColor = «background-color»;

  [self.view addSubview: self.adView];

  // Load the ad
  [self.adView loadAd];
}

设置自定义宽度

对于更具体的集成,您可以通过设置 MAAdViewConfiguration 构建器选项,以 points 为单位配置自定义宽度。 要为自定义的锚定式自适应广告获取合适的高度,请调用自适应尺寸 API。

CGFloat width = 400;

// Get the anchored adaptive banner height
CGFloat height = [self.adView.adFormat adapativeSizeForWidth: width].height;

MAAdViewConfiguration *config = [MAAdViewConfiguration configurationWithBuilderBlock:^(MAAdViewConfigurationBuilder *builder) {
  builder.adaptiveType = MAAdViewAdaptiveTypeAnchored;
  builder.adaptiveWidth = width;
}];
self.adView = [[MAAdView alloc] initWithAdUnitIdentifier: @"«ad-unit-ID»" configuration: config];

内嵌自适应横幅

自适应横幅默认是锚定式的。 您也可以启用内嵌自适应横幅,将其放置在可滚动的内容中。 内嵌自适应横幅通常比锚定式自适应横幅更大。 它们的高度是可变的,最高可延伸至设备屏幕的完整高度。

要启用内嵌自适应横幅,请将 MAAdViewConfiguration 自适应类型设置为 MAAdViewAdaptiveTypeInline,如以下代码所示:

MAAdViewConfiguration *config = [MAAdViewConfiguration configurationWithBuilderBlock:^(MAAdViewConfigurationBuilder *builder) {
  builder.adaptiveType = MAAdViewAdaptiveTypeInline;
  ⋮
}];

内嵌自适应广告的默认最大高度是设备屏幕的完整高度。 您可能希望为内嵌自适应广告设置一个最大高度 (以 points 为单位),以确保广告适合 MAAdView 的高度。 您可以使用如下代码来实现,以下代码以 100 points 的最大高度为例:

MAAdViewConfiguration *config = [MAAdViewConfiguration configurationWithBuilderBlock:^(MAAdViewConfigurationBuilder *builder) {
  builder.adaptiveType = MAAdViewAdaptiveTypeInline;
  builder.inlineMaximumHeight = 100;
  ⋮
}];

内嵌自适应 MREC

内嵌自适应 MREC 默认覆盖整个应用程序窗口宽度,但您也可以指定自定义宽度 (以 points 为单位)。该高度可变,如果您未指定最大高度,则该变量会超出标准的 MREC 广告尺寸,最高可达设备屏幕的完整高度。

要启用内嵌自适应 MREC,请将 MAAdViewConfiguration 自适应类型设置为 MAAdViewAdaptiveTypeInline,如以下代码所示:

- (void)createInlineAdaptiveMRecAd
{
  // Set a custom width, in points, for the inline adaptive MREC. Otherwise stretch to screen width by using CGRectGetWidth(UIScreen.mainScreen.bounds)
  CGFloat width = 400;

  // Set a maximum height, in points, for the inline adaptive MREC. Otherwise use standard MREC height of 250 points
  // Google recommends a height greater than 50 points, with a minimum of 32 points and a maximum equal to the screen height
  // The value must also not exceed the height of the MAAdView
  CGFloat height = 300;

  MAAdViewConfiguration *config = [MAAdViewConfiguration configurationWithBuilderBlock:^(MAAdViewConfigurationBuilder *builder) {
    builder.adaptiveType = MAAdViewAdaptiveTypeInline;
    builder.adaptiveWidth = width; // Optional: The adaptive ad spans the width of the application window if you do not set a value
    builder.inlineMaximumHeight = height; // Optional: The maximum height is the screen height if you do not set a value
  }];
  self.adView = [[MAAdView alloc] initWithAdUnitIdentifier: @"«ad-unit-ID»" adFormat: MAAdFormat.mrec configuration: config];
  self.adView.delegate = self;

  self.adView.frame = CGRectMake(x, y, width, height);

  // Set background color for adaptive MRECs to be fully functional
  self.adView.backgroundColor = «background-color»;

  [self.view addSubview: self.adView];

  // Load the ad
  [self.adView loadAd];
}

处理自适应广告尺寸

您加载的自适应广告可能小于您请求的尺寸。 您可能希望根据所展示的自适应广告的尺寸,配置 UI 以实现相应的适配。 如果是这样,您可以使用如下代码获取已加载广告的宽度 and 高度 (以 points 为单位):

- (void)didLoadAd:(MAAd *)ad
{
  CGSize adViewSize = ad.size;
  CGFloat width = adViewSize.width;
  CGFloat height = adViewSize.height;
  ⋮
}

停止和启动自动刷新

您可能想要停止广告的自动刷新。 例如,当您隐藏横幅广告或想要手动刷新时,您可能想要这样做。 使用以下代码停止横幅或 MREC 广告的自动刷新:

// Set this extra parameter to work around SDK bug that ignores calls to stopAutoRefresh()
[adView setExtraParameterForKey: @"allow_pause_auto_refresh_immediately" value: @"true"];
[adView stopAutoRefresh];

使用以下调用启动横幅或 MREC 广告的自动刷新:

[adView startAutoRefresh];

使用以下调用手动刷新内容。 在调用 loadAd() 之前您必须停止自动刷新。

[adView loadAd];

search