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'annonces sur le thread principal Unity

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

Synchronisez les événements d'annonces avec le thread principal Unity manuellement ou automatiquement en laissant le SDK Google Mobile Ads gérer la synchronisation.

Synchroniser manuellement les événements d'annonce

Pour synchroniser les événements d'annonces, utilisez manuellement la méthode ExecuteInUpdate sur le thread principal. Vous devez utiliser la méthode lorsque la propriété RaiseAdEventsOnUnityMainThread est désactivée et interagit avec les objets UnityEngine.

L'exemple suivant enregistre un thread d'arrière-plan et exécute une action pour interagir avec les objets UnityEngine :

rewardedAd.OnAdPaid += (AdValue value) =>
{
    // Log the ad value immediately.
    UnityEngine.Debug.Log($"Received ad value of {value.Value} {value.CurrencyCode}.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects here.
    });
};

Automatiser la synchronisation des événements publicitaires

Pour que le SDK Google Mobile Ads synchronise les événements d'annonces, définissez la propriété MobileAds.RaiseAdEventsOnUnityMainThread sur true :

...
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;
    }
}

Contrôle du volume des annonces vidéo

Si votre application dispose de ses propres commandes de contrôle du volume (telles que des volumes de musique ou d'effet audio personnalisés), la communication du volume de l'application au SDK Google Mobile Ads permet aux annonces vidéo de respecter les paramètres de volume de l'application. Elles permettent de s'assurer que les utilisateurs verront les annonces vidéo avec le volume audio prévu.

Le volume de l'appareil, contrôlé via les boutons de volume ou le curseur de volume au niveau de l'OS, 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() avant de charger l'annonce. Les valeurs valides pour le volume des annonces sont comprises entre 0.0 (silencieux) et 1.0 (volume actuel de l'appareil). Voici un exemple de la façon de signaler le volume relatif de l'application au SDK :

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

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

// 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é.

Consentement pour les cookies

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

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

Minification Android

Cette option de publication Unity vous permet d'activer la minification du code Java. Si vous activez la minification, vous devrez é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 > Créer), puis sélectionnez :

   • Fichier ProGuard personnalisé

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

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

Désactiver les rapports d'erreur

Le SDK Google Mobile Ads collecte les rapports d'erreur à des fins de débogage et d'analyse. Vous pouvez désactiver ce rapport d'erreur avec le code suivant. Les sections suivantes expliquent comment désactiver les rapports d'erreur sur Android et iOS.

<manifest>
   <application>
       <meta-data
           android:name="com.google.android.gms.ads.flag.DISABLE_CRASH_REPORTING"
           android:value="true" />
   </application>
</manifest>

void Awake() {
  MobileAds.DisableSDKCrashReporting();
}

Obtenir la version du plug-in Unity

Pour obtenir la version du SDK Unity, exécutez la commande suivante :

// Get the unity SDK version.
Debug.Log("Unity SDK Version: " + MobileAds.GetVersion());

Obtenir la version de la plate-forme

Le SDK Google Mobile Ads pour Unity dépend des SDK de plate-forme Android et iOS. Pour obtenir la version du SDK de la plate-forme, exécutez la commande suivante :

// Get the underlying platform SDK version.
Debug.Log("Platform SDK Version: " + MobileAds.GetPlatformVersion());