Interstitial mit Prämie (Beta)

Interstitial mit Prämie ist ein Anzeigenformat mit Anreizen, bei dem Sie Prämien für Anzeigen anbieten, die automatisch an natürlichen Übergangspunkten in der App eingeblendet werden. Anders als bei Anzeigen mit Prämie müssen Nutzer der Auslieferung von Interstitials mit Prämie nicht zustimmen.

Voraussetzungen

• Google Mobile Ads SDK 19.2.0 oder höher.
• Arbeiten Sie den Startleitfaden durch.

Implementierung

Im Folgenden sind die wichtigsten Schritte zum Einbinden von Interstitial-Anzeigen mit Prämie aufgeführt:

• Anzeige laden
• Für Vollbildereignis-Callbacks registrieren
• Callback für die Prämie
• Anzeige einblenden

• [Optional] SSV-Callbacks validieren

Anzeige laden

Das Laden einer Anzeige erfolgt mit der statischen Methode load() in der Klasse RewardedInterstitialAd. Für die Lademethode sind ein Kontext, Ihre Anzeigenblock-ID, ein AdRequest-Objekt und ein RewardedInterstitialAdLoadCallback erforderlich, um benachrichtigt zu werden, wenn das Laden der Anzeige erfolgreich ist oder fehlschlägt. Das geladene RewardedInterstitialAd-Objekt wird als Parameter im onRewardedInterstitialAdLoaded()-Callback bereitgestellt.

Das folgende Beispiel zeigt, wie ein RewardedInterstitialAd in deinem MainActivity geladen wird.

Java

public class MainActivity extends AppCompatActivity {
  private RewardedInterstitialAd rewardedInterstitialAd;
  private String TAG = "MainActivity";

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(this, initializationStatus -> {});
              // Load an ad on the main thread.
              runOnUiThread(
                  () -> {
                    loadAd();
                  });
            })
        .start();
  }

  public void loadAd() {
    // Use the test ad unit ID to load an ad.
    RewardedInterstitialAd.load(MainActivity.this, "ca-app-pub-3940256099942544/5354046379",
        new AdRequest.Builder().build(),  new RewardedInterstitialAdLoadCallback() {
      @Override
      public void onAdLoaded(RewardedInterstitialAd ad) {
        Log.d(TAG, "Ad was loaded.");
        rewardedInterstitialAd = ad;
      }
      @Override
      public void onAdFailedToLoad(LoadAdError loadAdError) {
        Log.d(TAG, loadAdError.toString());
        rewardedInterstitialAd = null;
      }
    });
  }
}

Kotlin

import com.google.android.gms.ads.rewardedinterstitial.RewardedInterstitialAd
import com.google.android.gms.ads.rewardedinterstitial.RewardedInterstitialAdLoadCallback

class MainActivity : AppCompactActivity() {

  private var rewardedInterstitialAd? = null
  private final var TAG = "MainActivity"

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) {}
      // Load an ad on the main thread.
      runOnUiThread {
        loadAd()
      }
    }
  }

  private fun loadAd() {
    RewardedInterstitialAd.load(this, "ca-app-pub-3940256099942544/5354046379",
      AdRequest.Builder().build(), object : RewardedInterstitialAdLoadCallback() {
      override fun onAdLoaded(ad: RewardedInterstitialAd) {
        Log.d(TAG, "Ad was loaded.")
        rewardedInterstitialAd = ad
      }

      override fun onAdFailedToLoad(adError: LoadAdError) {
        Log.d(TAG, adError?.toString())
        rewardedInterstitialAd = null
      }
    })
  }
}

Tipp:Sie können Aufrufe zum Laden von Anzeigen verwenden, um einen Cache mit vorab geladenen Anzeigen einzurichten, bevor Sie sie schalten möchten. So können Anzeigen bei Bedarf ohne Latenz bereitgestellt werden. Da Anzeigen nach einer Stunde ablaufen, sollten Sie diesen Cache leeren und stündlich neue Anzeigen hochladen.

Für Rückrufe registrieren

