Métodos delegados — iOS

Última actualización:

Los métodos delegados del SDK de Chartboost te permiten tener un mayor control sobre tu integración. Utilízalos para ajustar la experiencia de tus anuncios a tus necesidades.


Contenido


Resumen

Los métodos delegados del SDK de Chartboost te permiten tener un mayor control sobre tu integración. Por ejemplo, puedes:

  • Registrar mensajes de depuración cuando tu juego intenta cargar un intersitial
  • Impedir que aparezcan anuncios la primera vez que un usuario utiliza tu juego
  • Determinar si un usuario ha hecho clic en un anuncio o simplemente lo ha cerrado, y actuar en consecuencia
  • Impedir que un intersitial o una página de MoreApps aparezcan en momentos o ubicaciones que interfieran con tu juego

Puedes ver los métodos del SDK Chartboost iOS en el archivo de encabezamiento Chartboost.h del framework Chartboost. Puedes ver muchos de estos métodos en uso en el proyecto de muestra incluido en tu descarga del SDK.


Métodos de configuración del SDK

Estos métodos te permiten acceder a la funcionalidad y la configuración del SDK Chartboost:

// Comprueba su hay un intersitial en caché en la CBlocation elegida.
+ (BOOL)hasInterstitial:(CBLocation)location;

// Comprueba su hay una página MoreApps en caché en la CBlocation elegida.
+ (BOOL)hasMoreApps:(CBLocation)location;

// Comprueba su hay un video con recompensa en caché en la CBlocation elegida.
+ (BOOL)hasRewardedVideo:(CBLocation)location;

// Comprueba si cualquier vista es visible
+ (BOOL)isAnyViewVisible;

// Habilita y deshabilita la función de caché automático (habilitada por defecto)*.
+ (void)setAutoCacheAds:(BOOL)shouldCache;

// Obtiene el comportamiento actual del caché automático (habilitado por defecto)*.
+ (BOOL)getAutoCacheAds;

// Configura un identificador personalizado para enviar en el cuerpo POST a todas las solicitudes de servidor del API de Chartboost.
+ (void)setCustomId:(NSString *)customId;

// Obtén identificador personalizado enviado en el cuerpo POST a todas las solicitudes de servidor del API de Chartboost.
+ (NSString *)getCustomId;

// Decide si el SDK de Chartboost debe mostrar anuncios en la primera sesión.
+ (void)setShouldRequestInterstitialsInFirstSession:(BOOL)shouldRequest;

//  Decide si el SDK de Chartboost debe mostrar una vista de carga mientras prepara la interfaz de "más aplicaciones".
+ (void)setShouldDisplayLoadingViewForMoreApps:(BOOL)shouldDisplay;

// Controla si el SDK descarga creatividades de video por adelantado para mejorar su funcionamiento. Habilitado por defecto. Si lo inhabilitas, reducirás la capacidad de servir anuncios de video del SDK.
+ (void)setShouldPrefetchVideoContent:(BOOL)shouldPrefetch;

// Controla cómo los anuncios a pantalla completa interactúan con la barra de estado. (CBStatusBarBehaviorIgnore por defecto).
+ (void)setStatusBarBehavior:(CBStatusBarBehavior)statusBarBehavior;

(Puedes encontrar más información sobre la configuración de AutoCacheAds y el caché de anuncios en general aquí).


Configuración delegada del SDK

Antes de utilizar cualquier función delegada configura el delegado de Chartboost con delegate:self en tu código de inicialización de 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]; 

// Empieza una sesión de usuario. 
// No debe depender de acciones del usuario o cualquier solicitud previa de la red.
 [Chartboost startWithAppId:@"YOUR_CHARTBOOST_APP_ID"
 appSignature:@"YOUR_CHARTBOOST_APP_SIGNATURE"
 delegate:self];

 return YES;
}

Métodos delegados de intersitiales estáticos y de video

// Llamado antes de solicitar un intersitial a través del servidor del API de Chartboost.
- (BOOL)shouldRequestInterstitial:(CBLocation)location;

// Llamado antes de que aparezca un intersitial en la pantalla.
- (BOOL)shouldDisplayInterstitial:(CBLocation)location;

// Llamado después de que aparezca un intersitial en la pantalla.
- (void)didDisplayInterstitial:(CBLocation)location;

// Llamado después de que un intersitial haya sido cargado desde el API de Chartboost.
// servidores y en caché local.
- (void)didCacheInterstitial:(CBLocation)location;

// Llamado después de que un intersitial se haya intentado cargar desde el API de Chartboost.
// servidores pero fallido.
 - (void)didFailToLoadInterstitial:(CBLocation)location
 withError:(CBLoadError)error;

