Configurer le plug-in Google Mobile Ads Unity

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

Le plug-in Google Mobile Ads Unity permet aux développeurs Unity de diffuser des annonces Google pour mobile dans des applications Android et iOS sans avoir à écrire de code Java ou Objective-C. Le plug-in fournit une interface C# pour demander les annonces utilisées par les scripts C# de votre projet Unity.

Ce guide s'adresse aux éditeurs qui souhaitent monétiser une application Unity.

Prérequis

• Utilisez Unity Editor 2019.4 ou version ultérieure.
  • Nous vous recommandons d'utiliser la version 2022.2 ou une version ultérieure.
• Pour le déploiement sur iOS
  • Xcode 16.0 ou version ultérieure
  • Cibler iOS 13.0 ou version ultérieure
  • CocoaPods
• Pour le déploiement sur Android
  • Niveau d'API Android minimal de 24 ou supérieur
  • Cibler le niveau d'API Android 35 ou supérieur

Le niveau d'API Android est défini dans Project Settings > Player > Android > Other Settings > Other Settings (Paramètres du projet > Lecteur > Android > Autres paramètres > Autres paramètres).

Importer le plug-in Mobile Ads pour Unity

OpenUPM-CLI

Si OpenUPM CLI est installé, vous pouvez installer le registre OpenUPM à l'aide de la commande suivante :

openupm add com.google.ads.mobile

Supprimer .unitypackage composant de plug-in

Si vous migrez d'une installation utilisant un fichier .unitypackage vers OpenUPM, vous devez désinstaller manuellement les éléments de l'ancien emplacement. Supprimez les répertoires suivants qui ont été importés depuis .unitypackage :

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM avec l'UI

1. Ouvrez les paramètres du gestionnaire de paquets en sélectionnant l'option de menu Unity Edit > Project Settings > Package Manager (Modifier > Paramètres du projet > Gestionnaire de paquets).

2. Ajoutez OpenUPM en tant que registre ciblé à la fenêtre du gestionnaire de paquets :

   Name: OpenUPM
   URL: https://package.openupm.com
   Scopes: com.google
   

3. Ouvrez le menu du gestionnaire de packages en sélectionnant l'option de menu Unity Window > Package Manager (Fenêtre > Gestionnaire de packages).

4. Dans le menu déroulant du champ d'application du gestionnaire, sélectionnez My Registries (Mes registres).

   

5. Sélectionnez le package Google Mobile Ads pour Unity dans la liste des packages, puis appuyez sur Installer.

Supprimer .unitypackage composant de plug-in

Si vous migrez d'une installation utilisant un fichier .unitypackage vers OpenUPM, vous devez désinstaller manuellement les éléments de l'ancien emplacement. Supprimez les répertoires suivants qui ont été importés depuis .unitypackage :

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

1. Récupérez le tag de version de la version la plus récente. Le tag renvoyé, à l'exclusion du préfixe v, est la version Google Mobile Ads Unity Plugin.

   • macOS et Linux

     curl -sS https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest | jq -r '.tag_name'

   • Windows PowerShell

     (Invoke-RestMethod -Uri "https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest").tag_name
     

2. Modifiez le fichier Packages/manifest.json pour ajouter le registre ciblé et la dépendance OpenUPM en utilisant la version obtenue à l'aide de la commande précédente :

   {
     "scopedRegistries": [
       {
         "name": "google",
         "url": "https://package.openupm.com",
         "scopes": [
           "com.google"
         ]
       }
     ],
     "dependencies": {
       "com.google.ads.mobile": "11.6.0"
     }
   }
   

Supprimer .unitypackage composant de plug-in

Si vous migrez d'une installation utilisant un fichier .unitypackage vers OpenUPM, vous devez désinstaller manuellement les éléments de l'ancien emplacement. Supprimez les répertoires suivants qui ont été importés depuis .unitypackage :

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

Importer depuis GitHub

1. Téléchargez la version .unitypackage depuis GitHub.
2. Importez le fichier .unitypackage en sélectionnant l'option de menu Unity Assets > Import package > Custom Package (Éléments > Importer un package > Package personnalisé) et en important tous les éléments.

Facultatif : Désactiver External Dependency Manager

Si vous gérez les bibliothèques Android et iOS avec vos propres outils de compilation, vous pouvez désactiver le package com.unity.external-dependency-manager :

Dans l'éditeur Unity, sélectionnez Window > Package Manager (Fenêtre > Gestionnaire de packages), puis supprimez le package External Dependency Manager (com.unity.external-dependency-manager). La suppression de ce package désactive l'option Enable External Dependency Manager (Activer le gestionnaire de dépendances externes) dans Assets > Google Mobile Ads > Settings (Éléments > Google Mobile Ads > Paramètres).

Remarque : La suppression du fichier GoogleMobileAdsSettings.asset réinitialise vos paramètres et réinstalle le package com.unity.external-dependency-manager lors de la prochaine importation ou du prochain chargement de l'éditeur. Pour réinstaller le package ultérieurement, sélectionnez Assets > Google Mobile Ads > Settings (Éléments > Google Mobile Ads > Paramètres), puis Enable External Dependency Manager (Activer le gestionnaire de dépendances externes).

Installer l'ancien gestionnaire de dépendances externes

