App Open

Integração

Abaixo mostramos alguns exemplos simples para implementar os anúncios App Open seguindo as duas formas de integração possíveis:

Manual

import 'package:wortise/app_open_ad.dart';

AppOpenAd _appOpenAd;

// Cria um App Open
_appOpenAd = AppOpenAd('Ad Unit ID da Wortise', listener: (event, args) {
  // Este listener será invocado quando ocorrer um evento
});

// Solicita um anúncio
await _appOpenAd.loadAd();

/* ... */

// Exibe o anúncio, se estiver disponível
if (await _appOpenAd.isAvailable) {
  await _appOpenAd.showAd();
}

O construtor da classe AppOpenAd permite especificar os seguintes parâmetros opcionais para configurar seu comportamento:

// Define se um novo anúncio deve ser carregado após fechar o anterior
autoReload: true

Como alternativa, o método tryToShowAd() pode ser usado para exibir o anúncio, com a diferença de que, se não houver nenhum disponível, o carregamento de um novo anúncio é solicitado automaticamente.

await _appOpenAd.tryToShowAd();

Via Manager

import 'package:wortise/app_open_ad.dart';
import 'package:wortise/app_open_manager.dart';

// Cria um App Open
AppOpenAd appOpenAd = AppOpenAd('Ad Unit ID da Wortise')..loadAd();

// Registra o anúncio no manager
AppOpenManager.register(appOpenAd);

Nessa integração, os anúncios serão exibidos automaticamente quando o app passar do segundo plano para o primeiro plano. Além disso, os métodos oferecidos por AppOpenAd ainda podem ser usados para exibir anúncios sob demanda.

Eventos do listener

O listener atribuído a um AppOpenAd pode receber os seguintes eventos:

// O anúncio foi clicado
AppOpenAdEvent.CLICKED
// O anúncio foi fechado
AppOpenAdEvent.DISMISSED
// Não foi possível carregar o anúncio
AppOpenAdEvent.FAILED_TO_LOAD
// Não foi possível exibir o anúncio
AppOpenAdEvent.FAILED_TO_SHOW
// O anúncio gerou uma impressão
AppOpenAdEvent.IMPRESSION
// O anúncio foi carregado
AppOpenAdEvent.LOADED
// O anúncio gerou receita
AppOpenAdEvent.REVENUE_PAID
// O anúncio foi exibido
AppOpenAdEvent.SHOWN