A integração do SDK de anúncios para dispositivos móveis do Google em um aplicativo é o primeiro passo 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 você começar
Para preparar seu aplicativo, conclua as etapas nas seções a seguir.
Pré-requisitos do aplicativo
- Use o Android Studio 3.2 ou superior
Verifique se o arquivo de compilação do seu aplicativo usa os seguintes valores:
- Uma
minSdkVersion
de16
ou superior - Um
compileSdkVersion
de28
ou superior
- Uma
Configure seu aplicativo em sua conta da AdMob
Registre seu aplicativo como um aplicativo da AdMob seguindo as etapas a seguir:
Faça login ou inscreva-se em uma conta da AdMob.
Registre seu aplicativo na AdMob . Esta etapa cria um aplicativo da AdMob com um ID exclusivo do aplicativo da AdMob que será necessário posteriormente neste guia.
Configure seu aplicativo
No arquivo
build.gradle
no nível do projeto, inclua o repositório Maven do Google e o repositório central Maven nas seçõesbuildscript
eallprojects
:buildscript { repositories { google() mavenCentral() } } allprojects { repositories { google() mavenCentral() } }
Adicione as dependências do SDK de anúncios para dispositivos móveis do Google ao arquivo Gradle no nível do aplicativo do seu módulo, normalmente
app/build.gradle
:dependencies { implementation 'com.google.android.gms:play-services-ads:20.6.0' }
Adicione o ID do aplicativo AdMob ( identificado na interface do usuárioAdMob ) ao arquivo
AndroidManifest.xml
do seu aplicativo. Para fazer isso, adicione uma tag<meta-data>
comandroid:name="com.google.android.gms.ads.APPLICATION_ID"
. Você pode encontrar o ID do aplicativo na interface do usuário AdMob . Paraandroid:value
, insira seu próprio ID do aplicativo AdMob , 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 aplicativo real, use o ID do aplicativo AdMob real , não o listado acima. Se você deseja apenas experimentar o SDK em um aplicativo Hello World, pode usar o ID de aplicativo de exemplo mostrado acima.
Observe também que a falha em 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 que versões anteriores funcionem com o Android 13.Se seu aplicativo usa o SDK de anúncios para dispositivos móveis do Google versão 20.4.0 ou superior, você pode pular esta etapa, pois o SDK declara automaticamente a permissão
com.google.android.gms.permission.AD_ID
e pode acessar o ID de publicidade sempre que estiver disponível .Para aplicativos que usam o SDK de anúncios para dispositivos móveis do Google versão 20.3.0 ou inferior e segmentam o Android 13, você deve adicionar a permissão
com.google.android.gms.permission.AD_ID
no arquivoAndroidManifest.xml
do SDK de anúncios para dispositivos móveis do Google para 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ão
com.google.android.gms.permission.AD_ID
, incluindo como desativá-la, consulte este artigo do Play Console .
Inicialize o SDK de anúncios para dispositivos móveis do Google
Antes de carregar anúncios, faça com que seu aplicativo inicialize o SDK de anúncios para dispositivos móveis do Google chamando MobileAds.initialize()
, que inicializa o SDK e chama de volta um listener de conclusão quando a inicialização for 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 aplicativo.
Os anúncios podem ser pré-carregados pelo SDK de anúncios para dispositivos móveis do Google ou SDKs de parceiros de mediação ao chamar MobileAds.initialize()
. Se você precisar obter o consentimento de usuários no Espaço Econômico Europeu (EEE), defina sinalizações específicas de solicitação (como tagForChildDirectedTreatment
ou tag_for_under_age_of_consent
) ou tome medidas antes de carregar anúncios, certifique-se de fazer isso antes de inicializar o SDK de anúncios para dispositivos móveis do Google .
Aqui está um exemplo de como chamar o método initialize()
em uma Activity:
Exemplo 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 manipulador de conclusão seja chamado antes de carregar os anúncios, pois isso garantirá que todos os adaptadores de mediação sejam inicializados.
Selecione um formato de anúncio
O SDK de anúncios para dispositivos móveis do Google agora foi importado e você está pronto para implementar um anúncio.AdMob oferece vários formatos de anúncio diferentes, para que você possa escolher aquele que melhor se adapta à experiência do usuário do seu aplicativo.
Bandeira
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 de tempo. Se você é novo na publicidade para celular, eles são um ótimo lugar para começar.
Implementar anúncios de banner
Intersticial
Anúncios em tela cheia que cobrem a interface de um aplicativo até serem fechados pelo usuário. Eles são melhor usados em pausas naturais no fluxo de execução de um aplicativo, como entre os níveis 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 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.
Recompensado
Anúncios que recompensam os usuários por assistir a vídeos curtos e interagir com anúncios e pesquisas reproduzíveis. Usado para monetizar aplicativos gratuitos.
Implementar anúncios premiados
Recursos adicionais
O repositório do Google Mobile Ads no GitHub demonstra como usar os diferentes formatos de anúncio que essa API oferece.