Esta página foi traduzida pela API Cloud Translation.

Começar

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ê pode 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ão mais recente
O arquivo de build do app precisa usar estes valores:
- Uma minSdkVersion 19 ou versões mais recentes.
- A compileSdkVersion precisa ser definida como 28 ou versões mais recentes.

Configurar o app

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

Adicione as dependências do SDK dos anúncios para dispositivos móveis do Google ao arquivo Gradle no nível do seu módulo, que geralmente é app/build.gradle:
```
dependencies {
  implementation 'com.google.android.gms:play-services-ads:22.0.0'
}
```
Adicione o ID do app Ad Manager (identificado na IU doAd 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 Ad Manager IU. Para android:value, insira o próprio Ad Manager ID do app 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 app real, use o ID Ad Manager do app real, não o listado acima. Se você quiser apenas testar o SDK com um app Hello World, use o exemplo de ID do app 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 versões anteriores funcionarem com o Android 13.

Se o app usa o SDK dos anúncios para dispositivos móveis do Google 20.4.0 ou mais recente, você pode pular 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 ele estiver disponível.

Para apps que usam o SDK dos anúncios para dispositivos móveis do Google 20.3.0 ou uma versão anterior que segmentam o Android 13, é necessário adicionar a permissã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 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 os anúncios, faça com que o app inicialize o SDK dos anúncios para dispositivos móveis do Google. Para isso, chame MobileAds.initialize(), que 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 só precisa ser feito 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 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. Ad Manager oferece vários formatos de anúncios diferentes para que você possa escolher o mais adequado à experiência do usuário do seu app.

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 app 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. É melhor usá-los em pausas naturais no fluxo de execução de um app, como entre níveis de um jogo ou logo após a conclusão de uma tarefa.

Implementar anúncios intersticiais

Nativo

São anúncios personalizáveis que combinam com a aparência e o tom do seu app. Você decide como e onde eles são colocados para que o layout seja mais consistente com o design do seu app.

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

Os estilos nativos foram criados para facilitar a implementação de anúncios nativos. Essa é uma ótima opção para quem está começando a usar o formato. A renderização personalizada foi criada para maximizar a liberdade de criação de apresentações.

Implementar anúncios nativos

Implementar estilos nativos

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 de anúncios para dispositivos móveis do Google no GitHub demonstra como usar os diferentes formatos de anúncio oferecidos por essa API.