跳转到内容

原生广告

原生广告可让您以与现有设计一致的方式通过应用获利。 AppLovin MAX SDK 让您可以访问广告的各个资产。 这样,您就可以设计与应用的外观和感觉一致的广告布局。 SDK 自动处理图像缓存和指标跟踪。 您可以关注如何、何时以及在何处展示广告。

模板

最简单的将原生广告集成到应用中的方法,就是使用模板 API。 AppLovin MAX SDK 允许您加载 UIView,并为您预先填充了原生广告的资源。要使用模板 API,请在 Create New Ad Unit 界面中选择 “Small” (360×120 pts) 或 “Medium” (300×250 pts) 尺寸的模板。“Small” 模板的媒体视图占模板宽度的三分之一,并覆盖模板的高度。 “Medium” 模板的媒体视图会根据媒体内容的宽度和高度进行调整,同时保持内容的原始长宽比例,确保不会出现拉伸或变形。 原生广告的容器视图 (container view) 需要设置合适的高度,以便媒体内容能够正确呈现。 选择最符合您需求的尺寸。 SDK 会自动为您处理视图布局。

小:测试广告:Flood-It! Flood-It 应用程序免费! 免费流行...安装。 媒介:测试广告:Flood-It! Flood-It 应用程序免费! 免费流行的休闲游戏。 安装。

加载原生广告

要加载原生广告,创建与广告单元相对应的 MANativeAdLoader 实例对象,并调用其 loadAd() 方法。安装 MANativeAdDelegate以便在原生广告就绪时收到通知。

@interface ExampleViewController()<MANativeAdDelegate>
@property (nonatomic, weak) IBOutlet UIView *nativeAdContainerView;
@property (nonatomic, strong) MANativeAdLoader *nativeAdLoader;
@property (nonatomic, strong) MAAd *nativeAd;
@property (nonatomic, strong) UIView *nativeAdView;
@end
@implementation ExampleViewController
- (void)createNativeAd
{
self.nativeAdLoader = [[MANativeAdLoader alloc] initWithAdUnitIdentifier: @"«ad-unit-ID»"];
self.nativeAdLoader.nativeAdDelegate = self;
[self.nativeAdLoader loadAd];
}
- (void)didLoadNativeAd:(MANativeAdView *)nativeAdView forAd:(MAAd *)ad
{
// Clean up any pre-existing native ad to prevent memory leaks
if ( self.nativeAd )
{
[self.nativeAdLoader destroyAd: self.nativeAd];
}
// Save ad for cleanup
self.nativeAd = ad;
if ( self.nativeAdView )
{
[self.nativeAdView removeFromSuperview];
}
// Add ad view to view
self.nativeAdView = nativeAdView;
[self.nativeAdContainerView addSubview: nativeAdView];
// Set to false if modifying constraints after adding the ad view to your layout
self.nativeAdContainerView.translatesAutoresizingMaskIntoConstraints = NO;
// Set ad view to span width and height of container and center the ad
[self.nativeAdContainerView addConstraint: [NSLayoutConstraint constraintWithItem: nativeAdView
attribute: NSLayoutAttributeWidth
relatedBy: NSLayoutRelationEqual
toItem: self.nativeAdContainerView
attribute: NSLayoutAttributeWidth
multiplier: 1
constant: 0]];
[self.nativeAdContainerView addConstraint: [NSLayoutConstraint constraintWithItem: nativeAdView
attribute: NSLayoutAttributeHeight
relatedBy: NSLayoutRelationEqual
toItem: self.nativeAdContainerView
attribute: NSLayoutAttributeHeight
multiplier: 1
constant: 0]];
[self.nativeAdContainerView addConstraint: [NSLayoutConstraint constraintWithItem: nativeAdView
attribute: NSLayoutAttributeCenterX
relatedBy: NSLayoutRelationEqual
toItem: self.nativeAdContainerView
attribute: NSLayoutAttributeCenterX
multiplier: 1
constant: 0]];
[self.nativeAdContainerView addConstraint: [NSLayoutConstraint constraintWithItem: nativeAdView
attribute: NSLayoutAttributeCenterY
relatedBy: NSLayoutRelationEqual
toItem: self.nativeAdContainerView
attribute: NSLayoutAttributeCenterY
multiplier: 1
constant: 0]];
}
- (void)didFailToLoadNativeAdForAdUnitIdentifier:(NSString *)adUnitIdentifier withError:(MAError *)error
{
// AppLovin recommends that you retry with exponentially higher delays up to a maximum delay
}
- (void)didClickNativeAd:(MAAd *)ad
{
// Optional click callback
}
@end

