Métodos delegados — Android

Ú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 Android de Chartboost en la documentación que encontrarás en la carpeta doc incluida con la descarga del SDK. Puedes ver muchos de estos métodos en uso en el proyecto de muestra incluido en el paquete.


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 ubicación elegida.
public static boolean hasInterstitial(String location)

// Comprueba su hay una página MoreApps en caché en la ubicación elegida.
public static boolean hasMoreApps(String location)

// Comprueba su hay un video con recompensa en caché en la ubicación elegida.
public static boolean hasRewardedVideo(String location) 

// Comprueba si cualquier vista es visible
public static boolean isAnyViewVisible()

// Habilita y deshabilita la función de caché automático (habilitada por defecto)*.
public static void setAutoCacheAds(boolean autoCacheAds)

// Obtiene el comportamiento actual del caché automático (habilitado por defecto)*.
public static boolean getAutoCacheAds()

// Configura un identificador personalizado para enviar en el cuerpo POST a todas las solicitudes de servidor del API de Chartboost.
public static void setCustomId(String customID)

// Obtén identificador personalizado enviado en el cuerpo POST a todas las solicitudes de servidor del API de Chartboost.
public static String getCustomID()

// Decide si el SDK de Chartboost debe mostrar anuncios en la primera sesión.
public static void setShouldRequestInterstitialsInFirstSession(boolean shouldRequest)

//  Decide si el SDK de Chartboost debe mostrar una vista de carga mientras prepara la interfaz de "más aplicaciones".
public static void setShouldDisplayLoadingViewForMoreApps(boolean shouldDisplay)

// Decide si el SDK de Chartboost debe intentar tomar videos de los servidores del API de Chartboost.
public static void setShouldPrefetchVideoContent(boolean shouldPrefetch)

(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 usar funciones delegadas configura el delegado de Chartboost del método onCreate() de la siguiente manera:

Chartboost.setDelegate(YourDelegateObject);

Después ejemplifica el objeto delegado y declara los métodos delegados de la forma siguiente:

private ChartboostDelegate YourDelegateObject = new ChartboostDelegate() {
// Declara los métodos delegados aquí (puedes encontrar ejemplos en el proyecto CBSample).
};

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.
public boolean shouldRequestInterstitial(String location)

// Llamado antes de que aparezca un intersitial en la pantalla.
public boolean shouldDisplayInterstitial(String location)

// Llamado después de que aparezca un intersitial en la pantalla.
public void didDisplayInterstitial(String location)

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

// Llamado después de que un intersitial se haya intentado cargar desde el API de Chartboost.
// servidores pero fallido.
public void didFailToLoadInterstitial(String location, CBImpressionError error)

// Llamado después de que un intersitial haya sido ignorado.
public void didDismissInterstitial(String location)

// Llamado después de que un intersitial haya sido cerrado.
public void didCloseInterstitial(String location)

// Llamado después de un clic en un intersitial.
public void didClickInterstitial(String location)

Métodos delegados de MoreApps

// Llamado antes de que aparezca una página MoreApps en la pantalla.
public boolean shouldDisplayMoreApps(String location)

// Llamado después de que aparezca una página MoreApps en la pantalla.
public void didDisplayMoreApps(String location)

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

// Llamado después de que una página MoreApps haya sido ignorada.
public void didDismissMoreApps(String location)

// Llamado después de que una página MoreApps haya sido cerrada.
public void didCloseMoreApps(String location)

// Llamado después de un clic en una página MoreApps.
public void didClickMoreApps(String location)

// Llamado después de que una página MoreApps se haya intentado cargar desde el API de Chartboost.
// servidores pero fallido.
public void didFailToLoadMoreApps(String location, CBImpressionError error)

Métodos delegados de video con recompensa

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

// Llamado antes de que aparezca un video con recompensa en la pantalla.
public boolean shouldDisplayRewardedVideo(String location)

// Llamado después de que aparezca un video con recompensa en la pantalla.
public void didDisplayRewardedVideo(String location)

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

// Llamado después de que un video con recompensa se haya intentado cargar desde el API de Chartboost.
// servidores pero fallido.
public void didFailToLoadRewardedVideo(String location, CBImpressionError error)

// Llamado después de que un video con recompensa haya sido ignorado.
public void didDismissRewardedVideo(String location)

// Llamado después de que un video con recompensa haya sido cerrado.
public void didCloseRewardedVideo(String location)

// Llamado después de un clic en un video con recompensa.
public void didClickRewardedVideo(String location)

// Llamado después de que un video con recompensa haya sido visto hasta el final y el usuario sea elegible para la recompensa.
public void didCompleteRewardedVideo(String location, int reward)

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

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.
public void didCacheInPlay(String location)

// Llamado después de que un anuncio nativo se haya intentado cargar desde el API de Chartboost.
// servidores pero fallido.
public void didFailToLoadInPlay(String location, CBImpressionError error)

Otros métodos delegados

// Se llama si un clic queda registrado pero el usuario no es dirigido al App Store.
public void didFailToRecordClick(String uri, CBClickError error)

//Se llama después de que el SDK se haya inicializado con éxito y se haya completado la precarga de videos.
public void didInitialize()
{ Log.i("Chartboost, DID INITIALIZE! ")); }

Métodos delegados de la barrera de edad

Los métodos de barrera de edad de Android han quedado desfasados.