Começar

Selecione a plataforma: Android iOS Unity Flutter

Integrar o SDK dos anúncios para dispositivos móveis do Google a um app é a primeira etapa para exibir anúncios e gerar receita. Depois de integrar o SDK, escolha um formato de anúncio, como vídeo nativo ou premiado, e siga as etapas para implementá-lo.

Antes de começar

Para preparar o app, siga as etapas nas seções a seguir.

Pré-requisitos do app

  • O arquivo de build do app precisa usar estes valores:

    • Versão mínima do SDK: 23 ou mais recente
    • Versão do SDK de compilação: 34 ou mais recente

Configurar o app na conta da AdMob

Siga estas etapas para registrar o aplicativo como um app da AdMob:

  1. Faça login ou se inscreva em uma conta da AdMob.

  2. Registre seu app na AdMob. Essa etapa cria um ID do app da AdMob exclusivo, que será necessário mais adiante neste guia.

Configurar o app

  1. No arquivo de configurações do Gradle, inclua o repositório Maven do Google e o repositório central Maven:

    Kotlin

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include(":app")

    Groovy

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include ':app'

  2. Adicione as dependências do SDK dos anúncios para dispositivos móveis do Google ao arquivo de build do app:

    Kotlin

    dependencies {
  implementation("com.google.android.gms:play-services-ads:24.5.0")
}

    Groovy

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:24.5.0'
}

  3. Clique em Sync Now. Para mais detalhes sobre sincronização, consulte Sincronizar projetos com arquivos do Gradle.

  4. Adicione o ID do app da AdMob, como identificado na interface da Web da AdMob, ao arquivo AndroidManifest.xml do app. Para fazer isso, adicione uma tag <meta-data> com android:name="com.google.android.gms.ads.APPLICATION_ID". O ID do app aparece na interface da Web da AdMob. Em android:value, insira seu próprio ID do app da AdMob entre aspas.

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

    Substitua SAMPLE_APP_ID por esse ID. Durante o teste, use o ID do app de exemplo mostrado no exemplo anterior.

    Caso você não adicione a tag <meta-data> exatamente como ela aparece, vai ocorrer uma falha e esta mensagem será mostrada:

    Missing application ID.

    (Opcional) Declare a permissão AD_ID para que versões anteriores funcionem com o Android 13.

    Se o app usa a versão 20.4.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google, pule essa etapa. O SDK declara automaticamente a permissão com.google.android.gms.permission.AD_ID e pode acessar o ID de publicidade sempre que ele estiver disponível.

    Para apps que usam a versão 20.3.0 ou anterior do SDK dos anúncios para dispositivos móveis do Google e segmentam o Android 13, adicione a permissão com.google.android.gms.permission.AD_ID no arquivo AndroidManifest.xml para que o SDK acesse o ID de publicidade:

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

   <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
   <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

 </application>
</manifest>

    Para saber mais sobre a Declaração de Permissões com.google.android.gms.permission.AD_ID, inclusive como desativá-la, consulte este artigo do Play Console.

Inicializar o SDK dos anúncios para dispositivos móveis do Google

Antes de carregar anúncios, chame MobileAds.initialize() para inicializar o SDK dos anúncios para dispositivos móveis do Google.

Esse método inicializa o SDK e chama um listener de conclusão depois das inicializações do SDK dos anúncios para dispositivos móveis do Google e do adaptador ou após um tempo limite de 30 segundos. Isso só precisa ser feito uma vez, de preferência na inicialização do app.

Os anúncios podem ser pré-carregados pelo SDK dos anúncios para dispositivos móveis do Google ou de parceiros de mediação na inicialização. Se você precisar do consentimento de usuários no Espaço Econômico Europeu (EEE), definir flags específicas de solicitações, como setTagForChildDirectedTreatment() ou setTagForUnderAgeOfConsent(), ou entrar em ação antes de carregar os anúncios, faça isso antes de inicializar o SDK dos anúncios para dispositivos móveis do Google.

Confira um exemplo de como chamar o método initialize() em uma linha de execução em segundo plano dentro de uma atividade:

Java

new Thread(
        () -> {
          // Initialize the Google Mobile Ads SDK on a background thread.
          MobileAds.initialize(this, initializationStatus -> {});
        })
    .start();
MyActivity.java

Kotlin

CoroutineScope(Dispatchers.IO).launch {
  // Initialize the Google Mobile Ads SDK on a background thread.
  MobileAds.initialize(this@MainActivity) {}
}
MainActivity.kt

Selecionar um formato de anúncio

O SDK dos anúncios para dispositivos móveis do Google foi importado e você já pode implementar um anúncio. Na AdMob, há vários formatos diferentes de anúncio. Escolha a opção que melhor se ajusta à experiência do usuário no seu aplicativo.

Os blocos de anúncios de banner mostram anúncios retangulares que ocupam uma parte do layout de um app. Eles podem ser atualizados automaticamente após um período definido. Isso significa que é veiculado um novo anúncio em intervalos regulares, mesmo que os usuários permaneçam na mesma tela do aplicativo. Esse é o formato mais simples de implementar.

Implementar anúncios de banner

Intersticial

Os blocos de anúncios intersticiais mostram anúncios de tela cheia no seu app. Posicione-os em intervalos e transições naturais da interface, por exemplo, após a conclusão de uma fase em um app de jogo.

Implementar anúncios intersticiais

Nativo

Nos anúncios nativos, você personaliza a forma como os recursos, como títulos e calls-to-action, são apresentados nos seus apps. Ao estilizar o anúncio, você cria apresentações naturais e discretas que contribuem para uma experiência do usuário mais imersiva.

Implementar anúncios nativos

Premiado

Com os blocos de anúncios premiados, os usuários conseguem jogar, responder a pesquisas ou assistir vídeos para ganhar recompensas no app, como moedas, vidas extras ou pontos. É possível definir prêmios diferentes para cada bloco de anúncios e especificar os valores e itens que o usuário recebeu.

Implementar anúncios premiados

Intersticial premiado

O intersticial premiado é um novo tipo de formato de anúncio com incentivos que permite oferecer recompensas, como moedas ou vidas extras, em anúncios que são exibidos automaticamente em pontos de transição natural no app.

Diferente dos anúncios premiados, os usuários não precisam ativar a visualização dos intersticiais premiados.

Em vez de exibir um comando de ativação como nos anúncios premiados, os intersticiais premiados têm uma tela de introdução que mostra a recompensa e permite aos usuários recusar a oferta.

Implementar anúncios intersticiais premiados

Abertura do app

O anúncio de abertura do app é um formato que aparece quando os usuários abrem seu app ou voltam para ele. Ele se sobrepõe à tela de carregamento.

Implementar anúncios de abertura do app

Outros recursos

O repositório de anúncios para dispositivos móveis do Google no GitHub demonstra como usar os diferentes formatos oferecidos por essa API.