Começar

Integrar o SDK de última geração do GMA a 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:

  • 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 da GMA de próxima geração 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 a sincronização, consulte Sincronizar projetos com arquivos do Gradle.

Inicializar o SDK do GMA de última geração

Importante: você precisa inicializar o SDK do GMA de próxima geração antes de carregar anúncios e interagir com outros métodos MobileAds, a menos que esteja explicitamente indicado nos documentos de referência da API (consulte getVersion()). Caso contrário, um UninitializedPropertyAccessException pode ser gerado.

Chame MobileAds.initialize() para inicializar o SDK do GMA de próxima geração. 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 GMA Next Gen SDK 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 GMA Next Gen SDK 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 da próxima geração do GMA 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.

Observação: se você estiver usando a Mediação da AdMob, só carregue anúncios depois que o gerenciador de conclusão for chamado. Isso garante que todos os adaptadores de mediação sejam inicializados.

Os anúncios podem ser pré-carregados pelo SDK GMA Next Gen 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), definir flags específicas de solicitações, como RequestConfiguration.TagForChildDirectedTreatment ou RequestConfiguration.TagForUnderAgeOfConsent, ou entrar em ação antes de carregar os anúncios, faça isso antes de inicializar o SDK de última geração do GMA.

Selecione um formato de anúncio

O SDK de última geração do GMA 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.

Banner

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