このページは Cloud Translation API によって翻訳されました。

ネイティブ広告

ネイティブ広告は、広告の管理画面で表示される UI コンポーネントを通じて表示される広告アセットです。ネイティブに実装されていますすでに使用しているのと同じクラスを使用して表示されますアプリのビジュアルデザインに合わせてフォーマットできます。

ネイティブ広告が読み込まれると、アプリはその広告のアセットを含む広告オブジェクトを受け取ります。 Google Mobile Ads SDK ではなく表示を担います

ネイティブ広告を効果的に導入するには、大きく分けて次の 2 つの要素があります。 SDK を使用して広告を読み込み、アプリに広告コンテンツを表示する。

このページでは、SDK を使用して読み込む方法について説明します。ネイティブ広告。

前提条件

スタートガイドを完了している。

必ずテスト広告でテストする

アプリを作成、テストする際は、テスト広告ではなく、配信します。

テスト広告を読み込むには、専用のテスト広告ユニット ID を使用すると、 iOS 向けのネイティブ広告:

ca-app-pub-3940256099942544/3986624511

すべてのリクエストに対してテスト広告を返すように特別に構成されており、独自のアプリでコーディング、テスト、デバッグの際に使用できます。なお、テスト用 ID は、アプリを公開する前に必ずご自身の広告ユニット ID に置き換えてください。

Google Mobile Ads SDK のテスト広告の仕組みについて詳しくは、テスト広告。

広告を読み込む

ネイティブ広告は GADAdLoader クラスで委任されたメッセージに従って、代理人にメッセージを送信します。 GADAdLoaderDelegate 構成されます。

広告ローダを初期化する

広告を読み込むには、広告ローダを初期化する必要があります。次のコードは、GADAdLoader を初期化する方法を示しています。

Swift

adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    // The UIViewController parameter is optional.
    rootViewController: rootViewController,
    adTypes: [ .native ],
    options: [ ... ad loader options objects ... ])
adLoader.delegate = self

Objective-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    // The UIViewController parameter is nullable.
    rootViewController:rootViewController
               adTypes:@[ GADAdLoaderAdTypeNative ]
               options:@[ ... ad loader options objects ... ]];
self.adLoader.delegate = self;

広告ユニット ID（テスト ID を使用できます）と、 adTypes 配列と、リクエストするネイティブフォーマットを指定します。 options パラメータに設定します。リストには、 options パラメータの値については、ネイティブ広告の設定に関するページオプションページ。

adTypes 配列には、次のものを含めます。この定数は、

GADAdLoaderAdTypeNative

広告ローダのデリゲートを実装する

広告ローダのデリゲートは、広告タイプに固有のプロトコルを実装する必要があります。ネイティブ広告の場合、GADNativeAdLoaderDelegate プロトコルにメッセージが含まれます。ネイティブ広告の読み込み時にデリゲートに送信される要素です。

Swift

public func adLoader(_ adLoader: GADAdLoader,
            didReceive nativeAd: GADNativeAd)

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd *)nativeAd;

広告をリクエスト

GADAdLoader が初期化されたら、loadRequest: メソッドを呼び出して広告をリクエストします。

Swift

adLoader.load(GADRequest())

Objective-C

[self.adLoader loadRequest:[GADRequest request]];

「 loadRequest: メソッドを GADAdLoader 同じ GADRequest バナーやインタースティシャルのオブジェクトですリクエストオブジェクトは、ターゲティング情報を入力します。他の広告タイプと同じ効果を持たせることができます

複数の広告を読み込む（省略可）

1 回のリクエストで複数の広告を読み込むには、 GADMultipleAdsAdLoaderOptions オブジェクトを宣言します。GADAdLoader

Swift

let multipleAdOptions = GADMultipleAdsAdLoaderOptions()
multipleAdOptions.numberOfAds = 5;
adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    // The UIViewController parameter is optional.
    rootViewController: self,
    adTypes: [ .native ],
    options: [ multipleAdOptions ])

Objective-C

GADMultipleAdsAdLoaderOptions *multipleAdsOptions =
    [[GADMultipleAdsAdLoaderOptions alloc] init];
multipleAdsOptions.numberOfAds = 5;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    // The UIViewController parameter is nullable.
    rootViewController:rootViewController
               adTypes:@[ GADAdLoaderAdTypeNative ]
               options:@[ multipleAdsOptions ]];

1 回のリクエストあたりの広告数は最大 5 個であり、 SDK はリクエストされた広告の正確な数を返します。

返される Google 広告はそれぞれ異なりますが、予約広告枠や第三者購入者は必ずしも一意性は保証されません

メディエーションを使用している場合は、GADMultipleAdsAdLoaderOptions クラスを使用しないでください。複数のネイティブ広告のリクエストは、現時点では設定されていることを確認できます

読み込みが完了したタイミングを確認する

アプリが loadRequest: を呼び出した後に、次のコマンドを使用してリクエストの結果を取得できます。呼び出します。

adLoader:didFailToReceiveAdWithError: （GADAdLoaderDelegate）
adLoader:didReceiveNativeAd: （GADNativeAdLoaderDelegate内）

1 つの広告に対するリクエストによって、これらのメソッドのいずれかが 1 回呼び出されます。

複数の広告をリクエストすると、上記へのコールバックが少なくとも 1 回発生します。最大数を超えることはできません。