// Llamado después de que un intersitial haya sido ignorado.
- (void)didDismissInterstitial:(CBLocation)location;

// Llamado después de que un intersitial haya sido cerrado.
- (void)didCloseInterstitial:(CBLocation)location;

// Llamado después de un clic en un intersitial.
- (void)didClickInterstitial:(CBLocation)location;

Métodos delegados de MoreApps

// Llamado antes de que aparezca una página MoreApps en la pantalla.
- (BOOL)shouldDisplayMoreApps:(CBLocation)location;

// Llamado después de que aparezca una página MoreApps en la pantalla.
- (void)didDisplayMoreApps:(CBLocation)location;

// Llamado después de que una página MoreApps haya sido cargada desde el API de Chartboost.
// servidores y en caché local.
- (void)didCacheMoreApps:(CBLocation)location;

// Llamado después de que una página MoreApps haya sido ignorada.
- (void)didDismissMoreApps:(CBLocation)location;

// Llamado después de que una página MoreApps haya sido cerrada.
- (void)didCloseMoreApps:(CBLocation)location;

// Llamado después de un clic en una página MoreApps.
- (void)didClickMoreApps:(CBLocation)location;

// Llamado después de que una página MoreApps se haya intentado cargar desde el API de Chartboost.
// servidores pero fallido.
- (void)didFailToLoadMoreApps:(CBLocation)location
 withError:(CBLoadError)error;

Métodos delegados de video con recompensa

(Puedes encontrar más información sobre Chartboost Video en esta página.)

// Llamado después de que los videos hayan precargado con éxito.
- (void)didPrefetchVideos;

// Llamado antes de que aparezca un video con recompensa en la pantalla.
- (BOOL)shouldDisplayRewardedVideo:(CBLocation)location;

// Llamado después de que aparezca un video con recompensa en la pantalla.
- (void)didDisplayRewardedVideo:(CBLocation)location;

// Llamado después de que un video con recompensa haya sido cargado desde el API de Chartboost.
// servidores y en caché local.
- (void)didCacheRewardedVideo:(CBLocation)location;

// Llamado después de que un video con recompensa se haya intentado cargar desde el API de Chartboost.
// servidores pero fallido.
- (void)didFailToLoadRewardedVideo:(CBLocation)location
 withError:(CBLoadError)error;

// Llamado después de que un video con recompensa haya sido ignorado.
- (void)didDismissRewardedVideo:(CBLocation)location;

// Llamado después de que un video con recompensa haya sido cerrado.
- (void)didCloseRewardedVideo:(CBLocation)location;

// Llamado después de un clic en un video con recompensa.
- (void)didClickRewardedVideo:(CBLocation)location;

// Llamado después de que un video con recompensa haya sido visto hasta el final y el usuario sea elegible para la recompensa.
- (void)didCompleteRewardedVideo:(CBLocation)location
 withReward:(int)reward;

// Notifica cuando video será mostrado en la pantalla en 
// una CBLocation determinada. Te permite hacer cosas como silenciar los efectos y sonidos.
- (void)willDisplayVideo:(CBLocation)location;

Otros métodos delegados

// Se llama después de que la hoja del App Store sea ignorada, al mostrar la hoja de aplicaciones embebida.
- (void)didCompleteAppStoreSheetFlow;

// Se llama después de que un clic quede registrado pero el usuario no sea dirigido al App Store.
- (void)didFailToRecordClick:(CBLocation)location
 withError:(CBClickError)error;

//Se llama después de que el SDK se haya inicializado con éxito y se haya completado la precarga de videos.
- (void)didInitialize:(BOOL)status;

Métodos delegados de anuncios nativos

// Llamado después de que un objeto de anuncio nativo haya sido cargado desde el API de Chartboost.
// servidores y en caché local.
- (void)didCacheInPlay:(CBLocation)location;

// Llamado después de que un anuncio nativo se haya intentado cargar desde el API de Chartboost.
// servidores pero fallido.
- (void)didFailToLoadInPlay:(CBLocation)location
 withError:(CBLoadError)error;

Métodos delegados de la barrera de edad

// Decide si el SDK de Chartboost debe utilizar una barrera de edad para bloquear usuarios.
+ (void)setShouldPauseClickForConfirmation:(BOOL)shouldPause;

// Se llama si el SDK de Chartboost pausa las acciones de clic mientras espera la confirmación del usuario. Uso
// para implementar una barrera de edad en tu juego.
- (void)didPauseClickForConfirmation;

// Confirma si el usuario pasó o no la barrera de edad. Cunado está especificado Chartboost esperará a 
// esta llamada antes de mostrar el App Store de iOS.
+ (void)didPassAgeGate:(BOOL)pass;