资源规模

对于 AppLovin Exchange 广告需求,标题、描述和 CTA 所允许的最大字符数如下:

资源最大字符数
标题50 个字符
描述150 个字符。可以在第 149 个字符后添加省略号 (...)作为第 150 个字符。
CTA15 个字符

对于 SDK 聚合的广告平台,最大字符数由广告平台设置。

如何获取媒体内容的宽高比

以下代码片段展示了如何获取原生广告的媒体内容宽高比:

- (void)didLoadNativeAd:(MANativeAdView *)nativeAdView forAd:(MAAd *)ad
{
CGFloat aspectRatio = ad.nativeAd.mediaContentAspectRatio;
}

支持的适配器版本

广告渠道适配器版本
BidMachine1.9.4.1.1
Google Ad Manager8.13.0.2
Google Bidding 和 Google AdMob8.13.0.2
InMobi10.0.2.2
LINE2.4.20211004.2
Meta Audience Network6.9.0.2
Mintegral7.0.4.0.0
Pangle4.2.0.2.1
Smaato21.6.19.1
VK Ad Network5.14.4.1

手动

如果您有自定义视图并且想要手动将原生广告资源加载到这些视图中,请使用此 API。 这种集成方法主要涉及三个步骤:

  1. 绑定 UI 组件。
  2. 加载原生广告。
  3. 销毁原生广告。

要使用手动 API,在 Create New Ad Unit 界面中选择 Manual 模板:

Template: ☐ Small, ☐ Medium, ☒ Manual

绑定 UI 组件

您可以将自定义 UI 组件绑定到 MAX SDK,并将原生广告资源渲染到这些组件中。 此示例通过使用 xibs 和唯一标签 ID 创建的自定义视图的方式进行演示。 但是,如果您以编程方式或使用 Storyboard 创建视图,也可以使用此方法。

根据 AppLovin 的政策,您的广告必须包含隐私信息图标。 此图标链接至重要隐私声明。 您可以通过 -[MANativeAdViewBinderBuilder setOptionsContentViewTag:] 进行绑定。 包含要绑定的 UI 组件的自定义视图必须从 MANativeAdView 生成子类。

自定义类。 类:MANativeAdView。 模块:无。 ☐ 从目标继承模块。

为自定义视图的子视图分配唯一的标签 ID。 这些 ID 用于下一步的集成。 下面的示例图片将标题标签的 ID 设置为 1234

NativeCustomAdView。 看法。 标签:1234

下一步,使用实例为 MANativeAdViewBinder 的唯一标签 ID 绑定子视图。AppLovin 并不保证某个广告平台会返回特定资源。

#import "ExampleViewController.h"
#import <AppLovinSDK/AppLovinSDK.h>
@implementation ExampleViewController
- (MANativeAdView *)createNativeAdView
{
UINib *nativeAdViewNib = [UINib nibWithNibName: @"NativeCustomAdView" bundle: NSBundle.mainBundle];
MANativeAdView *nativeAdView = [nativeAdViewNib instantiateWithOwner: nil options: nil].firstObject;
MANativeAdViewBinder *binder = [[MANativeAdViewBinder alloc] initWithBuilderBlock:^(MANativeAdViewBinderBuilder *builder) {
builder.titleLabelTag = «title-label-tag»;
builder.bodyLabelTag = «body-lable-tag»;
builder.callToActionButtonTag = «call-to-action-label-tag»;
builder.iconImageViewTag = «icon-image-view-taG»;
builder.mediaContentViewTag = «media-view-content-view-tag»;
builder.starRatingContentViewTag = «star-rating-content-view-tag»;
builder.advertiserLabelTag = «advertiser-label-tag»;
builder.optionsContentViewTag = «options-content-view-tag»;
}];
[nativeAdView bindViewsWithAdViewBinder: binder];
return nativeAdView;
}
@end

