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 le guide AdMob autonome à la place.

Si vous n'êtes pas encore, en apprendre davantage sur tous les avantages de l' utilisation AdMob, Firebase et Google Analytics.

Avant que tu commences

Si vous ne possédez pas déjà un projet Firebase et une application Firebase, suivez le Firebase guide de démarrage: 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 pendant le workflow de création de projet.
- Si vous avez un projet Firebase existant qui ne possède pas Google Analytics activé, vous pouvez activer Google Analytics de l' Intégrations onglet de vos > Paramètres du projet.
  Projets Firebase créés avant le 31 Juillet, 2019 peuvent passer à l'expérience complète Google Analytics de l' Intégrations onglet, ainsi. 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 vous inscrire pour un compte AdMob.
2. Enregistrez votre application avec AdMob . Cette étape crée une application AdMob avec une expérience unique ID AdMob App que vous aurez besoin plus tard 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. En savoir plus sur les avantages de permettre des mesures utilisateur et lier votre application AdMob à Firebase.
Remplissez les deux étapes suivantes dans le tableau de bord Apps de votre compte AdMob:
1. Activer Metrics utilisateur pour permettre AdMob pour traiter et afficher des données analytiques dans curated 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 existant et l' application Firebase.
  Assurez-vous de saisir le même ID de groupe que celui que vous avez saisi pour votre application Firebase. Trouvez votre paquet de l' application Firebase ID dans la carte Vos applications de vos > Paramètres du projet .

Étape 2: Ajoutez votre AdMob App à votre `Info.plist` fichier

Dans votre application Info.plist fichier, ajoutez une GADApplicationIdentifier clé avec une valeur de chaîne de votre AdMob App .

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

Ajoutez la dépendance du SDK Google Mobile Ads au fichier Podfile de votre projet :
```
pod 'Google-Mobile-Ads-SDK'
```
Avant que les annonces de chargement, appelez le startWithCompletionHandler: méthode sur le 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é par le Mobile Ads SDK ou SDKs partenaires de médiation lors de l' appel 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)
- Initions les drapeaux spécifiques de demande (tels que tagForChildDirectedTreatment ou tag_for_under_age_of_consent )
En savoir plus dans la documentation AdMob .
Voici un exemple de comment appeler la startWithCompletionHandler: méthode 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 statistiques et les données utilisateur analytiques

Après son initialisation, le SDK Mobile Ads démarre automatiquement analyse de journalisation des événements et propriétés de l' utilisateur 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 carte des paramètres de l' utilisateur de votre compte AdMob (Home ou Apps tableau de bord), vous pouvez visualiser curated paramètres utilisateur dérivées à partir des données d'analyse collectées, comme la durée moyenne d' une session, l' ARPU et la rétention.
Dans le tableau de bord Analytics de la console Firebase, vous pouvez consulter les statistiques agrégées et des résumés des indicateurs clés . Si vous ajoutez le SDK Firebase pour Google Analytics , vous pouvez aussi les conversions marque pour des campagnes publicitaires et la construction des publics personnalisés dans la console Firebase.

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

É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
- Mettre en œuvre la journalisation des événements sur mesure dans votre application.
- Conversions marque pour des campagnes publicitaires sur mesure .
- Inclure ecommerce_purchase données d'événement dans le calcul des revenus pour les métriques et l' ARPU 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.
- Config à distance vous permet de modifier le comportement et l' apparence de votre application sans publier une mise à jour de l' application, sans frais, pour les utilisateurs actifs quotidiens illimités.
- A / B Testing vous donne le pouvoir aux changements de test à l' interface utilisateur, des fonctions ou des campagnes d'engagement de votre application pour savoir s'ils font un impact sur vos indicateurs clés (comme les revenus et la rétention) avant de rouler les changements à grande échelle.
- Prédictions applique l' apprentissage de la machine à 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, visitez le guide pour l' utilisation de Google Analytics et Firebase avec les applications AdMob .

Étape 6: Choisissez un format d'annonce pour 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)