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 ne disposez pas déjà d'un projet Firebase et d'une application Firebase, suivez le guide de démarrage de Firebase : Ajoutez 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 pendant le workflow de création de projet.
- Si vous disposez d'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 .
  Les projets Firebase créés avant le 31 juillet 2019 peuvent également passer à l'expérience complète de Google Analytics à partir de l'onglet Intégrations . Cette mise à niveau est facultative mais recommandée.

Étape 1: configurez votre application dans votre compte AdMob

Enregistrez votre application en tant qu'application AdMob.
1. Connectez-vous ou créez un compte AdMob.
2. Enregistrez votre application avec AdMob . Cette étape crée une application AdMob avec un identifiant d'application AdMob unique dont vous aurez besoin plus loin dans ce guide.
Vous serez invité à ajouter le SDK Mobile Ads à votre application. Trouvez des instructions détaillées pour cette tâche plus loin dans ce guide.
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 utilisateur et de l'association de votre application AdMob à Firebase.
Suivez les deux étapes suivantes dans le tableau de bord Applications de votre compte AdMob:
1. Activez les statistiques utilisateur pour permettre à AdMob de traiter et d'afficher des données analytiques 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 Firebase et à votre application Firebase existants.
  Assurez-vous de saisir le même ID de bundle que celui que vous avez entré pour votre application Firebase. Trouvez l'ID de bundle de votre application Firebase dans la carte 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 votre application, ajoutez une clé GADApplicationIdentifier avec une valeur de chaîne de votre ID d'application AdMob .

Vous pouvez effectuer cette modification par programme:

<!-- 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: ajoutez et initialisez le SDK Mobile Ads

Ajoutez la dépendance du SDK Google Mobile Ads au Podfile de votre projet:
```
pod 'Google-Mobile-Ads-SDK'
```
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). 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.
Avertissement: les annonces peuvent être préchargées par le SDK Mobile Ads ou les SDK des partenaires de médiation lors de l'appel de startWithCompletionHandler: Si vous devez prendre des mesures avant de charger des annonces, assurez-vous de le faire avant d'initialiser le SDK Mobile Ads. Voici quelques exemples d'actions qui pourraient être nécessaires avant l'initialisation:
- Obtenez le consentement des utilisateurs de l'Espace économique européen (EEE)
- Définissez les indicateurs spécifiques à la demande (tels que tagForChildDirectedTreatment ou tag_for_under_age_of_consent )
Pour en savoir plus, consultez la documentation AdMob .
Voici un exemple de la façon d'appeler 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 analytiques

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 d'annonces. Voici où vous pouvez voir ces données analytiques:

Dans la fiche Statistiques utilisateur de votre compte AdMob (tableau de bord Accueil ou Applications ), vous pouvez afficher des statistiques utilisateur sélectionnées dérivées des données d'analyse collectées, telles que la durée moyenne de session, l' ARPU et la rétention.
Dans le tableau de bord Analytics de la console Firebase, vous pouvez afficher des statistiques agrégées et des résumés des métriques clés . Vous pouvez également marquer les conversions pour les campagnes publicitaires et créer des audiences personnalisées .

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 plus de 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 des utilisateurs:

Ajouter et utiliser le SDK Firebase pour Google Analytics
- Implémentez la journalisation des événements personnalisée dans votre application.
- Marquer les conversions pour les campagnes publicitaires personnalisées .
- Incluez les données d'événement ecommerce_purchase dans le calcul des revenus pour les métriques ARPU et ARPPU .
Utilisez d'autres produits Firebase dans votre application
Après avoir ajouté le SDK Firebase pour Google Analytics, utilisez d'autres produits Firebase pour optimiser les annonces dans votre application.
- Remote Config vous permet de modifier le comportement et l'apparence de votre application sans publier une mise à jour de l'application, sans frais, pour un nombre illimité d'utilisateurs actifs quotidiens.
- Les tests A / B vous permettent de tester les modifications apportées à l'interface utilisateur, aux fonctionnalités ou aux campagnes d'engagement de votre application pour savoir si elles ont un impact sur vos indicateurs clés (comme les revenus et la rétention) avant de déployer largement les modifications.
- Predictions applique l'apprentissage automatique à vos données d'analyse pour créer des segments d'utilisateurs dynamiques en fonction du comportement prévu de vos utilisateurs. Ces prédictions peuvent être utilisées dans d'autres produits Firebase.

Pour commencer, consultez le guide d' utilisation de Google Analytics et de Firebase avec les applications AdMob .

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

AdMob propose un certain nombre de formats d'annonces différents. Vous pouvez donc choisir le format qui correspond le mieux à l'expérience utilisateur de votre application. Cliquez sur un bouton pour un format d'annonce pour afficher les instructions détaillées de mise en œuvre 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'à ce qu'elle soit fermée par l'utilisateur

Les publicités interstitielles sont mieux utilisées à 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.

Mettre en œuvre des annonces interstitielles

Originaire de

Des 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 contribuer à une expérience utilisateur riche.

Mettre en œuvre des annonces natives avancées

Récompensé

Des publicités qui récompensent les utilisateurs pour avoir regardé de courtes vidéos et interagi avec des publicités jouables et des sondages

Les annonces avec récompense (ou "basées sur les récompenses") peuvent aider à monétiser les utilisateurs gratuits.

Mettre en œuvre des annonces avec récompense

Mettre en œuvre des annonces avec récompense (nouvelles API)