Geçiş reklamları

Platform seçin: Android iOS Unity Flutter Android (Eski)

Geçiş reklamları, barındıkları uygulamanın arayüzünü kaplayan tam ekran reklamlardır. Genellikle bir uygulamanın akışındaki doğal geçiş noktalarında (ör. etkinlikler veya bir oyundaki seviyeler arasındaki duraklama sırasında) gösterilir. Bir uygulama geçiş reklamı gösterdiğinde kullanıcı, reklamı tıklayıp hedefine 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 edin

Uygulamalarınızı oluştururken ve test ederken yayındaki üretim reklamları yerine test reklamlarını kullandığınızdan emin olun. Bu koşula uymamanız halinde 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:

Android

ca-app-pub-3940256099942544/1033173712

iOS

ca-app-pub-3940256099942544/4411468910

Test reklam birimleri, her istek için test reklamları döndürecek şekilde yapılandırılmıştır. Kodlama, test 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üklenmektedir:

InterstitialAd.load(
  adUnitId: "_adUnitId",
  request: const AdRequest(),
  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');
    },
  ),
);

_adUnitId yerine kendi reklam birimi kimliğinizi yazın.

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 InterstitialAd.fullScreenContentCallback değerini ayarlayın. Bu örnekte her yöntem uygulanı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.');
  },
);

Geçiş reklamı gösterme

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

_interstitialAd?.show();

show() çağrıldıktan sonra, bu şekilde gösterilen bir Ad programatik olarak kapatılamaz ve kullanıcı girişi gerektirir. InterstitialAd yalnızca bir kez gösterilebilir. show için sonraki çağrılar onAdFailedToShowFullScreenContent değerini tetikler.

Artık erişilmesi gerekmeyen reklamlar silinmelidir. dispose() yöntemini çağırmak için en iyi uygulama, FullScreenContentCallback.onAdDismissedFullScreenContent ve FullScreenContentCallback.onAdFailedToShowFullScreenContent geri çağırmalarında çağırmaktır.

İşte bu kadar. Uygulamanız artık Görüntülü Ağ geçiş reklamları göstermeye hazır.

Sonraki adımlar

GitHub'daki eksiksiz örnek

Örneğin tamamını görmek için API demosuna bakın.