Começar

A integração do SDK dos anúncios para dispositivos móveis do Google em 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:

    • minSdkVersion de 19 ou mais
    • compileSdkVersion de 33 ou mais

Configurar o app na conta da AdMob

Registre seu app como um app da AdMob seguindo estas etapas:

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

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

Configurar o app

  1. No arquivo build.gradle no nível do projeto, inclua o repositório Maven do Google e o repositório Maven central nas seções buildscript e allprojects:

    buildscript {
    repositories {
        google()
        mavenCentral()
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

  2. Adicione as dependências do SDK dos anúncios para dispositivos móveis do Google ao arquivo Gradle no nível do app do módulo, normalmente app/build.gradle:

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

  3. Adicione o AdMob ID do app, conforme identificado na interface da Web AdMob, ao arquivo AndroidManifest.xml do seu 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 AdMob interface da Web. Para android:value, insira seu próprio AdMob ID do app, 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="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
  </application>
</manifest>

    Em um app real, use o ID real AdMob do app, não o listado acima. Se você quiser apenas testar o SDK em um app Hello World, use o exemplo de ID do app mostrado acima.

    Observe também que a não adição da tag <meta-data>, conforme mostrado acima, resulta em uma falha com a mensagem:

    The Google Mobile Ads SDK was initialized incorrectly.

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

    Caso seu app use o SDK dos anúncios para dispositivos móveis do Google versão 20.4.0 ou mais recente, pule esta etapa, porque 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 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 os anúncios, faça com que o app inicialize o SDK dos anúncios para dispositivos móveis do Google chamando MobileAds.initialize(), que faz a inicialização do SDK e chama um listener de conclusão quando a inicialização é concluída 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 dos parceiros de mediação ao chamar MobileAds.initialize(). Se você precisar do consentimento de usuários no Espaço Econômico Europeu (EEE), defina sinalizações específicas de solicitações, como tagForChildDirectedTreatment ou tag_for_under_age_of_consent, ou aja antes de carregar 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 atividade:

Exemplo de MainActivity (trecho)

Java

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        MobileAds.initialize(this, new OnInitializationCompleteListener() {
            @Override
            public void onInitializationComplete(InitializationStatus initializationStatus) {
            }
        });
    }
}

Kotlin

import com.google.android.gms.ads.MobileAds

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        MobileAds.initialize(this) {}
    }
}

Se você estiver usando a mediação, aguarde até que o gerenciador de conclusão seja chamado antes de carregar anúncios. Isso garante que todos os adaptadores de mediação sejam inicializados.

Selecione um formato de anúncio

O SDK dos anúncios para dispositivos móveis do Google foi importado e está tudo pronto para implementar um anúncio. OAdMob oferece vários formatos de anúncio diferentes para que você possa escolher o mais adequado à 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ê não tem experiência com anúncios para dispositivos móveis, eles são um ótimo ponto de partida.

Implementar anúncios de banner

Intersticial

Anúncios em tela cheia que cobrem a interface de um app até serem fechados pelo usuário. Eles são melhor usados em 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 anúncios intersticiais

Nativo

Anúncios personalizáveis que combinam com a aparência do seu app. Você decide como e onde eles serão colocados, tornando o layout mais consistente com o design do app.

Implementar anúncios nativos

Premiado

Anúncios que recompensam os usuários por assistir vídeos curtos e interagir com pesquisas e anúncios jogáveis. Usado para gerar receita com apps sem custo financeiro.

Implementar anúncios premiados

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 que essa API oferece.