Dar os primeiros passos

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

A integração do plug-in do Unity dos anúncios para dispositivos móveis do Google a um aplicativo, que você fará aqui, é 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 nativo ou vídeo premiado) para receber etapas de implementação detalhadas.

Pré-requisitos

  • Usar o Unity 2019 ou uma versão mais recente
  • Para implantar no iOS
    • Xcode 14.1 ou versão mais recente
    • Segmentar o iOS 11.0 ou superior
    • CocoaPods
  • Para implantar no Android
    • Google Play Services 18.1.0 ou posterior
    • Segmentar a API Android de nível 16 ou mais recente
  • Recomendado: criar uma conta da AdMob e registrar um app Android e/ou iOS

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

Com o plug-in do Unity dos anúncios para dispositivos móveis do Google, os desenvolvedores do Unity podem veicular facilmente os anúncios para dispositivos móveis do Google em apps para 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 analisar o código no GitHub.

FAZER O DOWNLOAD DO PLUG-IN VER ORIGEM

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

Abra seu projeto no editor do Unity. Selecione Recursos > Importar pacote > Pacote personalizado e encontre o arquivo GoogleMobileAdsPlugin.unitypackage que você baixou.

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

Inclua o SDK dos anúncios para dispositivos móveis

O plug-in do Unity dos anúncios para dispositivos móveis do Google é distribuído com a biblioteca do resolvedor do Google Play Services para Unity. Essa biblioteca é destinada a qualquer plug-in do Unity que exija acesso a bibliotecas específicas do Android (por exemplo, AARs) ou CocoaPods para iOS. Ele permite que os plug-ins do Unity declarem dependências, que são resolvidas e copiadas automaticamente no 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 de dependências de gerenciamento externas do Unity copiará as dependências declaradas no diretório Assets/Plugins/Android do app 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 aplicativo da AdMob para Android e iOS em cada campo.

Gerar eventos de anúncio na linha de execução principal do Unity

Às vezes, o SDK dos anúncios para dispositivos móveis do Google gera eventos em uma linha de execução diferente da linha de execução principal do Unity. Isso pode causar problemas ao interagir com objetos do Unity de eventos enviados do SDK dos anúncios para dispositivos móveis do Google. Como solução alternativa, pode ser necessário adicionar um código para sincronizar os eventos do SDK de anúncios para dispositivos móveis com a linha de execução principal do Unity.

Se você quiser que o SDK de anúncios para dispositivos móveis lide com essa questão de linhas de execução para você, defina MobileAds.RaiseAdEventsOnUnityMainThread como true. Isso forçará o SDK dos anúncios para dispositivos móveis a gerar todos os eventos e callbacks na linha de execução principal do Unity.

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

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

Antes de carregar anúncios, chame MobileAds.Initialize() para que seu app inicialize o SDK dos anúncios para dispositivos móveis. Isso precisa ser feito apenas 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()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

Se você estiver usando a mediação, aguarde até que o retorno de chamada ocorra 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 agora está incluído no seu app do Unity quando implantado na plataforma Android ou iOS. Agora você está pronto para implementar um anúncio. A AdMob oferece vários formatos de anúncio diferentes. Assim, você pode escolher o melhor formato para suas necessidades de experiência do usuário.

Os anúncios de banner são anúncios gráficos ou de texto retangulares que ocupam uma posição no layout de um aplicativo. 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, 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. Elas são mais úteis 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 um intersticial

Nativo

Nativo é um formato de anúncio baseado em componente que dá a você a liberdade de personalizar a forma como recursos, como títulos e calls-to-action, são apresentados nos aplicativos. 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 rica.

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 assisti-los até o fim em troca de prêmios no aplicativo.

Implementar anúncios premiados

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

Para exibir a solicitação de autorização de transparência no rastreamento do app (ATT, na sigla em inglês) para acessar o IDFA, use o pacote de suporte de publicidade do iOS 14 do Unity.

Mesma chave de app

Pré-requisitos: Plug-in do Unity para anúncios para dispositivos móveis do Google 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 dados coletados do aplicativo usado pelo usuário.

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