Commencer

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

Conditions préalables

• Utiliser Xcode 15.3 ou une version ultérieure
• Cibler iOS 12.0 ou version ultérieure

Importer le SDK Mobile Ads

Utilisez l'une des méthodes suivantes pour importer le SDK Google Mobile Ads.

CocoaPods (à privilégier)

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

pod 'Google-Mobile-Ads-SDK'

Ensuite, à partir de la ligne de commande, exécutez la commande suivante:

pod install --repo-update

Si vous débutez avec CocoaPods, consultez la documentation officielle pour découvrir comment créer et utiliser des Podfiles.

Gestionnaire de paquets Swift

Important :Les bibliothèques d'adaptateurs de médiation ne sont pas encore disponibles sur le gestionnaire de packages Swift. Si vous utilisez la médiation, nous vous recommandons d'intégrer CocoaPods.

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

Remarque :Si vous effectuez une migration à partir d'un projet basé sur CocoaPods, exécutez pod deintegrate pour supprimer CocoaPods de votre projet Xcode. Le fichier .xcworkspace généré par CocoaPods peut être supprimé en toute sécurité par la suite. Si vous ajoutez le SDK Google Mobile Ads à un projet pour la première fois, vous pouvez ignorer cette étape.

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

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

   https://github.com/googleads/swift-package-manager-google-mobile-ads.git
   

3. Sélectionnez la version du package Google Mobile Ads Swift que vous souhaitez utiliser. Pour les nouveaux projets, nous vous recommandons d'utiliser l'option Jusqu'à la prochaine version majeure.

Une fois que vous avez terminé, 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 d'Apple.

Téléchargement manuel

1. Téléchargez le SDK Google Mobile Ads et Embed & Signles frameworks suivants dans votre projet Xcode:

   • GoogleMobileAds.xcframework
   • UserMessagingPlatform.xcframework

2. Ajoutez l'indicateur d'association -ObjC à Other Linker Flags 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 correspondant à votreAd Manager app ID found in the Ad Manager UI and of the form ca-app-pub-################~##########.

2. Une clé SKAdNetworkItems avec des valeurs SKAdNetworkIdentifier pour Google (cstr6suwn9.skadnetwork) et certains acheteurs tiers qui ont fourni ces valeurs à Google.

Extrait complet

<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>4pfyvq9l8r.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>ludvb6z3bs.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cp8zw746q7.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3sh42y64q3.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>f38h382jlk.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>hs6bdukanm.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>gta9lk7p23.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>vutu7akeur.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>y5ghdn5j9k.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>n6fk4nfna4.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v9wttpbfk9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>n38lu8286q.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>47vhws6wlr.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>eh6m2bh4zr.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>a2p9lx4jpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>22mmun2rn5.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>klf5c3l5u5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ppxm28t8ap.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ecpz2srf59.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>uw77j35x4d.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>pwa73g5rt2.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>mlmmfzh3r3.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>3rd42ekr43.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qcr597p9d.skadnetwork</string>
  </dict>
</array>

Pour des performances d'initialisation optimales, il est important d'associer vos groupes de rendement aux applications spécifiques dans lesquelles ils sont utilisés. Les configurations de groupe de rendement ciblant iOS et non associées à une application spécifique seront envoyées à toutes les applications iOS de votre compte, ce qui risque de prolonger le temps d'initialisation.

Dans une application réelle, remplacez l'ID de l'application exemple par l'ID d'applicationAd Manager réel. Vous pouvez utiliser l'exemple d'ID si vous testez simplement le SDK dans une application Hello World.

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 d'achèvement une fois l'initialisation terminée (ou après un délai d'inactivité de 30 secondes). Cette opération ne doit être effectuée qu'une seule fois, idéalement au lancement de l'application. Vous devez appeler startWithCompletionHandler: le plus tôt possible.

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 obtenir le consentement des utilisateurs dans l'Espace économique européen (EEE), définissez des indicateurs spécifiques à une demande (comme tagForChildDirectedTreatment ou tag_for_under_age_of_consent) ou prenez les mesures nécessaires avant de charger des annonces, assurez-vous de le faire avant d'initialiser le SDK Mobile Ads.

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

Exemple d'AppDelegate (extrait)

Swift

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

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

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

    return true
  }
}

