Começar

Selecione a plataforma: Android iOS Unity Flutter

Integrar o SDK dos anúncios para dispositivos móveis do Google a um app é o primeiro passo para exibir anúncios e gerar receita. Depois de integrar o SDK, escolha um formato de anúncio, como um 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

Para registrar seu app como um app da AdMob, siga estas etapas:

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

  2. Registre seu app na AdMob. Essa etapa cria um app da AdMob com 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 do 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 no nível do app:

    Kotlin

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

    Groovy

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

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

  4. Adicione o ID do app da AdMob, conforme 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". Você encontra o ID do app na interface da Web da AdMob. Para android:value, insira seu próprio ID do app da AdMob, que fica 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 pelo ID do app da AdMob. Durante o teste, use o ID do app de exemplo mostrado no exemplo anterior.

    Além disso, observe que a falha ao adicionar a tag <meta-data> exatamente como mostrado resulta em uma falha com a mensagem:

    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, você pode pular esta etapa, já que 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 o SDK dos anúncios para dispositivos móveis do Google versão 20.3.0 ou inferior e segmentam o Android 13, adicione a permissão com.google.android.gms.permission.AD_ID no arquivo AndroidManifest.xml para que o SDK dos anúncios para dispositivos móveis do Google 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ão com.google.android.gms.permission.AD_ID, incluindo como desativá-la, consulte este artigo do Play Console.

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

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

Esse método inicializa o SDK e chama um listener de conclusão depois que as inicializações do SDK dos anúncios para dispositivos móveis do Google e do adaptador são concluídas ou após um tempo limite de 30 segundos. Isso precisa ser feito apenas 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 SDKs de parceiros de mediação durante a inicialização. Se você precisar do consentimento de usuários no Espaço Econômico Europeu (EEE), defina sinalizadores específicos de solicitações, como setTagForChildDirectedTreatment() ou setTagForUnderAgeOfConsent(), ou aja 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 thread 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

Selecione 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 parte do layout de um app. Eles podem ser atualizados automaticamente após um tempo definido. Isso significa que os usuários veem um novo anúncio em intervalos regulares, mesmo que permaneçam na mesma tela do app. 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

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

Implementar anúncios nativos

Premiado

Com os blocos de anúncios premiados, os usuários conseguem jogar, responder a pesquisas ou assistir a 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 de um intersticial premiado.

Em vez de exibir uma tela 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

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

Implementar anúncios de abertura do app

Outros recursos

O repositório do Google Mobile Ads no GitHub demonstra como usar os diferentes formatos de anúncio oferecidos por essa API.