Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Configurer le SDK Google Mobile Ads

Sélectionnez une plate-forme : Android iOS Unity Flutter Android (Legacy)

Pour diffuser des annonces et générer des revenus, intégrez Google Mobile Ads SDK à votre application iOS. Pour préparer votre projet, importez et initialisez Google Mobile Ads SDK avant de demander des annonces.

Ce guide explique comment importer et initialiser Google Mobile Ads SDK, et comment sélectionner un format d'annonce.

Prérequis

Avant de continuer, assurez-vous de disposer des éléments suivants :

Utilisez Xcode 16.0 ou une version ultérieure.
Ciblez iOS 13.0 ou une version ultérieure.

Importer Google Mobile Ads SDK

Pour importer Google Mobile Ads SDK, consultez l'une des sections suivantes :

Swift Package Manager

Pour ajouter une dépendance de package à votre projet, procédez comme suit :

Ouvrez Xcode.
Accédez à File > Add Package Dependencies... (Fichier > Ajouter des dépendances de package).
Installez le package Swift Google Mobile Ads SDK.
Dans l'invite qui s'affiche, recherchez le dépôt GitHub du package Swift de Google Mobile Ads :
```
https://github.com/googleads/swift-package-manager-google-mobile-ads.git
```
Sélectionnez la version du package Swift Google Mobile Ads SDK que vous souhaitez utiliser. Pour les nouveaux projets, nous vous recommandons d'utiliser Up to Next Major Version (Jusqu'à la prochaine version majeure).

CocoaPods

Pour utiliser CocoaPods, procédez comme suit :

Ouvrez le fichier Podfile de votre projet et ajoutez cette ligne à la configuration de compilation target de votre application :
```
pod 'Google-Mobile-Ads-SDK'
```
Dans un terminal, exécutez la commande suivante :
```
pod install --repo-update
```

Téléchargement manuel

Pour télécharger manuellement Google Mobile Ads SDK, procédez comme suit :

Télécharger Google Mobile Ads SDK.
Extrayez le package googlemobileadssdkios.zip.
Dans votre projet Xcode, ajoutez les frameworks suivants :
- GoogleMobileAds.xcframework
- UserMessagingPlatform.xcframework
Dans les paramètres General (Général) de votre cible, accédez à Frameworks, Libraries, and Embedded Content (Frameworks, bibliothèques et contenu intégré).
Vérifiez que vous avez défini GoogleMobileAds.xcframework et UserMessagingPlatform.xcframework sur Embed & Sign (Intégrer et signer).
Dans les paramètres de compilation de votre projet, procédez comme suit :
- Ajoutez le chemin /usr/lib/swift à Runpath Search Paths (Chemins de recherche Runpath).
- Ajoutez l'indicateur de l'éditeur de liens -ObjC à Other Linker Flags (Autres indicateurs de l'éditeur de liens).

Mettre à jour votre fichier Info.plist

Dans le fichier Info.plist de votre application, ajoutez les clés suivantes :

Une clé GADApplicationIdentifier avec une valeur de chaîne correspondant à l'ID de votre application Ad Manager, que vous trouverez dans l'interface utilisateur Ad Manager et qui se présente sous la forme ca-app-pub-################~##########.
Une clé SKAdNetworkItems. Cette clé inclut SKAdNetworkIdentifier valeurs pour Google cstr6suwn9.skadnetwork et certains acheteurs tiers.

Exemple complet

<key>GADApplicationIdentifier</key>
<!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~1458002511 -->
<string>SAMPLE_APP_ID</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>wg4vff78zm.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>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>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>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>44jx6755aq.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>k674qkevps.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>kbmxgpxpgc.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>tl55sbb4fm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>c3frkrj4fj.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>97r2b46745.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qcr597p9d.skadnetwork</string>
  </dict>
</array>

Remplacez SAMPLE_APP_ID par l'ID de votre application Ad Manager. Lors des tests, utilisez l'ID d'application exemple indiqué dans l'exemple précédent.

Pour accélérer l'initialisation de votre application, associez vos groupes de rendement à des applications spécifiques. Si un groupe de rendement cible iOS, mais n'est pas associé à une application, Google l'envoie à toutes les applications iOS de votre compte. Cette approche peut ralentir les performances.

Initialiser Google Mobile Ads SDK

Avant de charger des annonces, initialisez Google Mobile Ads SDK en appelant la méthode start() à partir de la propriété GADMobileAds.sharedInstance. Cette méthode appelle un gestionnaire d'achèvement une fois que Google Mobile Ads SDK et les adaptateurs de médiation ont terminé le traitement, ou après 30 secondes.

L'exemple suivant initialise Google Mobile Ads SDK :

Swift

// Initialize the Google Mobile Ads SDK.
MobileAds.shared.start()ViewController.swift

SwiftUI

// Initialize the Google Mobile Ads SDK.
MobileAds.shared.start()GoogleMobileAdsConsentManager.swift

Objective-C

// Initialize the Google Mobile Ads SDK.
[GADMobileAds.sharedInstance startWithCompletionHandler:nil];ViewController.m

Lors de l'initialisation, Google Mobile Ads SDK peut précharger des annonces ou initialiser des SDK tiers lorsqu'il appelle la méthode startWithCompletionHandler:. Si vous devez obtenir le consentement des utilisateurs de l'Espace économique européen (EEE), du Royaume-Uni ou de la Suisse, définissez des indicateurs spécifiques à la requête. Si vous devez définir des indicateurs spécifiques à la requête, assurez-vous de le faire avant d'initialiser Google Mobile Ads SDK. Pour en savoir plus, consultez la section Ciblage.

Sélectionner un format d'annonce

Une fois que vous avez importé Google Mobile Ads SDK, vous pouvez sélectionner un format d'annonce à implémenter.

Ad Manager propose les formats d'annonce suivants :

Format d'annonce	Description	Documentation
Bannière	Affiche des annonces rectangulaires dans une section de la mise en page de votre application. Cette annonce s'actualise automatiquement à intervalles définis. Les utilisateurs voient ces annonces périodiquement lorsqu'ils restent sur le même écran.	Configurer des bannières
Interstitiel	Affiche des annonces pleine page dans votre application. Placez cette annonce 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.	Annonces interstitielles
Natif	Vous permet de personnaliser les éléments, tels que les titres et les incitations à l'action, dans vos applications. Lorsque vous personnalisez l'annonce, vous créez des annonces qui correspondent au design visuel de votre application.	Charger une annonce native
Avec récompense	Les utilisateurs gagnent des récompenses dans l'application, comme des pièces ou des points, en jouant à des jeux, en répondant à des enquêtes ou en regardant des vidéos. Vous pouvez définir des récompenses pour les blocs d'annonces, et indiquer leur valeur et leur nature.	Annonces avec récompense
Interstitiel avec récompense	Vous permet de proposer des récompenses, comme des pièces ou des vies supplémentaires, pour les annonces diffusées lors des transitions d'application.	Annonces interstitielles avec récompense
Annonce à l'ouverture	S'affiche lorsque les utilisateurs ouvrent votre application ou y reviennent. L'annonce se superpose à l'écran de chargement.	Annonces à l'ouverture d'une appli

Configurer le SDK Google Mobile Ads Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.