ネイティブ広告のオプション

ネイティブ広告には多くの高度な機能があり、 最大限の広告エクスペリエンスを実現できます。このガイドでは、 ネイティブ広告の高度な機能を使用する方法

前提条件

アセット管理

優先するメディア アスペクト比のコントロール

メディア アスペクト比のコントロールを使用すると、 指定できます。

GADNativeAdMediaAdLoaderOptions mediaAspectRatio を設定します。 GADMediaAspectRatio に置き換えます。

  • 未設定の場合、返される広告には任意のメディア アスペクト比を指定できます。

  • 設定すると、 推奨のアスペクト比です。

次の例では、リターンされた画像や動画を優先するよう SDK に指示しています。 表示することもできます。

GADNativeAdMediaAdLoaderOptions *nativeOption = [[GADNativeAdMediaAdLoaderOptions alloc] init];
nativeOption.mediaAspectRatio = GADMediaAspectRatioAny;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

画像のダウンロードの管理

画像のダウンロード コントロールでは、画像アセットと URI のみのどちらを 渡されます。

GADNativeAdImageAdLoaderOptions disableImageLoading を設定します。 (BOOL 値)。
  • 画像のダウンロード コントロールはデフォルトで無効になっています。

  • 無効にすると、Google Mobile Ads SDK によって画像と URI の両方が入力されます。

  • 有効にすると、SDK が代わりに URI のみを入力するため、Android Studio を使用して 実際の画像は自由に変更できます。

次の例では、URI のみを返すように SDK に指示しています。

GADNativeAdImageAdLoaderOptions *nativeOption = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOption.disableImageLoading = YES;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

画像ペイロードのコントロール

広告によっては、1 つではなく複数の画像が使用されることがあります。この機能を使用して アプリがすべての画像を表示するか、1 つの画像のみを表示するかを示します。

GADNativeAdImageAdLoaderOptions shouldRequestMultipleImages を設定します。 (BOOL 値)。
  • 画像ペイロードのコントロールはデフォルトで無効になっています。

  • 無効にすると、アプリは 一連の画像を含むアセットの最初の画像

  • 有効にすると、アプリはすべての画像を表示する準備ができたことを示します 必ず指定してください

次の例では、複数の画像アセットを返すように SDK に指示しています。

GADNativeAdImageAdLoaderOptions *nativeOption = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOption.shouldRequestMultipleImages = YES;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

AdChoices プレースメント

AdChoices の位置の制御

AdChoices の位置コントロールでは、広告をレンダリングする隅を AdChoices アイコン。

GADNativeAdViewAdOptions preferredAdChoicesPosition を設定します。 GADAdChoicesPosition あります。

  • 未設定の場合、AdChoices アイコンの位置は右上に設定されます。

  • 設定すると、AdChoices はリクエストに応じてカスタムの位置に配置されます。

次の例は、AdChoices のカスタム画像位置を設定する方法を示しています。

GADNativeAdViewAdOptions *nativeOptions = [[GADNativeAdViewAdOptions alloc] init];
nativeOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopLeftCorner;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

AdChoices カスタムビュー

<ph type="x-smartling-placeholder">

AdChoices カスタムビュー機能を使用すると、AdChoices アイコンを できます。これは、AdChoices の位置コントロールとは異なります。 では、4 つの角のうち 1 つを指定できます。

GADNativeAd.adChoicesView を設定します。 GADAdChoicesView のプロパティ AdChoices コンテンツは GADAdChoicesView

次の例は、カスタムの AdChoices ビューを設定する方法を示しています。「 AdChoices アイコンは GADAdChoicesView 内にレンダリングされます。

Objective-C

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

    ...

    
    GADAdChoicesView *customAdChoicesView =
        [[GADAdChoicesView alloc] initWithFrame: CGRectMake(..., ..., ..., ...)];

    [nativeAdView addSubview:customAdChoicesView];
    nativeAdView.adChoicesView = customAdChoicesView;

    // Associate the native ad view with the native ad object. This is
    // required to make the ad clickable.
    // Note: this should always be done after populating the ad views.
    nativeAdView.nativeAd = nativeAd;
}

Swift

func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) {
    refreshAdButton.isEnabled = true

    ...
    // Define a custom position for the AdChoices icon.
    let customRect = CGRect(x: 100, y: 100, width: 15, height: 15)
    let customAdChoicesView = GADAdChoicesView(frame: customRect)
    nativeAdView.addSubview(customAdChoicesView)
    nativeAdView.adChoicesView = customAdChoicesView

    // Associate the native ad view with the native ad object. This is
    // required to make the ad clickable.
    // Note: this should always be done after populating the ad views.
    nativeAdView.nativeAd = nativeAd;
}

