Começar

Este guia é destinado a editores que querem gerar receita com um app do Flutter.

A integração do SDK dos anúncios para dispositivos móveis do Google a um app do Flutter, que você vai fazer aqui, é a primeira etapa para mostrar anúncios do Ad Manager e gerar receita. Depois que a integração for concluída, você poderá escolher um formato de anúncio para conferir as etapas detalhadas de implementação.

No momento, o SDK dos anúncios para dispositivos móveis do Google para Flutter oferece suporte ao carregamento e à veiculação de anúncios de banner, intersticiais (em tela cheia), nativos e premiados.

Pré-requisitos

  • Flutter 1.22.0 ou mais recente
  • Android
    • Android Studio 3.2 ou versões mais recentes
    • Segmentar o nível 20 da API do Android ou mais recente
    • Definir compileSdkVersion como 28 ou maior
  • iOS

Importar o SDK dos anúncios para dispositivos móveis

Configuração específica da plataforma

Android

Atualizar o AndroidManifest.xml.

O ID do app do Ad Manager precisa ser incluído no AndroidManifest.xml. Caso contrário, o app vai falhar na inicialização.

Adicione o ID do app do Ad Manager (identificado na interface do Ad Manager) ao arquivo android/app/src/main/AndroidManifest.xml do app. Para isso, adicione uma tag <meta-data> com o nome com.google.android.gms.ads.APPLICATION_ID. Você encontra o ID do app na interface do Ad Manager. Para android:value, insira seu próprio ID do app do Ad Manager entre aspas, conforme mostrado:

<manifest>
    <application>
        <!-- Sample app ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    <application>
<manifest>

Use o mesmo value ao inicializar o plug-in no código Dart.

Consulte o guia do Android para mais informações sobre como configurar AndroidManifest.xml e o ID do app.

iOS

Atualizar o Info.plist

No arquivo ios/Runner/Info.plist do seu app, adicione uma chave GADApplicationIdentifier com um valor de string do ID do app do Ad Manager (identificado na interface do Ad Manager):

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-################~##########</string>

É necessário transmitir o mesmo valor ao inicializar o plug-in no código Dart.

Consulte o guia do iOS para mais informações sobre como configurar Info.plist e o ID do app.

Inicializar o SDK de anúncios para dispositivos móveis

Antes de carregar anúncios, faça com que seu app inicialize o SDK dos anúncios para dispositivos móveis chamando MobileAds.instance.initialize(), que inicializa o SDK e retorna um Future que é concluído assim que a inicialização é concluída (ou após um tempo limite de 30 segundos). Isso precisa ser feito apenas uma vez, de preferência antes de executar o app.

import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:flutter/material.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  MobileAds.instance.initialize();

  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  @override
  MyAppState createState() => MyAppState();
}

class MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    // Load ads.
  }
}

Selecionar um formato de anúncio

O SDK dos anúncios para dispositivos móveis foi importado, e você já pode implementar um anúncio. O Ad Manager oferece vários formatos de anúncio diferentes para que você possa escolher o que melhor se adapta à experiência do usuário do seu app.

Anúncios retangulares que aparecem na parte de cima ou de baixo da tela do dispositivo. Os anúncios de banner permanecem na tela enquanto os usuários interagem com o app e podem ser atualizados automaticamente após um determinado período. Se você começou a usar os anúncios para dispositivos móveis agora, saiba que eles são um bom lugar para começar.

Implementar um anúncio de banner

Intersticial

Anúncios de tela cheia que cobrem a interface de um app até serem fechados pelo usuário. Eles são mais indicados para pausas naturais no fluxo de execução de um app, como entre os níveis de um jogo ou logo após a conclusão de uma tarefa.

Implementar um anúncio intersticial

Nativo

Anúncios personalizáveis que combinam com a aparência e o tom do seu app. Você decide como e onde eles aparecem. Assim, o layout fica mais consistente com o design do aplicativo.

Implementar um anúncio nativo

Premiado

Anúncios que recompensam os usuários por assistir a vídeos curtos e interagir com anúncios jogáveis e pesquisas. Eles são ideais para gerar receita com usuários que acessam conteúdo gratuito.

Implementar um anúncio premiado