Baixe e integre o Chartboost SDK para Amazon

Última atualização:

 

Adicione seu jogo móvel à rede Chartboost com apenas 10 linhas de código!

Observação: a integração com o Amazon usa o mesmo SDK que o Android.
Atualize seu SDK Ver log de alterações

 


 

O que há na caixa? Nosso pacote de SDK vem repleto de recursos.

Anúncios em vídeo de alta qualidade feitos sob medida para os jogos para recompensar os seus jogadores!

Intersticiais personalizáveis que dão aos jogadores uma experiência incorporada no jogo!

Um conjunto de análises robusto para direcionar para o melhor público possível para você!

Ver notas completas da versão do SDK ▶

 


 

Pronto para integrar o Chartboost SDK? Vamos lá!

 

 


 

Antes de começar:

  • Você se registrou para uma conta do Chartboost?
  • Você adicionou um app ao seu painel?
  • Você baixou o SDK mais recente?
  • Você tem uma campanha de publicação ativa?
  • A integração com o Amazon usa o mesmo SDK que o Android. Estas instruções de integração se aplicam a jogos para Google Play ou Amazon App Store.
  • Se o seu jogo é construído em Unity, recomendamos usar o nosso plug-in Unity para Android. Se você preferir usar o Android SDK com seu próprio adaptador para Unity, use este método para assegurar que os anúncios apareçam em seu jogo.
  • O Chartboost SDK requer API nível 9 (Android OS 2.3) ou posterior.
  • Permissão necessária: android.permission.INTERNET
  • Permissão necessária: android.permission.ACCESS_NETWORK_STATE
  • Altamente recomendado: para assegurar compatibilidade com dispositivos Android 6.0, defina a versão de build e compilação do SDK para API Nível 23 em seu arquivo build.gradle:
    buildToolsVersion = '23.0.0'
    compileSdkVersion = 23
  • Altamente recomendado: para compatibilidade com recursos do Android 6.0 Marshmallow, defina a versão de meta do SDK para API Nível 23 em seu AndroidManfiest.xml:
    android:targetSdkVersion="23"
  • Permissão opcional (mas recomendada): android.permission.WRITE_EXTERNAL_STORAGE Permite que o SDK coloque em cache todos os conteúdos de anúncios (criativos, quadros personalizados, etc.) em memória externa. Isso maximiza o desempenho, entregando anúncios imediatamente e reduzindo o tráfego de rede usado pelo SDK.
  • Permissão opcional (mas recomendada): android.permission.ACCESS_WIFI_STATE Permite que o SDK verifique detalhas de WiFi na solicitação HTTP. Isto será usando junto com o Android ID e/ou GAID como identificador para o usuário. Confira identificadores de dispositivo para obter mais informações.
  • Permissão opcional (mas recomendada): android.permission.READ_PHONE_STATE permite que o SDK aceite chamadas que interrompem a reprodução de vídeo durante os vídeos.

 


 

Adicione chartboost.jar ao seu diretório libs.

  • Se você não tem uma pasta libs, crie uma e adicione o arquivo .jar.
  • Opcional: Adicione chartboost.jar.properties e o diretório doc a libs para obter Javadocs em seu IDE.

 


 

Adicione a biblioteca Google Play Services como dependência do seu projeto.

  • A biblioteca Google Play Services tem seu próprio conjunto de integrações, incluindo adições à sua configuração de Android Manifest e ProGuard.
  • Siga estas instruções de configuração do Google.

 


 

Adicione a seguinte entrada ao seu arquivo 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" />
  • Isso ajuda a suavizar as transições de arquivos e reprodução do vídeo.

 


 

Se você exibir anúncios do Chartboost em qualquer atividade que suporta diferentes orientações, adicione o seguinte atributo a essas atividades em AndroidManifest.xml.

android:configChanges="keyboardHidden|orientation|screenSize"
  • Isso ajuda a suavizar a reprodução de vídeo durante mudanças de orientação.

 


 

Importe o Chartboost SDK em qualquer atividade que usa o 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;

 


 

Inicialize o Chartboost SDK em sua classe de atividade de inicialização.

  • Estenda o método de ciclo de vida de sua atividade principal onCreate desta maneira:
public class <your Class name> extends Activity {
            
@Override
public void onCreate() {
    super.onCreate();
    Chartboost.startWithAppId(this, appId, appSignature);
    Chartboost.onCreate(this);
    }   
}
  • Alternativamente, você pode deixar o SDK manipular isso para você estendendo ChartboostActivity. Isso previne a necessidade de substituir métodos de ciclo de vida de atividade, como onCreate, e você pode simplesmente chamar Chartboost.OnCreate().
