Começar

Selecione a plataforma: Android iOS Unity Flutter

A integração do 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, você pode escolher um formato de anúncio, como vídeo nativo ou premiado, e seguir 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 de 23 ou mais recente
    • Versão do SDK de compilação de 34 ou mais recente

Configurar o app na conta da AdMob

Siga estas etapas para registrar seu app como um app da AdMob:

  1. Faça login ou crie uma conta da AdMob.

  2. Registre seu app na AdMob. Essa etapa cria um app da AdMob com um ID exclusivo do app da AdMob 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 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 saber mais 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". Encontre o ID do app na interface da Web da AdMob. Para 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 pelo ID do app da AdMob. Durante os testes, use o ID de exemplo do app mostrado no exemplo anterior.

    Além disso, a falha na adição da 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 usar o SDK dos anúncios para dispositivos móveis do Google versão 20.4.0 ou mais recente, pule 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 anterior e que são destinados ao Android 13, é necessário adicionar 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 quando 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 pelos SDKs de parceiros de mediação após 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 linha de execução em segundo plano em 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. A AdMob oferece vários formatos de anúncio diferentes. Escolha o que melhor se adapta à experiência do usuário no seu app.

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 tempo definido. Isso significa que os usuários vão ver 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 são aqueles em que você pode personalizar a forma como recursos como títulos e calls-to-action são apresentados nos seus apps. Ao estilizar o anúncio, você pode criar apresentações de anúncios 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 podem jogar, responder a pesquisas ou assistir a vídeos para ganhar prêmios 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 aparecem automaticamente durante transições naturais 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 retornam ao app. O anúncio 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 de anúncio oferecidos pela API.