Paramètres globaux

La classe MobileAds fournit des paramètres généraux pour le SDK Google Mobile Ads.

Déclencher des événements d'annonce dans le thread principal Unity

Le SDK Google Mobile Ads déclenche les événements sur un thread différent de celui du thread principal Unity. Si vous implémentez des événements d'annonce et interagissez avec des objets Unity, vous devez synchroniser les événements du SDK Mobile Ads avec le thread principal Unity.

Si vous souhaitez que le SDK Mobile Ads gère ce problème de thread à votre place, définissez MobileAds.RaiseAdEventsOnUnityMainThread sur true. Cela oblige le SDK à déclencher 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;
    }
}

Remarque :Un effet secondaire de la génération d'événements sur le thread principal Unity signifie que certains événements tels que OnAdFullScreenContentOpened ne sont pas déclenchés tant que l'utilisateur n'est pas revenu dans l'application.

Contrôle du volume des annonces vidéo

Si votre application possède ses propres commandes de volume, telles que des volumes de musique ou d'effets sonores personnalisés, vous devez divulguer le volume de l'application au SDK Google Mobile Ads pour permettre aux annonces vidéo de respecter les paramètres de volume de l'application. Cela permet de s'assurer que les utilisateurs reçoivent des annonces vidéo au volume audio attendu.

Le volume de l'appareil, contrôlé via les boutons de volume ou le curseur de volume au niveau du système d'exploitation, détermine le volume de la sortie audio de l'appareil. Toutefois, les applications peuvent ajuster indépendamment les niveaux de volume par rapport au volume de l'appareil pour personnaliser l'expérience audio.

Vous pouvez signaler le volume relatif de l'application au SDK Google Mobile Ads en appelant la méthode SetApplicationVolume(). Les valeurs valides pour le volume d'annonces sont comprises entre 0.0 (silencieux) et 1.0 (volume actuel de l'appareil). Voici un exemple de procédure à suivre pour indiquer le volume relatif de l'application au SDK:

// Set app volume to be half of current device volume.
MobileAds.SetApplicationVolume(0.5f);

Avertissement :Diminuer le volume audio de votre application réduit l'éligibilité aux annonces vidéo et peut réduire les revenus publicitaires de votre application. N'utilisez cette méthode que si votre application fournit des commandes de volume personnalisées à l'utilisateur et que le volume de l'utilisateur est correctement reflété dans l'application.

Pour informer le SDK que le volume de l'application a été coupé, utilisez la méthode SetApplicationMuted():

// Set app to be muted.
MobileAds.SetApplicationMuted(true);

Par défaut, le volume de l'application est défini sur 1, le volume actuel de l'appareil et le son de l'application n'est pas coupé.

Avertissement :Couper le son de votre application réduit l'éligibilité aux annonces vidéo et peut réduire les revenus publicitaires de votre application. N'utilisez cette méthode que si votre application fournit une commande de désactivation personnalisée à l'utilisateur et que cette décision est correctement reflétée dans l'application.

Consentement pour les cookies

Si votre application présente des exigences particulières, vous pouvez définir la clé ApplicationPreferences facultative gad_has_consent_for_cookies sur zéro pour activer les annonces limitées (LTD):

// Enable limited ads (LTD)
ApplicationPreferences.SetInt("gad_has_consent_for_cookies", 0);

Minimisation Android

Cette option de publication Unity vous permet d'activer la minification du code Java. Si vous activez la minimisation, vous devez également créer un fichier ProGuard personnalisé pour conserver les classes référencées par le SDK.

1. Activer le fichier ProGuard personnalisé

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

   • Fichier ProGuard personnalisé

2. Ouvrez /Assets/Plugins/Android/proguard-user.txt et ajoutez le code suivant :

-keep class com.google.** { public *; }