Bei Squeezeback-Anzeigen wird der App-Inhalt in einer kleineren Ansicht dargestellt und eine native Anzeige im umgebenden Bereich eingeblendet. Bei diesem Format können Nutzer mit Ihrer App interagieren, während die Anzeige sichtbar bleibt. Wählen Sie dieses Format aus, um Anzeigen zu präsentieren, die den Inhalt Ihrer App nicht verdecken.
In diesem Leitfaden wird beschrieben, wie Sie mit GMA Next-Gen SDK squeezeback-Anzeigen in Ihrer App anfordern und präsentieren.
Hinweis
Führen Sie die folgenden Schritte aus, bevor Sie fortfahren:
Installieren Sie die GMA Next-Gen SDK-Version
1.7.0oder höher.Aktivieren Sie Testanzeigen und verwenden Sie die folgende Anzeigenblock-ID für native Testanzeigen:
ca-app-pub-3940256099942544/9983381271
Anzeige laden
Wenn Sie ein SqueezebackAd-Objekt laden möchten, erstellen Sie eine Anzeigenanfrage und rufen Sie die Methode load auf. Im folgenden Beispiel wird die geladene squeezeback-Anzeige gespeichert, es werden Anzeigenereignisse registriert und im Falle eines Fehlers wird ein Fehler protokolliert:
Kotlin
Java
Ersetzen Sie AD_UNIT_ID durch die ID Ihres Anzeigenblocks.
Anzeige einblenden
Rufen Sie die Methode show auf, um die squeezeback-Anzeige auf dem Bildschirm einzublenden:
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."); } }
Fallback-Hintergrundfarbe festlegen
Standardmäßig wird in GMA Next-Gen SDK ein dunkelgrauer Hintergrund hinter dem reduzierten App-Inhalt und der Anzeige eingeblendet. Wenn Sie diese Farbe anpassen möchten, geben Sie in den Anzeigenoptionen eine Fallback-Hintergrundfarbe an, die beim Ausliefern der Anzeige verwendet werden soll. Im folgenden Beispiel wird die Fallback-Hintergrundfarbe auf Dunkelgrau festgelegt und die Anzeige eingeblendet:
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."); } }
Auf Anzeigenereignisse warten
Wenn Sie squeezeback Anzeigen-Lifecycle-Events verarbeiten möchten, müssen Sie sich für Anzeigenereignisse registrieren, bevor Sie die Anzeige einblenden. Diese Ereignisse melden Anzeigeninteraktionen wie Klicks und Impressionen. Diese Ereignisse melden auch squeezeback-spezifische Ereignisse, z. B. wenn die Anzeige eingeblendet, nicht eingeblendet oder ausgeblendet wird.
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()); } }); }
Nachdem der Nutzer die Anzeige geschlossen hat, wird von GMA Next-Gen SDK das Ereignis „Anzeige ausgeblendet“ aufgerufen und die Anzeige kann nicht mehr eingeblendet werden.
Anzeige ausblenden
Wenn Sie die Anzeige entfernen und den App-Inhalt wieder in voller Größe anzeigen möchten, rufen Sie die Methode hide auf. Diese Methode ruft das Ereignis „Anzeige ausgeblendet“ auf. Im folgenden Beispiel wird geprüft, ob eine gespeicherte squeezeback-Anzeigenreferenz vorhanden ist. Falls ja, wird die Anzeige ausgeblendet:
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."); } }
Anzeigenressourcen bereinigen
Um Speicherlecks zu vermeiden, sollten Sie den Verweis auf das Anzeigenobjekt löschen, wenn die Anzeige in Ihrer App nicht mehr verwendet wird. Im folgenden Beispiel wird die Anzeige bereinigt:
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; } }