Przejdź do treści

Psittacus

Monetyzacja gier w Flutterze z modelem hybrydowym reklam i zakupów

Temat: Poradniki

Monetyzacja gier w Flutterze: reklamy, zakupy i retencja

Praktyczny przewodnik po monetyzacji gier w Flutterze: reklamy z nagrodą, zakupy w aplikacji z RevenueCat, optymalizacja 60 FPS oraz zgody RODO i ATT.

Autor Maksymilian JackowskiGłówny programista gier

Opublikowano 8 min

Wielu programistów traktuje monetyzację gry mobilnej jak dodanie kolejnej biblioteki do pliku pubspec.yaml. W praktyce to decyzja czysto architektoniczna. Jeśli wyświetlisz pełnoekranową reklamę w środku trudnego poziomu, gracz po prostu odinstaluje grę. Jeśli umieścisz baner w niewłaściwym miejscu drzewa widżetów, narzut Platform Views zniszczy płynność 60 FPS. Z kolei brak obsługi trybu offline sprawi, że przyciski nagród przestaną działać w metrze lub samolocie.

Flutter świetnie sprawdza się w grach 2D, zręcznościowych i logicznych, oferując gotowy system widżetów oraz elastyczne renderowanie. Aby jednak gra przynosiła zyski i nie traciła graczy, potrzebuje stabilnego modelu biznesowego oraz przemyślanego kodu. W tym artykule opisujemy architekturę monetyzacji, którą stosujemy w Psittacus Studio. Skupiamy się na konkretnych rozwiązaniach technicznych: cyklu życia reklam z nagrodą, optymalizacji renderowania pod kątem 60 FPS, bezpiecznej weryfikacji zakupów w aplikacji oraz poprawnej kolejności zgód RODO i ATT.

Cztery filary modelu hybrydowego

Opieranie budżetu gry wyłącznie na agresywnych reklamach pełnoekranowych to domena prostych gier hypercasual, w których średni czas życia gracza wynosi kilka dni. W grach projektowanych na dłuższą retencję najlepiej sprawdza się model hybrydowy. Statystyki rynkowe pokazują tu wyraźną proporcję: około 30% przychodów pochodzi z dobrowolnych reklam, a 70% z mikropłatności. Głównym wskaźnikiem staje się liczba wyświetleń na aktywnego użytkownika dziennie (imp/DAU), zestawiana z długoterminową wartością gracza (LTV).

Sprawdzona architektura monetyzacji w grze mobilnej opiera się na czterech filarach:

  1. Reklamy z nagrodą (Rewarded Ads). Gracz sam decyduje, kiedy chce obejrzeć krótkie wideo w zamian za konkretną pomoc: dodatkowe życie, odnowienie energii, drugą szansę po przegranej lub podpowiedź. Brak przymusu buduje zaufanie i zachęca do powrotów.
  2. Jednorazowy zakup usuwający reklamy (Remove Ads). Klasyczny zakup typu utility. Z punktu widzenia psychologii gracza to najprostszy, naturalny pierwszy krok do wydania pieniędzy w grze.
  3. Pakiety zasobów (Consumables). Opcja dla osób, które cenią swój czas i wolą kupić zapas monet, żyć lub ułatwień, zamiast regularnie oglądać reklamy wideo.
  4. Subskrypcja (VIP Pass / Club). Stały abonament zapewniający codzienne bonusy, dostęp do unikalnych poziomów lub skórek oraz całkowity brak banerów.

Przy wdrażaniu tego systemu obowiązuje jedna kluczowa zasada: płacący gracz nie może czuć się odcięty od ekonomii nagród. Jeśli ktoś kupi usunięcie reklam, zablokowanie mu dostępu do bonusów z reklam z nagrodą jest błędem projektowym. W dojrzałych grach stosuje się mechanizm natychmiastowego odbioru (instant reward) lub bilety pominięcia (skip tickets). Płacący użytkownik dotyka przycisku i natychmiast odbiera nagrodę, bez czekania na załadowanie i odtworzenie filmu promocyjnego.

