Configurações globais

A classe MobileAds fornece configurações globais para o SDK dos anúncios para dispositivos móveis do Google.

Gerar eventos de anúncios na linha de execução principal do Unity

O SDK dos anúncios para dispositivos móveis do Google gera eventos em uma linha de execução diferente da principal do Unity. Se você implementar eventos de anúncios e interagir com objetos do Unity, sincronize os eventos do SDK dos anúncios para dispositivos móveis com a linha de execução principal do Unity.

Se você quiser que o SDK de anúncios para dispositivos móveis gerencie essa questão de linha de execução, defina MobileAds.RaiseAdEventsOnUnityMainThread como true. Isso força o SDK a gerar todos os eventos e callbacks na linha de execução principal do Unity.

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // When true all events raised by GoogleMobileAds will be raised
        // on the Unity main thread. The default value is false.
        MobileAds.RaiseAdEventsOnUnityMainThread = true;
    }
}

Observação: um efeito colateral de gerar eventos na linha de execução principal do Unity significa que alguns eventos, como OnAdFullScreenContentOpened, não são gerados até que o usuário retorne ao app.

Controle de volume do anúncio em vídeo

Se o app tiver controles de volume próprios, como ajustes personalizados de música ou efeitos sonoros, a divulgação do volume do app ao SDK dos anúncios para dispositivos móveis do Google permite que os anúncios em vídeo respeitem as configurações de volume do app. Isso garante que os usuários recebam anúncios em vídeo com o volume de áudio esperado.

O volume do dispositivo, controlado por botões de volume ou pelo controle deslizante de volume no nível do SO, determina o volume da saída de áudio do dispositivo. No entanto, os apps podem ajustar de forma independente os níveis de volume em relação ao volume do dispositivo para personalizar a experiência de áudio.

É possível informar o volume relativo do app ao SDK dos anúncios para dispositivos móveis do Google chamando o método SetApplicationVolume(). Os valores válidos do volume do anúncio variam de 0.0 (sem som) a 1.0 (volume atual do dispositivo). Confira um exemplo de como informar o volume relativo do app ao SDK:

// Set app volume to be half of current device volume.
MobileAds.SetApplicationVolume(0.5f);

Aviso: reduzir o volume do áudio do app diminui a qualificação dos anúncios em vídeo e pode reduzir a receita de anúncios do app. Use esse método apenas se o app oferecer controles de volume personalizados ao usuário e o volume do usuário for refletido corretamente no app.

Para informar ao SDK que o volume do app foi silenciado, use o método SetApplicationMuted():

// Set app to be muted.
MobileAds.SetApplicationMuted(true);

Por padrão, o volume do app é definido como 1, o volume atual do dispositivo, e o app não é silenciado.

Aviso: desativar o som do app reduz a qualificação dos anúncios em vídeo e pode diminuir a receita de anúncios do app. Use esse método apenas se o app oferecer um controle de desativação personalizado para o usuário e a decisão de desativação do usuário for refletida corretamente no app.

Consentimento para cookies

Se o app tiver requisitos especiais, defina a chave ApplicationPreferences gad_has_consent_for_cookies opcional como zero para ativar anúncios limitados (LTD, na sigla em inglês):

// Enable limited ads (LTD)
ApplicationPreferences.SetInt("gad_has_consent_for_cookies", 0);

Minificação do Android

Essa opção de publicação do Unity permite ativar a minimização de código Java. Se você ativar a minificação, também precisará criar um arquivo Proguard personalizado para manter as classes referenciadas pelo SDK.

1. Ativar o arquivo Proguard personalizado

   Acesse Project Settings > Player > Android > Publishing Settings > Build e selecione:

   • Arquivo Proguard personalizado

2. Abra o arquivo /Assets/Plugins/Android/proguard-user.txt e adicione o seguinte:

-keep class com.google.** { public *; }

Desativar o relatório de falhas

O SDK dos anúncios para dispositivos móveis do Google coleta relatórios de falhas para fins de depuração e análise. É possível desativar esse relatório de falhas com o código a seguir. As seções a seguir descrevem como desativar o envio de relatórios de falhas no Android e no iOS.

AndroidiOS

Adicione a tag <meta-data> com DISABLE_CRASH_REPORTING definido como true no arquivo AndroidManifest.xml do app:

<manifest>
   <application>
       <meta-data
           android:name="com.google.android.gms.ads.flag.DISABLE_CRASH_REPORTING"
           android:value="true" />
   </application>
</manifest>

Chame o método DisableSDKCrashReporting para desativar os relatórios de erros no iOS:

void Awake() {
  MobileAds.DisableSDKCrashReporting();
}

Acessar a versão do plug-in do Unity

Para conferir a versão do SDK do Unity, execute o seguinte:

// Get the unity SDK version.
Debug.Log("Unity SDK Version: " + MobileAds.GetVersion());

Conferir a versão da plataforma

O SDK dos anúncios para dispositivos móveis do Google para Unity depende dos SDKs das plataformas Android e iOS. Para conferir a versão do SDK da plataforma, execute o seguinte:

// Get the underlying platform SDK version.
Debug.Log("Platform SDK Version: " + MobileAds.GetPlatformVersion());