Gli annunci Squeezeback inseriscono i contenuti della tua app in una visualizzazione più piccola e mostrano un annuncio nativo nello spazio circostante. Questo formato consente agli utenti di interagire con la tua app mentre l'annuncio rimane visibile. Scegli questo formato per mostrare annunci display che non coprono i contenuti della tua app.
Questa guida illustra come richiedere e visualizzare gli annunci squeezeback nella tua app utilizzando GMA Next-Gen SDK.
Prima di iniziare
Prima di continuare, completa queste operazioni:
Installa GMA Next-Gen SDK versione
1.7.0o successive.Attiva gli annunci di prova e utilizza il seguente ID unità pubblicitaria nativa di prova:
ca-app-pub-3940256099942544/9983381271
Carica un annuncio
Per caricare un oggetto SqueezebackAd, crea una richiesta di annuncio e chiama il metodo load. L'esempio seguente salva l'annuncio squeezeback caricato, si registra per gli eventi degli annunci e registra un errore in caso di errore:
Kotlin
Java
Sostituisci AD_UNIT_ID con l'ID unità pubblicitaria.
Mostra l'annuncio
Per visualizzare l'annuncio squeezeback sullo schermo, chiama il metodo 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."); } }
Imposta il colore di sfondo di riserva
Per impostazione predefinita, GMA Next-Gen SDK mostra uno sfondo grigio scuro dietro i contenuti dell'app e l'annuncio ridotti. Per personalizzare questo colore, specifica un colore di sfondo di riserva nelle opzioni dell'annuncio quando lo mostri. L'esempio seguente imposta il colore di sfondo di riserva su grigio scuro e mostra l'annuncio:
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."); } }
Ascolta gli eventi degli annunci
Per gestire gli eventi del ciclo di vita degli annunci squeezeback, registrati agli eventi degli annunci prima di visualizzare l'annuncio. Questi eventi segnalano le interazioni con gli annunci, come i clic e le impressioni. Questi eventi segnalano anche eventi specifici di squeezeback, ad esempio quando l'annuncio viene mostrato, non viene mostrato o viene nascosto.
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()); } }); }
Dopo che l'utente chiude l'annuncio, GMA Next-Gen SDK richiama l'evento di annuncio nascosto e non puoi più mostrare l'annuncio.
Nascondi l'annuncio
Per rimuovere l'annuncio e ripristinare le dimensioni originali dei contenuti dell'app, chiama il metodo hide. Questo metodo richiama l'evento annuncio nascosto. L'esempio seguente verifica la presenza di un riferimento all'annuncio squeezeback salvato e nasconde l'annuncio, se disponibile:
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."); } }
Esegui la pulizia delle risorse pubblicitarie
Per evitare perdite di memoria, elimina il riferimento all'oggetto annuncio quando l'app termina di utilizzare l'annuncio. L'esempio seguente pulisce l'annuncio:
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; } }