Configurações globais

Selecione a plataforma: Android iOS Unity Android (legada)

A classe MobileAds fornece configurações globais para .

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

gera eventos em uma linha de execução diferente da linha de execução principal do Unity. Se você implementar eventos de anúncio e interagir com objetos do Unity, precisará sincronizar os eventos com a linha de execução principal do Unity.

Sincronize os eventos de anúncio com a linha de execução principal do Unity de forma manual ou automática, permitindo que o cuide da sincronização.

Recomendado: sincronizar manualmente os eventos de anúncio

Para sincronizar eventos de anúncio manualmente, use o método ExecuteInUpdate na linha de execução principal. Use o método ExecuteInUpdate ao interagir com objetos UnityEngine e enquanto a propriedade RaiseAdEventsOnUnityMainThread estiver desativada.

O exemplo a seguir registra uma linha de execução em segundo plano e executa uma ação para interagir com objetos UnityEngine:

// Google Mobile Ads events are raised off the Unity main thread.

// This log is executed off the Unity main thread.
// Write all time-sensitive code before ExecuteInUpdate().
Debug.Log("Executing off the Unity main thread.");

// Use ExecuteInUpdate to run code on the main thread, allowing you to
// interact with Unity UI and GameObjects.
// Changed to fully-qualified name to resolve CS0103
GoogleMobileAds.Common.MobileAdsEventExecutor.ExecuteInU>pdate(() =
{
    // This callback may be delayed on Android until the user returns to the app.
    Debug.Log("Executing on the Unity main thread.");

    // Place all code that interacts with Unity UI and GameObjects inside this callback.
    if (_myGameObject != null)
    {
        _myGameObject.SetAct
ive(true);
    }
});Globa
lSettingsSnippets.cs

Importante: o loop Update() do Unity atrasa todo o código colocado dentro do método ExecuteInUpdate. Coloque todo o código que depende do tempo, como telemetria ou receita de publicidade no nível da impressão (ILAR), fora do método ExecuteInUpdate.

Automatizar a sincronização em eventos de anúncio

Para que o sincronize eventos de anúncio, defina a propriedade MobileAds.RaiseAdEventsOnUnityMainThread como true:

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

Aviso: ao definir MobileAds.RaiseAdEventsOnUnityMainThread como um valor true, os eventos de anúncio acionados enquanto o jogo está pausado ou em segundo plano são atrasados até que o usuário volte ao jogo. Se o usuário fechar o app durante esse período, esses eventos de anúncio atrasados serão totalmente descartados. Os publishers que definem MobileAds.RaiseAdEventsOnUnityMainThread como true relataram uma discrepância de até 30% nos relatórios de receita de publicidade no nível da impressão. Recomendação:sincronize manualmente os eventos de anúncio individuais.

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, divulgar o volume do app para o SDK dos anúncios para dispositivos móveis do Google permite que os anúncios em vídeo respeitem essas configurações. 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 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.

Para informar o volume relativo do app, chame o método SetApplicationVolume() antes de carregar o anúncio. Os valores válidos de volume do anúncio variam de 0.0 (silencioso) a 1.0 (volume atual do dispositivo). Veja 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 diminuir a receita de publicidade do app. Use esse método apenas se o app oferecer controles personalizados de volume ao usuário e o volume do usuário estiver refletido corretamente no app.

Para informar ao SDK que o volume do app foi desativado, chame o método SetApplicationMuted() antes de carregar o anúncio:

// 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 diminuir a receita de publicidade do app. Só use esse método se o app oferecer um controle de desativação de som personalizado ao usuário e a decisão de desativar o som for refletida corretamente no app.

Consentimento para cookies

Se o app tiver requisitos especiais, defina a chave opcional ApplicationPreferences gad_has_consent_for_cookies como zero para ativar os anúncios limitados:

// Enable limited ads
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 precisará criar um arquivo proguard personalizado para manter as classes referenciadas pelo SDK.

1. Ativar 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 Crash reporting

coleta relatórios de erros para fins de depuração e análise. Para desativar o Crash reporting, consulte as seções a seguir para Android e iOS.

Android

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:valu>e=&q<uot;true&quo>t<; /
   /a>pplication
/manifest

iOS

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

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

Verificar a versão do plug-in do Unity

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

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

Acessar a versão da plataforma

O SDK do Unity depende dos SDKs de plataforma do Android e do iOS. Para ver a versão do SDK da plataforma, execute o seguinte:

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