Warto też zadbać o stopniowanie pomocy. Zamiast natychmiast rozwiązywać problem za gracza, zaoferuj mu małą wskazówkę: najpierw wskaż obszar błędu, a dopiero przy kolejnej prośbie odsłoń pełne rozwiązanie. Dzięki temu gra nie traci waloru wyzwania, a nagrody zachowują realną wartość.

Interfejs gry mobilnej prezentujący system nagród odblokowywanych za pośrednictwem dobrowolnych reklam

Reklamy z nagrodą w Flutterze: obsługa braku sieci i pustego fillu

Większość oficjalnych samouczków pokazuje minimalistyczny kod: załaduj reklamę, wywołaj metodę show i przyznaj nagrodę w funkcji zwrotnej. Na produkcji taki kod szybko sprawi problemy. Sieci reklamowe regularnie zwracają brak reklamy, znany w Google AdMob jako błąd LoadAdError(code: 3) (No fill). Ponadto gracze regularnie uruchamiają gry bez dostępu do internetu.

Przycisk nagrody w interfejsie użytkownika musi obsługiwać trzy stany:

  1. Wczytywanie (Loading): Sprawdzanie w tle, czy reklama jest już pobrana do pamięci telefonu.
  2. Gotowy (Ready): Aktywny przycisk z ikoną wideo informujący o gotowości do odtworzenia.
  3. Niedostępny z alternatywą (Fallback): Gdy sieć nie zwróci reklamy, aplikacja nie może pokazywać martwego przycisku ani komunikatu o błędzie. Zaoferuj darmowy bonus z licznikiem odnowienia (na przykład raz na dziesięć minut). Gracz nie czuje frustracji spowodowanej problemem technicznym i kontynuuje zabawę.

Kluczowa zasada bezpieczeństwa: nagrodę w kodzie przyznajemy wyłącznie wewnątrz wywołania zwrotnego onUserEarnedReward. Zamknięcie reklamy przez użytkownika (onAdDismissedFullScreenContent) oznacza jedynie opuszczenie widoku pełnoekranowego, co mogło nastąpić przed obejrzeniem wymaganej części wideo.

Poniższy moduł w bibliotece google_mobile_ads realizuje bezpieczny przepływ z wcześniejszym pobieraniem (preloading) oraz zabezpieczeniem przed wielokrotnym kliknięciem:

import 'dart:async';
import 'package:google_mobile_ads/google_mobile_ads.dart';

class GameRewardedAdManager {
  RewardedAd? _ad;
  bool _isShowing = false;

  void preload() {
    _ad?.dispose();
    _ad = null;
    RewardedAd.load(
      adUnitId: RewardedAd.testAdUnitId,
      request: const AdRequest(),
      rewardedAdLoadCallback: RewardedAdLoadCallback(
        onAdLoaded: (ad) => _ad = ad,
        onAdFailedToLoad: (error) {
          _ad = null;
          // Code 3 indicates no fill. Retry after a backoff delay.
          unawaited(Future.delayed(const Duration(minutes: 2), preload));
        },
      ),
    );
  }

  Future<bool> showForReward() async {
    final ad = _ad;
    if (ad == null || _isShowing) return false;

    final completed = Completer<bool>();
    _isShowing = true;

    ad.fullScreenContentCallback = FullScreenContentCallback(
      onAdDismissedFullScreenContent: (ad) {
        ad.dispose();
        _isShowing = false;
        if (!completed.isCompleted) completed.complete(false);
        preload(); // Prepare the next ad for future requests
      },
      onAdFailedToShowFullScreenContent: (ad, error) {
        ad.dispose();
        _isShowing = false;
        if (!completed.isCompleted) completed.complete(false);
        preload();
      },
    );

    await ad.show(
      onUserEarnedReward: (ad, reward) {
        // Only grant the game reward upon verified completion
        if (!completed.isCompleted) completed.complete(true);
      },
    );

    return completed.future;
  }
}

