Anúncios (AdMob)

Anúncios Google AdMob nos 4 formatos, nos 3 backends. Só nativo (iOS/Android). Na web, toda chamada de anúncio vira um no-op silencioso: o mesmo código roda em qualquer plataforma sem quebrar.

Assinante ativo não vê banner nem interstitial. Os recompensados ficam porque o usuário escolhe assistir para ganhar algo.

ImplementaçãoCopiar link da âncora

O módulo de anúncios já vem ligado no modo Rápido do kasy new, e funciona em debug com anúncios de teste sem nenhuma configuração (veja Informações). Estes passos são para colocar em produção com IDs reais.

1. Em projeto existente, confirme que o módulo está ligado:

   Copiar texto

   kasy add ads        # adiciona (pede os IDs opcionalmente)
   kasy remove ads     # remove
   kasy add --list     # mostra o que está ligado

2. Crie a conta e o app no AdMob:

   1. Acesse admob.google.com
   2. Crie sua conta → Add App → selecione iOS ou Android
   3. Copie o App ID (ex.: ca-app-pub-XXXXXX~YYYYYYY)
   4. Crie unidades de anúncio para cada formato → copie os Ad Unit IDs

   

3. Configure no projeto:

   Copiar texto

   kasy configure

   O comando abre o console AdMob no navegador e pede:

   • App IDs (por plataforma) → gravados em Info.plist e strings.xml
   • Ad Unit IDs (8 valores: 4 formatos × 2 plataformas) → gravados no .env
   Pelo MCP: com os IDs em mãos, cole-os no chat e peça "configura os IDs do AdMob". O assistente roda configure_project_keys por você. Veja MCP do Kasy.

4. Para os formatos recompensados (rewarded e rewarded interstitial), configure a verificação no servidor (SSV). Banner e interstitial não precisam.

   O kit já tem os endpoints prontos nos 3 backends:

   Backend	Endpoint
   Firebase	ads-verifyAdReward (Cloud Function)
   Supabase	verify-ad-reward (Edge Function)
   API (seu servidor)	GET /ads/verify-reward

   1. Faça o deploy do endpoint (kasy deploy no Firebase, pelo MCP: deploy_backend; supabase functions deploy no Supabase)
   2. Copie a URL do endpoint
   3. AdMob Console → seu app → cada unidade de rewarded → SSV → cole a URL

   

5. Gere o build de release:

   Copiar texto

   kasy ios release       # iOS
   flutter build appbundle --release --dart-define=ENV=prod   # Android

   Pelo MCP: "publica o iOS" (release_ios).

InformaçõesCopiar link da âncora

Testar agora (debug, zero config)Copiar link da âncora

Em kasy run, qualquer formato mostra anúncios de teste do Google automaticamente. Pode tocar à vontade, sem risco, sem precisar de conta no AdMob.

Usar no códigoCopiar link da âncora

BannerCopiar link da âncora

Uma linha, onde você quiser:

const KasyAdBanner()

Para o retângulo médio:

const KasyAdBanner(size: KasyAdBannerSize.mediumRectangle)

InterstitialCopiar link da âncora

final ads = ref.read(googleAdsProvider.notifier);

// Mostra com cooldown (padrão 50s entre exibições):
await ads.showInterstitialIfElapsed();

// Força sem cooldown:
await ads.showInterstitial();

Rewarded e Rewarded interstitialCopiar link da âncora

O usuário assiste ao anúncio e ganha uma recompensa. A recompensa é verificada no servidor (SSV): nunca credite com base só no callback do cliente.

await ads.showRewarded(
  onReward: (reward) {
    // Só UI otimista. O crédito real vem do servidor (SSV).
  },
);

await ads.showRewardedInterstitial(onReward: (reward) { /* … */ });

As 8 variáveis do .envCopiar link da âncora

Deixe em branco para usar anúncios de teste em debug (nada em release):

ADMOB_ANDROID_BANNER=
ADMOB_IOS_BANNER=
ADMOB_ANDROID_INTERSTITIAL=
ADMOB_IOS_INTERSTITIAL=
ADMOB_ANDROID_REWARDED=
ADMOB_IOS_REWARDED=
ADMOB_ANDROID_REWARDED_INTERSTITIAL=
ADMOB_IOS_REWARDED_INTERSTITIAL=

Os App IDs (ADMOB_ANDROID_APP_ID / ADMOB_IOS_APP_ID) não ficam no .env: o kasy configure os grava direto no nativo.

Demo no AdminCopiar link da âncora

Para ver os 4 formatos funcionando em qualquer build (até release):

1. Abra o console Admin (toque duas vezes no número de versão em Configurações)
2. Vá em Depuração → Demo de anúncios

A demo sempre usa anúncios de teste, mesmo em produção com IDs reais configurados. Isso é intencional: clicar no seu próprio anúncio real conta como "atividade inválida" no AdMob e pode banir sua conta.

Atualizado em 03/11/2026