Wenn Sie Benachrichtigungen zu Präsentationsereignissen erhalten möchten, müssen Sie ein FullScreenContentCallback-Objekt an den Setter für Ihre Anzeige übergeben. Das FullScreenContentCallback-Objekt verarbeitet Callbacks, wenn die Anzeige erfolgreich oder nicht ausgeliefert werden konnte und geschlossen wird. Der folgende Code zeigt, wie Sie ein anonymes FullScreenContentCallback-Objekt innerhalb Ihrer RewardedInterstitialAdLoadCallback festlegen:

Java

public void loadAd(){
  RewardedInterstitialAd.load(MainActivity.this, "ca-app-pub-3940256099942544/5354046379",
      new AdRequest.Builder().build(), new RewardedInterstitialAdLoadCallback() {
    @Override
    public void onAdLoaded(RewardedInterstitialAd ad) {
      rewardedInterstitialAd = ad;
      rewardedInterstitialAd.setFullScreenContentCallback(new FullScreenContentCallback() {
        @Override
        public void onAdClicked() {
          // Called when a click is recorded for an ad.
          Log.d(TAG, "Ad was clicked.");
        }

        @Override
        public void onAdDismissedFullScreenContent() {
          // Called when ad is dismissed.
          // Set the ad reference to null so you don't show the ad a second time.
          Log.d(TAG, "Ad dismissed fullscreen content.");
          rewardedInterstitialAd = null;
        }

        @Override
        public void onAdFailedToShowFullScreenContent(AdError adError) {
          // Called when ad fails to show.
          Log.e(TAG, "Ad failed to show fullscreen content.");
          rewardedInterstitialAd = null;
        }

        @Override
        public void onAdImpression() {
          // Called when an impression is recorded for an ad.
          Log.d(TAG, "Ad recorded an impression.");
        }

        @Override
        public void onAdShowedFullScreenContent() {
          // Called when ad is shown.
          Log.d(TAG, "Ad showed fullscreen content.");
        }
      });
    }
    @Override
    public void onAdFailedToLoad(LoadAdError loadAdError) {
      Log.d(TAG, loadAdError.toString());
      rewardedInterstitialAd = null;
    }
  });
}

Kotlin

