Descarga e integra el SDK de Chartboost para Amazon

Última actualización:

 

Añade tu juego móvil al red de Chartboost con solo 10 líneas de código.

Nota: La integración de Amazon utiliza el mismo SDK que Android.
Actualiza tu SDK Ver registro de cambios

 


 

¿Qué incluye el paquete? Nuestro paquete SDK está repleto de prestaciones.

Anuncios en video de alta calidad especialmente diseñados para recompensar a tus jugadores.

Intersitiales personalizables que ofrecen a tus jugadores una experiencia impecable sin salir del juego.

Un eficaz conjunto de analíticas para dirigirte a la mejor audiencia posible.

Ver las notas completas del SDK ▶

 


 

¿Listo para integrar el SDK de Chartboost? ¡Vamos allá!

 

 


 

Antes de empezar:

  • ¿Has registrado una cuenta de Chartboost?
  • ¿Añadiste una aplicación a tu panel de control?
  • ¿Descargaste el último SDK?
  • ¿Tienes una una campaña de ofertas activa?
  • La integración de Amazon utiliza el mismo SDK que Android. Estas instrucciones de integración son aplicables únicamente a los juegos para Google Play o el Amazon App Store.
  • Si tu juego utiliza Unity, te recomendamos encarecidamente que uses nuestro plugin Unity para Android. Si prefieres utilizar el SDK de Android con tu propio adaptador Unity, usa este método para asegurarte de que los anuncios aparecen en tu juego.
  • El SDK de Chartboost SDK requiere API nivel 9 (Android 2.3) o superior.
  • Permiso requerido: android.permission.INTERNET
  • Permiso requerido: android.permission.ACCESS_NETWORK_STATE
  • Muy recomendado: para garantizar la compatibilidad con los dispositivos Android 6.0, configura los proyectos Construir y Compilar versión del SDK a API nivel 23 en tu archivo build.gradle:
    buildToolsVersion = '23.0.0'
    compileSdkVersion = 23
  • Muy recomendado: para utilizar las funciones de Android 6.0 Marshmallow, configura la versión Target del SDK a API nivel 23 en tu AndroidManfiest.xml:
    android:targetSdkVersion="23"
  • Permiso opcional (pero recomendado): android.permission.WRITE_EXTERNAL_STORAGE Permite al SDK almacenar en caché todos los recursos del anuncio (creatividades, marcos personalizados, etc.) en memoria externa. Esto maximiza el rendimiento mediante la entrega de inmediata anuncios y reduce el tráfico de red utilizado por el SDK.
  • Permiso opcional (pero recomendado): android.permission.ACCESS_WIFI_STATE Permite al SDK comprobar los detalles de WiFi en la solicitud HTTP. Esta se utilizará junto al ID de Android y/o GAID como el identificador del usuario. Echa un vistazo a los identificadores de dispositivos.
  • Permiso opcional pero recomendado: android.permission.READ_PHONE_STATE para permitir al SDK ocuparse de llamadas que interrumpen la reproducción de los videos.

 


 

Añade chartboost.jar a tu directorio de libs.

  • Si no tienes una carpeta libs, crea una y pon dentro el archivo .jar.
  • Opcional: Añade chartboost.jar.properties y el directorio doc a libs para tener Javadocs en tu IDE.

 


 

Añade la biblioteca de Google Play Services como una dependencia de tu proyecto.

  • La biblioteca de Google Play Services tiene su propias instrucciones de integración, incluyendo añadidos a tu configuración de Android Manifest y ProGuard.
  • Sigue estas instrucciones de configuración de Google.

 


 

Añade la siguiente entrada en tu archivo AndroidManifest.xml.

<activity android:name="com.chartboost.sdk.CBImpressionActivity"
               android:excludeFromRecents="true"
               android:hardwareAccelerated="true"
               android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"
               android:configChanges="keyboardHidden|orientation|screenSize" />
  • Esto ayuda a suavizar las transiciones de anuncios y la reproducción de video.

 


 

Si muestras anuncios de Chartboost en cualquier actividad que permita distintas orientaciones, añade el siguiente atributo a las actividades en AndroidManifest.xml.

android:configChanges="keyboardHidden|orientation|screenSize"
  • Esto ayuda a mejorar la reproducción de video durante los cambios de orientación.

 


 

Importa el SDK de Chartboost SDK en cualquier actividad que utilice Chartboost.

import com.chartboost.sdk.Chartboost;
import com.chartboost.sdk.CBLocation;
import com.chartboost.sdk.ChartboostDelegate;
import com.chartboost.sdk.Libraries.CBLogging.Level;
import com.chartboost.sdk.Model.CBError.CBClickError;
import com.chartboost.sdk.Model.CBError.CBImpressionError;
import com.chartboost.sdk.Tracking.CBAnalytics;
import com.chartboost.sdk.CBImpressionActivity;

 


 

Inicializa el SDK de Chartboost en tu clase de actividad de lanzamiento.

  • Extiende el método de ciclo de vida onCreate de tu actividad principal:
public class <your Class name> extends Activity {
            
@Override
public void onCreate() {
    super.onCreate();
    Chartboost.startWithAppId(this, appId, appSignature);
    Chartboost.onCreate(this);
    }   
}
  • Alternativamente, puedes dejar que el SDK se ocupe de hacerlo extendiendo ChartboostActivity. Esto evita la necesidad de anular métodos de ciclo de vida de actividad como onCreate, por lo que simplemente puedes llamar a Chartboost.OnCreate().
