Paramètres globaux

La classe MobileAds fournit des paramètres globaux pour le SDK Google Mobile Ads.

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

Le SDK Google Mobile Ads génère des événements sur un thread différent de celui du thread principal d'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 d'Unity.

Si vous souhaitez que le SDK Mobile Ads gère ce problème de thread pour vous, définissez MobileAds.RaiseAdEventsOnUnityMainThread sur true. Cela oblige le SDK à générer tous les événements et rappels sur le thread principal d'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 :L'envoi d'événements sur le thread principal d'Unity a pour effet secondaire que certains événements tels que OnAdFullScreenContentOpened ne sont pas envoyés tant que l'utilisateur ne revient pas dans l'application.

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, divulguer le volume de l'application au SDK Google Mobile Ads permet aux annonces vidéo de respecter les paramètres de volume de l'application. Cela permet de s'assurer que les utilisateurs voient 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 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 adapter l'expérience audio.

Vous pouvez signaler le volume d'applications relatif au SDK Google Mobile Ads en appelant la méthode SetApplicationVolume(). Les valeurs de volume de l'annonce valides sont comprises entre 0.0 (silencieux) et 1.0 (volume actuel de l'appareil). Voici un exemple d'enregistrement du volume relatif de l'application dans le SDK:

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

Avertissement :Réduire 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 à l'utilisateur des commandes de volume personnalisées 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 :Si vous désactivez le son de votre application, son éligibilité aux annonces vidéo sera réduite et ses revenus publicitaires pourraient également diminuer. N'utilisez cette méthode que si votre application fournit à l'utilisateur un contrôle de mise en sourdine personnalisé et que la décision de l'utilisateur est correctement reflétée dans l'application.

Consentement aux 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 d'édition Unity vous permet d'activer la minimisation du code Java. Si vous activez la minification, 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 *; }

Désactiver le signalement 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 à l'aide du code suivant. Les sections suivantes expliquent comment désactiver les rapports d'erreur sur Android et iOS.

Android

Ajoutez la balise <meta-data> avec DISABLE_CRASH_REPORTING défini sur true dans le fichier AndroidManifest.xml de votre application:

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

iOS

Appelez la méthode DisableSDKCrashReporting pour désactiver les rapports d'erreur sur iOS:

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