MobileAds

public class MobileAds


La classe contient une logique qui s'applique au SDK Google Mobile Ads dans son ensemble. Pour le moment, les seules méthodes qu'il contient sont utilisées pour l'initialisation.

Résumé

Constantes

static final String
ERROR_DOMAIN = "com.google.android.gms.ads"

Nom de domaine d'erreur par défaut pour le SDK Google Mobile Ads.

Méthodes publiques

static void

Appelez-le avant initialize ou la première demande d'annonce pour désactiver l'initialisation de l'adaptateur de médiation.

static @Nullable InitializationStatus

Récupère l'état d'initialisation du SDK.

static @NonNull RequestConfiguration

Récupère le RequestConfiguration global.

static VersionInfo

Récupère la version externe (par exemple, 20.6.0) du SDK Google Mobile Ads.

static void
@RequiresPermission(value = Manifest.permission.INTERNET)
initialize(Context context)

Initialise le SDK Google Mobile Ads.

static void

Initialise le SDK Google Mobile Ads.

static void

Ouvre l'interface utilisateur de l'inspecteur d'annonces.

static void
openDebugMenu(Context context, String adUnitId)

Ouvre le menu de débogage.

static boolean

Détermine si l'ID first party de l'éditeur du SDK Google Mobile Ads (anciennement "clé d'application identique") est activé.

static @Nullable CustomTabsSession
registerCustomTabsSession(
    @NonNull Context context,
    @NonNull CustomTabsClient client,
    @NonNull String origin,
    @Nullable CustomTabsCallback callback
)

Enregistre un CustomTabsClient auprès du SDK Google Mobile Ads pour améliorer la monétisation des annonces dans l'application dans ce CustomTabsSession.

static void

Enregistre un WebView auprès du SDK Google Mobile Ads pour améliorer la monétisation des annonces dans l'application dans ce WebView.

static void
setAppMuted(boolean muted)

Indique si le son de l'application est coupé.

static void
setAppVolume(float volume)

Définit le volume audio de l'application.

static void
setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

Définit l'RequestConfiguration global qui sera utilisé pour chaque AdRequest pendant la session de l'application.

static void
startPreload(
    @NonNull Context context,
    @NonNull List<PreloadConfiguration> preloadConfigurations,
    @NonNull PreloadCallback preloadCallback
)

Démarre le préchargement des annonces pour les configurations données.

Constantes

ERROR_DOMAIN

public static final String ERROR_DOMAIN = "com.google.android.gms.ads"

Nom de domaine d'erreur par défaut pour le SDK Google Mobile Ads.

Méthodes publiques

disableMediationAdapterInitialization

public static void disableMediationAdapterInitialization(Context context)

Appelez-le avant initialize ou la première demande d'annonce pour désactiver l'initialisation de l'adaptateur de médiation. Cette méthode est une opération sans effet une fois que initialize ou la première demande d'annonce est envoyée.

Avertissement: Appeler cette méthode peut avoir un impact négatif sur les performances de votre médiation. Cette méthode ne doit être appelée que si vous incluez des adaptateurs de médiation dans votre application, mais que vous ne prévoyez pas d'utiliser la médiation Google pendant cette session d'application (par exemple, si vous effectuez un test A/B).

getInitializationStatus

public static @Nullable InitializationStatus getInitializationStatus()

Récupère l'état d'initialisation du SDK.

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

Récupère le RequestConfiguration global.

getVersion

public static VersionInfo getVersion()

Récupère la version externe (par exemple, 20.6.0) du SDK Google Mobile Ads.

initialize n'a pas besoin d'être appelé avant cette fonction.

initialize

@RequiresPermission(value = Manifest.permission.INTERNET)
public static void initialize(Context context)

Initialise le SDK Google Mobile Ads.

Appelez cette méthode le plus tôt possible après le lancement de l'application pour réduire la latence de la première demande d'annonce de la session.

Si cette méthode n'est pas appelée, la première demande d'annonce initialise automatiquement le SDK Google Mobile Ads.

Paramètres
Context context

Context dans lequel le SDK s'exécute.

initialize

public static void initialize(Context context, OnInitializationCompleteListener listener)

Initialise le SDK Google Mobile Ads.

Appelez cette méthode le plus tôt possible après le lancement de l'application pour réduire la latence de la première demande d'annonce de la session.

Si cette méthode n'est pas appelée, la première demande d'annonce initialise automatiquement le SDK Google Mobile Ads.

Paramètres
Context context

Context de l'activité dans laquelle le SDK s'exécute.

OnInitializationCompleteListener listener

Rappel à appeler une fois l'initialisation terminée.

openAdInspector

