Configurer le plug-in Google Mobile Ads Unity

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

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 ni 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 est destiné 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 ultérieure.
• Pour le déploiement sur iOS
  • Xcode 16.0 ou version ultérieure
  • Ciblez iOS 13.0 ou version ultérieure
  • CocoaPods
• Pour le déploiement sur Android
  • Niveau d'API Android minimal de 23 ou supérieur
  • Ciblez le niveau d'API Android 35 ou supérieur

• Recommandé : Créez un compte AdMob et enregistrez une application Android ou iOS

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 for Unity

OpenUPM-CLI

Si vous avez installé l'interface de ligne de commande OpenUPM, vous pouvez installer le registre OpenUPM avec la commande suivante :

openupm add com.google.ads.mobile

Supprimer les éléments du plug-in .unitypackage

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 à partir du fichier .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 interface utilisateur

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 délimité à la fenêtre "Package Manager" (Gestionnaire de paquets) :

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

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

4. Définissez le menu déroulant de la portée du gestionnaire sur My Registries (Mes registres).

   

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

Supprimer les éléments du plug-in .unitypackage

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 à partir du fichier .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 dernière version. Le tag renvoyé, à l'exclusion du préfixe v, correspond à 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 et la dépendance délimités OpenUPM à l'aide de la version obtenue à partir de la commande précédente :

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

Supprimer les éléments du plug-in .unitypackage

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 à partir du fichier .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 .unitypackage version 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é), puis en important tous les éléments.

Définir votre ID d'application AdMob

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

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

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

Initialiser le SDK

Avant de charger les annonces, demandez à votre application d'initialiser Google Mobile Ads Unity Plugin en appelant MobileAds.Initialize(). Vous ne devez le faire qu'une seule fois, idéalement au lancement de l'application.

Avertissement : Les annonces peuvent être préchargées par Google Mobile Ads Unity Plugin ou les SDK des partenaires de médiation lors de l'appel de MobileAds.Initialize(). Si vous devez obtenir le consentement des utilisateurs dans l'Espace économique européen (EEE), au Royaume-Uni ou en Suisse, définissez des indicateurs spécifiques à la requête, tels que tagForChildDirectedTreatment ou tag_for_under_age_of_consent, ou prenez d'autres mesures avant de charger les annonces. Vérifiez que vous le faites 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 des objets Unity sur le thread principal

Google Mobile Ads Unity Plugin déclenche des événements publicitaires sur un thread en arrière-plan. Si les rappels d'annonces interagissent avec des objets Unity, tels que 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 publicitaires sur le thread principal Unity.

Sélectionner un format d'annonce

Google Mobile Ads Unity Plugin est désormais inclus dans votre application Unity lorsque vous la déployez sur la plate-forme Android ou iOS. Vous pouvez maintenant 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 vous permettent de personnaliser la façon dont les éléments tels que les titres et les incitations à l'action sont présentés dans vos applications. En personnalisant vous-même le style de l'annonce, vous pouvez créer des présentations naturelles et discrètes qui peuvent enrichir l'expérience utilisateur.

Implémenter des annonces natives

Accordé

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, 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

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 de choisir de regarder un interstitiel avec récompense.

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 est un format d'annonce qui apparaît lorsque l'utilisateur ouvre votre application ou y revient. L'annonce se superpose à l'écran de chargement.

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