Annonces interstitielles

Les annonces interstitielles s'affichent en plein écran et recouvrent l'interface d'une application jusqu'à ce que l'utilisateur les ferme. Elles s'affichent généralement à des points de transition naturels dans le flux d'une application, par exemple entre des activités ou pendant la pause entre les niveaux d'un jeu. Lorsqu'une application affiche une annonce interstitielle, l'utilisateur a le choix d'appuyer sur l'annonce et de continuer jusqu'à sa destination, ou de la fermer et de revenir à l'application.

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

Conditions préalables

Toujours tester avec des annonces tests

Lorsque vous créez et testez vos applications, veillez à utiliser des annonces tests plutôt que des annonces de production en ligne. À 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é aux interstitiels iOS:
/6499/example/interstitial

Cet outil a été spécialement configuré pour renvoyer des annonces tests pour chaque requête. Vous êtes libre de l'utiliser dans vos propres applications lors du codage, des tests et du débogage. Veillez simplement à le remplacer 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 Annonces tests.

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

Pour charger une annonce, vous devez utiliser la méthode statique loadWithAdManagerAdUnitID:request:completionHandler: sur la classe GAMInterstitialAd. La méthode de chargement nécessite votre ID de bloc d'annonces, un objet GAMRequest et un gestionnaire d'achèvement appelé lorsque le chargement de l'annonce réussit ou échoue. L'objet GAMInterstitialAd chargé est fourni en tant que paramètre dans le gestionnaire d'achèvement. L'exemple ci-dessous montre comment charger un GAMInterstitialAd dans votre classe ViewController.

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController {

  private var interstitial: GAMInterstitialAd?

  override func viewDidLoad() {
    super.viewDidLoad()

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

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:@"/6499/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 l'attribuer à la propriété fullScreenContentDelegate de l'annonce renvoyée. Le protocole GADFullScreenContentDelegate gère les rappels lorsque l'annonce est bien présentée ou non, et lorsqu'elle est ignorée. Le code suivant montre 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()

    do {
      interstitial = try await GAMInterstitialAd.load(
        withAdUnitID: "/6499/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.")
  }
}

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:@"/6499/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. Cela 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 l'annonce interstitielle suivante se charge dès que la précédente est ignorée.

Afficher l'annonce

Les interstitiels doivent être affichés lors de pauses naturelles dans le flux d'une application. C'est le cas entre les niveaux d'un jeu ou après que l'utilisateur a terminé une tâche. Voici un exemple de procédure à suivre dans l'une des méthodes d'action d'un UIViewController:

Swift

@IBAction func doSomething(_ sender: Any) {
  guard let interstitial = interstitial else {
    return print("Ad wasn't ready.")
  }

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

Objective-C

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

Si vous n'obtenez aucune annonce et que le message d'erreur "Erreur de demande: Aucune annonce à diffuser" s'affiche, vérifiez que votre élément de campagne comporte une création dont la taille est appropriée. Les tailles des interstitiels sont les suivantes : 320 x 480 et 480 x 320 pour les téléphones, et 1 024 x 768 et 768 x 1 024 pour les tablettes. Si un appareil n'est pas assez grand pour s'adapter à une taille de 1 024 x 768 ou 768 x 1 024, il reviendra à la taille 320 x 480 ou 480 x 320.

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 un niveau de jeu, constitue un tel point de départ. Comme l'utilisateur s'attend à ce qu'une pause soit interrompue, il est facile de diffuser une annonce interstitielle sans perturber son expérience. Veillez à déterminer à quels moments du flux de travail de votre application vous diffuserez des annonces interstitielles, ainsi que la manière 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, vidéo, etc. Il est important de s'assurer que lorsque votre application affiche une annonce interstitielle, elle suspend également l'utilisation de certaines ressources pour permettre à l'annonce d'en profiter. Par exemple, lorsque vous effectuez l'appel pour afficher une annonce interstitielle, veillez à mettre en pause toute sortie audio produite par votre application. Vous pouvez reprendre la lecture des sons dans le gestionnaire d'événements adDidDismissFullScreenContent:, qui sera appelé lorsque l'utilisateur aura fini d'interagir avec l'annonce. En outre, envisagez d'interrompre temporairement toutes les tâches de calcul intenses (telles qu'une boucle de jeu) pendant la diffusion de l'annonce. Ainsi, l'utilisateur ne verra pas de graphiques lents ou qui ne répondent pas, ni de vidéos saccadées.
Prévoyez un temps de chargement adéquat.
Tout comme il est important de vous assurer que vos annonces interstitielles s'affichent au bon moment, il est important de veiller à ce que l'utilisateur n'ait pas à attendre qu'elles se chargent. En chargeant l'annonce avant son intention de diffusion, vous pouvez vous assurer que votre application dispose d'une annonce interstitielle entièrement chargée, prête à être utilisée au moment de sa diffusion.
N'inondez pas les utilisateurs d'annonces.
Si augmenter la fréquence des annonces interstitielles dans votre application peut sembler être un excellent moyen d'accroître vos revenus, cela peut également nuire à l'expérience utilisateur et aux taux de clics. Assurez-vous que les utilisateurs ne sont pas interrompus si souvent qu'ils ne peuvent 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 que vous n'ayez besoin de la diffuser. Vérifiez ensuite la méthode canPresentFromRootViewController:error: sur GAMInterstitialAd pour savoir si elle est prête à être affichée.

Exemples sur GitHub

Étapes suivantes