SwiftUI

import GoogleMobileAds

class AppDelegate: UIResponder, UIApplicationDelegate {

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

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

    return true
  }
}

@main
struct YourApp: App {
  // To handle app delegate callbacks in an app that uses the SwiftUI lifecycle,
  // you must create an application delegate and attach it to your `App` struct
  // using `UIApplicationDelegateAdaptor`.
  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

Objective-C

@import GoogleMobileAds;

@implementation AppDelegate

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

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

@end

Remarque :Si vous utilisez la médiation, attendez que le gestionnaire d'achèvement soit appelé avant de charger les annonces pour vous assurer que tous les adaptateurs de médiation sont initialisés.

Sélectionnez un format d'annonce

Le SDK Mobile Ads est maintenant importé et initialisé, et vous êtes prêt à implémenter une annonce. Ad Manager propose différents formats d'annonces. Vous pouvez donc choisir celui qui correspond le mieux à l'expérience utilisateur de votre application.

Pour les développeurs SwiftUI, suivez notre guide SwiftUI.

Bannière

Les blocs de bannières affichent des annonces rectangulaires qui occupent une partie de la mise en page d'une application. Elles peuvent s'actualiser automatiquement après un certain délai. Cela signifie que les utilisateurs voient une nouvelle annonce à intervalles réguliers, même s'ils restent sur le même écran dans votre application. Il s'agit également du format d'annonce le plus simple à implémenter.

Implémenter des bannières

Interstitiel

Les blocs d'annonces interstitielles affichent des annonces pleine page dans votre application. Placez-les lors des pauses ou des transitions naturelles dans l'interface de votre application, par exemple à la fin d'un niveau dans une application de jeu.

Implémenter des annonces interstitielles

Il s'agit de ma langue maternelle

Les annonces natives vous permettent de personnaliser la présentation de composants tels que les titres et les incitations à l'action dans vos applications. En appliquant vous-même un style à l'annonce, vous pouvez créer une présentation naturelle et discrète qui contribue à enrichir l'expérience utilisateur.

Google Ad Manager propose deux méthodes pour intégrer des annonces natives: les styles natifs et les annonces natives standards via l'affichage personnalisé.

Les styles natifs ont été conçus pour simplifier l'implémentation des annonces natives. Ils constituent un excellent choix si vous débutez avec ce format. L'affichage personnalisé a été conçu pour maximiser la liberté de création de vos présentations.

Intégrer des styles natifs Implémenter des annonces natives (affichage personnalisé)

Accordé

Les blocs d'annonces avec récompense permettent aux utilisateurs de jouer à des jeux, de répondre à des enquêtes ou de regarder des vidéos pour gagner des récompenses dans l'application, telles que des pièces, des vies supplémentaires ou des points. Vous pouvez définir différentes récompenses en fonction des blocs d'annonces, en indiquant les valeurs et les articles reçus par l'utilisateur.

Implémenter des annonces avec récompense

Interstitiel avec récompense

L'interstitiel avec récompense est un nouveau type de format d'annonce incitatif qui vous permet d'offrir des récompenses, telles que des pièces ou des vies supplémentaires, pour les annonces qui s'affichent automatiquement lors des transitions naturelles de l'application.

Contrairement aux annonces avec récompense, les utilisateurs ne sont pas obligés d'activer un interstitiel avec récompense.

Au lieu de l'invite d'activation dans les annonces avec récompense, les interstitiels avec récompense nécessitent un écran d'introduction qui annonce la récompense et permet aux utilisateurs de désactiver la fonctionnalité s'ils le souhaitent.

Implémenter des annonces interstitielles avec récompense

Annonce à l'ouverture

Les annonces à l'ouverture sont des annonces qui s'affichent lorsque les utilisateurs ouvrent votre application ou y reviennent. L'annonce se superpose sur l'écran de chargement.

Implémenter des annonces à l'ouverture d'une application