Wstępne pobieranie eliminuje irytujące opóźnienia: materiał ładuje się w tle podczas gry, dzięki czemu po dotknięciu przycisku wideo startuje natychmiast. Z kolei flaga _isShowing zabezpiecza aplikację przed podwójnym otwarciem okna przy szybkim stuknięciu w ekran.

Sama logika portfela zasobów nie wymaga bibliotek mobilnych i działa całkowicie offline, co pozwala przetestować ją bezpośrednio w DartPad. Poniższy kod w czystym Darcie demonstruje zarządzanie stanem i licznikiem odnowienia:

class GameEconomyWallet {
  int _balance = 3;
  DateTime? _lastFreeBonusAt;

  int get balance => _balance;

  Duration get freeBonusCooldown {
    final last = _lastFreeBonusAt;
    if (last == null) return Duration.zero;
    final elapsed = DateTime.now().difference(last);
    const cooldown = Duration(minutes: 10);
    return elapsed >= cooldown ? Duration.zero : cooldown - elapsed;
  }

  bool grantFromRewardedAd() {
    _balance++;
    return true;
  }

  bool grantFreeWithCooldown() {
    if (freeBonusCooldown > Duration.zero) return false;
    _lastFreeBonusAt = DateTime.now();
    _balance++;
    return true;
  }

  bool consume() {
    if (_balance <= 0) return false;
    _balance--;
    return true;
  }
}

void main() {
  final wallet = GameEconomyWallet();
  assert(wallet.consume());
  assert(wallet.consume());
  assert(wallet.consume());
  assert(!wallet.consume()); // Wallet empty
  assert(!wallet.grantFreeWithCooldown()); // Cooldown active
  print('Wallet logic verified: ${wallet.balance} items available');
}

Banery reklamowe a płynność 60 FPS: unikanie janku w Flutterze

Banery generują najmniejszy zysk, a w grach tworzonych w Flutterze niosą spore ryzyko techniczne. Widżet AdWidget korzysta z Platform Views, czyli mechanizmu osadzającego natywne widoki Androida i iOS wewnątrz potoku graficznego Fluttera. Niepoprawne zarządzanie tym widżetem wymusza kosztowne przeliczanie układu ekranu i prowadzi do widocznego gubienia klatek (jank).

Trzy zasady inżynierskie pozwalają utrzymać stabilne 60 klatek na sekundę:

  1. Sztywna rezerwacja miejsca w układzie. Umieść AdWidget w kontenerze SizedBox o stałych wymiarach zgodnych z formatem reklamy, połączonym z SafeArea. Zapobiega to przesuwaniu elementów ekranu w momencie załadowania banera. Nagły skok interfejsu podczas dynamicznej rozgrywki prowadzi do przypadkowych dotknięć w złe miejsca.
  2. Zachowanie instancji banera w stanie. Obiekt BannerAd utwórz raz w kontrolerze stanu i utrzymuj go przez cały czas trwania sesji. Tworzenie nowej instancji wewnątrz metody build() widżetów powoduje wycieki pamięci i nieustanne przeładowywanie widoku natywnego.
  3. Asynchroniczny start SDK poza wątkiem głównym. Wywołaj MobileAds.instance.initialize() w funkcji main() asynchronicznie za pomocą unawaited(). Dzięki temu uruchamianie bibliotek reklamowych nie opóźnia pierwszego rysowania klatek gry na ekranie.

Warto też zadbać o higienę przestrzenną: umieszczaj banery wyłącznie na ekranach statycznych, takich jak menu główne, wybór poziomów czy ekran pauzy. Właściwy ekran rozgrywki powinien być całkowicie wolny od banerów. Płynność animacji i spokój wizualny są kluczowe dla zadowolenia graczy.

Schemat mechanizmu zegarowego symbolizujący stabilność 60 FPS i izolację layoutu w Flutterze

in_app_purchase czy RevenueCat: weryfikacja zakupów

Gdy dodajesz pakiety zasobów oraz subskrypcje, stajesz przed dylematem: użyć oficjalnego pakietu in_app_purchase czy wdrożyć RevenueCat?

