Começar

Selecione a plataforma: Android iOS Unity Flutter

Com o plug-in dos anúncios para dispositivos móveis do Google para Unity, os desenvolvedores veiculam anúncios 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 uma versão mais recente
  • Para implantar no iOS
    • Xcode 16.0 ou versões mais recentes
    • Direcione o app ao iOS 12.0 ou a 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 ou mais recente da API do Android

O nível da API do Android é definido em Configurações do projeto > Player > Android > Outras configurações > Outras configurações.

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

OpenUPM-CLI

Se você tiver a CLI do OpenUPM 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 seguintes diretórios importados do .unitypackage:

  • Assets/ExternalDependencyManager
  • Assets/GoogleMobileAds
  • 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 do menu do Unity Edit > Project Settings > Package Manager.
  2. Adicione o OpenUPM como um registro com 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 do menu do Unity Window > Package Manager.

  4. Defina o menu suspenso de escopo do administrador para selecionar Meus registros.

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

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 seguintes diretórios importados do .unitypackage:

  • Assets/ExternalDependencyManager
  • Assets/GoogleMobileAds
  • 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 Assets > Import package > Custom Package do Unity 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 do 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 oferece aos plug-ins do Unity a capacidade de declarar dependências, que são resolvidas e copiadas automaticamente para seu projeto do Unity.

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

Android

Acesse Configurações do projeto > Player > Android > Configurações de publicação > Build e selecione:

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

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

iOS

O Unity para iOS usa o CocoaPods para identificar e gerenciar dependências. Consulte a documentação do CocoaPods para requisitos específicos ou etapas de solução de problemas relacionadas às suas 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, chame MobileAds.Initialize() para que o app inicialize o SDK dos anúncios para dispositivos móveis do Google. Esse processo só é realizado uma vez, de preferência na inicialização do app.

Veja um exemplo de como chamar MobileAds.Initialize():

MobileAds.Initialize((InitializationStatus initstatus) =>
{
    if (initstatus == null)
    {
        Debug.LogError("Google Mobile Ads initialization failed.");
        return;
    }

    Debug.Log("Google Mobile Ads initialization complete.");

    // Google Mobile Ads events are raised off the Unity Main thread. If you need to
    // access UnityEngine objects after initialization,
    // use MobileAdsEventExecutor.ExecuteInUpdate(). For more information, see:
    // https://developers.google.com/admob/unity/global-settings#raise_ad_events_on_the_unity_main_thread
});

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.

Selecione 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 implantar nas plataformas Android ou iOS. Agora você já pode implementar um anúncio. A AdMob oferece vários formatos de anúncio diferentes para que você possa escolher aquele que proporciona a melhor experiência do usuário.

Os blocos de anúncios de banner mostram anúncios retangulares que ocupam parte do layout de um app. Eles podem ser atualizados automaticamente após um tempo definido. Isso significa que os usuários veem 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 permitem personalizar a forma como os recursos, como títulos e calls-to-action, são apresentados nos seus apps. Ao estilizar o anúncio por conta própria, você cria apresentações 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 conseguem jogar, responder a pesquisas ou assistir a vídeos para ganhar recompensas 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 são exibidos automaticamente em pontos de transição natural 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 voltam para seu aplicativo. O anúncio se sobrepõe à tela de carregamento.

Implementar anúncios de abertura do app