CONSEJO PROFESIONAL: Tal vez veas el mensaje Exception: Initialization error. Esto indica que el SDK no se inicializó correctamente.
CONSEJO PROFESIONAL: Si utilizas el SDK de Android con tu propio adaptador de Unity, debes reportar Unity como la estructura inmediatamente después de startWithAppId utilizando el método Chartboost.setFramework(CBFramework.CBFrameworkUnity, unityVersion);. Reemplaza unityVersion con el valor devuelto por esta función de Unity.
startWithAppId(android.app.Activity activity, java.lang.String appId, java.lang.String appSignature) debe llamarse siempre durante las incializaciones suaves o duras, independientemente de las acciones que tu aplicación esté realizando,

 


 

Añade el ID y la firma de tu aplicación

 


 

Anula los métodos de actividad de ciclo de vida.

  • Añade el siguiente código para extender los métodos onStart(), onPause(), onResume(), onStop(), onDestroy()y onBackPressed() de tu actividad:
@Override
public void onStart() {
 super.onStart();
 Chartboost.onStart(this);
}

@Override
public void onResume() {
 super.onResume();
 Chartboost.onResume(this);
}

@Override
public void onPause() {
 super.onPause();
 Chartboost.onPause(this);
}
 
@Override
public void onStop() {
 super.onStop();
 Chartboost.onStop(this);
}

@Override
public void onDestroy() {
 super.onDestroy();
 Chartboost.onDestroy(this);
}

@Override
public void onBackPressed() {
// Si hay un intersitial en la pantalla, ciérralo.
 if (Chartboost.onBackPressed())
 return;
 else
 super.onBackPressed();
}

 


 

Para mostrar un anuncio intersitial o de video

Chartboost.cacheInterstitial(CBLocation.LOCATION_DEFAULT);
Chartboost.showInterstitial(CBLocation.LOCATION_DEFAULT);
Te recomendamos que guardes en caché tus intersitiales antes de mostrarlos. Más información sobre caché ▶

 

Para mostrar un anuncio de video con recompensa

Chartboost.cacheRewardedVideo(CBLocation.LOCATION_GAMEOVER);
Chartboost.showRewardedVideo(CBLocation.LOCATION_GAMEOVER);
Te recomendamos que guardes en caché tus intersitiales antes de mostrarlos. Más información sobre caché ▶

 

Si utilizas ProGuard, añade lo siguiente a tu proguard-rules.pro:

-keep class com.chartboost.** { *; }
CONSEJO PROFESIONAL: Sigue las instrucciones de Google Play Services para configurar ProGuard correctamente.

 


 

Prueba tu integración.

  • Ejecuta tu proyecto en un dispositivo Android.
  • Si tienes una campaña de ofertas y has integrados llamadas de "mostrar intersitial" o "mostrar video con recompensa", deberías ver anuncios en vivo.
  • Si no tienes campañas de ofertas pero has integrado estas llamadas, puedes utilizar el modo de prueba para ver anuncios de muestra.
  • ¿Por qué no veo anuncios en mi juego?

 


 

Comprueba el icono del SDK en el panel de control de Chartboost

  • Ajustes de la aplicación > Ajustes básicos en tu panel de control.
  • Cuando nuestros servidores reciben una llamada de arranque con éxito desde nuestro SDK utilizando su ID de aplicación, el icono SDK bajo del icono de la aplicación cambiará de gris a verde.

 


 

w00t! ¡Acabas de integrar el SDK de Chartboost en tu aplicación!

Ahora puedes empezar una campaña ▶

 


 

Descubre más funciones del SDK de Chartboost

  • Caché: acorta los tiempos de carga de los anuncios y las páginas MoreApps guardándolos de forma local en los dispositivos.
  • Chartboost Video: incorpora anuncios en video de alta calidad para dar a los jugadores la mejor experiencia de juego posible.
  • Ubicaciones nombradas: ajusta la segmentación y la frecuencia de anuncios de tu campaña desde el panel de control.
  • Métodos delegados: aumenta el control sobre el comportamiento de los anuncios en tu juego.
  • Métodos de configuración del SDK: permiten acceder a la funcionalidad y la configuración del SDK de Chartboost.
  • MoreApps: crea una página de "ver más juegos" personalizada para promocionar tus propios juegos o publicar los anuncios de otro desarrollador.
  • Analíticas de post-segmentación: para juegos con compras dentro de la aplicación. Descubre datos útiles sobre los hábitos de compra de los jugadores para optimizar o resegmentar tus campañas.
  • Mediación: muestra tus anuncios en una gran variedad de redes de alta calidad.

 


 

Cómo usar OpenGL y versiones antiguas del SDK de Chartboost

<activity android:name="com.chartboost.sdk.CBImpressionActivity"
               android:excludeFromRecents="true"
               android:hardwareAccelerated="true"
               android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"
               android:configChanges="keyboardHidden|orientation|screenSize" />
  • Para SDK de Chartboost v3.4.0 o anterior: cb.setImpressionsUseActivities(true);
  • Para SDK de Chartboost v4.x: CBPreferences.getInstance().setImpressionsUseActivities(true);
  • Para SDK de Chartboost v5.x: Chartboost.setImpressionsUseActivities(boolean impressionsUseActivities) Llama a este método en el método onCreate() de tu actividad después de inicializar el SDK con startWithAppId pero antes de llamar a Chartboost.onCreate()

 


 

Quizás también te interese...
  • Códigos de error: problemas comunes al integrar el SDK de Android y cómo solucionarlos.

 

▲ Volver arriba