Annonces interstitielles

Les annonces interstitielles s'affichent en plein écran et recouvrent l'interface d'une application jusqu'à fermé par l'utilisateur. Elles s'affichent généralement à des points de transition naturels le flux d'une application, par exemple entre des activités ou pendant une pause entre différents niveaux dans un jeu. Lorsqu'une application diffuse une annonce interstitielle, l'utilisateur a le choix soit appuyer sur l'annonce et accéder à sa destination, soit la fermer et revenir à l'application. Étude de cas :

Ce guide vous explique comment intégrer des annonces interstitielles dans une application iOS.

Prérequis

Effectuez toujours des tests avec des annonces tests

Lorsque vous créez et testez vos applications, assurez-vous d'utiliser des annonces tests plutôt que des annonces de production. À défaut, votre compte risque d'être suspendu.

Le moyen le plus simple de charger des annonces tests consiste à utiliser notre ID de bloc d'annonces test dédié. pour les interstitiels iOS:
/21775744923/example/interstitial

Il a été spécialement configuré pour renvoyer des annonces tests pour chaque demande. de l'utiliser dans vos propres applications lors du codage, des tests et du débogage. Il suffit de créer remplacez-le par votre propre ID de bloc d'annonces avant de publier votre application.

Pour en savoir plus sur le fonctionnement des annonces tests du SDK Mobile Ads, consultez Tester les annonces

Implémentation

Voici les principales étapes à suivre pour intégrer des annonces interstitielles :

  1. Chargez une annonce.
  2. Demandez à recevoir des rappels.
  3. Affichez l'annonce et gérez l'événement lié à la récompense.

Charger une annonce

Le chargement d'une annonce s'effectue à l'aide de la méthode load(adUnitID:request) sur la GAMInterstitialAd.

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController {

  private var interstitial: GAMInterstitialAd?

  override func viewDidLoad() {
    super.viewDidLoad()

    Task {
      do {
        interstitial = try await GAMInterstitialAd.load(
          withAdUnitID: "/21775744923/example/interstitial", request: GAMRequest())
      } catch {
        print("Failed to load interstitial ad with error: \(error.localizedDescription)")
      }
    }
  }
}

SwiftUI

import GoogleMobileAds

class InterstitialViewModel: NSObject, GADFullScreenContentDelegate {
  private var interstitialAd: GADInterstitialAd?

  func loadAd() async {
    do {
      interstitialAd = try await GADInterstitialAd.load(
        withAdUnitID: "ca-app-pub-3940256099942544/4411468910", request: GADRequest())
      interstitialAd?.fullScreenContentDelegate = self
    } catch {
      print("Failed to load interstitial ad with error: \(error.localizedDescription)")
    }
  }
InterstitialViewModel.swift

Objective-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController ()

@property(nonatomic, strong) GAMInterstitialAd *interstitial;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];
  GAMRequest *request = [GAMRequest request];
  [GAMInterstitialAd loadWithAdManagerAdUnitID:@"/21775744923/example/interstitial"
      request:request
      completionHandler:^(GAMInterstitialAd *ad, NSError *error) {
    if (error) {
      NSLog(@"Failed to load interstitial ad with error: %@", [error localizedDescription]);
      return;
    }
    self.interstitial = ad;
  }];
}

S'inscrire pour recevoir des rappels

