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

Para adotar melhorias na latência e na estabilidade do Android, use GMA Next-Gen SDK. Este guia aborda a configuração do Google Mobile Ads Unity Plugin para usar GMA Next-Gen SDK no Android.

Pré-requisitos

Antes de continuar, faça o seguinte:

• Instale a versão 10.6.0 ou mais recente do Google Mobile Ads Unity Plugin.
• Use a versão 2019.4 ou mais recente do Unity.
• Configure o Google Mobile Ads Unity Plugin.
• Ter um projeto do Unity.

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

GMA Next-Gen SDK exige um nível mínimo da API de 24. 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 GMA Next-Gen SDK nos seus 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.25.0-beta01">
     <repositories>
       <repository>https://maven.google.com/</repository>
     </repositories>
   </androidPackage>
   

4. Salve o arquivo.

Durante o processo de build, o Google Mobile Ads Unity Plugin detecta a presença do GMA Next-Gen SDK e usa sua implementação.

Aviso: a atualização do pacote GMA Next-Gen SDK 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.25.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>