Instalar o SDK de última geração do GMA

Para adotar melhorias na latência e na estabilidade do Android, use o SDK de última geração do GMA. Este guia explica como configurar o plug-in dos anúncios para dispositivos móveis do Google no Unity e usar o SDK de última geração do GMA no Android.

Pré-requisitos

Antes de continuar, faça o seguinte:

• Instale a versão 10.6.0 ou mais recente do plug-in dos anúncios para dispositivos móveis do Google no Unity.

• Use a versão 6.0 ou mais recente do Unity.

  Observação: o suporte para Unity 2021.3.41f1 a 2023.2 requer uma atualização do SDK de última geração do GMA, esperado na versão 0.22.0-beta01. Para verificar quando a versão 0.22.0-beta01 estará disponível, consulte as notas da versão.

• Leia o guia para iniciantes.

• Inicie um projeto do Unity.

Atualizar o nível mínimo da API para 24

O SDK de última geração do GMA exige no mínimo o nível 24 da API. Para atualizar o nível mínimo da API, faça o seguinte:

1. Na barra de menus, clique em Arquivo > Criar perfis > Configurações do jogador > Android > Outras configurações > Identificação.
2. Defina o Nível mínimo da API como Android 7.0 "Nougat" (nível 24 da API) ou mais recente.

Modificar o arquivo de dependência

Para ativar o SDK de última geração do GMA em builds do Android, faça o seguinte:

1. No projeto do Unity, navegue até o arquivo Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml.

   • Se você usa o gerenciador de pacotes do Unity, acesse Pacotes > Anúncios para dispositivos móveis do Google para Unity > GoogleMobileAds > Editor > GoogleMobileAdsDependencies.xml.

2. Localize o elemento <androidPackage> com a especificação com.google.android.gms:play-services-ads.

3. Substitua o elemento pela versão mais recente disponível de com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:

   <androidPackage spec="com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01">
     <repositories>
       <repository>https://maven.google.com/</repository>
     </repositories>
   </androidPackage>
   

4. Salve o arquivo.

Durante o processo de build, o plug-in dos anúncios para dispositivos móveis do Google no Unity detecta a presença do SDK de última geração do GMA e usa sua implementação.

Aviso: a atualização do pacote do SDK de última geração do GMA substitui o arquivo de dependência. Se você atualizar o pacote, repita as etapas anteriores.

Conferir o exemplo completo

Confira abaixo um exemplo do arquivo GoogleMobileAdsDependencies.xml atualizado:

<dependencies>
  <androidPackages>
    <androidPackage spec="com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01">
      <repositories>
        <repository>https://maven.google.com/</repository>
      </repositories>
    </androidPackage>
    <androidPackage spec="androidx.constraintlayout:constraintlayout:2.1.4">
      <repositories>
        <repository>https://maven.google.com/</repository>
      </repositories>
    </androidPackage>
    <androidPackage spec="androidx.lifecycle:lifecycle-process:2.6.2">
        <repositories>
            <repository>https://maven.google.com/</repository>
        </repositories>
    </androidPackage>
  </androidPackages>

  <iosPods>
    <iosPod name="Google-Mobile-Ads-SDK" version="~> 12.11.0">
      <sources>
        <source>https://github.com/CocoaPods/Specs</source>
      </sources>
    </iosPod>
  </iosPods>
</dependencies>