Google Bidding 和 Google AdMob/Google Ad Manager 的额外集成步骤

从 Google Bidding 和 Google AdMob 适配器版本 9.11.0.6 以及 Google Ad Manager 适配器版本 9.11.0.5 开始,请按照这些额外步骤绑定 UI 组件。 这可确保自定义原生广告视图中任何不关联的视图对于这些网络来说仍可点击:

  1. 在包含所有广告资源的 MANativeAdView 内添加包装器视图。将其 Custom Class 设置为 GADNativeAdView

    NativeCustomAdView。 原生广告视图。 GAD 原生广告视图。 自定义类:类:GADNativeAdView。 模块:无。

  2. 赋予此包装器视图一个唯一的、其他视图未使用的Tag

    NativeCustomAdView。 原生广告视图。 GAD 原生广告视图。 视图:内容模式:缩放以填充。 语义:未指定。 标签:1008。 交互:✅ 已启用用户交互。

  3. 为包含此标签值的原生广告加载器设置一个本地额外参数,以及相应的键 google_native_ad_view_tag。 例如,如果视图的标签是 1008:

    -[setLocalExtraParameterForKey: "google_native_ad_view_tag" value: 1008]

加载原生广告

加载预渲染广告

要加载预渲染原生广告,请创建一个对应您广告单元 ID 的 MANativeAdLoader 实例对象,并调用其 loadAdIntoAdView 方法。 实现并设置 MANativeAdDelegate,以便在原生广告的加载状态发生变化时获得通知。

分别加载和呈现广告

要加载原生广告,创建一个与您的广告单元 ID 相对应的 MANativeAdLoader 实例对象,并调用其 loadAd 方法。 实现并设置 MANativeAdDelegate,以便在原生广告的加载状态发生变化时获得通知。然后使用 didLoadNativeAd:forAd: 中返回的 MAAd 来呈现广告视图。您可以通过调用 MANativeAdLoaderrenderNativeAdView:withAd: 方法来完成此操作。

销毁原生广告

如果您不再使用某个原生广告,就必须清理其资源。 您可以通过调用 destroy() 方法来完成此操作。否则应用的性能就会下降。

以下是在绑定上一步中的 UI 组件后,如何加载和销毁原生广告的示例:

#import "ExampleViewController.h"
#import <AppLovinSDK/AppLovinSDK.h>
@interface ExampleViewController()<MANativeAdDelegate, MAAdRevenueDelegate>
@property (nonatomic, strong) UIView *nativeAdContainerView;
@property (nonatomic, strong) MANativeAdLoader *nativeAdLoader;
@property (nonatomic, strong) MAAd *loadedNativeAd;
@end
@implementation ExampleViewController
- (void)createNativeAdLoader
{
self.nativeAdLoader = [[MANativeAdLoader alloc] initWithAdUnitIdentifier: @"«ad-unit-ID»"];
self.nativeAdLoader.nativeAdDelegate = self;
self.nativeAdLoader.revenueDelegate = self;
}
- (void)loadNativeAd
{
[self.nativeAdLoader loadAdIntoAdView: [self createNativeAdView]];
}
- (void)didLoadNativeAd:(MANativeAdView *)nativeAdView forAd:(MAAd *)ad
{
// Cleanup any pre-existing native ad to prevent memory leaks.
if ( self.loadedNativeAd )
{
[self.nativeAdLoader destroyAd: self.loadedNativeAd];
}
// Save ad for cleanup.
self.loadedNativeAd = ad;
// Set to false if modifying constraints after adding the ad view to your layout
self.nativeAdContainerView.translatesAutoresizingMaskIntoConstraints = NO;
// Add the native ad view to your layout
[self.nativeAdContainerView addSubview: nativeAdView];
// Set ad view to span width and height of container and center the ad
[self.nativeAdContainerView addConstraint: [NSLayoutConstraint constraintWithItem: nativeAdView attribute: NSLayoutAttributeWidth r elatedBy: NSLayoutRelationEqual toItem: self.nativeAdContainerView attribute: NSLayoutAttributeWidth multiplier: 1 constant: 0]];
[self.nativeAdContainerView addConstraint: [NSLayoutConstraint constraintWithItem: nativeAdView attribute: NSLayoutAttributeHeight relatedBy: NSLayoutRelationEqual toItem: self.nativeAdContainerView attribute: NSLayoutAttributeHeight multiplier: 1 constant: 0]];
[self.nativeAdContainerView addConstraint: [NSLayoutConstraint constraintWithItem: nativeAdView attribute: NSLayoutAttributeCenterX relatedBy: NSLayoutRelationEqual toItem: self.nativeAdContainerView attribute: NSLayoutAttributeCenterX multiplier: 1 constant: 0]];
[self.nativeAdContainerView addConstraint: [NSLayoutConstraint constraintWithItem: nativeAdView attribute: NSLayoutAttributeCenterY relatedBy: NSLayoutRelationEqual toItem: self.nativeAdContainerView attribute: NSLayoutAttributeCenterY multiplier: 1 constant: 0]];
}
- (void)didFailToLoadNativeAdForAdUnitIdentifier:(NSString *)adUnitIdentifier withError:(MAError *)error
{
// Native ad load failed
// AppLovin recommends that you retry with exponentially higher delays up to a maximum delay
}
- (void)didClickNativeAd:(MAAd *)ad { }
- (void)didPayRevenueForAd:(MAAd *)ad { }
@end

