Anzeigen mit Prämie

Anzeigen mit Prämie sind Anzeigen, mit denen Nutzer interagieren können, um In-App-Prämien zu erhalten. In diesem Leitfaden wird beschrieben, wie Sie Anzeigen mit Prämie aus Ad Manager in eine Flutter-App einbinden.

Immer mit Testanzeigen testen

Verwenden Sie beim Erstellen und Testen Ihrer Apps Testanzeigen anstelle von aktiven Anzeigen. Andernfalls kann es zur Sperrung Ihres Kontos kommen.

Testanzeigen lassen sich am einfachsten mit unserer speziellen Test-Anzeigenblock-ID für Anzeigen mit Prämie laden:

/21775744923/example/rewarded

Die Testanzeigenblöcke sind so konfiguriert, dass bei jeder Anfrage Testanzeigen zurückgegeben werden. Sie können sie beim Programmieren, Testen und Debuggen in Ihren eigenen Apps verwenden. Ersetzen Sie sie vor der Veröffentlichung Ihrer App durch Ihre eigenen Anzeigenblock-IDs.

Anzeige laden

Im folgenden Beispiel wird eine Anzeige mit Prämie geladen:

RewardedAd.load(
  adUnitId: "_adUnitId",
  request: const AdManagerAdRequest(),
  rewardedAdLoadCallback: RewardedAdLoadCallback(
    onAdLoaded: (RewardedAd ad) {
      // Called when an ad is successfully received.
      debugPrint('Ad was loaded.');
      // Keep a reference to the ad so you can show it later.
      _rewardedAd = ad;
    },
    onAdFailedToLoad: (LoadAdError error) {
      // Called when an ad request failed.
      debugPrint('Ad failed to load with error: $error');
    },
  ),
);rewarded_ad_snippets.dart

Ersetzen Sie _adUnitId durch Ihre eigene Anzeigenblock-ID.

Anzeigenereignisse mit Prämie

Mit FullScreenContentCallback können Sie auf Lebenszyklusereignisse wie das Einblenden oder Schließen der Anzeige warten. Legen Sie RewardedAd.fullScreenContentCallback fest, bevor Sie die Anzeige einblenden, um Benachrichtigungen zu diesen Ereignissen zu erhalten. In diesem Beispiel wird jede Methode implementiert und eine Nachricht in der Konsole protokolliert:

ad.fullScreenContentCallback = FullScreenContentCallback(
  onAdShowedFullScreenContent: (ad) {
    // Called when the ad showed the full screen content.
    debugPrint('Ad showed full screen content.');
  },
  onAdFailedToShowFullScreenContent: (ad, err) {
    // Called when the ad failed to show full screen content.
    debugPrint('Ad failed to show full screen content with error: $err');
    // Dispose the ad here to free resources.
    ad.dispose();
  },
  onAdDismissedFullScreenContent: (ad) {
    // Called when the ad dismissed full screen content.
    debugPrint('Ad was dismissed.');
    // Dispose the ad here to free resources.
    ad.dispose();
  },
  onAdImpression: (ad) {
    // Called when an impression occurs on the ad.
    debugPrint('Ad recorded an impression.');
  },
  onAdClicked: (ad) {
    // Called when a click is recorded for an ad.
    debugPrint('Ad was clicked.');
  },
);rewarded_ad_snippets.dart

Anzeige einblenden

Eine RewardedAd wird als Overlay über allen App-Inhalten angezeigt und ist statisch platziert. Sie kann also nicht dem Flutter-Widget-Baum hinzugefügt werden. Sie können festlegen, wann die Anzeige eingeblendet werden soll, indem Sie show() aufrufen. RewardedAd.show() akzeptiert ein OnUserEarnedRewardCallback, das aufgerufen wird, wenn der Nutzer eine Prämie erhält. Implementieren Sie diese Funktion und belohnen Sie den Nutzer dafür, dass er sich eine Anzeige angesehen hat.

_rewardedAd?.show(
  onUserEarnedReward:
      (AdWithoutView ad, RewardItem rewardItem) {
        debugPrint(
          'Reward amount: ${rewardItem.amount}',
        );
      },
);main.dart

Sobald show() aufgerufen wird, kann eine so angezeigte Ad nicht programmatisch entfernt werden. Dazu ist eine Nutzereingabe erforderlich. Eine RewardedAd kann nur einmal angezeigt werden. Bei nachfolgenden Aufrufen von „show“ wird onAdFailedToShowFullScreenContent ausgelöst.

Eine Anzeige muss verworfen werden, wenn der Zugriff darauf nicht mehr erforderlich ist. Die Best Practice für den Aufruf von dispose() besteht in den Callbacks FullScreenContentCallback.onAdDismissedFullScreenContent und FullScreenContentCallback.onAdFailedToShowFullScreenContent.

[Optional] Serverseitige Überprüfungs-Callbacks (SSV) validieren

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

Im folgenden Codebeispiel wird gezeigt, wie Sie die SSV-Optionen festlegen, nachdem die Anzeige mit Prämie geladen wurde:

RewardedAd.load(
  adUnitId: "_adUnitId",
  request: AdManagerAdRequest(),
  rewardedAdLoadCallback: RewardedAdLoadCallback(
    onAdLoaded: (ad) {
      ServerSideVerificationOptions _options =
          ServerSideVerificationOptions(
            customData: 'SAMPLE_CUSTOM_DATA_STRING',
          );
      ad.setServerSideOptions(_options);
      _rewardedAd = ad;
    },
    onAdFailedToLoad: (error) {},
  ),
);rewarded_ad_snippets.dart

Ersetzen Sie SAMPLE_CUSTOM_DATA_STRING durch Ihre benutzerdefinierten Daten.