Premiers pas

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

• Utiliser l'éditeur Unity 2019.4 ou version ultérieure
• Déployer sur iOS
  • Xcode 16.0 ou version ultérieure
  • Cibler iOS 12.0 ou version ultérieure
  • CocoaPods
• Déployer sur Android
  • Niveau d'API Android minimal de 23 ou supérieur
  • Cibler le niveau d'API Android 34 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 pour Unity

openupm add com.google.ads.mobile

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.

Pour vous assurer que votre projet inclut toutes les dépendances, procédez comme suit :

Les dépendances du plug-in Google Mobile Ads Unity sont listées dans Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml.

Définir votre ID d'application AdMob

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 AdMob Android et iOS dans chaque champ.

Initialiser le SDK

Avant de charger des 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 MobileAds.Initialize() :

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

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

    // Google Mobile Ads events are raised off the Unity Main thread. If you need to
    // access UnityEngine objects after initialization,
    // use MobileAdsEventExecutor.ExecuteInUpdate(). For more information, see:
    // https://developers.google.com/admob/unity/global-settings#raise_ad_events_on_the_unity_main_thread
});
GoogleMobileAdsController.cs

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 lorsque vous la déployez 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 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 personnalisant vous-même l'apparence de l'annonce, vous pouvez créer des présentations publicitaires naturelles et discrètes qui peuvent enrichir l'expérience utilisateur.

Implémenter des annonces natives

Avec récompense

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

Les annonces à l'ouverture d'une application sont un format d'annonce qui s'affiche lorsque les utilisateurs ouvrent votre application ou y reviennent. L'annonce se superpose à l'écran de chargement.

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