Este guia mostra como pôr um anúncio a aparecer numa app Flutter, primeiro em modo de teste e depois a sério. Não precisa de conta de pagamento nem de cartão para chegar ao fim.
O que precisa
- Uma app Flutter 3.10 ou mais recente (Dart 3).
- Uma conta adPluga, grátis.
- Dois minutos no painel para criar a chave e o espaço.
1. Crie a chave e o espaço no painel
- Em Propriedades, crie a propriedade da sua app.
- Em Slots, crie um espaço, por exemplo um banner 320×50 na parte de baixo do ecrã. Guarde o identificador do slot.
- Em Integração, copie a chave publicável de teste. Começa por
pk_test_.
A chave de teste mostra anúncios a sério na sua app, mas nada é cobrado, nada é pago e nada conta para a quota.
2. Instale o SDK
flutter pub add adpluga_flutter
O pacote funciona em Android e iOS.
3. Inicialize uma vez
Faça-o no arranque da app, antes de mostrar qualquer anúncio:
import 'package:adpluga_flutter/adpluga_flutter.dart';
Future<void> main() async {
WidgetsFlutterBinding.ensureInitialized();
await AdPluga.initialize(publisherKey: 'pk_test_...');
runApp(const MyApp());
}
4. Mostre um banner
O banner é um widget como outro qualquer. Ponha-o onde quer que o anúncio apareça:
AdPlugaBanner(
slotId: 'o-id-do-seu-slot',
onImpression: () {},
onClick: () {},
onError: (err) {},
)
Quando ainda não há anunciantes para esse espaço, aparece um anúncio da própria adPluga. O espaço nunca fica vazio.
5. Mostre um intersticial
Um intersticial ocupa o ecrã todo entre dois momentos da app, por exemplo no fim de um nível:
final ad = await InterstitialAd.load(slotId: 'o-id-do-slot-intersticial');
await ad.show(context);
O SDK também tem formatos nativo, com recompensa e carrossel.
6. Passe a real
Quando tudo funcionar em teste, troque pk_test_ por pk_live_. Para usar a chave real, confirme primeiro no painel que a propriedade é sua. Não pedimos cartão para isso: o plano grátis serve em real até 100 mil decisões por mês, e uma decisão é cada pedido de anúncio que a app faz.
Já usa o AdMob?
Não precisa de o tirar. Na Mediação do painel, junte o AdMob e outras redes (Meta, InMobi, Unity, Liftoff) e deixe-as competir pelo mesmo espaço com a adPluga. Ganha a melhor oferta de cada vez. A página alternativa ao AdMob explica como.
A referência completa dos SDKs está em SDKs e o caminho mais curto em Quickstart.