Commencer

Ce guide s'adresse aux éditeurs qui souhaitent monétiser une application iOS avec AdMob et qui n'utilisent pas Firebase. Si vous envisagez d'inclure Firebase dans votre application (ou si vous envisagez de l'utiliser), consultez plutôt la version AdMob avec Firebase de ce guide.

L'intégration du SDK Google Mobile Ads dans une application constitue la première étape pour diffuser des annonces et générer des revenus. Une fois le SDK intégré, vous pouvez procéder à l'intégration d'un ou de plusieurs formats d'annonces compatibles.

Prerequisites

  • Utilisez Xcode 13.2.1 ou une version ultérieure.
  • Cibler iOS 10.0 ou version ultérieure

Importez le SDK Mobile Ads

CocoaPods (recommandé)

Le moyen le plus simple d'importer le SDK dans un projet iOS consiste à utiliser CocoaPods. Ouvrez le fichier Podfile de votre projet et ajoutez la ligne suivante à la cible de votre application:

pod 'Google-Mobile-Ads-SDK'

Ensuite, exécutez la ligne de commande:

pod install --repo-update

Si vous débutez avec CocoaPods, consultez la documentation officielle pour en savoir plus sur la création et l'utilisation de Podfiles.

Gestionnaire de packages Swift

Le SDK Google Mobile Ads est compatible avec Swift Package Manager à partir de la version 9.0.0. Pour importer le package Swift, procédez comme suit :

  1. Dans Xcode, installez le package Google Mobile Ads Swift en accédant à File > Add Packages... (Fichier et fichier ; Ajouter des packages).

  2. Dans l'invite qui s'affiche, recherchez le dépôt GitHub Google Mobile Ads Swift:

    https://github.com/googleads/swift-package-manager-google-mobile-ads.git
    
  3. Sélectionnez la version du package Swift de Google Mobile Ads que vous souhaitez utiliser. Pour les nouveaux projets, nous vous recommandons d'utiliser la version principale suivante.

Une fois l'opération terminée, Xcode commence à résoudre vos dépendances de package et à les télécharger en arrière-plan. Pour en savoir plus sur l'ajout de dépendances de packages, consultez l'article Apple's.

Téléchargement manuel

  1. Téléchargez et décompressez directement le framework du SDK, puis importez les frameworks suivants dans votre projet Xcode:

    • GoogleAppMeasurement.xcframework
    • GoogleAppMeasurementIdentitySupport.xcframework
    • GoogleMobileAds.xcframework
    • GoogleUtilities.xcframework
    • nanopb.xcframework
    • PromisesObjC.xcframework
    • UserMessagingPlatform.xcframework
  2. Ajoutez l'option Linker -ObjC aux autres options Linker dans les paramètres de compilation de votre projet:

Mettre à jour votre fichier Info.plist

Mettez à jour le fichier Info.plist de votre application pour ajouter deux clés:

  1. Une clé GADApplicationIdentifier avec une valeur de chaîne de l'AdMob ID de votre application (identifiée dans l'AdMob UI).
  2. Une clé SKAdNetworkItems avec des valeurs SKAdNetworkIdentifier pour Google (cstr6suwn9.skadnetwork) et sélectionnez les acheteurs supplémentaires qui ont fourni ces valeurs à Google.
<key>GADApplicationIdentifier</key>
<string>ca-app-pub-3940256099942544~1458002511</string>
<key>SKAdNetworkItems</key>
  <array>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>cstr6suwn9.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>4fzdc2evr5.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>2fnua5tdw4.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>ydx93a7ass.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>5a6flpkh64.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>p78axxw29g.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>v72qych5uu.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>c6k4g5qg8m.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>s39g8k73mm.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>3qy4746246.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>3sh42y64q3.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>f38h382jlk.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>hs6bdukanm.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>prcb7njmu6.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>v4nxqhlyqp.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>wzmmz9fp6w.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>yclnxrl5pm.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>t38b2kh725.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>7ug5zh24hu.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>9rd848q2bz.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>n6fk4nfna4.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>kbd757ywx3.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>9t245vhmpl.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>4468km3ulz.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>2u9pt9hc89.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>8s468mfl3y.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>av6w8kgt66.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>klf5c3l5u5.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>ppxm28t8ap.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>424m5254lk.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>uw77j35x4d.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>578prtvx9j.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>4dzt52r2t5.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>e5fvkxwrpn.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>8c4e2ghe7u.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>zq492l623r.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>3qcr597p9d.skadnetwork</string>
    </dict>
  </array>

Si vous n'avez pas encore créé de compte AdMob et enregistré une application, c'est le moment.

Initialiser le SDK Mobile Ads

Avant de charger les annonces, appelez la méthode startWithCompletionHandler: sur GADMobileAds.sharedInstance, qui initialise le SDK et rappelle un gestionnaire de fin à la fin de l'initialisation (ou après un délai d'inactivité de 30 secondes). Cette opération n'est à effectuer qu'une seule fois, idéalement lors du lancement de l'application. Vous devez appeler startWithCompletionHandler: le plus tôt possible.

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

Exemple de fichier AppDelegate.m (extrait)

Swift

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

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

    GADMobileAds.sharedInstance().start(completionHandler: nil)

    return true
  }

}

Objective-C

@import GoogleMobileAds;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [[GADMobileAds sharedInstance] startWithCompletionHandler:nil];
  return YES;
}

@end

Si vous utilisez la médiation, vous pouvez attendre que le gestionnaire d'exécution soit appelé avant de charger les annonces, car cela garantit l'initialisation de tous les adaptateurs de médiation.

Sélectionnez un format d'annonce

Le SDK Mobile Ads est désormais importé et initialisé. Vous êtes prêt à implémenter une annonce. AdMob Vous pouvez utiliser différents formats d'annonces afin de choisir celui qui correspond le mieux à l'expérience utilisateur de votre application.

Annonces rectangulaires qui s'affichent en haut ou en bas de l'écran de l'appareil. Les bannières restent affichées à l'écran lorsque les utilisateurs interagissent avec l'application et peuvent s'actualiser automatiquement au bout d'un certain temps. Si vous n'avez jamais utilisé la publicité mobile, cela représente un bon point de départ.

Intégrer une bannière

Interstitiel

Annonces plein écran qui couvrent l'interface d'une application jusqu'à ce qu'elles soient fermées par l'utilisateur. Elles sont plus adaptées aux pauses naturelles dans l'exécution d'une application, par exemple entre deux niveaux d'un jeu ou juste après la fin d'une tâche.

Implémenter un interstitiel

Natifs

Annonces personnalisables qui s'adaptent à l'apparence de votre application. Vous choisissez leur emplacement et leur emplacement, de sorte qu'elles correspondent mieux au design de votre application.

Mettre en œuvre Native Ads

Avec récompense

Annonces qui récompensent les utilisateurs pour le visionnage de courtes vidéos et l'interaction avec des annonces jouables et des enquêtes. Parfait pour monétiser les utilisateurs gratuits.

Intégrer des annonces avec récompense Intégrer des annonces avec récompense