さらに、GADAdLoaderDelegate では adLoaderDidFinishLoading 呼び出すことができます。このデリゲートメソッドは、広告ローダの読み込みが完了したことを示します。他の広告やエラーは報告されません。こちらが複数のネイティブ広告を一度に読み込む場合の使用方法の例を以下に示します。

Swift

class ViewController: UIViewController, GADNativeAdLoaderDelegate {

  var adLoader: GADAdLoader!

  override func viewDidLoad() {
    super.viewDidLoad()

    let multipleAdOptions = GADMultipleAdsAdLoaderOptions()
    multipleAdOptions.numberOfAds = 5;
    adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
        // The UIViewController parameter is optional.
        rootViewController: rootViewController,
        adTypes: [ .native ],
        options: [ multipleAdOptions ])

    adLoader.delegate = self
    adLoader.load(GADRequest())
  }

  func adLoader(_ adLoader: GADAdLoader,
       didReceive nativeAd: GADNativeAd) {
    // A native ad has loaded, and can be displayed.
  }

  func adLoaderDidFinishLoading(_ adLoader: GADAdLoader) {
    // The adLoader has finished loading ads, and a new request can be sent.
  }

}

Objective-C

@interface ViewController () <GADNativeAdLoaderDelegate, GADVideoControllerDelegate>
@property(nonatomic, strong) GADAdLoader *adLoader;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  GADMultipleAdsAdLoaderOptions *multipleAdsOptions =
      [[GADMultipleAdsAdLoaderOptions alloc] init];
  multipleAdsOptions.numberOfAds = 5;
  self.adLoader = [[GADAdLoader alloc]
        initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
      // The UIViewController parameter is nullable.
      rootViewController:rootViewController
                 adTypes:@[ GADAdLoaderAdTypeNative ]
                 options:@[ multipleAdsOptions ]];

  self.adLoader.delegate = self;
  [self.adLoader loadRequest:[GADRequest request]];
}

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd *)nativeAd {
  // A native ad has loaded, and can be displayed.
}

- (void)adLoaderDidFinishLoading:(GADAdLoader *) adLoader {
  // The adLoader has finished loading ads, and a new request can be sent.
}

@end

失敗したリクエストの処理

上記のプロトコルは、GADAdLoaderDelegate プロトコルを拡張するものです。広告の読み込みに失敗したときに送信されるメッセージです。

Swift

public func adLoader(_ adLoader: GADAdLoader,
    didFailToReceiveAdWithError error: NSError)

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didFailToReceiveAdWithError:(NSError *)error;

ネイティブ広告イベントの通知を受け取る

ネイティブ広告の操作に関連するイベントの通知を受け取るには、デリゲートを設定します。プロパティを指定します。

Swift

nativeAd.delegate = self

Objective-C

nativeAd.delegate = self;

次に GADNativeAdDelegate 次の委任呼び出しを受ける必要があります。

Swift

func nativeAdDidRecordImpression(_ nativeAd: GADNativeAd) {
  // The native ad was shown.
}

func nativeAdDidRecordClick(_ nativeAd: GADNativeAd) {
  // The native ad was clicked on.
}

func nativeAdWillPresentScreen(_ nativeAd: GADNativeAd) {
  // The native ad will present a full screen view.
}

func nativeAdWillDismissScreen(_ nativeAd: GADNativeAd) {
  // The native ad will dismiss a full screen view.
}

func nativeAdDidDismissScreen(_ nativeAd: GADNativeAd) {
  // The native ad did dismiss a full screen view.
}

func nativeAdWillLeaveApplication(_ nativeAd: GADNativeAd) {
  // The native ad will cause the app to become inactive and
  // open a new app.
}

Objective-C

- (void)nativeAdDidRecordImpression:(GADNativeAd *)nativeAd {
  // The native ad was shown.
}

- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  // The native ad was clicked on.
}

- (void)nativeAdWillPresentScreen:(GADNativeAd *)nativeAd {
  // The native ad will present a full screen view.
}

- (void)nativeAdWillDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad will dismiss a full screen view.
}

- (void)nativeAdDidDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad did dismiss a full screen view.
}

- (void)nativeAdWillLeaveApplication:(GADNativeAd *)nativeAd {
  // The native ad will cause the app to become inactive and
  // open a new app.
}

ベストプラクティス

広告を読み込む際は以下のルールを守ってください。

リスト内のネイティブ広告を使用するアプリでは、広告のリストを事前キャッシュに保存する必要があります。
広告を事前キャッシュする場合は、キャッシュをクリアして、1 時間後に再読み込みしてください。
前のリクエストまで GADAdLoader で loadRequest: を再度呼び出さないでください読み込みが終了したとき。adLoaderDidFinishLoading: で示されます。

広告を表示する

広告を読み込んだら、あとはユーザーに表示するだけです。ネイティブアドバンスガイドをご覧ください。

ネイティブ広告

前提条件

必ずテスト広告でテストする

広告を読み込む

広告ローダを初期化する

Swift

Objective-C

広告ローダのデリゲートを実装する

Swift

Objective-C

広告をリクエスト

Swift

Objective-C

複数の広告を読み込む（省略可）

Swift

Objective-C

読み込みが完了したタイミングを確認する

Swift

Objective-C

失敗したリクエストの処理

Swift

Objective-C

ネイティブ広告イベントの通知を受け取る

Swift

Objective-C

Swift

Objective-C

ベスト プラクティス

広告を表示する

ベストプラクティス