Métodos delegados — Android

Última atualização:

Os métodos delegados do Chartboost SDK permitem ter mais controle sobre a integração. Use-os para ajustar a experiência do anúncio às suas necessidades!


Conteúdo


Visão geral

Os métodos delegados do Chartboost SDK permitem ter mais controle sobre a integração. Por exemplo, você pode:

  • Registrar mensagens de depuração quando o seu jogo tenta carregar um intersticial
  • Impedir que anúncios apareçam na primeira vez que um usuário joga o seu jogo
  • Determinar se um usuário clicou em um anúncio ou só fechou, e reagir de maneira correspondente
  • Impedir que um intersticial ou página MoreApps apareça quando e onde possa interferir no seu jogo

Você pode ver os métodos do Chartboost Android SDK a seu dispor na documentação localizada na pasta doc inclusa com o seu download do SDK. Você pode ver vários desses métodos em uso no projeto de amostra incluso no pacote.


Métodos de configuração do SDK

Estes métodos permitem acessar os recursos e configurações do Chartboost SDK:

// Verifica se há um intersticial em cache no determinado local.
public static boolean hasInterstitial(String location)

// Verifica se há uma página MoreApps em cache no determinado local.
public static boolean hasMoreApps(String location)

// Verifica se há um vídeo de recompensa em cache no determinado local.
public static boolean hasRewardedVideo(String location) 

// Verifica se há exibições visíveis
public static boolean isAnyViewVisible()

// Definido para ativar e desativar o recurso de cache automático (Ativado por padrão).*
public static void setAutoCacheAds(boolean autoCacheAds)

// Obter o comportamento atual de cache automático (Ativado por padrão).*
public static boolean getAutoCacheAds()

// Defina um identificador personalizado para enviar o corpo POST para todas as solicitações de servidor Chartboost API.
public static void setCustomId(String customID)

// Obtenha o identificador personalizado atual que está sendo enviado ao corpo POST para todas as solicitações de servidor Chartboost API.
public static String getCustomID()

// Decidir se o Chartboost SDK deve mostrar intersticiais na primeira sessão.
public static void setShouldRequestInterstitialsInFirstSession(boolean shouldRequest)

//  Decidir se o Chartboost SDK deve mostrar uma exibição de carregamento ao preparar para exibir a UI de "mais aplicativos".
public static void setShouldDisplayLoadingViewForMoreApps(boolean shouldDisplay)

// Decidir se o Chartboost SDK tentará obter vídeos dos servidores Chartboost API.
public static void setShouldPrefetchVideoContent(boolean shouldPrefetch)

(Você pode obter mais informações sobre as configurações de AutoCacheAds e cache de anúncios em geral aqui.)


Configuração de delegado do SDK

Antes de usar qualquer função delegada, defina o delegado Chartboost no método onCreate() em sua atividade, desta maneira:

Chartboost.setDelegate(YourDelegateObject);

Depois, instancie o objeto delegado e declare os métodos delegados da seguinte maneira:

private ChartboostDelegate YourDelegateObject = new ChartboostDelegate() {
// Declare métodos delegados aqui. Consulte o projeto CBSample para ver exemplos
};

Métodos delegados de intersticial estático e em vídeo

// Chamado antes de solicitar um intersticial através do servidor Chartboost API.
public boolean shouldRequestInterstitial(String location)

// Chamado antes de um intersticial ser exibido na tela.
public boolean shouldDisplayInterstitial(String location)

// Chamado após um intersticial ser exibido na tela.
public void didDisplayInterstitial(String location)

// Chamado após um intersticial ser carregado da API do Chartboost
// e colocado em cache localmente.
public void didCacheInterstitial(String location)

// Chamado após um intersticial ter tentado carregar dos servidores Chartboost API
// mas falhar.
public void didFailToLoadInterstitial(String location, CBImpressionError error)

// Chamado após um intersticial ter sido dispensado.
public void didDismissInterstitial(String location)

// Chamado após um intersticial ter sido fechado.
public void didCloseInterstitial(String location)

// Chamado após um intersticial ter sido clicado.
public void didClickInterstitial(String location)

Métodos delegados de MoreApps

// Chamado antes de uma página MoreApps ser exibida na tela.
public boolean shouldDisplayMoreApps(String location)

// Chamado após uma página MoreApps ter sido exibida na tela.
public void didDisplayMoreApps(String location)

// Chamado após uma página MoreApps ser carregada dos servidores Chartboost API
// e colocado em cache localmente.
public void didCacheMoreApps(String location)

// Chamado após uma página MoreApps ter sido dispensada.
public void didDismissMoreApps(String location)

// Chamado após uma página MoreApps ter sido fechada.
public void didCloseMoreApps(String location)

// Chamado após uma página MoreApps ter sido clicada.
public void didClickMoreApps(String location)

// Chamado após uma página MoreApps tentar carregar dos servidores Chartboost API
// mas falhar.
public void didFailToLoadMoreApps(String location, CBImpressionError error)

Métodos delegados de vídeo de recompensa

(Para obter mais informações sobre Chartboost Vídeo, consulte esta página.)

// Chamado antes de um vídeo de recompensa ser exibido na tela.
public boolean shouldDisplayRewardedVideo(String location)

// Chamado após um vídeo de recompensa ter sido exibido na tela.
public void didDisplayRewardedVideo(String location)

// Chamado após um vídeo de recompensa ter sido carregado dos servidores Chartboost API
// e colocado em cache localmente.
public void didCacheRewardedVideo(String location)

// Chamado após um vídeo de recompensa tentar carregar dos servidores Chartboost API
// mas falhar.
public void didFailToLoadRewardedVideo(String location, CBImpressionError error)

// Chamado após um vídeo de recompensa ter sido dispensado.
public void didDismissRewardedVideo(String location)

// Chamado após um vídeo de recompensa ter sido fechado.
public void didCloseRewardedVideo(String location)

// Chamado após um vídeo de recompensa ter sido clicado.
public void didClickRewardedVideo(String location)

// Chamado após um vídeo de recompensa ter sido exibido completamente e o usuário se qualificar para a recompensa.
public void didCompleteRewardedVideo(String location, int reward)

// Implementar para ser notificado quando um vídeo for exibido na tela para 
// um determinado CBLocation. Então você poderá executar ações como silenciar áudio de efeitos e sons.
public void willDisplayVideo(String location)

Métodos delegados de Native Ads

// Chamado após um objeto Native Ads ser carregado dos servidores Chartboost API
// e colocado em cache localmente.
public void didCacheInPlay(String location)

// Chamado após um Native Ad tentar carregar dos servidores Chartboost API
// mas falhar.
public void didFailToLoadInPlay(String location, CBImpressionError error)

Métodos delegados variados

// Chamado se um clique é registrado pelo app, mas o usuário não é encaminhado para a App Store.
public void didFailToRecordClick(String uri, CBClickError error)

// Chamado após o SDK ter sido inicializado com êxito e o pré-carregamento do vídeo estar completo.
public void didInitialize()
{ Log.i("Chartboost, DID INITIALIZE! ")); }

Métodos de restrição de idade

Métodos de restrição de idade para Android tornaram-se obsoletos.