O intersticial premiado é um tipo de formato de anúncio com incentivos que permite oferecer recompensas em anúncios que aparecem automaticamente durante transições naturais do app. Diferente dos anúncios premiados, os usuários não precisam ativar a visualização dos intersticiais premiados.
Pré-requisitos
Antes de continuar, configure o Google Mobile Ads Unity Plugin.
Sempre usar anúncios de teste
O exemplo de código a seguir contém um ID de bloco de anúncios que você pode usar para solicitar anúncios de teste. Ele foi configurado especialmente para retornar anúncios de teste em vez de anúncios de produção em todas as solicitações, o que garante a segurança.
No entanto, depois de registrar um app na interface da web da AdMob e criar seus próprios IDs de bloco de anúncios para usar nele, configure explicitamente seu aparelho como um dispositivo de teste durante o desenvolvimento.
Android
ca-app-pub-3940256099942544/1033173712
iOS
ca-app-pub-3940256099942544/4411468910
Inicializar o Google Mobile Ads Unity Plugin
Antes de carregar anúncios, chame MobileAds.Initialize() para que o app inicialize Google Mobile Ads Unity Plugin. Isso só precisa ser feito uma vez, de preferência na inicialização do app.
using GoogleMobileAds;
using GoogleMobileAds.Api;
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
public void Start()
{
// Initialize Google Mobile Ads Unity Plugin.
MobileAds.Initialize((InitializationStatus initStatus) =>
{
// This callback is called once the MobileAds SDK is initialized.
});
}
}
Se você estiver usando a mediação, aguarde o callback antes de carregar anúncios, porque isso garante a inicialização de todos os adaptadores de mediação.
Carregar o anúncio intersticial premiado
Para carregar um anúncio intersticial premiado, use o método estático Load na classe RewardedInterstitialAd. O objeto RewardedInterstitialAd carregado é fornecido como um parâmetro no gerenciador de conclusão. O exemplo a seguir carrega um anúncio intersticial premiado:
Substitua AD_UNIT_ID pelo seu ID do bloco de anúncios.
[Opcional] Validar callbacks de verificação do lado do servidor (SSV)
Se o app precisar de dados extras em callbacks de verificação do lado do servidor, use o recurso de dados personalizados dos anúncios intersticiais premiados. Qualquer valor de string definido em um objeto de anúncio intersticial premiado é transmitido ao parâmetro de consulta custom_data do callback de SSV. Se nenhum valor de dados personalizado for definido, o valor do parâmetro de consulta custom_data não estará incluído no callback de SSV.
O exemplo de código a seguir demonstra como definir as opções de SSV depois que o anúncio intersticial premiado é carregado:
Substitua SAMPLE_CUSTOM_DATA_STRING pelos seus dados personalizados.
Se quiser definir a string de recompensa personalizada, faça isso antes de mostrar o anúncio.
Mostrar o anúncio intersticial premiado com o callback de recompensa
Ao apresentar seu anúncio, você precisa fornecer um callback para processar a recompensa do usuário. Os anúncios só podem aparecer uma vez por carregamento. Use o método CanShowAd para verificar se o anúncio está pronto para ser veiculado.
O código a seguir mostra um anúncio intersticial premiado:
if (rewardedInterstitialAd != null && rewardedInterstitialAd.CanShowAd())
{
rewardedInterstitialAd.Show((Reward reward) =>
{
// The ad was shown and the user earned a reward.
Debug.Log($"Rewarded interstitial ad rewarded user: {reward.Type}, {reward.Amount}");
});
}
Detectar eventos de anúncios intersticiais premiados
Para personalizar ainda mais o comportamento do seu anúncio, conecte-se a uma série de eventos no ciclo de vida do anúncio. O exemplo a seguir detecta eventos de anúncio:
rewardedInterstitialAd.OnAdPaid += (AdValue adValue) =>
{
// Raised when the ad is estimated to have earned money.
Debug.Log($"Rewarded interstitial ad paid {adValue.Value} {adValue.CurrencyCode}.");
};
rewardedInterstitialAd.OnAdImpressionRecorded += () =>
{
// Raised when an impression is recorded for an ad.
Debug.Log("Rewarded interstitial ad recorded an impression.");
};
rewardedInterstitialAd.OnAdClicked += () =>
{
// Raised when a click is recorded for an ad.
Debug.Log("Rewarded interstitial ad was clicked.");
};
rewardedInterstitialAd.OnAdFullScreenContentOpened += () =>
{
// Raised when the ad opened full screen content.
Debug.Log("Rewarded interstitial ad full screen content opened.");
};
rewardedInterstitialAd.OnAdFullScreenContentClosed += () =>
{
// Raised when the ad closed full screen content.
Debug.Log("Rewarded interstitial ad full screen content closed.");
};
rewardedInterstitialAd.OnAdFullScreenContentFailed += (AdError error) =>
{
// Raised when the ad failed to open full screen content.
Debug.LogError($"Rewarded interstitial ad failed to open full screen content: {error}");
};
Limpar o anúncio intersticial premiado
Quando terminar de usar um objeto RewardedInterstitialAd, chame o método Destroy antes de descartar a referência a ele:
if (rewardedInterstitialAd != null)
{
rewardedInterstitialAd.Destroy();
}
Isso notifica o plug-in de que o objeto não é mais usado e que é possível recuperar a memória que ele ocupa. Se esse método não for chamado, haverá vazamentos de memória.
Pré-carregar o próximo anúncio intersticial premiado
Um objeto RewardedInterstitialAd é de uso único. Quando um anúncio intersticial premiado é mostrado, o objeto não pode ser usado de novo. Para solicitar outro anúncio intersticial premiado, carregue um novo objeto RewardedInterstitialAd.
Faça o pré-carregamento de um anúncio intersticial premiado assim que o evento OnAdFullScreenContentClosed ou OnAdFullScreenContentFailed for gerado e deixe o anúncio preparado para a próxima oportunidade de impressão.
Substitua AD_UNIT_ID pelo seu ID do bloco de anúncios.
Outros recursos
- Exemplo de HelloWorld: uma implementação mínima de todos os formatos de anúncio.