Esta página foi traduzida pela API Cloud Translation.

Iniciar

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 de 16 ou superior
- Um compileSdkVersion de 28 ou superior

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ções buildscript e allprojects :

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> com android:name="com.google.android.gms.ads.APPLICATION_ID" . Você pode encontrar o ID do aplicativo na interface do usuário AdMob . Para android:value , insira seu próprio ID do aplicativo AdMob , entre aspas.
```
<manifest>
    <application>
        
        <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 arquivo AndroidManifest.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.

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.

Implementar anúncios nativos

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.