Compartilhe seu feedback e ajude a melhorar o roteiro do SDK dos anúncios para dispositivos móveis do Google. Participe da pesquisa anual do SDK dos anúncios para dispositivos móveis do Google de 2023 até 5 de maio de 2023.

Vamos começar

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Este guia é destinado a editores que querem gerar receita com um app Unity.

A integração do plug-in dos anúncios para dispositivos móveis do Google para Unity em um app é o primeiro passo para exibir anúncios da AdMob e gerar receita. Quando a integração estiver concluída, você poderá escolher um formato de anúncio, como vídeo nativo ou premiado, para receber etapas detalhadas da implementação.

Pré-requisitos

  • Usar o Unity 2019 ou uma versão mais recente
  • Para implantar no iOS
    • Xcode 13.2.1 ou mais recente
    • Segmentar iOS 10.0 ou posterior
    • CocoaPods
  • Para implantar no Android
    • Google Play Services 18.1.0 ou mais recente
    • Segmentar o nível 16 da API do Android ou versões mais recentes
  • Recomendado: crie uma conta da AdMob e registre um app Android e/ou iOS

Fazer o download do plug-in dos anúncios para dispositivos móveis do Unity

Com o plug-in dos anúncios para dispositivos móveis do Google para Unity, os desenvolvedores podem exibir anúncios do Google Mobile com facilidade em apps Android e iOS sem precisar escrever código Java ou Objective-C. O plug-in fornece uma interface C# para solicitar anúncios usados por scripts C# no seu projeto do Unity.

Use os links abaixo para fazer o download do pacote do Unity para o plug-in ou verificar o código no GitHub.

FAZER O DOWNLOAD DO PLUG-IN VER ORIGEM

Importar o plug-in dos anúncios para dispositivos móveis do Unity

Abra seu projeto no editor do Unity. Selecione Assets > Import Package > Custom Package e encontre o arquivo GoogleMobileAdsPlugin.unitypackage que você fez o download.

Verifique se todos os arquivos estão selecionados e clique em Importar.

Incluir o SDK de anúncios para dispositivos móveis

O plug-in dos anúncios para dispositivos móveis do Google para Unity é distribuído com a biblioteca Unity Play Services. Essa biblioteca é destinada a uso por qualquer plug-in do Unity que exija acesso a bibliotecas específicas do Android (por exemplo, AARs) ou CocoaPods para iOS. Com eles, os plug-ins do Unity podem declarar dependências, que são resolvidas automaticamente e copiadas para o projeto do Unity.

Siga as etapas abaixo para garantir que seu projeto inclua o SDK dos anúncios para dispositivos móveis.

Android

No editor do Unity, selecione Assets > External Dependency Manager > Android Resolver > Resolve. A biblioteca do External Dependency Manager do Unity copiará as dependências declaradas no diretório Assets/Plugins/Android do seu app do Unity.

.

iOS

Nenhuma outra etapa é necessária para incluir o SDK de anúncios para dispositivos móveis no projeto do Unity.

  • Ao usar o Unity 5.6 e versões mais recentes, é gerado um xcworkspace que inclui as bibliotecas de dependência necessárias. Use o xcworkspace gerado em vez do projeto padrão do Xcode.
  • Ao usar versões mais antigas do Unity, as dependências são incluídas no projeto padrão do Xcode.

Definir o ID do app da AdMob

No editor do Unity, selecione Recursos > Anúncios para dispositivos móveis do Google > Configurações no menu.

Insira o ID do app da AdMob para Android e iOS em cada campo.

Inicializar o SDK de anúncios para dispositivos móveis

Antes de carregar anúncios, chame MobileAds.Initialize() para que o app inicialize o SDK de anúncios para dispositivos móveis. Isso só precisa ser feito uma vez, de preferência na inicialização do app.

Veja um exemplo de como chamar Initialize() no método Start() de um script anexado a um GameObject:

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // When true all events raised by GoogleMobileAds will be invoked
        // on the Unity main thread. The default value is false.
        MobileAds.RaiseAdEventsOnUnityMainThread = true;

        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

Se você estiver usando a mediação, aguarde até que o callback ocorra antes de carregar os anúncios. 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 agora está incluído no seu app do Unity quando implantado na plataforma Android ou iOS. Agora está tudo pronto para implementar o anúncio. A AdMob oferece vários formatos de anúncios diferentes para você escolher o mais adequado à sua experiência do usuário.

Os anúncios de banner são anúncios gráficos ou de texto retangulares que ocupam um lugar no layout de um app. Eles 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 um banner

Intersticial

Intersticiais são anúncios em tela cheia que cobrem a interface de um aplicativo até serem fechados pelo usuário. Eles são mais recomendados para 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 um intersticial

Nativo

Nativo é um formato de anúncio baseado em componente que dá a liberdade de personalizar a forma como recursos, como títulos e calls-to-action, são apresentados nos apps. Ao escolher fontes, cores e outros detalhes, você cria apresentações naturais e discretas de anúncios que contribuem para uma experiência de usuário mais interessante.

Implementar anúncios nativos

Premiado

Os anúncios em vídeo premiados são exibidos em tela cheia e os usuários têm a opção de assistir a eles em troca de recompensas no app.

Implementar anúncios premiados

Solicitar autorização de transparência no rastreamento em apps

Para exibir a solicitação de autorização de Transparência no rastreamento em apps (ATT) para acessar o IDFA, use o pacote de suporte de publicidade do iOS 14 do Unity.

Mesma chave de app

Pré-requisitos: Plug-in de anúncios para dispositivos móveis do Google para Unity versão 6.1.0 ou mais recente

O SDK dos anúncios para dispositivos móveis do Google apresenta a mesma chave de app para ajudar você a exibir anúncios mais relevantes e personalizados usando os dados coletados pelo app que o usuário está usando.

A mesma chave de app é ativada por padrão, mas é possível desativá-la com a seguinte API:

public void Start()
    {
        RequestConfiguration requestConfiguration =
            new RequestConfiguration.Builder()
            .SetSameAppKeyEnabled(true).build();
        MobileAds.SetRequestConfiguration(requestConfiguration);

        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(HandleInitCompleteAction);
    }