Les annonces Squeezeback insèrent le contenu de votre application dans une vue plus petite et affichent une annonce native dans l'espace environnant. Ce format permet aux utilisateurs d'interagir avec votre application pendant que l'annonce reste visible. Pour diffuser des annonces display qui ne masquent pas le contenu de votre application, choisissez ce format.
Ce guide explique comment demander et afficher des annonces squeezeback dans votre application à l'aide de GMA Next-Gen SDK.
Avant de commencer
Avant de continuer, procédez comme suit :
Installez GMA Next-Gen SDK version
1.7.0ou ultérieure.Activez les annonces tests et utilisez l'ID de bloc d'annonces natives test suivant :
ca-app-pub-3940256099942544/9983381271
Charger une annonce
Pour charger un objet SqueezebackAd, créez une demande d'annonce et appelez la méthode load. L'exemple suivant enregistre l'annonce squeezeback chargée, s'enregistre pour les événements d'annonce et consigne une erreur en cas d'échec :
Kotlin
Java
Remplacez AD_UNIT_ID par l'ID de votre bloc d'annonces.
Diffuser l'annonce
Pour afficher l'annonce squeezeback à l'écran, appelez la méthode show :
Kotlin
private fun showSqueezebackAd(activity: Activity) { // Capture the ad reference saved from the onAdLoaded callback. val ad = squeezebackAd if (ad != null) { ad.show(activity) } else { Log.d(TAG, "No ad to show.") } }
Java
private void showSqueezebackAd(@NonNull Activity activity) { // Use the ad reference saved from the onAdLoaded callback. if (squeezebackAd != null) { squeezebackAd.show(activity); } else { Log.d(TAG, "No ad to show."); } }
Définir la couleur d'arrière-plan de remplacement
Par défaut, GMA Next-Gen SDK affiche un arrière-plan gris foncé derrière le contenu réduit de l'application et l'annonce. Pour personnaliser cette couleur, spécifiez une couleur d'arrière-plan de remplacement dans les options de l'annonce lors de sa diffusion. L'exemple suivant définit la couleur d'arrière-plan de remplacement sur gris foncé et affiche l'annonce :
Kotlin
private fun showSqueezebackAdWithFallbackBackgroundColor(activity: Activity) { // Capture the ad reference saved from the onAdLoaded callback. val ad = squeezebackAd if (ad != null) { val options = SqueezebackAdOptions.Builder() // Sets the fallback background color for the space behind the shrunken content and ad. .setFallbackBackgroundColor(Color.DKGRAY) .build() ad.show(activity, options) } else { Log.d(TAG, "No ad to show.") } }
Java
private void showSqueezebackAdWithFallbackBackgroundColor(@NonNull Activity activity) { // Use the ad reference saved from the onAdLoaded callback. if (squeezebackAd != null) { SqueezebackAdOptions options = new SqueezebackAdOptions.Builder() // Sets the fallback background color for the space behind the shrunken content and // ad. .setFallbackBackgroundColor(Color.DKGRAY) .build(); squeezebackAd.show(activity, options); } else { Log.d(TAG, "No ad to show."); } }
Écouter les événements d'annonce
Pour gérer les événements de cycle de vie des annonces squeezeback, enregistrez-vous pour les événements d'annonce avant d'afficher votre annonce. Ces événements signalent les interactions avec les annonces, telles que les clics et les impressions. Ces événements signalent également des événements spécifiques à squeezeback, par exemple lorsque l'annonce s'affiche, ne s'affiche pas ou est masquée.
Kotlin
private fun setAdEventCallback(squeezebackAd: SqueezebackAd) { squeezebackAd.adEventCallback = object : SqueezebackAdEventCallback { override fun onAdShown() { Log.d(TAG, "Squeezeback ad shown.") } override fun onAdHidden() { // Called when hide() is invoked or the user taps the close button. // The ad cannot be shown again after it is hidden. Log.d(TAG, "Squeezeback ad hidden.") } override fun onAdFailedToShow(error: FullScreenContentError) { Log.w(TAG, "Squeezeback ad failed to show: $error") } override fun onAdImpression() { Log.d(TAG, "Squeezeback ad recorded an impression.") } override fun onAdClicked() { Log.d(TAG, "Squeezeback ad recorded a click.") } override fun onAdShowedFullScreenContent() { Log.d(TAG, "Squeezeback ad showed full screen content.") } override fun onAdDismissedFullScreenContent() { Log.d(TAG, "Squeezeback ad dismissed full screen content.") } override fun onAdFailedToShowFullScreenContent( fullScreenContentError: FullScreenContentError ) { Log.w(TAG, "Squeezeback ad failed to show full screen content: $fullScreenContentError") } override fun onAdPaid(value: AdValue) { Log.d(TAG, "Squeezeback ad paid: ${value.valueMicros} ${value.currencyCode}") } } }
Java
private void setAdEventCallback(@NonNull SqueezebackAd squeezebackAd) { squeezebackAd.setAdEventCallback( new SqueezebackAdEventCallback() { @Override public void onAdShown() { Log.d(TAG, "Squeezeback ad shown."); } @Override public void onAdHidden() { // Called when hide() is invoked or the user taps the close button. // The ad cannot be shown again after it is hidden. Log.d(TAG, "Squeezeback ad hidden."); } @Override public void onAdFailedToShow(@NonNull FullScreenContentError error) { Log.w(TAG, "Squeezeback ad failed to show: " + error); } @Override public void onAdImpression() { Log.d(TAG, "Squeezeback ad recorded an impression."); } @Override public void onAdClicked() { Log.d(TAG, "Squeezeback ad recorded a click."); } @Override public void onAdShowedFullScreenContent() { Log.d(TAG, "Squeezeback ad showed full screen content."); } @Override public void onAdDismissedFullScreenContent() { Log.d(TAG, "Squeezeback ad dismissed full screen content."); } @Override public void onAdFailedToShowFullScreenContent( @NonNull FullScreenContentError fullScreenContentError) { Log.w( TAG, "Squeezeback ad failed to show full screen content: " + fullScreenContentError); } @Override public void onAdPaid(@NonNull AdValue value) { Log.d( TAG, "Squeezeback ad paid: " + value.getValueMicros() + " " + value.getCurrencyCode()); } }); }
Une fois que l'utilisateur a fermé l'annonce, GMA Next-Gen SDK appelle l'événement d'annonce masquée, et vous ne pouvez plus l'afficher.
Masquer l'annonce
Pour supprimer l'annonce et restaurer le contenu de votre application en taille réelle, appelez la méthode hide. Cette méthode appelle l'événement d'annonce masquée. L'exemple suivant recherche une référence d'annonce squeezeback enregistrée et masque l'annonce si elle est disponible :
Kotlin
private fun hideSqueezebackAd() { // Capture the ad reference saved from the onAdLoaded callback. val ad = squeezebackAd if (ad != null) { ad.hide() } else { Log.d(TAG, "No ad to hide.") } }
Java
private void hideSqueezebackAd() { // Use the ad reference saved from the onAdLoaded callback. if (squeezebackAd != null) { squeezebackAd.hide(); } else { Log.d(TAG, "No ad to hide."); } }
Nettoyer les ressources d'annonces
Pour éviter les fuites de mémoire, supprimez la référence à l'objet d'annonce lorsque votre application a fini d'utiliser l'annonce. L'exemple suivant nettoie l'annonce :
Kotlin
private fun cleanUpSqueezebackAd() { squeezebackAd?.destroy() squeezebackAd = null }
Java
private void cleanUpSqueezebackAd() { // Use the ad reference saved from the onAdLoaded callback. if (squeezebackAd != null) { squeezebackAd.destroy(); squeezebackAd = null; } }