public static void openAdInspector(Context context, OnAdInspectorClosedListener listener)

Ouvre l'interface utilisateur de l'inspecteur d'annonces.

openDebugMenu

public static void openDebugMenu(Context context, String adUnitId)

Ouvre le menu de débogage. initialize doit être appelé avant cette fonction.

Paramètres
Context context

Context de l'activité dans laquelle le SDK s'exécute.

String adUnitId

N'importe quel ID de bloc d'annonces Ad Manager associé à votre application.

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

Détermine si l'ID first party de l'éditeur du SDK Google Mobile Ads (anciennement "clé d'application identique") est activé.

L'ID est activé par défaut. Lorsqu'il est désactivé, le paramètre est conservé d'une session d'application à l'autre et l'ID est effacé.

initialize doit être appelé avant cette fonction.

Paramètres
boolean enabled

Valeur booléenne "true" si l'ID first party de l'éditeur est activé, ou "false" dans le cas contraire.

Renvoie
boolean

"True" si la décision est correctement conservée. "False" si la persistance échoue.

registerCustomTabsSession

public static @Nullable CustomTabsSession registerCustomTabsSession(
    @NonNull Context context,
    @NonNull CustomTabsClient client,
    @NonNull String origin,
    @Nullable CustomTabsCallback callback
)

Enregistre un CustomTabsClient auprès du SDK Google Mobile Ads pour améliorer la monétisation des annonces dans l'application dans ce CustomTabsSession. Une seule instance de CustomTabsSession sera créée. Si vous l'exécutez à nouveau, la session existante sera remplacée.

Paramètres
@NonNull Context context

Context dans lequel le SDK s'exécute.

@NonNull CustomTabsClient client

CustomTabsClient utilisé pour créer l'instance CustomTabsSession.

@NonNull String origin

Chaîne utilisée comme origine dans Digital Asset Links pour la validation.

@Nullable CustomTabsCallback callback

CustomTabsCallback facultatif pour recevoir des rappels de

Renvoie
@Nullable CustomTabsSession

Instance CustomTabsSession à utiliser pour l'intent Custom Tabs lors de l'ouverture d'une page Custom Tabs.

registerWebView

public static void registerWebView(@NonNull WebView webview)

Enregistre un WebView auprès du SDK Google Mobile Ads pour améliorer la monétisation des annonces dans l'application dans ce WebView.

setAppMuted

public static void setAppMuted(boolean muted)

Indique si le son de l'application est coupé. Affecte l'état initial de la mise en sourdine pour toutes les annonces.

Avertissement: Si vous mettez votre application en sourdine, vous réduisez son éligibilité aux annonces vidéo et vous risquez de réduire ses revenus publicitaires. Vous ne devez utiliser cette API que si votre application fournit à l'utilisateur une commande de mise en sourdine personnalisée. Vous devez également refléter la décision de l'utilisateur de mettre en sourdine dans cette API.

Paramètres
boolean muted

"true" si l'application est mise en sourdine, "false" dans le cas contraire. Valeur par défaut : "false".

setAppVolume

public static void setAppVolume(float volume)

Définit le volume audio de l'application. Affecte le volume audio de toutes les annonces par rapport à d'autres sorties audio.

Avertissement: Si vous baissez le volume audio de votre application, vous réduisez son éligibilité aux annonces vidéo et vous risquez de réduire ses revenus publicitaires. Vous ne devez utiliser cette API que si votre application fournit à l'utilisateur des commandes de volume personnalisées. Vous devez également refléter le choix de volume de l'utilisateur dans cette API.

Paramètres
float volume

Volume sous forme de nombre à virgule flottante compris entre 0 (volume coupé) et 1,0 (volume multimédia maximal). Valeur par défaut : 1,0

Génère
java.lang.IllegalArgumentException

si le volume n'est pas compris dans la plage valide

setRequestConfiguration

public static void setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

Définit l'RequestConfiguration global qui sera utilisé pour chaque AdRequest pendant la session de l'application.

startPreload

public static void startPreload(
    @NonNull Context context,
    @NonNull List<PreloadConfiguration> preloadConfigurations,
    @NonNull PreloadCallback preloadCallback
)

Démarre le préchargement des annonces pour les configurations données.

Les API de préchargement des annonces sont disponibles en version alpha limitée. Pour en savoir plus, contactez votre responsable de compte.

Paramètres
@NonNull Context context

Context dans lequel le SDK s'exécute.

@NonNull List<PreloadConfiguration> preloadConfigurations

Les configurations pour précharger les annonces.

@NonNull PreloadCallback preloadCallback

Rappel à appeler lorsque la disponibilité des annonces change pour chaque configuration de préchargement.