Commencer

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

L'intégration du plug-in Google Mobile Ads Unity dans une application constitue 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 (vidéo native ou avec récompense, par exemple) pour obtenir des instructions détaillées sur l'implémentation.

Prérequis

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

Le plug-in Unity de Google Mobile Ads permet aux développeurs Unity de diffuser facilement 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.

Utilisez les liens ci-dessous pour télécharger le package Unity du plug-in ou pour examiner son code sur GitHub.

TÉLÉCHARGER LE PLUGIN VOIR LA SOURCE

Importer le plug-in Mobile Ads Unity

Ouvrez votre projet dans l'éditeur Unity. Sélectionnez Assets > Importer le package > Package personnalisé et recherchez le fichier GoogleMobileAdsPlugin.unitypackage que vous avez téléchargé.

Assurez-vous que tous les fichiers sont sélectionnés et cliquez sur Importer.

Inclure le SDK Mobile Ads

Le plug-in Google Mobile Ads Unity est distribué avec la bibliothèque de résolution des services de jeux Unity. 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 (par exemple, AAR) ou CocoaPods sur iOS. Il permet aux plug-ins Unity de déclarer des dépendances, qui sont ensuite résolues et copiées automatiquement dans votre projet Unity.

Suivez la procédure ci-dessous pour vous assurer que votre projet inclut le SDK Mobile Ads.

Android

Dans l'éditeur Unity, sélectionnez Assets > External Dependency Manager > Android Resolver > Resolve (Gérer les dépendances > Android Resolver > Resolve). 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 Mobile Ads dans le projet Unity.

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

Définir votre ID d'application AdMob

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

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

Générer des événements d'annonce sur le thread principal Unity

Le SDK Google Mobile Ads génère parfois des événements sur un thread différent du thread principal Unity. Cela peut entraîner des problèmes lors de l'interaction avec des objets Unity à partir d'événements envoyés depuis le SDK Google Mobile Ads. Pour contourner ce problème, vous devrez peut-être ajouter du code afin de synchroniser les événements du SDK Mobile Ads avec le thread principal Unity.

Si vous souhaitez que le SDK Mobile Ads traite ce problème de thread, définissez MobileAds.RaiseAdEventsOnUnityMainThread sur true. Cela forcera le SDK Mobile Ads à afficher tous les événements et rappels sur le thread principal Unity.

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // When true all events raised by GoogleMobileAds will be raised
        // on the Unity main thread. The default value is false.
        MobileAds.RaiseAdEventsOnUnityMainThread = true;
    }
}

Initialiser le SDK Mobile Ads

Avant de charger des annonces, demandez à votre application d'initialiser le SDK 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 ait lieu avant de charger les annonces. De cette façon, tous les adaptateurs de médiation seront initialisés.

Sélectionnez un format d'annonce

Le SDK 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 à intégrer une annonce. AdMob propose différents formats d'annonces. Vous pouvez ainsi choisir celui qui correspond le mieux à vos besoins en termes d'expérience utilisateur.

Les bannières sont des annonces illustrées ou textuelles rectangulaires qui occupent un emplacement dans la mise en page d'une application. Ils restent à l'écran lorsque les utilisateurs interagissent avec l'application et peuvent s'actualiser automatiquement après un certain temps. Si vous faites vos premiers pas dans la publicité mobile, c'est un bon point de départ.

Intégrer une bannière

Interstitiel

Les interstitiels sont des annonces plein écran qui couvrent l'interface d'une application jusqu'à ce qu'elles soient fermées par l'utilisateur. Ils sont particulièrement adaptés à des pauses naturelles dans le flux d'exécution d'une application, par exemple entre deux niveaux d'un jeu ou juste après la fin d'une tâche.

Intégrer un interstitiel

Natif

Le format d'annonce native est basé sur des composants. Il vous permet de personnaliser la façon dont les éléments tels que les titres et les incitations à l'action sont présentés dans leurs applications. En choisissant des polices, des couleurs et d'autres détails, vous pouvez créer des présentations d'annonces naturelles et discrètes, qui peuvent enrichir l'expérience utilisateur.

Intégrer des annonces natives

Accordé

Les annonces vidéo avec récompense sont des annonces vidéo plein écran que les utilisateurs peuvent regarder en échange de récompenses dans l'application.

Implémenter des annonces avec récompense

Demander l'autorisation de transparence des informations de suivi des applications

Pour afficher la demande d'autorisation ATT (App Tracking Transparency) pour l'accès à l'IDFA, utilisez le package d'assistance publicitaire iOS 14 d'Unity.

Clé d'application identique

Conditions préalables: plug-in Google Mobile Ads Unity 6.1.0 ou version ultérieure

Le SDK Google Mobile Ads introduit la clé d'application identique pour vous aider à diffuser des annonces plus pertinentes et personnalisées en utilisant les données collectées dans l'application utilisée par l'utilisateur.

La clé d'application identique est activée par défaut, mais vous pouvez la désactiver avec l'API suivante:

public void Start()
    {
        RequestConfiguration requestConfiguration =
            new RequestConfiguration.Builder()
            .SetSameAppKeyEnabled(true).build();
        MobileAds.SetRequestConfiguration(requestConfiguration);

        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(HandleInitCompleteAction);
    }