Integrar o SDK dos anúncios para dispositivos móveis do Google a um app é o primeiro passo para exibir anúncios e gerar receita. Depois de integrar o SDK, você poderá 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
- Usar o Android Studio 3.2 ou versões mais recentes
O arquivo de compilação do seu app precisa usar os seguintes valores:
- Uma
minSdkVersion
19
ou versões mais recentes. - Uma
compileSdkVersion
28
ou versões mais recentes.
- Uma
Configurar o app na conta da AdMob
Registre seu aplicativo como um app da AdMob seguindo estas etapas:
Faça login na sua conta da AdMob ou crie uma.
Registre seu app na AdMob. Nesta etapa, você cria um aplicativo da AdMob com um ID exclusivo do app da AdMob que será necessário mais adiante neste guia.
Configurar o app
No arquivo
build.gradle
do projeto, inclua o repositório Maven do Google e o repositório central do Maven nas seçõesbuildscript
eallprojects
:buildscript { repositories { google() mavenCentral() } } allprojects { repositories { google() mavenCentral() } }
Adicione as dependências do SDK dos anúncios para dispositivos móveis do Google ao arquivo Gradle no nível do app do seu módulo, normalmente
app/build.gradle
:dependencies { implementation 'com.google.android.gms:play-services-ads:21.0.0' }
Adicione o AdMob ID do app (identificado na IU do AdMob) ao arquivo
AndroidManifest.xml
do seu app. Para fazer isso, adicione uma tag<meta-data>
comandroid:name="com.google.android.gms.ads.APPLICATION_ID"
. É possível encontrar o ID do app na AdMob IU. Paraandroid:value
, insira seu próprio AdMob ID do app, entre aspas.<manifest> <application> <!-- Sample AdMob 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, use o ID do app AdMob real, não o listado acima. Se você quer apenas testar o SDK em um app Hello World, use o exemplo de ID do app mostrado acima.
Observe também que a falha ao adicionar a tag
<meta-data>
conforme mostrado acima resulta em uma falha com a mensagem:The Google Mobile Ads SDK was initialized incorrectly.
(Opcional) Declare a permissão
AD_ID
para versões anteriores funcionarem com o Android 13.Se seu app usa a versão 20.4.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google, você pode pular esta etapa, uma vez que o SDK declara automaticamente a permissão
com.google.android.gms.permission.AD_ID
e pode acessar o código de publicidade sempre que ele 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, é necessário adicionar a permissão
com.google.android.gms.permission.AD_ID
no arquivoAndroidManifest.xml
do SDK dos anúncios para dispositivos móveis 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 a declaração de permissão
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, faça com que o app inicialize o SDK dos anúncios para dispositivos móveis do Google chamando MobileAds.initialize()
. Ele inicializa o SDK e retorna um listener de conclusão quando a inicialização é concluída (ou após um tempo limite de 30 segundos). Isso precisa
ser feito apenas uma vez, de preferência no lançamento 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 ao chamar MobileAds.initialize()
. Se você precisar do consentimento de usuários no Espaço Econômico Europeu (EEE), defina sinalizações específicas de solicitações (como tagForChildDirectedTreatment
ou tag_for_under_age_of_consent
) ou tome medidas antes de carregar anúncios. Faça isso antes de inicializar o SDK dos anúncios para dispositivos móveis do Google.
Veja um exemplo de como chamar o método initialize()
em uma atividade:
Exemplo de MainActivity (trecho)
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) {} } }
Se você estiver usando a mediação, aguarde até que o gerenciador de conclusão seja chamado antes de carregar anúncios, porque isso garantirá que todos os adaptadores de mediação sejam inicializados.
Selecione um formato de anúncio
O SDK dos anúncios para dispositivos móveis do Google agora é importado, e você está pronto para implementar um anúncio.AdMob oferece vários formatos de anúncio. Assim, você pode escolher o mais adequado à experiência do usuário do seu aplicativo.
Banner
Anúncios retangulares que aparecem na parte superior ou inferior da tela do dispositivo. Os anúncios de banner permanecem na tela enquanto os usuários interagem com o aplicativo e podem ser atualizados automaticamente após um determinado período. Se você começou a usar os anúncios para dispositivos móveis agora, saiba que eles são um bom lugar para começar.
Implementar anúncios de banner
Intersticial
São anúncios de tela cheia que cobrem a interface de um aplicativo até serem fechados pelo usuário. Elas são melhor utilizadas em pausas naturais no fluxo de execução de um app, como entre as fases de um jogo ou logo após a conclusão de uma tarefa.
Implementar anúncios intersticiais
Nativo
Anúncios personalizáveis que combinam com a aparência e o tom do seu aplicativo. Você decide como e onde eles são colocados para que o layout seja mais consistente com o design do seu aplicativo.
Premiado
Anúncios que recompensam os usuários por assistir a vídeos curtos e interagir com pesquisas e anúncios jogáveis. Usados para gerar receita com apps sem custo financeiro.
Implementar anúncios premiados
Outros recursos
O repositório do Google Mobile Ads no GitHub demonstra como usar os diferentes formatos de anúncio oferecidos por essa API.