Começar

Integrar o SDK dos Anúncios para Dispositivos Móveis do Google (beta) a um app é a primeira etapa para exibir anúncios e gerar receita. Em seguida, 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: 24 ou mais recente
    • Versão do SDK de compilação: 35 ou mais recente
  • Para apps Kotlin, use a versão mínima 1.9.

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 (beta) ao arquivo de build do app:

    Kotlin

    dependencies {
  implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01")
}

    Groovy

    dependencies {
  implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01'
}

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

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

Chame MobileAds.initialize() para inicializar o SDK dos anúncios para dispositivos móveis do Google (Beta). Isso precisa ser chamado em uma linha de execução em segundo plano. Caso contrário, pode ocorrer um erro "O app não está respondendo" (ANR).

Kotlin

import com.google.android.libraries.ads.mobile.sdk.MobileAds
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

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

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize Google Mobile Ads SDK (beta) on a background thread.
      MobileAds.initialize(
        this@MainActivity,
        // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
        InitializationConfig.Builder("SAMPLE_APP_ID").build()
      ) {
        // Adapter initialization is complete.
      }
      // Other methods on MobileAds can now be called.
    }
  }
}

Java

import com.google.android.libraries.ads.mobile.sdk.MobileAds;
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig;

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

    new Thread(
            () -> {
              // Initialize Google Mobile Ads SDK (beta) on a background thread.
              MobileAds.initialize(
                  this,
                  // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
                  new InitializationConfig.Builder("SAMPLE_APP_ID")
                      .build(),
                  initializationStatus -> {
                    // Adapter initialization is complete.
                  });
              // Other methods on MobileAds can now be called.
            })
        .start();
  }
}

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 (beta) 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 (beta) ou SDKs de parceiros de mediação na inicialização. Se você precisar do consentimento de usuários no Espaço Econômico Europeu (EEE), defina flags específicas de solicitações, como RequestConfiguration.TagForChildDirectedTreatment ou RequestConfiguration.TagForUnderAgeOfConsent, ou tome outras medidas antes de carregar os anúncios. Faça isso antes de inicializar o SDK dos Anúncios para Dispositivos Móveis do Google (beta).

Selecione um formato de anúncio

O SDK dos anúncios para dispositivos móveis do Google (beta) foi importado. 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

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 ou voltam para seu app. Ele se sobrepõe à tela de carregamento.

Implementar anúncios de abertura do app