DICA PRO: Observe se há uma mensagem de erro Exceção: erro de inicialização. Isso indica que o SDK não inicializou corretamente.
DICA PRO: se estiver usando o Android SDK com seu próprio adaptador Unity, é necessário relatar o Unity como estrutura imediatamente após startWithAppId usando o método Chartboost.setFramework(CBFramework.CBFrameworkUnity, unityVersion);. Substitua unityVersion com o valor retornado por esta função Unity.
startWithAppId(android.app.Activity activity, java.lang.String appId, java.lang.String appSignature) sempre deve ser chamado durante ativações suaves e forçadas, independentemente de outras ações que o app esteja executando.

 


 

Adicione o ID do app e assinatura do app.

 


 

Substitua os métodos de ciclo de vida da sua atividade.

  • Adicione o seguinte código para estender os métodosonStart(), onPause(), onResume(), onStop(), onDestroy() e onBackPressed() da sua atividade:
@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() {
// Se houver um intersticial na tela, feche-o.
 if (Chartboost.onBackPressed())
 return;
 else
 super.onBackPressed();
}

 


 

Para exibir um anúncio intersticial estático ou em vídeo:

Chartboost.cacheInterstitial(CBLocation.LOCATION_DEFAULT);
Chartboost.showInterstitial(CBLocation.LOCATION_DEFAULT);
  • Você pode usar a classe de interface CBLocation para obter uma lista de constantes de local padrão e também definir as suas.  Quando um local é usado, ele é adicionado ao seu painel, onde você pode personalizar suas configurações.
  • Para o controle personalizado de como os anúncios se comportam em seu jogo, o Chartboost SDK também oferece mais recursos, como cache, métodos delegados e locais nomeados.
  • Saiba mais sobre anúncios em vídeo do Chartboost.
Nós recomendamos que você coloque seus intersticiais em cache antes de exibi-los. Saiba mais sobre cache ▶

 

Para exibir um anúncio de vídeo de recompensa:

Chartboost.cacheRewardedVideo(CBLocation.LOCATION_GAMEOVER);
Chartboost.showRewardedVideo(CBLocation.LOCATION_GAMEOVER);
Nós recomendamos que você coloque seus intersticiais em cache antes de exibi-los. Saiba mais sobre cache ▶

 

Se estiver usando ProGuard, adicione o seguinte ao seu proguard-rules.pro:

-keep class com.chartboost.** { *; }
DICA PRO: Siga as instruções do Google Play Services para a configuração correta de ProGuard.

 


 

Teste sua integração.

  • Execute seu projeto em um dispositivo Android.
  • Se você tem uma campanha de publicação ativa e integrou chamadas de "exibir intersticial" ou "exibir vídeo de recompensa", deverá ver os anúncios ativos.
  • Se você não tem campanhas de publicação e integrou essas chamadas, pode usar o Modo de Teste para ver se aparecem os anúncios de teste.
  • Por que não vejo anúncios no meu jogo?

 


 

Verifique o ícone do SDK no painel Chartboost.

  • Acesse as Configurações do app > Configurações básicas em seu painel.
  • Quando nossos servidores recebem com êxito uma chamada de ativação do nosso SDK usando seu ID do app, o ícone do SDK abaixo do ícone do seu app passará de cinza para verde.

 


 

u00u! Você integrou o Chartboost SDK em seu app!

Agora você pode começar uma campanha ▶

 


 

Confira mais recursos do Chartboost SDK

  • Cache: Acelere os tempos de carregamento para anúncios e páginas MoreApps armazenando-os localmente nos dispositivos.
  • Chartboost Vídeo: Acrescente lindos anúncios em vídeo de alta qualidade para dar a melhor experiência no jogo aos jogadores.
  • Locais nomeados: Ajuste o direcionamento da campanha e frequência de anúncios a partir do painel.
  • Métodos delegados: Ganhe mais controle sobre como o seu jogo se comporta em torno dos anúncios.
  • Métodos de configuração de SDK: Acesse recursos e configurações do Chartboost SDK.
  • MoreApps: Crie uma página personalizada "veja mais jogos" em seu app para anunciar seus jogos ou publicar anúncios de outros desenvolvedores.
  • Análises pós-instalação: Para jogos com compras no aplicativo. Desbloqueie dados úteis sobre o comportamento de compra do jogador para otimizar campanhas ou redirecionar.
  • Mediação: Mostre seus anúncios em diversas outras redes de alta qualidade.

 


 

Usar OpenGL e versões mais antigas do Chartboost SDK

<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 Chartboost SDK v3.4.0 ou inferior: cb.setImpressionsUseActivities(true);
  • Para Chartboost SDK v4.x: CBPreferences.getInstance().setImpressionsUseActivities(true);
  • Para Chartboost SDK v5.x: Chartboost.setImpressionsUseActivities(boolean impressionsUseActivities) Chame este método no método onCreate() da sua atividade após inicializar o SDK com startWithAppId e antes de chamar Chartboost.onCreate()

 


 

Você também pode se interessar...
  • Códigos de erro: Problemas comuns e suas soluções ao integrar o SDK para Android.

 

▲ Voltar para o topo