Les bannières réductibles sont des bannières qui sont initialement présentées sous la forme d'une superposition plus grande, avec un bouton permettant de les réduire à la taille de bannière demandée à l'origine. Les bannières réductibles sont destinées à améliorer les performances des annonces ancrées de plus petite taille. Ce guide explique comment activer les bannières réductibles pour les emplacements de bannières existants.
Conditions préalables
- Suivez le guide de démarrage relatif aux bannières.
Implémentation
Assurez-vous que l'affichage de votre bannière est défini avec la taille que vous souhaitez que les utilisateurs voient dans l'état standard (réduit) de la bannière. Incluez un paramètre supplémentaire dans la demande d'annonce avec collapsible
comme clé et l'emplacement de l'annonce comme valeur.
L'emplacement réductible définit la manière dont la zone agrandie s'ancre sur la bannière.
Valeur Placement
|
Comportement | Cas d'utilisation prévu |
---|---|---|
top |
La partie supérieure de l'annonce développée s'aligne sur la partie supérieure de l'annonce réduite. | L'annonce est placée en haut de l'écran. |
bottom |
La partie inférieure de l'annonce développée s'aligne sur la partie inférieure de l'annonce réduite. | L'annonce est placée en bas de l'écran. |
Si l'annonce chargée est une bannière réductible, la bannière affiche la superposition réductible dès qu'elle est placée dans la hiérarchie des vues.
Java
private void loadBannerAd() {
adView = new AdView(this);
adView.setAdUnitId("ca-app-pub-3940256099942544/2014213617")
AdSize adSize = getAdSize();
adView.setAdSize(adSize);
// Create an extra parameter that aligns the bottom of the expanded ad to
// the bottom of the bannerView.
Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest = new AdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter.class, extras)
.build();
adView.loadAd(adRequest);
}
Kotlin
private fun loadBanner() {adView = AdView(this);
adView.adUnitId = "ca-app-pub-3940256099942544/2014213617"
adView.setAdSize(adSize)
// Create an extra parameter that aligns the bottom of the expanded ad to
// the bottom of the bannerView.
val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest = AdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
.build()
adView.loadAd(adRequest)
}
Comportement d'actualisation des annonces
L'actualisation des bannières réductibles toutes les 30 à 120 secondes peut être trop fréquente, ce qui entraîne une expérience utilisateur frustrante. Pour les applications qui configurent l'actualisation automatique dans l'interface Web d'Ad Manager, nous vous recommandons de n'afficher que la première demande d'annonce comme réductible, et les bannières actualisées suivantes dans cet emplacement à la taille de la demande d'origine. Pour ce faire, transmettez un UUID en tant que collapsible_request_id
à la demande d'annonce:
Java
extras.putString("collapsible_request_id", UUID.randomUUID().toString());
Kotlin
extras.putString("collapsible_request_id", UUID.randomUUID().toString())
Si vous souhaitez charger une autre bannière réductible ultérieurement au cours de la session, vous pouvez charger une annonce manuellement avec une demande contenant le paramètre réductible.
Vérifier si une annonce chargée peut être réduite
Appelez isCollapsible
pour vérifier si la dernière bannière chargée peut être réduite.
Si la requête ne se charge pas et que la bannière précédente peut être réduite, l'API renvoie la valeur "true".
Java
public void onAdLoaded() {
Log.i(TAG, String.format("The last loaded banner is %scollapsible.", adView.isCollapsible() ? "" : "not "));
}
Kotlin
fun onAdLoaded() {
Log.i(TAG, "The last loaded banner is ${if (adView.isCollapsible) "" else "not "}collapsible.")
}
Médiation
Les bannières réductibles ne sont disponibles que pour la demande Google pendant la phase bêta. Les annonces diffusées par le biais de la médiation se présentent comme des bannières standards non réductibles.
Comportement de diffusion des annonces
Pour optimiser les performances de vos bannières, les annonces qui n'acceptent pas les superpositions réductibles de plus grande taille peuvent renvoyer des demandes de bannières réductibles et s'afficher immédiatement dans la taille de bannière standard.