Começar

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, 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

  • Usar o Android Studio 3.2 ou posterior

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

    • Uma minSdkVersion 19 ou versões mais recentes.
    • A compileSdkVersion precisa ser definida como 28 ou versões mais recentes.

Configurar o app na conta da AdMob

Registre seu aplicativo como um aplicativo da AdMob concluindo as seguintes etapas:

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

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

Configurar o app

  1. No arquivo build.gradle 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 aplicativo do módulo, que geralmente é app/build.gradle:

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

  3. Adicione o AdMob ID do aplicativo (identificado na IU 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". É possível encontrar o ID do app na AdMob IU. Para android:value, insira o próprio AdMob ID do aplicativo 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 do app AdMob real, não o listado acima. Se você quer apenas testar o SDK em um aplicativo Hello World, use o exemplo de código de aplicativo mostrado acima.

    Observe também que a falha na 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.

    Se o app usa a versão 20.4.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google, ignore esta etapa, porque o SDK declara automaticamente a permissão com.google.android.gms.permission.AD_ID e pode acessar o código 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 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 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, faça com que seu app inicialize o SDK dos anúncios para dispositivos móveis do Google. Para isso, chame MobileAds.initialize(), que inicializa o 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 pelos 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 sinalizadores específicos de solicitações (como tagForChildDirectedTreatment ou tag_for_under_age_of_consent) 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.

Veja 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, pois isso garantirá 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 agora é importado e você está pronto para implementar um anúncio. OAdMob oferece vários formatos de anúncio diferentes para que você possa escolher o que melhor se ajusta à experiência do usuário do seu aplicativo.

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 aplicativo e podem ser atualizados automaticamente após um determinado período. Se você começou a usar os anúncios para dispositivos móveis agora, eles são um bom lugar para começar.

Implementar anúncios de banner

Intersticial

Anúncios em tela cheia que cobrem a interface de um aplicativo até serem fechados pelo usuário. Elas são mais úteis 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

São anúncios personalizáveis que combinam com a aparência do seu app. Você decide como e onde eles são posicionados. Assim, o layout fica mais consistente com o design do app.

Implementar anúncios nativos

Premiado

Anúncios que recompensam os usuários por assistir a 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 do Google para dispositivos móveis no GitHub demonstra como usar os diferentes formatos de anúncio oferecidos por essa API.