Si votre projet utilise Unity 2022.2 ou une version antérieure, vous pouvez installer l'ancien package com.google.external-dependency-manager de Google après avoir désactivé le package d'Unity :

• Téléchargez le dernier fichier .unitypackage depuis la page des versions du gestionnaire de dépendances externes pour Unity, puis sélectionnez Assets > Import Package > Custom Package (Éléments > Importer un package > Package personnalisé).

• Exécutez la commande OpenUPM CLI suivante :

  openupm add com.google.external-dependency-manager

Configurer manuellement les dépendances natives

Si vous n'utilisez pas de package External Dependency Manager, ajoutez les bibliothèques requises des fichiers Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml et Assets/GoogleMobileAds/Editor/GoogleUmpDependencies.xml à vos fichiers de compilation :

• Pour Android, sélectionnez Edit > Project Settings > Player > Android > Publishing Settings > Build (Modifier > Paramètres du projet > Lecteur > Android > Paramètres de publication > Compilation), puis activez Custom Main Gradle Template (Modèle Gradle principal personnalisé). Ajoutez les bibliothèques requises des fichiers GoogleMobileAdsDependencies.xml et GoogleUmpDependencies.xml au bloc dependencies du fichier Assets/Plugins/Android/mainTemplate.gradle :

  implementation 'com.google.android.gms:play-services-ads:25.5.0'
  implementation 'com.google.android.ump:user-messaging-platform:4.0.0'
  

  Ajoutez également les packages androidx.constraintlayout:constraintlayout, androidx.lifecycle:lifecycle-process et androidx.fragment:fragment en utilisant les versions du fichier GoogleMobileAdsDependencies.xml.

• Pour iOS, exportez votre projet Xcode. Ajoutez les pods requis des fichiers GoogleMobileAdsDependencies.xml et GoogleUmpDependencies.xml au fichier Podfile dans le dossier de votre projet exporté :

  pod 'Google-Mobile-Ads-SDK'
  pod 'GoogleUserMessagingPlatform'
  

  Exécutez ensuite la commande suivante dans le dossier de votre projet iOS exporté :

  pod install --repo-update

Définir votre ID d'application Ad Manager

Dans l'éditeur Unity, sélectionnez Assets > Google Mobile Ads > Settings (Ressources > Google Mobile Ads > Paramètres) dans le menu.

Saisissez votre ID d'application Ad Manager Android et iOS dans chaque champ.

Google Mobile Ads Unity Plugin enregistre ces paramètres sous forme de texte dans le fichier de configuration Assets/GoogleMobileAds/Resources/GoogleMobileAdsSettings.asset.

Initialiser le SDK

Avant de charger des annonces, votre application doit initialiser Google Mobile Ads Unity Plugin en appelant MobileAds.Initialize(). Cette opération ne doit être effectuée qu'une seule fois, idéalement au lancement de l'application.

Avertissement : Les annonces peuvent être préchargées par les SDK Google Mobile Ads Unity Plugin ou des partenaires de médiation lors de l'appel de MobileAds.Initialize(). 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 demande, tels que tagForChildDirectedTreatment ou tag_for_under_age_of_consent, ou prenez d'autres mesures avant de charger les annonces. Veillez à le faire avant d'initialiser Google Mobile Ads Unity Plugin.

Voici un exemple d'appel de MobileAds.Initialize() :

MobileAds.Initialize((InitializationStatus initstatus) =>
{
    if (initstatus == null)
    {
        Debug.LogError("Google Mobile Ads initialization failed.");
        return;
    }

    Debug.Log("Google Mobile Ads initialization complete.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects on the main thread here.
    });
});
GoogleMobileAdsController.cs

Interagir avec les objets Unity sur le thread principal

Google Mobile Ads Unity Plugin déclenche des événements d'annonce sur un thread d'arrière-plan. Si les rappels d'annonce interagissent avec des objets Unity, comme UnityEngine, planifiez explicitement ce travail sur le thread principal Unity à l'aide de la méthode MobileAdsEventExecutor.ExecuteInUpdate. Pour en savoir plus sur l'implémentation, consultez Déclencher des événements d'annonce sur le thread principal Unity.

Sélectionnez un format d'annonce

Google Mobile Ads Unity Plugin est désormais inclus dans votre application Unity lors du déploiement sur la plate-forme Android ou iOS. Vous êtes maintenant prêt à implémenter une annonce. AdMob propose différents formats d'annonces. Vous pouvez donc choisir celui qui offre la meilleure expérience utilisateur.

Bannière

Les blocs d'annonces de type bannière affichent des annonces rectangulaires qui occupent une partie de la mise en page d'une application. Ils peuvent être automatiquement actualisés selon un délai défini. 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 sont des annonces dans lesquelles vous pouvez personnaliser la façon dont les composants tels que les titres et les incitations à l'action sont présentés dans vos applications. En stylisant vous-même l'annonce, vous pouvez créer une présentation naturelle et discrète qui peut enrichir l'expérience utilisateur.

Implémenter des annonces natives

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 obtenir des récompenses dans l'application, par exemple des pièces, des vies supplémentaires ou des points. Vous pouvez définir différentes récompenses pour les blocs d'annonces, et indiquer leur valeur et leur nature.

Implémenter des annonces avec récompense