Geçiş reklamı

Platform seçin: Android iOS Unity Flutter

Geçiş reklamları, barındıkları uygulamanın arayüzünü kaplayan tam ekran reklamlardır. Genellikle uygulamaların akışındaki doğal geçiş noktalarında (ör. etkinlikler arasında veya oyun seviyeleri arasındaki duraklatmalar sırasında) gösterilir. Bir uygulama geçiş reklamı gösterdiğinde kullanıcı, reklama dokunup hedef sayfaya gitmeyi veya reklamı kapatıp uygulamaya dönmeyi seçebilir.

Bu kılavuzda, geçiş reklamlarının Flutter uygulamasına nasıl entegre edileceği açıklanmaktadır.

Her zaman test reklamlarıyla test yapın

Uygulamalarınızı oluşturup test ederken canlı yayınlanan üretim reklamları yerine test reklamlarını kullandığınızdan emin olun. Bu işlemi yapmazsanız hesabınız askıya alınabilir.

Test reklamlarını yüklemenin en kolay yolu, geçiş reklamları için özel test reklam birimi kimliğimizi kullanmaktır:

  • /21775744923/example/interstitial

Test reklam birimleri, her istek için test reklamları döndürecek şekilde yapılandırılır ve kodlama, test etme ve hata ayıklama sırasında bunları kendi uygulamalarınızda kullanabilirsiniz. Uygulamanızı yayınlamadan önce bunları kendi reklam birimi kimliklerinizle değiştirdiğinizden emin olun.

Reklam yükleme

Aşağıdaki örnekte bir geçiş reklamı yüklenir:

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

_adUnitId öğesini kendi reklam birimi kimliğinizle değiştirin.

Geçiş reklamı etkinlikleri

FullScreenContentCallback kullanarak reklamın gösterilmesi veya kapatılması gibi yaşam döngüsü etkinliklerini dinleyebilirsiniz. Bu etkinliklerle ilgili bildirim almak için reklamı göstermeden önce AdManagerInterstitialAd.fullScreenContentCallback ayarlayın. Bu örnekte her yöntem uygulanmaktadır:

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.');
  },
);
interstitial_ad_snippets.dart

Geçiş reklamı görüntüleme

AdManagerInterstitialAd, tüm uygulama içeriğinin üzerinde Overlay olarak gösterilir ve statik olarak yerleştirilir. Bu nedenle, Flutter widget ağacına eklenemez. show() işlevini çağırarak reklamın ne zaman gösterileceğini seçebilirsiniz.

_interstitialAd?.show();
main.dart

show() çağrıldıktan sonra bu şekilde gösterilen bir Ad programatik olarak kapatılamaz ve kullanıcı girişi gerektirir. AdManagerInterstitialAd yalnızca bir kez gösterilebilir. Gösterilecek sonraki aramalar onAdFailedToShowFullScreenContent tetiklenir.

Bir reklama erişim artık gerekli olmadığında reklamın kaldırılması gerekir. dispose() ile FullScreenContentCallback.onAdDismissedFullScreenContent ve FullScreenContentCallback.onAdFailedToShowFullScreenContent geri aramaları için en iyi uygulama, arama zamanını belirlemektir.

İşte bu kadar. Uygulamanız artık geçiş reklamları göstermeye hazır.

Sonraki adımlar