Configurar o plug-in dos anúncios para dispositivos móveis do Google para Flutter

Selecione a plataforma: Android iOS Unity Flutter Android (legada)

Para veicular anúncios e gerar receita, integre o Google Mobile Ads Flutter Plugin ao app Flutter. Para preparar seu projeto, importe e inicialize o Google Mobile Ads Flutter Plugin antes de solicitar anúncios.

Este guia aborda a importação e inicialização do Google Mobile Ads Flutter Plugin e a seleção de um formato de anúncio.

Pré-requisitos

Antes de continuar, você precisa do seguinte:

Flutter versão 3.38.1 ou mais recente.
Para Android, a versão mais recente do Android Studio.
Para iOS, a versão mais recente do Xcode com as ferramentas de linha de comando ativadas. Para mais detalhes, consulte Instalar o Flutter.
Um ID do app da AdMob. Para mais detalhes, consulte Encontrar e copiar um ID de app ou do bloco de anúncios.

Importar o Google Mobile Ads Flutter Plugin

Para importar o Google Mobile Ads Flutter Plugin no seu projeto do Flutter, consulte google_mobile_ads.

Configurar o app

Depois de importar o Google Mobile Ads Flutter Plugin, selecione uma das seguintes plataformas para configurar seu app:

Android

No Android Studio, navegue até o arquivo android/app/src/main/AndroidManifest.xml.
No arquivo AndroidManifest.xml, adicione uma tag <meta-data> à tag <application> com as seguintes propriedades:
```
<manifest>
    <application>
        
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    <application>
<manifest>
```
Essas propriedades precisam ter estes valores:
- android:name: com.google.android.gms.ads.APPLICATION_ID.
- android:value: o ID do seu app da AdMob.
Para detalhes sobre a configuração do arquivo AndroidManifest.xml, consulte Configurar o Google Mobile Ads SDK (Legacy).

iOS

No Xcode, navegue até o arquivo ios/Runner/Info.plist.
No arquivo Info.plist, adicione uma chave GADApplicationIdentifier com o ID do app da AdMob como uma string.
```
<key>GADApplicationIdentifier</key>
<string>ca-app-pub-################~##########</string>
```
Para detalhes sobre como configurar um arquivo Info.plist, consulte Atualizar Info.plist.

Inicializar o Google Mobile Ads Flutter Plugin

Antes de carregar anúncios, chame MobileAds.instance.initialize() para inicializar o Google Mobile Ads Flutter Plugin.

Esse método retorna um Future que é concluído após a inicialização do Google Mobile Ads Flutter Plugin ou após 30 segundos.

O exemplo a seguir inicializa o Google Mobile Ads Flutter Plugin:

// Initialize the Mobile Ads SDK.
MobileAds.instance.initialize();main.dart

Selecione um formato de anúncio

Depois de importar o Google Mobile Ads Flutter Plugin, você pode selecionar um formato de anúncio para implementar. A AdMob oferece os seguintes formatos:

Formato do anúncio	Descrição	Documentação
Banner	Mostra anúncios retangulares em uma área designada. Esses anúncios são atualizados automaticamente. Assim, os usuários veem a publicidade enquanto permanecem na mesma tela.	Configurar anúncios de banner
Intersticial	Mostra anúncios de página inteira no seu app. Posicione esses anúncios em pontos de transição naturais, como entre as fases de um jogo.	Anúncios intersticiais
Nativo	Permite personalizar recursos, como títulos e calls-to-action, nos seus apps. Ao personalizar o anúncio, você cria uma publicidade que combina com o design visual do app.	Carregar um anúncio nativo
Premiado	Permite que os usuários assistam vídeos ou respondam a pesquisas para ganhar recompensas no app, como moedas ou vidas extras. Para cada bloco de anúncios, é possível especificar valores de recompensa.	Anúncios premiados
Intersticial premiado	Permite oferecer recompensas, como moedas ou vidas extras, em anúncios que são mostrados durante as transições do app.	Anúncios intersticiais premiados
Abertura do app	Aparece quando os usuários abrem ou voltam para o app. O anúncio se sobrepõe à tela de carregamento.	Anúncios de abertura do app