Le plug-in Google Mobile Ads Unity permet aux développeurs Unity de diffuser des annonces pour mobile Google 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 est destiné aux éditeurs qui souhaitent monétiser une application Unity.
Conditions préalables
- Utiliser Unity 2019.4 ou version ultérieure
- Pour déployer sur iOS :
- Xcode 15.3 ou version ultérieure
- Cibler iOS 12.0 ou version ultérieure
- CocoaPods
- Pour déployer sur Android :
- Niveau d'API Android 21 ou supérieur
- Cibler le niveau d'API Android 31 ou supérieur
- Recommandation: 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 la CLI OpenUPM est installée, 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 de l'utilisation d'un .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 de .unitypackage
:
- Assets/ExternalDependencyManager (Gestionnaire de dépendances externes)
- Assets/GoogleMobileAds
- Assets/Plugins/Android/googlemobileads-unity.aar
- Assets/Plugins/Android/GoogleMobileAdsPlugin
- Assets/Plugins/iOS/GADUAdNetworkExtras
- Assets/Plugins/iOS/unity-plugin-library.a
OpenUPM
- Ouvrez les paramètres du gestionnaire de packages en sélectionnant l'option de menu Unity Edit > Project Settings > Package Manager (Modifier > Paramètres du projet > Gestionnaire de packages).
Ajoutez OpenUPM en tant que registre restreint dans la fenêtre du gestionnaire de packages:
Name: OpenUPM URL: https://package.openupm.com Scopes: com.google
Ouvrez le menu du gestionnaire de packages en sélectionnant l'option de menu Unity Window > Package Manager (Fenêtre > Gestionnaire de packages).
Dans le menu déroulant "Champ d'application du gestionnaire", sélectionnez Mes registres.
Sélectionnez le package Google Mobile Ads for Unity dans la liste des packages et appuyez sur Install (Installer).
Supprimer .unitypackage
composant de plug-in
Si vous migrez de l'utilisation d'un .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 de .unitypackage
:
- Assets/ExternalDependencyManager (Gestionnaire de dépendances externes)
- 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
- Téléchargez la dernière version de
.unitypackage
sur GitHub. - Importez le fichier
.unitypackage
en sélectionnant l'option de menu Unity Assets > Import package > Custom Package (Ressources > Importer un package > Package personnalisé) et en important tous les éléments.
Inclure les dépendances externes
Le plug-in Google Mobile Ads Unity est distribué avec la bibliothèque de résolution des services Unity Play. Cette bibliothèque est destinée à être utilisée par tout plug-in Unity qui nécessite un accès à des bibliothèques spécifiques à Android, telles que des AAR ou des CocoaPods iOS. Il permet aux plug-ins Unity de déclarer des dépendances, qui sont ensuite automatiquement résolues et copiées dans votre projet Unity.
Suivez ces étapes pour vous assurer que votre projet inclut toutes les dépendances:
Android
Accédez à Project Settings > Player > Android > Publishing Settings > Build (Paramètres du projet > Lecteur > Android > Paramètres de publication > Compiler), puis sélectionnez les éléments suivants:
- Modèle Gradle principal personnalisé
- Modèle de propriétés Gradle personnalisé
Dans l'éditeur Unity, sélectionnez Assets > External Dependency Manager > Android Resolver > Resolve (Assets > Gestionnaire de dépendances externes > Résolveur Android > Résolution) pour que la bibliothèque Unity External Dependency Manager copie les dépendances déclarées dans le répertoire Assets/Plugins/Android
de votre application Unity.
iOS
Unity pour iOS utilise CocoaPods pour identifier et gérer les dépendances. Consultez la documentation de CocoaPods pour connaître les exigences spécifiques ou les étapes de dépannage liées à vos dépendances iOS.
Les dépendances du plug-in Google Mobile Ads Unity sont répertoriées dans Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml
.
Définir l' AdMob identifiant de votre application
Dans l'éditeur Unity, sélectionnez Assets > Google Mobile Ads > Settings (Assets > Google Mobile Ads > Paramètres) dans le menu.
Saisissez votre Android et iOS ID d'application AdMob dans chaque champ.
Initialiser le SDK
Avant de charger les annonces, demandez à votre application d'initialiser le SDK Google Mobile Ads en appelant MobileAds.Initialize()
. Cette opération ne doit être effectuée qu'une seule fois, idéalement au lancement de l'application.
Voici un exemple d'appel de Initialize()
dans la méthode Start()
d'un script associé à un GameObject
:
...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
public void Start()
{
// Initialize the Google Mobile Ads SDK.
MobileAds.Initialize(initStatus => { });
}
}
Si vous utilisez la médiation, attendez que le rappel se produise 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 Google Mobile Ads est désormais inclus dans votre application Unity lors du déploiement sur la plate-forme Android ou iOS. Vous êtes maintenant prêt à mettre en œuvre 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 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.
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.
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 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