Premiers pas avec AdMob dans votre projet iOS

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

Si vous ne l'avez pas encore fait, découvrez tous les avantages de l'utilisation conjointe d'AdMob, de Firebase et de Google Analytics.

Avant que tu commences

  • Si vous n'avez pas encore de projet Firebase ni d'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 nouveau projet Firebase, activez Google Analytics lors du workflow de création de projet.

    • Si vous avez un projet Firebase existant pour lequel Google Analytics n'est pas activé, vous pouvez activer Google Analytics à partir de l'onglet Intégrations de vos > 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 créez un compte AdMob.

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

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

  2. Associez votre application AdMob à votre application Firebase.

    Cette étape est facultative mais fortement recommandée. En savoir plus sur les avantages de l'activation des statistiques relatives aux utilisateurs et de l'association de votre application AdMob à Firebase.

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

    1. Activez les statistiques utilisateur pour permettre à AdMob de traiter et d'afficher des données d'analyse organisé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 Firebase et à votre application Firebase existants.

      Assurez-vous de saisir le même ID de groupe que celui que vous avez saisi pour votre application Firebase. Recherchez l'ID de bundle de votre application Firebase dans la fiche Vos applications de vos > 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 par programmation :

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

Ou modifiez-le dans l'éditeur de liste de propriétés :

Éditeur de liste de propriétés

Étape 3 : Ajouter et initialiser le SDK Mobile Ads

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

    pod 'Google-Mobile-Ads-SDK'
    
  2. Avant de charger des 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). Appelez cette méthode une seule fois et le plus tôt possible, idéalement au lancement de l'application mais après l'initialisation de Firebase.

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

    Rapide

    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
      }
    
    }
    

    Objectif 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 : Afficher les métriques utilisateur et les données d'analyse

Après son initialisation, le SDK Mobile Ads démarre automatiquement la journalisation des événements d'analyse et des propriétés utilisateur à partir de votre application. Vous pouvez afficher ces données sans ajouter de code supplémentaire à votre application ni mettre en œuvre de publicités. Voici où vous pouvez voir ces données d'analyse :

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

Étape 5 : (Facultatif) Utiliser davantage de fonctionnalités de Google Analytics et de Firebase

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

  • Optimisez la monétisation des publicités 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 la mise en œuvre de l'annonce pour tous vos utilisateurs. Pour en savoir plus, consultez les tutoriels suivants :

Étape 6 : Choisissez un format d'annonce à mettre en œuvre dans votre application

AdMob propose différents formats d'annonces. Vous pouvez donc choisir celui qui correspond le mieux à l'expérience utilisateur de votre application. Cliquez sur le bouton d'un format d'annonce pour afficher les instructions de mise en œuvre 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 publicitaires restent à l'écran pendant que les utilisateurs interagissent avec l'application et peuvent s'actualiser automatiquement après un certain temps. Si vous débutez dans la publicité mobile, c'est un excellent point de départ.

Mettre en œuvre des bannières publicitaires

Interstitiel

Annonces en plein écran qui couvrent l'interface d'une application jusqu'à sa fermeture par l'utilisateur

Les publicités interstitielles sont mieux utilisées lors des pauses naturelles dans le flux d'exécution d'une application, comme entre les niveaux d'un jeu ou juste après la fin d'une tâche.

Mettre en œuvre des annonces interstitielles

Indigène

Annonces personnalisables qui correspondent à l'apparence de votre application

Les annonces natives sont un format d'annonce basé sur des composants. Vous décidez comment et où les annonces natives sont placées afin que la mise en page soit plus cohérente avec la conception de votre application. En choisissant vous-même les polices, les couleurs et d'autres détails, vous pouvez créer des présentations publicitaires naturelles et discrètes qui peuvent ajouter à une expérience utilisateur riche.

Mettre en œuvre des annonces natives avancées

Récompensé

Annonces qui récompensent les utilisateurs qui regardent de courtes vidéos et interagissent avec des annonces et des enquêtes lisibles

Les publicités avec récompense (ou « basées sur la récompense ») peuvent aider à monétiser les utilisateurs de jeux gratuits.

Implémenter des publicités avec récompense Mettre en œuvre des publicités avec récompense (nouvelles API)