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 é a primeira etapa para exibir anúncios do Ad Manager e gerar receita. Quando a integração for concluída, você poderá escolher um formato de anúncio para conferir 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 à exibição de anúncios de banner, intersticiais (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. Se isso não for feito, o app apresentará falha 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 adicionando uma tag <meta-data> com o nome com.google.android.gms.ads.APPLICATION_ID. Encontre 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 o 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 logo 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.
  }
}

Selecione 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 superior ou inferior 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ê está começando na publicidade para dispositivos móveis, eles são um ótimo ponto de partida.

Implementar um anúncio de banner

Intersticial

Anúncios em 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 do seu app. Você decide como e onde eles serão colocados para que o layout fique mais consistente com o design do app.

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. É bom para gerar receita com usuários que acessam conteúdo sem custo financeiro.

Implementar um anúncio premiado