Afin de recevoir des notifications pour les événements de présentation, vous devez implémenter le protocole GADFullScreenContentDelegate et attribuez-le au Propriété fullScreenContentDelegate de l'annonce renvoyée. Le protocole GADFullScreenContentDelegate gère les rappels lorsque l'annonce est diffusée avec succès ou non, et lorsqu'elle est fermée. Les éléments suivants : indique comment implémenter le protocole et l'attribuer à l'annonce:

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, GADFullScreenContentDelegate {

  private var interstitial: GAMInterstitialAd?

  override func viewDidLoad() {
    super.viewDidLoad()

    Task {
      do {
        interstitial = try await GAMInterstitialAd.load(
          withAdUnitID: "/21775744923/example/interstitial", request: GAMRequest())
        interstitial?.fullScreenContentDelegate = self
      } catch {
        print("Failed to load interstitial ad with error: \(error.localizedDescription)")
      }
    }
  }

  /// Tells the delegate that the ad failed to present full screen content.
  func ad(_ ad: GADFullScreenPresentingAd, didFailToPresentFullScreenContentWithError error: Error) {
    print("Ad did fail to present full screen content.")
  }

  /// Tells the delegate that the ad will present full screen content.
  func adWillPresentFullScreenContent(_ ad: GADFullScreenPresentingAd) {
    print("Ad will present full screen content.")
  }

  /// Tells the delegate that the ad dismissed full screen content.
  func adDidDismissFullScreenContent(_ ad: GADFullScreenPresentingAd) {
    print("Ad did dismiss full screen content.")
  }
}

SwiftUI

Attribuez la propriété fullScreenContentDelegate à l'annonce renvoyée:

interstitialAd?.fullScreenContentDelegate = self
InterstitialViewModel.swift

Implémentez le protocole:

func adDidRecordImpression(_ ad: GADFullScreenPresentingAd) {
  print("\(#function) called")
}

func adDidRecordClick(_ ad: GADFullScreenPresentingAd) {
  print("\(#function) called")
}

func ad(
  _ ad: GADFullScreenPresentingAd,
  didFailToPresentFullScreenContentWithError error: Error
) {
  print("\(#function) called")
}

func adWillPresentFullScreenContent(_ ad: GADFullScreenPresentingAd) {
  print("\(#function) called")
}

func adWillDismissFullScreenContent(_ ad: GADFullScreenPresentingAd) {
  print("\(#function) called")
}

func adDidDismissFullScreenContent(_ ad: GADFullScreenPresentingAd) {
  print("\(#function) called")
  // Clear the interstitial ad.
  interstitialAd = nil
}
InterstitialViewModel.swift

Objective-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController () <GADFullScreenContentDelegate>

@property(nonatomic, strong) GAMInterstitialAd *interstitial;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];
  GAMRequest *request = [GAMRequest request];
  [GAMInterstitialAd loadWithAdManagerAdUnitID:@"/21775744923/example/interstitial"
      request:request
      completionHandler:^(GAMInterstitialAd *ad, NSError *error) {
    if (error) {
      NSLog(@"Failed to load interstitial ad with error: %@", [error localizedDescription]);
      return;
    }
    self.interstitial = ad;
    self.interstitial.fullScreenContentDelegate = self;
  }];
}

/// Tells the delegate that the ad failed to present full screen content.
- (void)ad:(nonnull id<GADFullScreenPresentingAd>)ad
didFailToPresentFullScreenContentWithError:(nonnull NSError *)error {
    NSLog(@"Ad did fail to present full screen content.");
}

/// Tells the delegate that the ad will present full screen content.
- (void)adWillPresentFullScreenContent:(nonnull id<GADFullScreenPresentingAd>)ad {
    NSLog(@"Ad will present full screen content.");
}

/// Tells the delegate that the ad dismissed full screen content.
- (void)adDidDismissFullScreenContent:(nonnull id<GADFullScreenPresentingAd>)ad {
  NSLog(@"Ad did dismiss full screen content.");
}

GAMInterstitialAd est un objet à usage unique. Ce signifie qu'une fois qu'une annonce interstitielle a été diffusée, elle ne peut plus être diffusée. Il est recommandé de charger une autre annonce interstitielle dans la méthode adDidDismissFullScreenContent: sur GADFullScreenContentDelegate afin que la prochaine annonce interstitielle commence à se charger dès que la précédente est fermée.

Afficher l'annonce

Les interstitiels doivent être affichés lors des pauses naturelles dans le flux d'une application. Un bon exemple entre deux niveaux d'un jeu ou une fois que l'utilisateur a terminé une tâche.

Swift

