ネイティブ スタイルの設定を使用すると、Google アド マネージャーで商品内に指定したネイティブ スタイルに沿って、ネイティブ広告のレンダリングが処理されます。まず、サイズとターゲティングを指定します。次に、HTML、CSS、JavaScript を追加して、レスポンシブで、すべての画面で質の高い表示を実現する広告を定義します。レンダリングは一切必要ありません。アド マネージャーがデスティネーションに適したネイティブ スタイルを自動的に適用します。ネイティブ スタイルは、バナー広告と同様に GAMBannerView
を使用して実装されます。事前に決定された固定の広告サイズまたは実行時に決定される Fluid 広告サイズで使用できます。
前提条件
- Google Mobile Ads SDK バージョン 7.14.0 以降
このガイドは、Google Mobile Ads SDK に関する実践的な知識がある方を対象としています。まだ行っていない場合は、スタートガイドをご確認いただくことをおすすめします。
固定サイズ
固定サイズのネイティブ スタイルを使用すると、ネイティブ広告の幅と高さを制御できます。固定サイズを設定する手順は次のとおりです。
アド マネージャーの管理画面で広告申込情報を作成し、
Size
フィールドのプルダウンから事前定義済みのサイズのいずれかを選択します。Interface Builder で、
GAMBannerView
の幅と高さを、手順 1 で選択した事前定義サイズに合わせて設定します。サイズとそれに対応するGADAdSize
定数のリストは、[バナーサイズ] セクションで確認できます。
固定サイズのネイティブ スタイルを実装する手順は、最初のバナー リクエストの手順と同じくらい簡単です。ただし、HTML、CSS、JavaScript を柔軟に制御して、アプリに自然に溶け込むネイティブな外観をバナー広告に与えることができます。
Fluid サイズ
固定サイズが適切でないこともあります。たとえば、広告の幅はアプリのコンテンツに合わせて、高さは広告のコンテンツに合わせて動的に調整したい場合があります。このケースを処理するには、アド マネージャーの管理画面で広告サイズとして Fluid
を指定します。これは、広告のサイズがアプリの実行時に決定されることを指定します。このケースを処理するために、SDK には特別な GADAdSize
定数 kGADAdSizeFluid
が用意されています。フレキシブル広告サイズの高さは、パブリッシャーが定義した幅に基づいて動的に決定されるため、GAMBannerView
はクリエイティブの高さに合わせて高さを調整できます。
流動的なリクエスト
他の広告フォーマットとは異なり、kGADAdSizeFluid
広告サイズには事前定義された幅がないため、コードまたは Interface Builder でバナーのフレーム幅を明示的に設定してください。幅が指定されていない場合、SDK はデフォルトでデバイスの全幅に基づいてバナーの高さを設定します。
kGADAdSizeFluid
を含むマルチサイズ リクエストを実行すると、返される広告は常に Fluid コンテナ内に配置され、Fluid 広告のように動作します。このフレキシブル コンテナで非フレキシブル クリエイティブが返された場合、SDK は広告をコンテナの中央に配置します。これにより、新しい広告が返されるたびに幅の制約を変更する必要がなくなります。
単一サイズと複数サイズの Fluid リクエストの実装は非常に似ています。唯一の違いは、複数サイズのリクエストでは、validAdSizes
プロパティを設定して、広告リクエストで有効な広告サイズを指定することです。
Swift
bannerView.validAdSizes = [nsValue(for: AdSizeFluid), nsValue(for: AdSizeBanner)]
Objective-C
_bannerView.validAdSizes = @[ NSValueFromGADAdSize(kGADAdSizeFluid),
NSValueFromGADAdSize(kGADAdSizeBanner) ];
実装全体のコードは次のようになります。
Swift
var bannerView: AdManagerBannerView!
override func viewDidLoad() {
super.viewDidLoad()
// Create the GAMBannerView and set its width to a width that makes sense for your
// app. In this example, the width is set to the width of the UIViewController's
// root view.
bannerView = AdManagerBannerView(adSize: AdSizeFluid)
var frameRect = bannerView.frame
frameRect.size.width = view.bounds.width
bannerView.frame = frameRect
// Uncomment this code for a multisize fluid request.
// bannerView.validAdSizes = [nsValue(for: AdSizeFluid), nsValue(for: AdSizeBanner)]
bannerView.adUnitID = "YOUR_AD_UNIT_ID"
bannerView.rootViewController = self
// Make the ad request.
bannerView.load(AdManagerRequest())
}
Objective-C
GAMBannerView *_bannerView;
- (void)viewDidLoad {
[super viewDidLoad];
// Create the GAMBannerView and set its width to a width that makes sense for your
// app. In this example, the width is set to the width of the UIViewController's
// root view.
_bannerView = [[GAMBannerView alloc] initWithAdSize:kGADAdSizeFluid];
CGRect frameRect = _bannerView.frame;
frameRect.size.width = CGRectGetWidth(self.view.bounds);
_bannerView.frame = frameRect;
// Uncomment this code for a multisize fluid request.
// _bannerView.validAdSizes = @[ NSValueFromGADAdSize(kGADAdSizeFluid),
// NSValueFromGADAdSize(kGADAdSizeBanner) ];
_bannerView.adUnitID = @"YOUR_AD_UNIT_ID";
_bannerView.rootViewController = self;
// Make the ad request.
[_bannerView loadRequest:[GAMRequest request]];
}
アド マネージャーのフレキシブル広告サイズの実装例を確認するには、Swift または Objective-C の iOS API デモアプリをダウンロードしてください。
GADAdSizeDelegate プロトコル
広告サイズが変更される前に、バナーの高さを把握しておきたい場合があります。adView:willChangeAdSizeTo:
コールバックは、バナービューが新しい GADAdSize
に変更される前に、そのデリゲートに通知します。バナービューが新しい広告サイズに変更される前に通知を受け取るには、クラスが GADAdSizeDelegate
プロトコルに準拠している必要があります。
バナーの新しい幅と高さを取得する方法を示した adView:willChangeAdSizeTo:
コールバックの実装例を次に示します。
Swift
// To be notified before the banner's ad size changes, your view controller class must
// conform to the GADAdSizeDelegate protocol.
bannerView.adSizeDelegate = self
// MARK: - GADAdSizeDelegate
func adView(_ bannerView: BannerView, willChangeAdSizeTo adSize: AdSize) {
let height = adSize.size.height
let width = adSize.size.width
}
Objective-C
// To be notified before the banner's ad size changes, your view controller class must
// conform to the GADAdSizeDelegate protocol.
_bannerView.adSizeDelegate = self;
#pragma mark - GADAdSizeDelegate
- (void)adView:(GADBannerView *)bannerView willChangeAdSizeTo:(GADAdSize)adSize {
CGFloat height = adSize.size.height;
CGFloat width = adSize.size.width;
}