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 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 2019.4 ou mais recente
- Para implantar no iOS
- Xcode 15.3 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 21 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
- Abra as configurações do gerenciador de pacotes selecionando a opção de menu do Unity Edit > Project Settings > Package Manager.
Adicione o OpenUPM como um registro de escopo à janela do Gerenciador de pacotes:
Name: OpenUPM URL: https://package.openupm.com Scopes: com.google
Abra o menu do gerenciador de pacotes selecionando a opção de menu do Unity Window > Package Manager.
Defina o menu suspenso "Escopo do administrador" para selecionar Meus registros.
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
- Faça o download da versão mais recente do
.unitypackage
no GitHub. - 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.
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 AdMob
No editor do Unity, selecione Assets > Google Mobile Ads > Settings no menu.
Insira o ID do app 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.
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 um nível em um app de jogo.
Implementar anúncios intersticiais
Nativo
Com os anúncios nativos, você pode personalizar a forma como os recursos, como títulos e chamadas para ação, são apresentados nos seus apps. Ao definir o estilo do anúncio, você pode criar apresentações de anúncios naturais e discretas que podem contribuir para uma experiência mais imersiva para o usuário.
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 do 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