Premiers pas

Ce guide est destiné aux éditeurs qui souhaitent monétiser une application Unity.

L'intégration du plug-in Google Mobile Ads Unity à une application est la première étape pour diffuser des annonces AdMob et générer des revenus. Une fois l'intégration terminée, vous pouvez choisir un format d'annonce (annonce native ou avec récompense, par exemple) pour obtenir la procédure d'implémentation détaillée.

Prérequis

  • Utiliser Unity 2019.4 ou une 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

Télécharger le plug-in Mobile Ads Unity

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.

Utilisez les liens suivants pour télécharger le package Unity pour le plug-in ou pour consulter son code sur GitHub.

TÉLÉCHARGER LE PLUG-IN VOIR LA SOURCE

Importer le plug-in Mobile Ads Unity

Google Mobile Ads pour Unity est distribué via un package d'éléments Unity. Pour importer le package, ouvrez votre projet dans l'éditeur Unity, sélectionnez Assets > Import Package > Custom Package (Ressources > Importer un package > Package personnalisé), puis recherchez le fichier GoogleMobileAdsPlugin.unitypackage que vous avez téléchargé. Assurez-vous que tous les fichiers sont sélectionnés, puis cliquez sur Import (Importer).

Inclure les dépendances externes

Le plug-in Google Mobile Ads Unity est distribué avec la bibliothèque Unity Play Services Resolver. Cette bibliothèque est destinée à être utilisée par tout plug-in Unity nécessitant un accès à des bibliothèques spécifiques à Android, telles que les AAR ou les 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 > Compilation) et sélectionnez:

  • 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ésolution Android > Résoudre) 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

Aucune étape supplémentaire n'est requise pour inclure le SDK Google Mobile Ads dans le projet Unity.

  • Lorsque vous utilisez Unity 5.6 ou une version ultérieure, un objet xcworkspace est généré et inclut les bibliothèques de dépendances requises. Utilisez l'espace de travail xcworkspace généré au lieu du projet Xcode standard.
  • Lorsque vous utilisez des versions antérieures d'Unity, les dépendances sont incluses dans le projet Xcode standard.

Définissez l' AdMob ID 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 ID d'application AdMob pour Android et iOS 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. Choisissez celui qui convient le mieux à l'expérience utilisateur.

Les blocs d'annonces de type bannière affichent des annonces rectangulaires qui occupent une partie de la mise en page d'une application. Elles peuvent être actualisées automatiquement après une période donnée. 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.

Implémenter des bannières

Interstitiel

Les blocs d'annonces interstitielles affichent des annonces en pleine page dans votre application. Placez-les lors des pauses ou des points de transition naturels dans l'interface de votre application, par exemple à la fin d'un niveau dans une application de jeu.

Intégrer des annonces interstitielles

Natif

Les annonces natives sont des annonces qui vous permettent de personnaliser la façon dont les composants tels que les titres et les incitations à l'action sont présentés dans vos applications. En appliquant vous-même un style à l'annonce, vous pouvez créer des présentations naturelles et discrètes qui enrichiront l'expérience utilisateur.

Intégrer 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, et indiquer les valeurs et les éléments de récompense que l'utilisateur a reçus.

Intégrer des annonces avec récompense

Interstitiel avec récompense

L'interstitiel avec récompense est un nouveau type de format d'annonce incitative 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 dans l'application.

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

Au lieu d'une 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 la désactiver s'ils le souhaitent.

Implémenter des annonces interstitielles avec récompense

Annonce à l'ouverture

Il s'agit d'un format d'annonce qui apparaît 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