Różnica nie polega na wygodzie kodu w aplikacji, lecz na architekturze weryfikacji transakcji. Pakiet in_app_purchase to lekki mostek do bibliotek StoreKit i Google Play Billing. Oferuje bezpośrednie połączenie z platformami mobilnymi, ale cała reszta spoczywa na programiście: weryfikacja paragonów po stronie własnego serwera, obsługa okresów karencji (grace period), ponawianie płatności oraz obsługa pauzy subskrypcji w systemie Android. Rezygnacja z walidacji serwerowej naraża grę na oszustwa przy użyciu zmodyfikowanych aplikacji symulujących potwierdzenie zakupu.

RevenueCat przejmuje tę odpowiedzialność w modelu zarządzanym: weryfikuje paragony na własnych serwerach u Apple i Google, normalizuje stany subskrypcyjne, zarządza uprawnieniami (entitlements) oraz udostępnia panel analityczny. Dla niezależnego studia darmowy próg do 2500 dolarów miesięcznego śledzonego przychodu pozwala wdrożyć bezpieczną monetyzację bez ponoszenia kosztów stałych i bez konieczności utrzymywania dedykowanego serwera płatności.

W kodzie Fluttera weryfikacja dostępu sprowadza się do prostego zapytania o uprawnienie:

import 'package:purchases_flutter/purchases_flutter.dart';

Future<bool> hasPremiumAccess() async {
  final customerInfo = await Purchases.getCustomerInfo();
  // The 'premium' entitlement is configured in the RevenueCat dashboard
  return customerInfo.entitlements.all['premium']?.isActive ?? false;
}

Future<CustomerInfo> restorePurchases() async {
  return Purchases.restorePurchases();
}

Wymóg formalny: wdrożenie RevenueCat wymaga aktualizacji deklaracji w sekcji Bezpieczeństwo danych w konsoli Google Play oraz w ankiecie prywatności w App Store Connect, ponieważ pakiet przetwarza identyfikatory transakcyjne. Pominięcie tego kroku może skutkować odrzuceniem aplikacji podczas weryfikacji w sklepie.

Schemat skrzyni skarbów obrazujący zakupy w aplikacji oraz architekturę uprawnień w RevenueCat

Zgody użytkowników: prawidłowa sekwencja UMP, RODO i Apple ATT

Zgodnie z wymogami Google wydawcy serwujący reklamy graczom w Europejskim Obszarze Gospodarczym (EOG), Wielkiej Brytanii i Szwajcarii muszą stosować certyfikowaną platformę zarządzania zgodami (CMP) zintegrowaną ze standardem IAB TCF 2.2. Google UMP (User Messaging Platform) to bezpłatna, certyfikowana platforma wbudowana bezpośrednio w konsolę AdMob.

Prawidłowe wdrożenie wymaga zachowania ścisłej kolejności wywołań:

  1. Weryfikacja statusu zgody przy starcie gry. Wywołaj requestConsentInfoUpdate(). Jeśli formularz jest wymagany (ConsentStatus.required), wyświetl go przed wysłaniem pierwszego zapytania o reklamę.
  2. Kolejność UMP i ATT w systemie iOS. Formularz Google UMP musi zostać wyświetlony przed systemowym oknem dialogowym Apple App Tracking Transparency (ATT). UMP ustala ramy prawne przetwarzania danych zgodnie z RODO, a ATT reguluje dostęp do identyfikatora reklamowego IDFA. Wywołanie obu okien jednocześnie sprawia, że iOS zablokuje jedno z nich, co skutkuje trwałą utratą zgody w danej sesji.
  3. Przycisk zmiany decyzji w opcjach gry. Europejskie przepisy wymagają, aby wycofanie zgody było tak samo proste jak jej udzielenie. W menu ustawień gry należy umieścić przycisk wywołujący metodę showPrivacyOptionsForm().
  4. Testowanie geolokalizacji. Aby przetestować zachowanie formularza z lokalizacji spoza EOG, ustaw parametr debugGeography na DebugGeography.debugGeographyEea na zarejestrowanych urządzeniach testowych. W wersjach produkcyjnych flagi debugowania muszą zostać bezwzględnie usunięte.