资源规模

对于 AppLovin Exchange 广告需求,标题、描述和 CTA 所允许的最大字符数如下:

资源最大字符数
标题50 个字符
描述150 个字符。可以在第 149 个字符后添加省略号 (...)作为第 150 个字符。
CTA15 个字符

对于 SDK 聚合的广告平台,最大字符数由广告平台设置。

如何获取媒体内容的宽高比

以下代码片段展示了如何获取原生广告的媒体内容宽高比:

- (void)didLoadNativeAd:(MANativeAdView *)nativeAdView forAd:(MAAd *)ad
{
CGFloat aspectRatio = ad.nativeAd.mediaContentAspectRatio;
}

支持的适配器版本

广告渠道适配器版本
BidMachine1.9.4.1.1
Google Ad Manager8.13.0.2
Google Bidding 和 Google AdMob8.13.0.2
InMobi10.0.2.2
LINE2.4.20211004.2
Meta Audience Network6.9.0.2
Mintegral7.0.4.0.0
Pangle4.2.0.2.1
Smaato21.6.19.1
VK Ad Network5.14.4.1

星级评定

使用 AppLovin MAX SDK(从 11.7.1 版本开始),您可以访问并呈现所宣传应用的星级评定。 如果可用,该值是 [0.0, 5.0] 范围内的浮点数。

MAX SDK 会自动在您指定为星级评定容器的容器视图中渲染星星。 如果网络没有提供星级评定,或者星级评定 < 3,则 SDK 不会填充星级评定容器视图。 您有责任相应地调整您的布局。

要检索当前广告的星级:

- (void)didLoadNativeAd:(MANativeAdView *)nativeAdView forAd:(MAAd *)ad
{
if ( ad.nativeAd.starRating < 3 )
{
// Star rating not available, or < 3 - hide star rating container view
return;
}
// Star rating available and >= 3 - show star rating container view
}

支持的适配器版本(星级)

广告渠道适配器版本
Google Ad Manager9.14.0.2
Google Bidding 和 Google AdMob9.14.0.2
InMobi10.1.2.5

Ad Placer

Ad Placer 会使用 UITableViewUICollectionView 自动将原生广告插入您的现有信息流中。 要集成此 API,请进行以下主要步骤:

  1. 设置原生广告布局。
  2. 创建 Ad Placer 设置。
  3. 配置 Ad Placer。
  4. 配置广告呈现设置。
  5. (可选)接收回传。

根据 AppLovin 的政策,您的广告必须包含隐私信息图标。 此图标链接至重要隐私声明。 您可以通过 -[MANativeAdViewBinderBuilder setOptionsContentViewTag:] 进行绑定。 包含要绑定的 UI 组件的自定义视图必须从 MANativeAdView 生成子类。

1. 设置原生广告布局

Ad Placer 支持模板或原生广告手动布局。 请参阅上文 “Tempates” 和 “Manual” 两节了解如何配置广告单元。 请参阅下方的 Configure Ad Rendering Settings 了解如何根据您的布局设置广告投放器。

