Commencer

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

Prérequis

• 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 (recommandé)

Le moyen le plus simple d'importer le SDK dans un projet iOS consiste à utiliser CocoaPods : Ouverts 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 leurs documentation officielle pour en savoir plus sur la création et l'utilisation de Podfiles.

Gestionnaire de paquets Swift

Important :Les bibliothèques d'adaptateurs de médiation ne sont pas encore disponibles sur le package Swift. Gestionnaire. Si vous utilisez la médiation, recommandez l'intégration à CocoaPods.

Le SDK Google Mobile Ads est compatible avec le package Swift Manager à partir de la version 9.0.0. Suivre ces étapes pour importer le package Swift:

Remarque :Si vous migrez depuis un projet basé sur CocoaPods, exécutez pod deintegrate pour supprimez 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 à Fichier > Ajouter des packages...

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

   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 en les téléchargeant en arrière-plan. Pour savoir comment ajouter un package les dépendances, consultez l'article d'Apple.

Téléchargement manuel

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

   • GoogleMobileAds.xcframework
   • UserMessagingPlatform.xcframework

2. Dans les paramètres de compilation de votre projet:

   • Ajoutez le chemin d'accès /usr/lib/swift aux Chemins de recherche du chemin d'exécution.
   • Ajoutez l'indicateur de lien -ObjC à Other Linker Flags (Autres indicateurs Linker).

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 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>2fnua5tdw4.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ydx93a7ass.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>hs6bdukanm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>mlmmfzh3r3.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>su67r6k2v3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>yclnxrl5pm.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>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>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>ppxm28t8ap.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>578prtvx9j.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4dzt52r2t5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>Tl55sbb4fm.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>3rd42ekr43.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qcr597p9d.skadnetwork</string>
  </dict>
</array>

Pour optimiser les performances d'initialisation, il est important d'associer le rendement des groupes avec les applications spécifiques dans lesquelles ils sont utilisés. Configurations du groupe de rendement ciblant iOS et n'étant associées à aucune application spécifique, elles sont envoyées à toutes les applications applications de votre compte, ce qui allonge potentiellement le temps nécessaire à l'initialisation.

Dans une application réelle, remplacez l'exemple d'ID d'application par votre 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: au niveau de GADMobileAds.sharedInstance, qui initialise le SDK et rappelle un gestionnaire d'achèvement l'initialisation est terminée (ou après un délai d'inactivité de 30 secondes). Il suffit que une seule fois, idéalement au lancement de l'application. Vous devriez appeler startWithCompletionHandler: dès que 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 avez besoin d'obtenir le consentement de utilisateurs de l'Espace économique européen (EEE), définissez des indicateurs spécifiques à une demande (comme comme tagForChildDirectedTreatment ou tag_for_under_age_of_consent), ou sinon prenez les mesures nécessaires avant de charger les annonces, veillez à le faire avant de le SDK Mobile Ads.

Voici un exemple d'appel de la méthode startWithCompletionHandler: dans votre 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é. Vous pouvez maintenant pour diffuser une annonce. Ad Manager Elle propose un certain nombre les différents formats d'annonces, ce qui vous permet de choisir celui qui convient le mieux à l'utilisateur expérience.

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

Bannière

Les blocs de bannières affichent des annonces rectangulaires qui occupent une partie de l'espace mise en page. Elles peuvent s'actualiser automatiquement après un certain délai. Cela signifie que les utilisateurs verront 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 facile à implémenter.

Implémenter des bannières

Interstitiel

Les blocs d'annonces interstitielles diffusent des annonces pleine page dans votre application. Placez-les lors des pauses ou des points de transition naturels dans l'interface de votre application, comme à la fin d'un niveau s'il s'agit d'une application de jeu.

Implémenter des annonces interstitielles

Natif

Les annonces natives vous permettent de personnaliser la façon dont vos composants (titres, titres, etc.) des incitations à l'action sont présentées dans vos applications. En appliquant vous-même un style à l'annonce, vous pouvez : Créez des présentations publicitaires naturelles et discrètes qui plairont à un utilisateur riche expérience.

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, et c'est un excellent choix si vous débutez dans ce format. L'affichage personnalisé a été conçu pour maximiser votre liberté de création de présentations.

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

Avec récompense

Les annonces avec récompense permettent aux utilisateurs de jouer à des jeux, de répondre à des enquêtes ou de regarder des vidéos pour obtenir des récompenses dans l'application, comme des pièces, des vies supplémentaires ou des points. Vous pouvez définir différentes récompenses selon les blocs d'annonces, et spécifier leurs valeurs et 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 incitatif qui vous permet de proposer des récompenses (comme des pièces de monnaie ou des vies supplémentaires) pour les annonces diffusées automatiquement aux points de transition naturels dans votre application.

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

Au lieu de recevoir une invite d'activation, comme c'est le cas pour 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 les désactiver s'ils le souhaitent.

Implémenter des annonces interstitielles avec récompense

Annonce à l'ouverture

L'annonce à l'ouverture d'une application est un format d'annonce qui s'affiche lorsque les utilisateurs ouvrent votre application ou y retournent. L'annonce se superpose à l'écran de chargement.

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