guard let interstitial = interstitial else {
  return print("Ad wasn't ready.")
}

// The UIViewController parameter is an optional.
interstitial.present(fromRootViewController: nil)

SwiftUI

Écoutez les événements d'interface utilisateur dans la vue pour déterminer quand diffuser l'annonce.

var body: some View {
  // ...
  }
  .onChange(of: countdownTimer.isComplete) { newValue in
    showGameOverAlert = newValue
  }
  .alert(isPresented: $showGameOverAlert) {
    Alert(
      title: Text("Game Over"),
      message: Text("You lasted \(countdownTimer.countdownTime) seconds"),
      dismissButton: .cancel(
        Text("OK"),
        action: {
          viewModel.showAd()
        }))
InterstitialContentView.swift

Présentez l'annonce interstitielle à partir du ViewModel:

func showAd() {
  guard let interstitialAd = interstitialAd else {
    return print("Ad wasn't ready.")
  }

  interstitialAd.present(fromRootViewController: nil)
}
InterstitialViewModel.swift

Objective-C

if (self.interstitial) {
  // The UIViewController parameter is nullable.
  [self.interstitial presentFromRootViewController:nil];
} else {
  NSLog(@"Ad wasn't ready");
}

Bonnes pratiques

Déterminez si les annonces interstitielles sont adaptées à votre application.
Les annonces interstitielles sont plus efficaces dans les applications avec des points de transition naturels. La conclusion d'une tâche dans une application, comme partager une image ou terminer une au niveau du jeu, crée un tel point. Comme l'utilisateur s'attend à une pause dans le l'utilisateur peut facilement diffuser une annonce interstitielle expérience. Veillez à déterminer à quels moments du flux de travail de votre application vous allez les annonces display interstitielles et la façon dont l'utilisateur est susceptible d'y répondre.
N'oubliez pas de mettre en veille l'action lorsque vous diffusez une annonce interstitielle.
Il existe plusieurs types d'annonces interstitielles: textuelles, illustrées, des vidéos, etc. Il est important de vous assurer que lorsque votre application affiche un l'utilisation de certaines ressources pour permettre à l'annonce pour en tirer parti. Par exemple, lorsque vous effectuez l'appel pour afficher une interstitielle, veillez à mettre en pause toute sortie audio produite par votre application. Vous pouvez reprendre la lecture des sons dans la adDidDismissFullScreenContent: Gestionnaire d'événements, qui sera appelé lorsque l'utilisateur aura fini d'interagir avec l'annonce. En outre, envisagez d'interrompre temporairement tout calcul intensif. (comme une boucle de jeu) pendant l'affichage de l'annonce. Cela garantit que l'utilisateur ne rencontre pas de graphiques lents ou non réactifs, ni de vidéos saccadées.
Prévoyez un temps de chargement adéquat.
Tout comme il est important de vous assurer que vous diffusez des annonces interstitielles le bon moment, il est également important de s'assurer que l'utilisateur n'a pas à à attendre qu'elles soient chargées. Charger l'annonce avant sa diffusion vous pouvez vous assurer qu'une annonce interstitielle entièrement chargée est prête dès que il est temps d'en afficher un.
N'inondez pas les utilisateurs d'annonces.
Même si augmenter la fréquence des annonces interstitielles dans votre application peut sembler est un excellent moyen d'augmenter vos revenus, mais il peut aussi nuire à l'expérience utilisateur et de réduire les taux de clics. Assurez-vous que les utilisateurs interrompu et il ne pourra plus profiter de votre application.
N'utilisez pas le rappel de fin de chargement pour afficher l'interstitiel.
Cela peut nuire à l'expérience utilisateur. Préchargez plutôt l'annonce avant vous devez la montrer. Vérifiez ensuite la méthode canPresentFromRootViewController:error:. sur GAMInterstitialAd pour savoir s'il est prêt à être affichés.

Exemples sur GitHub

Affichez tous les exemples d'annonces interstitielles dans la langue de votre choix:

Étapes suivantes