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 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 s'adresse aux éditeurs qui souhaitent monétiser une application Unity.

Prérequis

  • 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 minimal 21 ou supérieur
    • Cibler le niveau d'API Android 34 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 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 les composants du plug-in .unitypackage

Si vous passez d'un .unitypackage à OpenUPM, vous devez désinstaller manuellement les composants de l'ancienne destination. Supprimez les répertoires suivants qui ont été importés depuis .unitypackage:

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

OpenUPM

  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 à portée à la fenêtre du 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. Dans le menu déroulant de l'étendue du gestionnaire, sélectionnez Mes registres.

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

Supprimer les composants du plug-in .unitypackage

Si vous passez d'un .unitypackage à OpenUPM, vous devez désinstaller manuellement les composants de l'ancienne destination. Supprimez les répertoires suivants qui ont été importés depuis .unitypackage:

  • Composants/ExternalDependencyManager
  • Composants/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 dernière version de .unitypackage sur 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.

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 n'importe quel plug-in Unity qui nécessite l'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:

Android

Accédez à Project Settings > Player > Android > Publishing Settings > Build (Paramètres de projet > Lecteur > Android > Paramètres de publication > Compilation) et sélectionnez:

  • Modèle Gradle principal personnalisé
  • Modèle de propriétés Gradle personnalisées

Dans l'éditeur Unity, sélectionnez Assets > External Dependency Manager > Android Resolver > Resolve (Composants > Gestionnaire de dépendances externes > Résolveur Android > Résoudre) pour que la bibliothèque du Gestionnaire de dépendances externes Unity 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 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 listées dans Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml.

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.

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 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 à implémenter une annonce. AdMob propose différents formats d'annonces. Vous pouvez donc choisir celui qui offre la meilleure 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. 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 créant vous-même le style de l'annonce, vous pouvez créer des présentations d'annonces naturelles et non intrusives 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, comme 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