Começar

A integração do SDK dos anúncios para dispositivos móveis do Google em um app é a primeira etapa exibir anúncios e gerar receita. Depois de integrar o SDK, será possível escolha um formato de anúncio, como vídeo nativo ou premiado, e siga as etapas para implementá-los.

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 21 ou superior
    • Compilar a versão do SDK do 33 ou superior

Configurar o app

  1. No arquivo de configurações do Gradle, inclua o Repositório Maven do Google e 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. Adicionar as dependências do SDK dos anúncios para dispositivos móveis do Google ao build no nível do app arquivo:

    Kotlin

    dependencies {
  implementation("com.google.android.gms:play-services-ads:23.3.0")
}

    Groovy

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

  3. Adicione o Ad Manager ID do seu aplicativo, conforme identificado no Ad Manager interface da Web, à interface AndroidManifest.xml. Para isso, adicione uma tag <meta-data> com android:name="com.google.android.gms.ads.APPLICATION_ID". Você pode encontrar o ID do app na Ad Manager interface da Web. Para android:value, insira seu Ad Manager ID do app entre aspas.

    <manifest>
  <application>
    <!-- Sample Ad Manager 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 aplicativo real, substitua o ID do aplicativo de exemplo pelo seu código real Ad Manager ID do app. Use o ID de amostra se: estiver apenas testando o SDK em um app Hello World.

    Além disso, se a tag <meta-data> não for adicionada exatamente aos resultados, em uma falha com a mensagem:

    Missing application ID.

    (Opcional) Declarar Permissão AD_ID para versões anteriores funcionarem com o Android 13.

    Se o app usa o SDK dos anúncios para dispositivos móveis do Google versão 20.4.0 ou mais recentes, poderá pular esta etapa, pois o SDK declara automaticamente o com.google.android.gms.permission.AD_ID e pode para acessar o ID de publicidade sempre que ele estiver disponível.

    Para aplicativos que usam o SDK dos anúncios para dispositivos móveis do Google versão 20.3.0 ou anterior e for destinado ao Android 13, adicione o com.google.android.gms.permission.AD_ID no arquivo AndroidManifest.xml do SDK dos anúncios para dispositivos móveis do Google para acessar 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 o declaração de permissão com.google.android.gms.permission.AD_ID, incluindo como desativá-lo, consulte este artigo Artigo do console.

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

Antes de carregar anúncios, inicialize o SDK dos anúncios para dispositivos móveis do Google chamando MobileAds.initialize()

Esse método inicializa o SDK e chama um listener de conclusão assim que o As inicializações do adaptador e do SDK dos anúncios para dispositivos móveis do Google foram 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 SDKs de parceiros de mediação. na inicialização. Se você precisa receber o consentimento de usuários na Europa Espaço Econômico (EEE), defina sinalizações específicas para solicitações, como: setTagForChildDirectedTreatment() ou setTagForUnderAgeOfConsent(), ou Faça isso antes de carregar os anúncios. SDK dos anúncios para dispositivos móveis do Google.

Confira um exemplo de como chamar o método initialize() em um segundo plano linha de execução em uma Activity:

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);

    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(this, initializationStatus -> {});
            })
        .start();
  }
}

Kotlin

import com.google.android.gms.ads.MobileAds
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) {}
    }
  }
}

Selecione 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. Ad Manager oferece vários formatos de anúncio diferentes. Portanto, você pode escolher a melhor opção para a experiência do usuário do seu app.

Os blocos de anúncios de banner exibem anúncios retangulares que ocupam uma parte do espaço o mesmo layout organizacional. Eles podem ser atualizados automaticamente após um determinado período. Isso significa que os usuários visualizam um novo anúncio em intervalos regulares, mesmo que permaneçam na mesma tela no seu app. Eles também são o formato de anúncio mais simples de implementar.

Implementar anúncios de banner

Intersticial

Os blocos de anúncios intersticiais exibem anúncios de página inteira no seu app. Coloque-as em um lugar pausas e transições na interface do app, como após a conclusão de um nível em um aplicativo de jogo.

Implementar anúncios intersticiais

Nativo

Os anúncios nativos são onde você pode personalizar a forma como os recursos, como títulos e calls-to-action são apresentadas nos seus apps. Ao criar o estilo do anúncio, é possível criam apresentações de anúncios naturais e discretas que podem agregar ainda mais valor para o usuário do usuário.

O Google Ad Manager oferece duas maneiras de implementar anúncios nativos: estilos nativos e anúncios nativos padrão com a renderização personalizada.

Os estilos nativos foram criados para simplificar a implementação de anúncios nativos. e é uma ótima escolha se você ainda não conhece o formato. A renderização personalizada projetada para maximizar a liberdade que você tem na criação de suas apresentações.

Implementar estilos nativos Implementar anúncios nativos (renderização personalizada)

Premiado

Com os blocos de anúncios premiados, os usuários podem jogar, responder a pesquisas ou assistir a vídeos para ganhar recompensas no app, como moedas, vidas extras ou pontos; Você pode definir prêmios diferentes para blocos de anúncios diferentes e especifica os valores do prêmio e itens que o usuário recebeu.

Implementar anúncios premiados

Intersticial premiado

O intersticial premiado é um novo tipo de formato de anúncio incentivado que permite Ofereça recompensas, como moedas ou vidas extras, por anúncios que aparecem automaticamente durante transições naturais do app.

Ao contrário dos anúncios premiados, os usuários não precisam ativar para ver um anúncio premiado. intersticial.

Em vez da solicitação de permissão em anúncios premiados, os intersticiais premiados exigem uma mensagem tela inicial que anuncia o prêmio e dá aos usuários a chance de recusar se: querem fazer isso.

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 sua app. O anúncio se sobrepõe à tela de carregamento.

Implementar anúncios de abertura do app

Outros recursos

O repositório de anúncios para dispositivos móveis do Google no GitHub demonstra como usar os diferentes formatos de anúncios que essa API oferece.