Começar

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

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

Pré-requisitos

• Use o Unity Editor 2019.4 ou mais recente
• Para implantar no iOS
  • Xcode 16.0 ou mais recente
  • Direcione o app para o iOS 12.0 ou versões mais recentes
  • CocoaPods
• Para implantar no Android
  • Nível mínimo da API do Android 23 ou mais recente
  • Segmentar o nível 34 da API do Android ou mais recente

• Recomendado: crie uma conta da AdMob e registre um app Android ou iOS.

O nível da API do Android é definido em Project Settings > Player > Android > Other Settings > Other Settings.

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

OpenUPM-CLI

Se você tiver a OpenUPM CLI instalada, poderá instalar o registro do OpenUPM com o seguinte comando:

openupm add com.google.ads.mobile

Remover recursos do plug-in .unitypackage

Se você estiver migrando de um .unitypackage para o OpenUPM, será necessário desinstalar manualmente os recursos do local antigo. Remova os diretórios a seguir que foram importados do .unitypackage:

• Recursos/ExternalDependencyManager
• Recursos/Google Mobile Ads
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

1. Abra as configurações do gerenciador de pacotes selecionando a opção de menu do Unity Edit > Project Settings > Package Manager.

2. Adicione o OpenUPM como um registro de escopo à janela do Gerenciador de pacotes:

   Name: OpenUPM
   URL: https://package.openupm.com
   Scopes: com.google
   

3. Abra o menu do gerenciador de pacotes selecionando a opção de menu do Unity Window > Package Manager.

4. Defina o menu suspenso "Escopo do administrador" para selecionar Meus registros.

   

5. Selecione o pacote Google Mobile Ads para Unity na lista de pacotes e pressione Install.

Remover recursos do plug-in .unitypackage

Se você estiver migrando de um .unitypackage para o OpenUPM, será necessário desinstalar manualmente os recursos do local antigo. Remova os diretórios a seguir que foram importados do .unitypackage:

• Recursos/ExternalDependencyManager
• Recursos/Google Mobile Ads
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

Importar do GitHub

1. Faça o download da versão mais recente do .unitypackage no GitHub.
2. Importe o arquivo .unitypackage selecionando a opção de menu do Unity Assets > Import package > Custom Package e importando todos os itens.

Incluir dependências externas

O plug-in dos anúncios para dispositivos móveis do Google para Unity é distribuído com a biblioteca Unity Play Services Resolver. Essa biblioteca é destinada ao uso por qualquer plug-in do Unity que exija acesso a bibliotecas específicas do Android, como AARs ou CocoaPods do iOS. Ele permite que os plug-ins do Unity declarem dependências, que são resolvidas e copiadas automaticamente no projeto do Unity.

Importante:use a versão mais recente do SDK dos anúncios para dispositivos móveis do Google para ter acesso a todos os recursos de compliance com a privacidade.

Siga estas etapas para garantir que o projeto inclua todas as dependências:

Android

Acesse Project Settings > Player > Android > Publishing Settings > Build e selecione:

• Modelo principal do Gradle personalizado
• Modelo de propriedades do Gradle personalizado

No editor do Unity, selecione Assets > External Dependency Manager > Android Resolver > Resolve para que a biblioteca Unity External Dependency Manager copie as dependências declaradas para o diretório Assets/Plugins/Android do app Unity.

iOS

O Unity para iOS usa o CocoaPods para identificar e gerenciar dependências. Consulte a documentação do CocoaPods para conferir requisitos específicos ou etapas de solução de problemas relacionados às dependências do iOS.

As dependências do plug-in dos anúncios para dispositivos móveis do Google para Unity estão listadas em Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml.

Definir o ID do app da AdMob

No editor do Unity, selecione Assets > Google Mobile Ads > Settings no menu.

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

Inicializar o SDK

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

Aviso: 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 sinalizadores específicos de solicitações, como tagForChildDirectedTreatment ou tag_for_under_age_of_consent, ou aja antes de carregar os anúncios. Faça isso antes de inicializar o SDK dos anúncios para dispositivos móveis do Google.

Confira 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 callback ocorra antes de carregar anúncios para garantir que todos os adaptadores de mediação sejam inicializados.

Selecionar um formato de anúncio

O SDK dos anúncios para dispositivos móveis do Google agora está incluído no seu app Unity ao ser implantado na plataforma Android ou iOS. Agora está tudo pronto para implementar um anúncio. A AdMob oferece vários formatos de anúncio diferentes para que você possa escolher o que proporciona a melhor experiência do usuário.

Banner

Os blocos de anúncios de banner mostram anúncios retangulares que ocupam uma parte do layout de um app. Eles podem ser atualizados automaticamente após um tempo definido. Isso significa que os usuários vão ver um novo anúncio em intervalos regulares, mesmo que permaneçam na mesma tela do app. Esse é o formato mais simples de implementar.

Implementar anúncios de banner

Intersticial

Os blocos de anúncios intersticiais mostram anúncios de tela cheia no seu app. Posicione-os em intervalos e transições naturais da interface, por exemplo, após a conclusão de uma fase em um app de jogo.

Implementar anúncios intersticiais

Nativo

Os anúncios nativos são aqueles em que você pode personalizar a forma como recursos como títulos e calls-to-action são apresentados nos seus apps. Ao estilizar o anúncio, você pode criar apresentações de anúncios naturais e discretas que contribuem para uma experiência mais imersiva para o usuário.

Implementar anúncios nativos

Premiado

Com os blocos de anúncios premiados, os usuários podem jogar, responder a pesquisas ou assistir a vídeos para ganhar prêmios no app, como moedas, vidas extras ou pontos. É possível definir prêmios diferentes para cada bloco de anúncios e especificar os valores e itens que o usuário recebeu.

Implementar anúncios premiados

Intersticial premiado

O intersticial premiado é um novo tipo de formato de anúncio com incentivos que permite oferecer recompensas, como moedas ou vidas extras, em anúncios que aparecem automaticamente durante transições naturais no app.

Diferente dos anúncios premiados, os usuários não precisam ativar a visualização de um intersticial premiado.

Em vez de exibir uma tela de ativação como nos anúncios premiados, os intersticiais premiados têm uma tela de introdução que mostra a recompensa e permite aos usuários recusar a oferta.

Implementar anúncios intersticiais premiados

Abertura do app

A abertura do app é um formato de anúncio que aparece quando os usuários abrem ou retornam ao app. O anúncio se sobrepõe à tela de carregamento.

Implementar anúncios de abertura do app