private fun loadAd() {
  RewardedInterstitialAd.load(this, "ca-app-pub-3940256099942544/5354046379",
    AdRequest.Builder().build(), object : RewardedInterstitialAdLoadCallback() {
    override fun onAdLoaded(ad: RewardedInterstitialAd) {
      rewardedInterstitialAd = ad
      rewardedInterstitialAd?.fullScreenContentCallback = object: FullScreenContentCallback() {
        override fun onAdClicked() {
          // Called when a click is recorded for an ad.
          Log.d(TAG, "Ad was clicked.")
        }

        override fun onAdDismissedFullScreenContent() {
          // Called when ad is dismissed.
          // Set the ad reference to null so you don't show the ad a second time.
          Log.d(TAG, "Ad dismissed fullscreen content.")
          rewardedInterstitialAd = null
        }

        override fun onAdFailedToShowFullScreenContent(adError: AdError) {
          // Called when ad fails to show.
          Log.e(TAG, "Ad failed to show fullscreen content.")
          rewardedInterstitialAd = null
        }

        override fun onAdImpression() {
          // Called when an impression is recorded for an ad.
          Log.d(TAG, "Ad recorded an impression.")
        }

        override fun onAdShowedFullScreenContent() {
          // Called when ad is shown.
          Log.d(TAG, "Ad showed fullscreen content.")
        }
      }
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {
      Log.d(TAG, adError?.toString())
      rewardedInterstitialAd = null
    }
  })
}

Prämien verwalten

Damit Ihre Interstitial-Anzeige mit Prämie präsentiert werden kann, müssen Sie die OnUserEarnedRewardListener-Oberfläche in der MainActivity implementieren. Sie werden dann benachrichtigt, wenn der Nutzer eine Prämie erhält.

Java

public class MainActivity extends AppCompatActivity implements OnUserEarnedRewardListener {
  ...
  @Override
  public void onUserEarnedReward(@NonNull RewardItem rewardItem) {
    Log.i(TAG, "User earned reward.");
    // TODO: Reward the user!
  }
}

Kotlin

class MainActivity : AppCompatActivity(), OnUserEarnedRewardListener {
  ...
  override fun onUserEarnedReward(rewardItem: RewardItem) {
    Log.d(TAG, "User earned reward.")
    // TODO: Reward the user!
  }
}

Anzeige einblenden

Wichtiger Hinweis :Bevor Nutzern eine Interstitial-Anzeige mit Prämie präsentiert wird, müssen Sie ihnen einen Eingangsbildschirm einblenden, der eine klare Botschaft zur Prämie enthält und die Möglichkeit hat, die Anzeige vor dem Start zu überspringen. Weitere Informationen

Nach der Implementierung der OnUserEarnedRewardListener-Oberfläche können Sie die Anzeige mit der show()-Methode der Anzeige so präsentieren:

Java

rewardedInterstitialAd.show(/* Activity */ MainActivity.this,/*
    OnUserEarnedRewardListener */ MainActivity.this);

Kotlin

rewardedInterstitialAd?.show(/* Activity */ this, /*
    OnUserEarnedRewardListener */ this)

[Optional] Callbacks für die serverseitige Überprüfung validieren

Apps, für die zusätzliche Daten bei Callbacks der serverseitigen Überprüfung erforderlich sind, sollten die Funktion für benutzerdefinierte Daten von Anzeigen mit Prämie verwenden. Jeder Stringwert, der für ein Anzeigenobjekt mit Prämie festgelegt ist, wird an den custom_data-Abfrageparameter des SSV-Callbacks übergeben. Wenn kein benutzerdefinierter Datenwert festgelegt ist, ist der Wert des Abfrageparameters custom_data nicht im SSV-Callback vorhanden.

Im folgenden Codebeispiel wird gezeigt, wie benutzerdefinierte Daten für ein Interstitial-Anzeigenobjekt mit Prämie festgelegt werden, bevor eine Anzeige angefragt wird.

Java

RewardedInterstitialAd.load(MainActivity.this, "ca-app-pub-3940256099942544/5354046379",
    new AdRequest.Builder().build(),  new RewardedInterstitialAdLoadCallback() {
  @Override
  public void onAdLoaded(RewardedInterstitialAd ad) {
    Log.d(TAG, "Ad was loaded.");
    rewardedInterstitialAd = ad;
    ServerSideVerificationOptions options = new ServerSideVerificationOptions
        .Builder()
        .setCustomData("SAMPLE_CUSTOM_DATA_STRING")
        .build();
    rewardedInterstitialAd.setServerSideVerificationOptions(options);
  }
  @Override
  public void onAdFailedToLoad(LoadAdError loadAdError) {
    Log.d(TAG, loadAdError.toString());
    rewardedInterstitialAd = null;
  }
});

Kotlin

RewardedInterstitialAd.load(this, "ca-app-pub-3940256099942544/5354046379",
    AdRequest.Builder().build(), object : RewardedInterstitialAdLoadCallback() {
  override fun onAdLoaded(ad: RewardedInterstitialAd) {
    Log.d(TAG, "Ad was loaded.")
    rewardedInterstitialAd = ad
    val options = ServerSideVerificationOptions.Builder()
        .setCustomData("SAMPLE_CUSTOM_DATA_STRING")
        .build()
    rewardedInterstitialAd.setServerSideVerificationOptions(options)
  }

  override fun onAdFailedToLoad(adError: LoadAdError) {
    Log.d(TAG, adError?.toString())
    rewardedInterstitialAd = null
  }
})

Wenn Sie den benutzerdefinierten Prämienstring festlegen möchten, müssen Sie das tun, bevor die Anzeige ausgeliefert wird.

Wichtiger Hinweis :Der benutzerdefinierte Prämienstring wird in Prozent maskiert und muss beim Parsen aus dem SSV-Callback möglicherweise decodiert werden.

Beispiele auf GitHub

• Beispiel für Interstitial-Anzeigen mit Prämie: Java | Kotlin

Nächste Schritte

Sehen Sie sich die folgenden Themen an:

• Datenschutz für Nutzer
• Optimierte SDK-Initialisierung und -Laden von Anzeigen (Beta)