動画をコントロールする

ミュートの開始動作

「ミュートを開始」動作では、動画の開始音声を無効または有効にできます。

GADVideoOptions startMuted を設定します。 (BOOL 値)。
  • ミュートの開始動作はデフォルトで有効になっています。

  • 無効にすると、アプリは 生成できます。

  • 有効にすると、アプリは音声をミュートした状態で動画の再生を開始するようにリクエストします。

次の例は、ミュートされていない音声で動画を開始する方法を示しています。

GADVideoOptions *nativeOptions = [[GADVideoOptions alloc] init];
nativeOptions.startMuted = NO;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

カスタム再生コントロール

<ph type="x-smartling-placeholder">

これにより、カスタム動画入力コントロールをリクエストして、コンテンツの再生、一時停止、ミュートを 動画をご覧ください。

GADVideoOptions customControlsRequested を設定します。 (BOOL 値)。
  • カスタム再生コントロールはデフォルトで無効になっています。

  • 無効にすると、SDK でレンダリングされた入力コントロールが動画に表示されます。

  • 広告に動画コンテンツが含まれていて、カスタム コントロールが有効になっている場合は、 広告とともにカスタム コントロールが表示されるため、広告は 制御します。これにより、コントロールは GADVideoController

次の例は、カスタム再生コントロールを使用して動画をリクエストする方法を示しています。

GADVideoOptions *nativeOptions = [[GADVideoOptions alloc] init];
nativeOptions.customControlsRequested = YES;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

カスタム コントロールが有効かどうかを確認する

返された広告で広告が許可されるかどうかをリクエスト時に不明なため 設定するには、カスタム コントロールが有効になっているかどうかを確認する必要があります。

Objective-C

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

  GADVideoController *videoController = nativeAd.mediaContent.videoController;
  BOOL canShowCustomControls = videoController.customControlsEnabled;

}

Swift

func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) {
        let videoController = nativeAd.mediaContent.videoController
        let canShowCustomControls = videoController?.customControlsEnabled() == true
}

カスタム クリック操作

<ph type="x-smartling-placeholder">

カスタム クリック操作はネイティブ広告の機能です。広告ビューをスワイプすると、 広告のクリックとしてカウントされます。スワイプを使用するアプリと連携する設計 コンテンツ ナビゲーションのジェスチャー。このガイドでは、カスタム クリックを有効にする方法について説明します ネイティブ広告に設定できる項目です

GADNativeAdCustomClickGestureOptions を初期化する スワイプの方向を変更できます。また、コンバージョンが タップ操作をクリックとして許可します。

  • カスタム クリック操作はデフォルトで無効になっています。

  • 無効にすると、タップのみがクリック数としてカウントされます。

  • 有効にすると、スワイプ操作がクリックとしてカウントされ、 タップをクリック数としてカウントできるかどうか。

次の例は、カスタム スワイプ操作を 通常のタップ動作を維持します。

GADNativeAdCustomClickGestureOptions *swipeGestureOptions = [[GADNativeAdCustomClickGestureOptions alloc]
        initWithSwipeGestureDirection:UISwipeGestureRecognizerDirectionRight
                          tapsAllowed:YES];

// The following sample ad unit ID has been enabled for custom click gestures
// and can be used for testing.
self.adLoader = [[GADAdLoader alloc]
        initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
      rootViewController:self
                 adTypes:@[ GADAdLoaderAdTypeNative ]
                 options:@[ swipeGestureOptions ]];

スワイプ操作イベントをリッスンする

スワイプ操作のクリックが記録されると、Google Mobile Ads SDK は nativeAdDidRecordSwipeGestureClick: GADNativeAdDelegate の delegate メソッド に加えて、既存の nativeAdDidRecordClick: に加えて、 delegate メソッドを使用します。

#pragma mark - GADNativeAdDelegate implementation

// Called when a swipe gesture click is recorded.
- (void)nativeAdDidRecordSwipeGestureClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click has occurred.");
}

// Called when a swipe gesture click or a tap click is recorded, as configured in
// GADNativeAdCustomClickGestureOptions.
- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click or tap click has occurred.");
}

メディエーション

カスタム クリック操作は、Google モバイルのネイティブ広告でのみ機能します Ads SDK がレンダリングします。広告のソース サードパーティの SDK が必要 カスタム クリック方向設定には反応しないことに注意してください。