Instalar o SDK do GMA Next-Gen

Para adotar melhorias de latência e estabilidade do Android, use GMA Next-Gen SDK. Este guia aborda a configuração de 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 Google Mobile Ads Unity Plugin 10.6.0 ou mais recente.
• Use a versão 2019.4 ou mais recente do Unity.
• Configurar Google Mobile Ads Unity Plugin.
• Inicie 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

11.1.0 e superior

Para ativar GMA Next-Gen SDK nos builds do Android, selecione Assets > Google Mobile Ads > Settings no Unity Editor:

No inspetor de configurações de GMA Next-Gen SDK, ative Switch Google Mobile Ads Android Architecture e GMA Next-Gen SDK.

11.0.0 - 10.6.0

Para ativar GMA Next-Gen SDK nos builds do Android, modifique o arquivo de dependência:

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:1.1.1">
     <repositories>
       <repository>https://maven.google.com/</repository>
     </repositories>
   </androidPackage>
   

4. Salve o arquivo.

Durante o processo de build, Google Mobile Ads Unity Plugin detecta a presença de 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.

Confira abaixo um exemplo do arquivo GoogleMobileAdsDependencies.xml atualizado:

<dependencies>
<androidPackages>
  <androidPackage spec="com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.1.1">
    <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>

Integrações de mediação

Se você usa a mediação, siga o guia de migração do Android para excluir módulos com.google.android.gms nas integrações de mediação e evitar erros de classe duplicada.