Premiers pas avec AdMob dans votre projet iOS

Ce guide de démarrage rapide s'adresse aux éditeurs et aux développeurs qui souhaitent utiliser AdMob pour monétiser une application créée avec Firebase. Si vous ne prévoyez pas d'inclure Firebase dans votre application, consultez plutôt le guide AdMob autonome.

Si ce n'est pas déjà fait, découvrez tous les avantages de l'utilisation combinée de AdMob, de Firebase et de Google Analytics.

Avant de commencer

  • Si vous ne disposez pas encore d'un projet Firebase ni d'une application Firebase, suivez le guide de démarrage de Firebase : Ajouter Firebase à votre projet iOS.

  • Assurez-vous que Google Analytics est activé dans votre projet Firebase :

    • Si vous créez un projet Firebase, activez Google Analytics au cours du workflow de création du projet.

    • Si vous disposez d'un projet Firebase existant pour lequel Google Analytics n'est pas activé, vous pouvez activer Google Analytics dans l'onglet Intégrations de > Paramètres du projet.

Étape 1 : Configurez votre application dans votre compte AdMob

  1. Enregistrez votre application en tant qu'application AdMob.

    1. Connectez-vous ou inscrivez-vous à un compte AdMob.

    2. Enregistrez votre application auprès de AdMob. Cette étape crée une application AdMob avec un ID d'application AdMob unique dont vous aurez besoin plus tard dans ce guide.

    Vous serez invité à ajouter le SDK Mobile Ads à votre application. Vous trouverez des instructions détaillées concernant cette tâche plus loin dans ce guide.

  2. Associez votre application AdMob à votre application Firebase.

    Cette étape est facultative, mais vivement recommandée. Découvrez les avantages d'activer les métriques utilisateur et d'associer votre application AdMob à Firebase.

    Effectuez les deux étapes suivantes dans le tableau de bord Applications de votre compte AdMob :

    1. Activez les métriques utilisateur pour autoriser AdMob à traiter et afficher les données d'analyse sélectionnées dans votre compte AdMob. Il s'agit également d'un paramètre obligatoire pour associer votre application AdMob à Firebase.

    2. Associez votre application AdMob à votre projet et application Firebase existants.

      Veillez à saisir le même ID de bundle que pour votre application Firebase. Recherchez l'ID de bundle de votre application Firebase dans la fiche Vos applications de > Paramètres du projet.

Étape 2 : Ajoutez votre ID d'application AdMob à votre fichier Info.plist

Dans le fichier Info.plist de votre application, ajoutez une clé GADApplicationIdentifier avec une valeur de chaîne correspondant à votre ID d'application AdMob.

Vous pouvez effectuer cette modification de manière programmatique :

<!-- Sample AdMob App ID: ca-app-pub-3940256099942544~1458002511 -->
<key>GADApplicationIdentifier</key>
<string>ADMOB_APP_ID</string>

Vous pouvez également le modifier dans l'éditeur de la liste des établissements :

Éditeur de la liste des établissements

Étape 3 : Ajoutez et initialisez le SDK Mobile Ads

  1. Ajoutez la dépendance du SDK Google Mobile Ads au fichier Podfile de votre projet:

    pod 'Google-Mobile-Ads-SDK'

  2. Avant de charger les annonces, appelez la méthode startWithCompletionHandler: sur GADMobileAds.sharedInstance.

    Cet appel initialise le SDK et rappelle un gestionnaire d'achèvement une fois l'initialisation terminée (ou après un délai de 30 secondes). N'appelez cette méthode qu'une seule fois et le plus tôt possible, idéalement au démarrage de l'application, mais après avoir initialisé Firebase.

    Voici un exemple d'appel de la méthode startWithCompletionHandler: dans votre AppDelegate:

    Swift

    import Firebase
import GoogleMobileAds
...

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    // Use Firebase library to configure APIs.
    FirebaseApp.configure()

    // Initialize the Google Mobile Ads SDK.
    GADMobileAds.sharedInstance().start(completionHandler: nil)

    return true
  }

}

    Objective-C

    @import Firebase;
@import GoogleMobileAds;
...

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  // Use Firebase library to configure APIs.
  [FIRApp configure];
  // Initialize the Google Mobile Ads SDK.
  [[GADMobileAds sharedInstance] startWithCompletionHandler:nil];
  return YES;
}

@end

Étape 4 : Affichez les métriques utilisateur et les données analytiques

Après son initialisation, le SDK Mobile Ads commence automatiquement à consigner les événements d'analyse et les propriétés utilisateur à partir de votre application. Vous pouvez afficher ces données sans ajouter de code supplémentaire à votre application ni implémenter d'annonces. Vous pouvez consulter ces données analytiques :

Notez que pour mieux représenter les métriques ARPU et ARPPU, vous pouvez inclure les données d'un événement personnalisé d'analyse appelé ecommerce_purchase dans le calcul des revenus pour ces métriques (découvrez comment).

Étape 5:(Facultatif) Utilisez d'autres fonctionnalités de Google Analytics et Firebase

Profitez de plus d'opportunités et de fonctionnalités pour améliorer la monétisation des applications et l'engagement utilisateur :

  • Optimiser la monétisation des annonces pour votre application

    Essayez différents formats ou configurations d'annonces avec un petit sous-ensemble d'utilisateurs, puis prenez des décisions basées sur les données concernant l'implémentation de l'annonce pour tous vos utilisateurs. Pour en savoir plus, consultez les tutoriels suivants :

Étape 6:Choisissez un format d'annonce à implémenter dans votre application

AdMob propose plusieurs formats d'annonces différents. Vous pouvez donc choisir celui qui convient le mieux à l'expérience utilisateur de votre application. Cliquez sur un bouton pour un format d'annonce afin d'afficher des instructions d'implémentation détaillées dans la documentation AdMob.

Annonces rectangulaires qui s'affichent en haut ou en bas de l'écran de l'appareil

Les bannières restent à l'écran lorsque les utilisateurs interagissent avec l'application et peuvent s'actualiser automatiquement au bout d'un certain temps. Si vous débutez dans la publicité mobile, elles constituent un excellent point de départ.

Implémenter des bannières

Interstitiel

Annonces en plein écran qui recouvrent l'interface d'une application jusqu'à ce que l'utilisateur les ferme

Les annonces interstitielles sont particulièrement utiles lors des pauses naturelles dans le flux d'exécution d'une application, par exemple entre les niveaux d'un jeu ou juste après la fin d'une tâche.

Implémenter des annonces interstitielles

Natif

Annonces personnalisables qui s'adaptent à l'apparence de votre application

Les annonces natives sont un format d'annonce basé sur des composants. C'est vous qui décidez où et comment les annonces natives sont placées afin d'harmoniser leur mise en page avec celle de votre application. En choisissant vous-même des polices, des couleurs et d'autres détails, vous pouvez créer des présentations d'annonces naturelles et non intrusives qui peuvent enrichir l'expérience utilisateur.

Implémenter les annonces natives avancées

Avec récompense

Annonces qui récompensent les utilisateurs pour avoir regardé de courtes vidéos, et interagi avec des annonces jouables et des enquêtes

Les annonces avec récompense (ou "basées sur une récompense") peuvent vous aider à monétiser les jeux sans frais.

Implémenter les annonces avec récompense Implémenter les annonces avec récompense (nouvelles API)