2.创建 Ad Placer 设置

使用您的广告单元标识符,创建一个 MAAdPlacerSettings 对象。该对象用于配置您的 Ad Placer,并提供广告在信息流中的定位信息。

MAAdPlacerSettings *settings = [MAAdPlacerSettings settingsWithAdUnitIdentifier: @"«ad-unit-ID»"];

配置广告位置

Ad Placer 将广告放置在您的信息流中。 它至少基于下列之一来实现这一点:

  1. 指示广告投放位置的固定索引路径列表
  2. 定期插入广告的重复间隔
    • Ad Placer 会在最后一个固定位置后插入重复广告。 如果您未设置任何固定位置,则 Ad Placer 会在流中的第一个位置后重复添加广告。 该间隔值必须大于或等于2。 小于 2 的间隔值会禁用 Ad Placer。

通过修改 MAAdPlacerSettings 来配置广告位置

  1. 要添加新的固定广告位置,例如在第 1 行:
    [settings addFixedPositions: [NSIndexPath indexPathForRow: 1 inSection: 0]];
  2. 删除现有的固定位置:
    [settings resetFixedPositions];
  3. 要更改重复间隔;例如,在信息流中每五个位置插入一个广告:
    settings.repeatingInterval = 5;

其他设置

您可以通过调整 MAAdPlacerSettings 中的附加设置来配置您的 Ad Placer:

maximumAdCount
将其设置为流中的最大广告数量(默认值 = 256)。 如果流包含多个部分,则这将决定每个广告部分的最大广告数量。
maximumPreloadedAdCount
将其设置为在流中预加载的最大广告数(默认值为 4)。

3. 设置广告投放器

配置 Ad Placer 时,请选择以下两个选项之一:

  1. 如果您的内容流基于 UITableViewMATableViewAdPlacer。 如果基于 UICollectionView,请使用 MACollectionViewAdPlacer。 辅助类封装了原始适配器,能够自动渲染并将广告插入到内容流中。

它们位于 UITableView+MATableViewAdPlacer.hUICollectionView+MACollectionViewAdPlacer.h 中。 这些方法会调整索引路径,以适应已插入的广告。 并且,它们会提示 Ad Placer 内容的变更。 :::

  1. 如果您的内容流使用其他自定义 UI 组件,您可能更愿意使用子类或直接在实现时使用 MAAdPlacer

使用 MATableViewAdPlacer

要使用 MATableViewAdPlacer 设置 Ad Placer,请按照下列说明操作:

  1. 使用表格视图和设置MATableViewAdPlacer 进行初始化:
    self.adPlacer = [MATableViewAdPlacer placerWithTableView: self.tableView settings: settings];
  2. 将以下 UITableView 属性和方法替换为 AppLovin 类别的同等属性和方法 (前缀为 al_):
    • dataSource
    • delegate
    • deleteRowsAtIndexPaths:withRowAnimation:
    • deleteSections:withRowAnimation:
    • dequeueReusableCellWithIdentifier:forIndexPath:
    • deselectRowAtIndexPath:animated:
    • endUpdates
    • indexPathForCell:
    • indexPathForRowAtPoint:
    • indexPathForSelectedRow
    • indexPathsForRowsInRect:
    • indexPathsForSelectedRows
    • indexPathsForVisibleRows
    • insertRowsAtIndexPaths:withRowAnimation:
    • insertSections:withRowAnimation:
    • moveRowsAtIndexPaths:withRowAnimation:
    • moveSections:withRowAnimation:
    • performBatchUpdates:completion:
    • rectForRowAtIndexPath:
    • reloadData
    • reloadRowsAtIndexPaths:withRowAnimation:
    • reloadSections:withRowAnimation:
    • scrollToRowAtIndexPath:atScrollPosition:animated:
    • selectRowAtIndexPath:animated:scrollPosition:
    • visibleCells
  3. 调用 loadAds 开始加载广告。

以下代码展示了如何使用 MATableViewAdPlacer 将广告加载到表格视图中:

- (void)viewDidLoad
{
[super viewDidLoad];
// Configure table view
self.tableView.al_delegate = self;
self.tableView.al_dataSource = self;
// Configure ad placer and load ads
MAAdPlacerSettings *settings = [MAAdPlacerSettings settingsWithAdUnitIdentifier: @"«ad-unit-ID»"];
self.adPlacer = [MATableViewAdPlacer placerWithTableView: self.tableView settings: settings];
self.adPlacer.delegate = self;
[self.adPlacer loadAds];
}
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section
{
return self.data.count;
}
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
UITableViewCell *cell = [tableView al_dequeueReusableCellWithIdentifier: @"YourCell" forIndexPath: indexPath];
cell.textLabel.text = self.data[indexPath.row];
return cell;
}

使用 MACollectionViewAdPlacer

要使用 MACollectionViewAdPlacer 设置 Ad Placer,请按照下列说明操作:

  1. 使用表格视图和设置MACollectionViewAdPlacer 进行初始化:
    self.adPlacer = [MACollectionViewAdPlacer placerWithCollectionView: self.collectionView settings: settings];
  2. 将以下 UITableView 属性和方法替换为 AppLovin 类别的同等属性和方法 (前缀为 al_):
    • cellForItemAtIndexPath:
    • dataSource
    • delegate
    • deleteItemsAtIndexPaths:
    • deleteSections:
    • dequeueReusableCellWithIdentifier:forIndexPath:
    • deselectItemAtIndexPath:animated:
    • indexPathForCell:
    • indexPathForItemAtPoint:
    • indexPathsForSelectedItems
    • indexPathsForVisibleItems
    • insertItemsAtIndexPaths:
    • insertSections:
    • layoutAttributesForItemAtIndexPath:
    • moveItemsAtIndexPaths:
    • moveSections:
    • performBatchUpdates:completion:
    • reloadData
    • reloadItemsAtIndexPaths:
    • reloadSections:
    • scrollToItemAtIndexPath:atScrollPosition:animated:
    • selectedItemAtIndexPath:animated:scrollPosition:
    • visibleCells
  3. 如果您在使用 storyboard 来布局集合视图,请将集合视图的 “Estimate Size” 属性设置为 “None”。
  4. 调用 loadAds 开始加载广告。

以下代码展示了如何使用 MACollectionViewAdPlacer 将广告加载到表格视图中:

- (void)viewDidLoad
{
[super viewDidLoad];
// Configure collection view
self.collectionView.al_delegate = self;
self.collectionView.al_dataSource = self;
// Configure ad placer and load ads
MAAdPlacerSettings *settings = [MAAdPlacerSettings settingsWithAdUnitIdentifier: @"«ad-unit-ID»"];
self.adPlacer = [MACollectionViewAdPlacer placerWithCollectionView: self.collectionView settings: settings];
self.adPlacer.delegate = self;
[self.adPlacer loadAds];
}
- (NSInteger)collectionView:(UICollectionView *)collectionView numberOfItemsInSection:(NSInteger)section
{
return self.data.count;
}
- (UICollectionViewCell *)collectionView:(UICollectionView *)collectionView cellForItemAtIndexPath:(NSIndexPath *)indexPath
{
MyCollectionViewCell *cell = (MyCollectionViewCell *)[collectionView al_dequeueReusableCellWithIdentifier: @"YourCell" forIndexPath: indexPath];
cell.textLabel.text = self.data[indexPath.row];
return cell;
}

4.配置广告呈现设置

模板

如果您使用默认模板,则广告视图大小将自动调整为“小”模板的 360×120 和“中”模板的 360×300。

您可以在加载广告之前,在 Ad Placer 上设置 adSize 属性来自定义渲染广告的大小。例如,要将广告尺寸设置为宽度为 300,高度为 200,请进行以下调用:

self.adPlacer.adSize = CGSizeMake(300, 200);

手动

如果您使用手动布局,则必须在加载广告前设置 Ad Placer 的 nativeAdViewNibnativeAdViewBinder 属性。 AppLovin 建议您在使用手动模板时也设置 adSize 属性。这样可以优化渲染。

5. 可选的接收回传

所有 Ad Placer 都包含可选的回传,你可以使用它来接收事件通知:

  • didLoadAdAtIndexPath:
  • didRemoveAdsAtIndexPaths:
  • didClickAd:
  • didPayRevenueForAd: