Cette page a été traduite par l'API Cloud Translation.

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 et d'application Firebase, suivez le guide de démarrage 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 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 .
  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 ID d'application AdMob unique dont vous aurez besoin plus loin dans ce guide.
Il vous sera demandé d'ajouter le SDK Mobile Ads à votre application. Vous trouverez 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. Découvrez les avantages de l'activation des statistiques sur les 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 sur les utilisateurs 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 du 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 votre application, ajoutez une clé GADApplicationIdentifier avec une valeur de chaîne de 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 : Ajoutez et initialisez le SDK Mobile Ads

Ajoutez la dépendance du SDK Google Mobile Ads au fichier 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 d'attente 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 avoir initialisé 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 pouvant être nécessaires avant l'initialisation :
- Obtenir le consentement des utilisateurs de l'Espace économique européen (EEE)
- Définissez tous les indicateurs spécifiques à la demande (tels que tagForChildDirectedTreatment ou tag_for_under_age_of_consent )
En savoir plus dans la documentation AdMob .
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 d'annonces. Voici où vous pouvez voir ces données d'analyse :

Dans la fiche " Statistiques utilisateur" de votre compte AdMob (tableau de bord Accueil ou Applications ), vous pouvez afficher les statistiques utilisateur sélectionnées dérivées des données d'analyse collectées, telles que la durée moyenne de la 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 . Si vous ajoutez le SDK Firebase pour Google Analytics , vous pouvez également marquer les conversions pour les campagnes publicitaires et créer des audiences personnalisées dans la console Firebase.

Notez que pour mieux représenter les métriques ARPU et ARPPU , vous pouvez inclure les données d'un événement d'analyse personnalisé appelé ecommerce_purchase dans le calcul des revenus de 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
- Mettez en œuvre une journalisation des événements personnalisée dans votre application.
- Marquez 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 .
Utiliser 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 de mise à jour d'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 mesures clés (comme les revenus et la rétention) avant de déployer les modifications à grande échelle.
- Predictions applique l'apprentissage automatique à vos données d'analyse pour créer des segments d'utilisateurs dynamiques basés sur le 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 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 le bouton d'un format d'annonce pour afficher des instructions de mise en œuvre détaillées dans la documentation AdMob.

Annonces rectangulaires qui apparaissent 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 annonces 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

Originaire de

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 sondages jouables

Les annonces avec récompense (ou « basées sur les récompenses ») peuvent aider à monétiser les utilisateurs free-to-play.

Mettre en œuvre des annonces avec récompense

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