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 linha de execução principal do Unity. Se você implementar eventos de anúncios e interagir com objetos do Unity, será necessário sincronizar 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 dos anúncios para dispositivos móveis lide com essa questão da 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 certos 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

Caso seu app tenha controles de volume próprios, como volumes personalizados de música ou de efeitos sonoros, a divulgação do volume do app para o 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 pelos botões de volume ou pelo controle deslizante no nível do SO, determina o volume da saída de áudio do dispositivo. No entanto, os apps podem ajustar os níveis de volume de forma independente em relação ao volume do dispositivo para personalizar a experiência de áudio.

Você pode 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 de volume de anúncio vão de 0.0 (silencioso) 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 :diminuir o volume do áudio do app reduz a qualificação para anúncios em vídeo e pode reduzir a receita de publicidade do app. Use esse método apenas se o app fornecer controles de volume personalizados e se o volume do usuário for refletido corretamente no app.

Para informar o SDK de que o volume do app foi desativado, 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 para anúncios em vídeo e pode reduzir a receita de publicidade dele. Esse método só deve ser utilizado se o app fornecer um controle de desativação de som personalizado ao usuário e a decisão de desativação do áudio for devidamente refletida no app.

Consentimento para o uso de cookies

Caso seu app tenha requisitos especiais, defina a chave ApplicationPreferences opcional gad_has_consent_for_cookies como zero para ativar os 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 minificação de código Java. Se você ativar a minificação, também vai precisar criar um arquivo ProGuard personalizado para manter as classes referenciadas pelo SDK.

1. Ativar arquivo personalizado do ProGuard

   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 *; }