Começar

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 24 ou mais recente
    • Versão do SDK de compilação de 35 ou mais recente
  • Para apps Kotlin, use a versão mínima 1.9.

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.libraries.ads.mobile.sdk:ads-mobile-sdk:0.17.0-alpha01")
}

    Groovy

    dependencies {
  implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.17.0-alpha01'
}

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

Inicializar o SDK de anúncios do Google para dispositivos móveis

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

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 the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(
        this@MainActivity,
        // Sample Ad Manager 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 the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(
                  this,
                  // Sample Ad Manager 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 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 RequestConfiguration.TagForChildDirectedTreatment ou RequestConfiguration.TagForUnderAgeOfConsent, 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.

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. O Ad Manager 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

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