Métodos delegados — iOS

Ú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 SDK para iOS disponíveis no arquivo de cabeçalho Chartboost.h na estrutura Chartboost. Você pode ver vários desses métodos em uso no projeto de amostra incluso com o seu download do SDK.


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 CBlocation.
+ (BOOL)hasInterstitial:(CBLocation)location;

// Verifica se há uma página MoreApps em cache no determinado CBlocation.
+ (BOOL)hasMoreApps:(CBLocation)location;

// Verifica se há um vídeo de recompensa em cache no determinado CBlocation.
+ (BOOL)hasRewardedVideo:(CBLocation)location;

// Verifica se há exibições visíveis
+ (BOOL)isAnyViewVisible;

// Definido para ativar e desativar o recurso de cache automático (Ativado por padrão).*
+ (void)setAutoCacheAds:(BOOL)shouldCache;

// Obter o comportamento atual de cache automático (Ativado por padrão).*
+ (BOOL)getAutoCacheAds;

// Defina um identificador personalizado para enviar o corpo POST para todas as solicitações de servidor Chartboost API.
+ (void)setCustomId:(NSString *)customId;

// Obtenha o identificador personalizado atual que está sendo enviado ao corpo POST para todas as solicitações de servidor Chartboost API.
+ (NSString *)getCustomId;

// Decidir se o Chartboost SDK deve mostrar intersticiais na primeira sessão.
+ (void)setShouldRequestInterstitialsInFirstSession:(BOOL)shouldRequest;

//  Decidir se o Chartboost SDK deve mostrar uma exibição de carregamento ao preparar para exibir a interface de "mais aplicativos".
+ (void)setShouldDisplayLoadingViewForMoreApps:(BOOL)shouldDisplay;

// Controla se o SDK baixa criativos de vídeo antes para melhor desempenho. Habilitado por padrão. Se estiver desativado, impactará a capacidade do SDK de servir anúncios em vídeo!
+ (void)setShouldPrefetchVideoContent:(BOOL)shouldPrefetch;

// Definir para controlar como as unidades de anúncios de tela cheia devem interagir com a barra de status. (CBStatusBarBehaviorIgnore por padrão).
+ (void)setStatusBarBehavior:(CBStatusBarBehavior)statusBarBehavior;

(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 com delegate:self em seu código de inicialização do Chartboost:

#import <Chartboost/Chartboost.h>
#import <Chartboost/CBNewsfeed.h>
#import "AppDelegate.h"

@interface AppDelegate () 
@end

@implementation AppDelegate 

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

 [self initializeStoryBoardBasedOnScreenSize]; 

// Iniciar uma sessão de usuário. 
// Não deve ser dependente de ações de usuário ou solicitações de rede anteriores.
 [Chartboost startWithAppId:@"YOUR_CHARTBOOST_APP_ID"
 appSignature:@"YOUR_CHARTBOOST_APP_SIGNATURE"
 delegate:self];

 return YES;
}

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

// Chamado antes de solicitar um intersticial através do servidor Chartboost API.
- (BOOL)shouldRequestInterstitial:(CBLocation)location;

// Chamado antes de um intersticial ser exibido na tela.
- (BOOL)shouldDisplayInterstitial:(CBLocation)location;

// Chamado após um intersticial ser exibido na tela.
- (void)didDisplayInterstitial:(CBLocation)location;

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

// Chamado após um intersticial ter tentado carregar dos servidores Chartboost API
// mas falhar.
 - (void)didFailToLoadInterstitial:(CBLocation)location
 withError:(CBLoadError)error;

// Chamado após um intersticial ter sido dispensado.
- (void)didDismissInterstitial:(CBLocation)location;

// Chamado após um intersticial ter sido fechado.
- (void)didCloseInterstitial:(CBLocation)location;

// Chamado após um intersticial ter sido clicado.
- (void)didClickInterstitial:(CBLocation)location;

Métodos delegados de MoreApps

// Chamado antes de uma página MoreApps ser exibida na tela.
- (BOOL)shouldDisplayMoreApps:(CBLocation)location;

// Chamado após uma página MoreApps ter sido exibida na tela.
- (void)didDisplayMoreApps:(CBLocation)location;

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

// Chamado após uma página MoreApps ter sido dispensada.
- (void)didDismissMoreApps:(CBLocation)location;

// Chamado após uma página MoreApps ter sido fechada.
- (void)didCloseMoreApps:(CBLocation)location;

// Chamado após uma página MoreApps ter sido clicada.
- (void)didClickMoreApps:(CBLocation)location;

// Chamado após uma página MoreApps tentar carregar dos servidores Chartboost API
// mas falhar.
- (void)didFailToLoadMoreApps:(CBLocation)location
 withError:(CBLoadError)error;

Métodos delegados de vídeo de recompensa

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

// Chamado após vídeos serem pré-carregados com êxito.
- (void)didPrefetchVideos;

// Chamado antes de um vídeo de recompensa ser exibido na tela.
- (BOOL)shouldDisplayRewardedVideo:(CBLocation)location;

// Chamado após um vídeo de recompensa ter sido exibido na tela.
- (void)didDisplayRewardedVideo:(CBLocation)location;

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

// Chamado após um vídeo de recompensa tentar carregar dos servidores Chartboost API
// mas falhar.
- (void)didFailToLoadRewardedVideo:(CBLocation)location
 withError:(CBLoadError)error;

// Chamado após um vídeo de recompensa ter sido dispensado.
- (void)didDismissRewardedVideo:(CBLocation)location;

// Chamado após um vídeo de recompensa ter sido fechado.
- (void)didCloseRewardedVideo:(CBLocation)location;

// Chamado após um vídeo de recompensa ter sido clicado.
- (void)didClickRewardedVideo:(CBLocation)location;

// Chamado após um vídeo de recompensa ter sido exibido completamente e o usuário se qualificar para a recompensa.
- (void)didCompleteRewardedVideo:(CBLocation)location
 withReward:(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.
- (void)willDisplayVideo:(CBLocation)location;

Métodos delegados variados

// Chamado após a folha da App Store ser dispensada ao mostrar a folha do app incorporado.
- (void)didCompleteAppStoreSheetFlow;

// Chamado após um clique ser registrado, mas o usuário não é encaminhado para a App Store.
- (void)didFailToRecordClick:(CBLocation)location
 withError:(CBClickError)error;

// Chamado após o SDK ter sido inicializado com êxito e o pré-carregamento do vídeo estar completo
- (void)didInitialize:(BOOL)status;

Métodos delegados de Native Ads

// Chamado após um objeto Native Ad ser carregado dos servidores Chartboost API
// e colocado em cache localmente.
- (void)didCacheInPlay:(CBLocation)location;

// Chamado após um Native Ad tentar carregar dos servidores Chartboost API
// mas falhar.
- (void)didFailToLoadInPlay:(CBLocation)location
 withError:(CBLoadError)error;

Métodos de restrição de idade

// Decidir se o Chartboost SDK deve bloquear para uma restrição de idade.
+ (void)setShouldPauseClickForConfirmation:(BOOL)shouldPause;

// Chamado se o Chartboost SDK pausar ações de clique aguardando confirmação do usuário. Usar
// para implementar uma restrição de idade em seu jogo.
- (void)didPauseClickForConfirmation;

// Confirmar se uma restrição de idade passou ou falhou. Quando especificado, o Chartboost aguardará 
// esta chamada antes de mostrar a IOS App Store.
+ (void)didPassAgeGate:(BOOL)pass;