Jeśli gracz odmówi udzielenia zgody, monetyzacja reklamowa nie wyłącza się całkowicie: AdMob automatycznie serwuje niespersonalizowane reklamy kontekstowe. Mają one nieco niższy eCPM, ale nadal przynoszą przychód. Warto również skonfigurować wpisy SKAdNetworkItems w pliku Info.plist, co pozwala mierzyć skuteczność kampanii bez naruszania zasad prywatności Apple.

Schemat ścieżki zgód prywatności określający kolejność formularzy Google UMP i okna Apple ATT

Środowisko testowe i weryfikacja przed publikacją

Rzetelne przetestowanie ścieżek zakupowych i reklamowych zapobiega problemom po premierze gry:

  • Licencjonowani testerzy w Google Play: W konsoli Google Play zdefiniuj listę kont testerskich za pośrednictwem Google Play License Testers. Użytkownicy z tej listy realizują zakupy w realnym interfejsie płatniczym bez obciążania karty kredytowej, otrzymując prawidłowe paragony testowe.
  • Pliki konfiguracyjne StoreKit w Xcode: Na systemie iOS plik StoreKit Configuration (.storekit) pozwala symulować pełen cykl życia subskrypcji lokalnie: przyspieszone odnowienia, symulację wygasania, zwroty środków oraz błędy autoryzacji karty. Scenariusze wymagające w świecie rzeczywistym wielu tygodni przetestujesz w kilka sekund.
  • Bezpieczeństwo konta AdMob: Klikanie we własne reklamy produkcyjne to najczęstsza przyczyna zablokowania konta wydawcy. Na etapie programowania korzystaj wyłącznie z testowych jednostek reklamowych oraz zarejestruj identyfikatory urządzeń w parametrze testDeviceIds.

FAQ: Najczęściej zadawane pytania

Czy gra mobilna w Flutterze może utrzymać się wyłącznie z reklam?

W praktyce model oparty tylko na reklamach rzadko bywa wystarczający. Gracze chętnie płacą za usunięcie reklam oraz pakiety zasobów. Finansowanie gry wyłącznie reklamami zmusza twórców do zagęszczania przerw reklamowych, co obniża retencję i przynosi negatywne opinie w sklepach z aplikacjami.

Dlaczego po zakupie usunięcia reklam banery nadal się pokazują?

Najczęstszą przyczyną jest błąd synchronizacji stanu w kodzie. Zdarza się to, gdy aplikacja sprawdza uprawnienia tylko raz przy starcie bez nasłuchiwania strumienia purchaseStream w trakcie sesji, lub gdy polega na nieodświeżonej pamięci podręcznej. Każda aktualizacja uprawnień musi natychmiast odświeżać stan widżetów na ekranie.

Kiedy warto wprowadzić model subskrypcyjny w grze jednoosobowej?

Subskrypcja sprawdza się wtedy, gdy gra regularnie dostarcza nową wartość: codzienne wyzwania, stały przydział zasobów, brak reklam oraz systematycznie dodawane nowe pakiety poziomów. W przypadku gier o zamkniętej liczbie etapów lepsze wyniki przynosi jednorazowy zakup usunięcia reklam połączony z pakietami zasobów.


Polecane artykuły z naszego bloga technologicznego: skąd czerpać pomysły na gry, tworzenie gier w pojedynkę, optymalizacja wydajności gier w Flutterze oraz zarządzanie zapisem stanu gry.

Autor: Maksymilian Jackowski, założyciel Psittacus Studio i główny programista gier mobilnych w Psittacus Studio.

Polydocu - sudoku w formie przygody

Dziewięć cyfr, wyprawa przez dżunglę, papuga Poly i brak sztucznych blokad. Zapisz się na listę oczekujących, a wyślemy Ci powiadomienie o premierze.

Dołącz do listy oczekujących

Jeden e-mail przy premierze, bez spamu.

Trzy kolejne zapiski z tego samego notatnika, wybrane po temacie, a nie przez algorytm.

Wszystkie wpisy