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, 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 de 19 ou mais recente
    • Compilar a versão do SDK de 33 ou mais recente

Configurar o app

  1. No arquivo build.gradle no nível 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 do módulo do app, normalmente app/build.gradle:

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:23.0.0'
    }
    
  3. Adicione o Ad Manager ID do app, conforme identificado na interface da Web Ad Manager, ao arquivo AndroidManifest.xml do app. Para fazer isso, adicione uma tag <meta-data> com android:name="com.google.android.gms.ads.APPLICATION_ID". Encontre o ID do app na interface da Web do Ad Manager . Para android:value, insira o próprio 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 app real, substitua o ID do app de exemplo pelo ID Ad Manager real. Use o ID de amostra se estiver apenas testando o SDK em um app Hello World.

    Além disso, se você não adicionar a tag <meta-data> exatamente como mostrado, ocorrerá 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, pule esta etapa, porque o SDK declara automaticamente a permissão com.google.android.gms.permission.AD_ID e pode acessar o ID de publicidade sempre que ela 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 segmentam o Android 13, é necessário adicionar a permissão com.google.android.gms.permission.AD_ID ao arquivo AndroidManifest.xml para que o SDK dos anúncios para dispositivos móveis do Google 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ões 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, 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 as inicializações do SDK e do adaptador dos anúncios para dispositivos móveis do Google 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 SDKs do parceiro de mediação na inicialização. Se você precisar do consentimento de usuários no Espaço Econômico Europeu (EEE), defina sinalizações específicas de solicitações, como setTagForChildDirectedTreatment() ou setTagForUnderAgeOfConsent(), . Caso contrário, faça isso antes de inicializar o SDK dos anúncios para dispositivos móveis do Google.

Confira um exemplo de como chamar o método initialize() em uma atividade:

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) {}
  }
}

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. OAd Manager oferece vários formatos de anúncio diferentes para que você possa escolher o que melhor se adapta à experiência do usuário do seu app.

Os blocos de anúncios de banner exibem 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 os usuários visualizam um novo anúncio em intervalos regulares, mesmo que fiquem na mesma tela do app. 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 aplicativo. Posicione-os em intervalos e transições naturais na interface do aplicativo, como após a conclusão de uma fase em um aplicativo de jogo.

Implementar anúncios intersticiais

Nativo

Nos anúncios nativos, é possível personalizar a forma como os recursos, como títulos e calls-to-action, são apresentados nos seus apps. Ao personalizar o estilo do anúncio, é possível criar apresentações naturais e discretas que criam uma experiência melhor para o usuário.

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

Os estilos nativos foram criados para simplificar a implementação de anúncios nativos e são uma ótima opção se você não tem muita experiência com o formato. A renderização personalizada foi projetada para maximizar a liberdade que você tem na criação de apresentações.

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

Premiado

Os blocos de anúncios premiados permitem que os usuários joguem, respondam a pesquisas ou assistam vídeos para ganhar recompensas no app, como moedas, vidas extras ou pontos. Você pode 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

Os intersticiais premiados são um novo tipo de formato de anúncio incentivado que permite oferecer recompensas, como moedas ou vidas extras, para 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 a visualização de um intersticial premiado.

Em vez de um aviso de ativação nos anúncios premiados, os intersticiais premiados exigem uma tela inicial que anuncia a recompensa e dá aos usuários a chance de recusar essa exibição.

Implementar anúncios intersticiais premiados

Abertura do app

A abertura do app é um formato de anúncio exibido quando os usuários abrem ou voltam ao seu 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úncio que essa API oferece.