Carregar um único anúncio de abertura do app

SDK com API de carregamento único.

Os anúncios de abertura do app são um formato especial destinado a publishers que querem gerar receita com as telas de carregamento do app. Eles podem ser fechados a qualquer momento e são projetados para aparecer quando os usuários colocam seu app em primeiro plano.

Para mais informações, consulte Orientações sobre anúncios de abertura do app.

Este guia explica como integrar anúncios de abertura do app a um app Android.

Pré-requisitos

Configure GMA Next-Gen SDK.

Sempre usar anúncios de teste

Ao criar e testar seus apps, use anúncios de teste em vez de anúncios de produção ativos. Se não, sua conta poderá ser suspensa.

Para carregar anúncios de teste, use o ID de bloco de anúncios de teste dedicado para anúncios de abertura do app Android:

ca-app-pub-3940256099942544/9257395921

Esse ID de bloco de anúncios foi configurado especialmente para retornar anúncios de teste em todas as solicitações. Você pode usá-lo nos seus próprios apps durante a programação, os testes e a depuração. Não se esqueça de substituí-lo pelo ID do seu bloco de anúncios antes de publicar o app.

Para detalhes sobre os anúncios de teste GMA Next-Gen SDK, consulte Ativar anúncios de teste.

Carregar um anúncio

O exemplo a seguir mostra como carregar um único anúncio:

Kotlin

// Load ads after you initialize MobileAds.
AppOpenAd.load(
  AdRequest.Builder(adUnitId).build(),
  object : AdLoadCallback<AppOpenAd> {
    override fun onAdLoaded(ad: AppOpenAd) {
      // App open ad loaded.
      appOpenAd = ad
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {
      // App open ad failed to load.
      Log.e(TAG, "App open ad failed to load: ${adError.message}")
      appOpenAd = null
    }
  },
)

Java

// Load ads after you initialize MobileAds.
AppOpenAd.load(
    new AdRequest.Builder(adUnitId).build(),
    new AdLoadCallback<AppOpenAd>() {
      @Override
      public void onAdLoaded(AppOpenAd ad) {
        // App open ad loaded.
        appOpenAd = ad;
      }

      @Override
      public void onAdFailedToLoad(LoadAdError adError) {
        // App open ad failed to load.
        Log.e(TAG, "App open ad failed to load: " + adError.getMessage());
        appOpenAd = null;
      }
    });

Ao testar, use o ID do bloco de anúncios de teste: ca-app-pub-3940256099942544/9257395921.

Veicular o anúncio

Para mostrar um anúncio de abertura do app, use o método show.

Kotlin

private fun showAd(appOpenAd: AppOpenAd, activity: Activity) {
  // Show the ad.
  appOpenAd.show(activity)
}

Java

private void showAd(AppOpenAd appOpenAd, Activity activity) {
  // Show the ad.
  appOpenAd.show(activity);
}

Detectar eventos de anúncios

Antes de veicular o anúncio, detecte os eventos do ciclo de vida do anúncio:

Kotlin

private fun listenToAdEvents() {
  // Listen for ad events.
  val ad = appOpenAd
  if (ad == null) {
    Log.e(TAG, "App open ad is not ready yet.")
    return
  }

  ad.adEventCallback =
    object : AppOpenAdEventCallback {
      override fun onAdShowedFullScreenContent() {
        // App open ad did show.
      }

      override fun onAdDismissedFullScreenContent() {
        // App open ad did dismiss.
        appOpenAd = null
      }

      override fun onAdFailedToShowFullScreenContent(
        fullScreenContentError: FullScreenContentError
      ) {
        // App open ad failed to show.
        Log.e(TAG, "App open ad failed to show: ${fullScreenContentError.message}")
      }

      override fun onAdImpression() {
        // App open ad did record an impression.
      }

      override fun onAdClicked() {
        // App open ad did record a click.
      }
    }
}

Java

private void listenToAdEvents() {
  // Listen for ad events.
  if (appOpenAd == null) {
    Log.e(TAG, "App open ad is not ready yet.");
    return;
  }

  appOpenAd.setAdEventCallback(
      new AppOpenAdEventCallback() {
        @Override
        public void onAdShowedFullScreenContent() {
          // App open ad did show.
        }

        @Override
        public void onAdDismissedFullScreenContent() {
          // App open ad did dismiss.
          appOpenAd = null;
        }

        @Override
        public void onAdFailedToShowFullScreenContent(
            @NonNull FullScreenContentError fullScreenContentError) {
          // App open ad failed to show.
          Log.e(TAG, "App open ad failed to show: " + fullScreenContentError.getMessage());
        }

        @Override
        public void onAdImpression() {
          // App open ad did record an impression.
        }

        @Override
        public void onAdClicked() {
          // App open ad did record a click.
        }
      });
}

Inicializações a frio e telas de carregamento

Uma inicialização a frio ocorre quando o app é iniciado do zero, por exemplo, quando um usuário abre o app pela primeira vez ou após o encerramento da memória. Durante uma inicialização a frio, não há um anúncio de abertura do app carregado anteriormente pronto para ser mostrado imediatamente.

Devido a atrasos na solicitação de anúncios, os usuários podem interagir com seu app antes que um anúncio de abertura do app apareça. Para evitar uma experiência ruim do usuário, mostre anúncios de abertura do app em inicializações a frio estritamente em uma tela de carregamento enquanto os recursos do app são carregados. Se o carregamento de recursos for concluído e o usuário acessar o conteúdo principal antes que o anúncio seja carregado, não mostre o anúncio.

Carregue os recursos do app em uma linha de execução em segundo plano para que o carregamento continue enquanto o anúncio é exibido.

Práticas recomendadas

Siga estas práticas recomendadas para anúncios de abertura do app:

  • Mostre o primeiro anúncio de abertura do app somente depois que um usuário abrir o app várias vezes.
  • Mostre anúncios de abertura do app somente enquanto os usuários aguardam o carregamento do app.
  • Se a tela de carregamento terminar de carregar enquanto o anúncio estiver sendo exibido, dispense a tela de carregamento no método de callback do anúncio dispensado.