Guia de atualização para 6.x: Unity

Última atualização:

Este guia de atualização ajuda a atualizar seus jogos para usarem os mais recentes  Chartboost Unity SDKs (versão 6.0+).

Se você está procurando um guia básico que ilustre a integração do zero, consulte esta página.


Requisitos

Note que o Chartboost suporta Android 2.3+ e iOS 6.0+, então certifique-se de definir as versões mínimas de OS em seu projeto Unity de maneira correspondente.


Principais diferenças

  1. Inicialização é manipulada pelo SDK
    • Para simplificar a integração e reduzir possíveis problemas após o lançamento
  2. Item de menu Chartboost
    • Configuração e controle mais fácil de pares de ID do App/Assinatura do App
  3. namespace Chartboost renomeado para namespace ChartboostSDK
    • Em C#, não é recomendado ter o mesmo nome para namespace e para a classe (a classe Chartboost fornece as funções de API públicas)
  4. null ou () não são mais aceitos como locais; em vez disso, você pode passar em CBLocation.Default
    • Embora ainda exista um local padrão, estimulamos o uso de nomes de locais mais descritivos através da classe CBLocation para fornecer análises mais significativas
  5. Todos os locais agora são passados através da classe CBLocation
    • A classe CBLocation tem diversos valores predefinidos de local comum disponíveis para uso
    • Sequências de local personalizado agora são passadas através do método de classe CBLocation locationFromName(string)
  6. Chamadas MoreApps agora usam locais public static void showMoreApps(CBLocation location)
    • Controle mais granular sobre MoreApps (existia em SDKs nativos)
  7. Nomes de eventos e assinaturas de métodos Chartboost SDK foram atualizados e melhorados
    • Coloca API e funcionalidade mais em paridade com SDKs nativos
    • Para saber mais sobre a funcionalidade de evento disponível, tanto antiga quanto nova, consulte o arquivo README.md ou o site de Ajuda do Chartboost (https://answers.chartboost.com/hc/pt-br/articles/200780379)
  8. CBBinding.cs é essencialmente substituído por Chartboost.cs.  Se você costumava chamar CBBinding.isImpressionVisible(), agora deverá chamar Chartboost.isAnyViewVisible() -- consulte Chartboost.cs para saber os métodos disponíveis.

Atualizando para 6.x

    1. Exclua pastas de plug-ins antigos:
      • \Plugins\Android //Arquivos Android SDK
      • \Plugins\iOS //Arquivos iOS SDK
      • \Plugins\Chartboost //Projeto de amostra
    2. Importe o novo pacote SDK:
      • Ativos > Importar pacote > Pacote personalizado
      • Navegue até o arquivo .unitypackage que você baixou do Chartboost e use-o
      • Selecione Importar para concluir a ação (por padrão, todos os ativos do pacote são marcados para importar)
    3. Arraste e solte o Chartboost prefab encontrado em sua cena de jogo de /Assets/Chartboost/Chartboost
    4. Selecione o item de menu Chartboost > Editar configurações:
      • Pressione o botão Configurar Android SDK em Configurações Chartboost na janela Inspetor
      • Edite as configurações de ID do app e assinatura do app com seus valores atuais para cada plataforma
    5. Renomeie todas as linhas usando Chartboost; para usando ChartboostSDK;
    6. Renomeie todas as referencias CBManager.CBImpressionError para CBImpressionError
    7. Remova o seguinte código de init Chartboost em OnEnable():
    8. void OnEnable() {
      // Inicialize o plug-in Chartboost
      #if UNITY_ANDROID
      // Substitua com seu próprio ID e assinatura do app Android do portal Chartboost web
       CBBinding.init("CB_APP_ID_ANDROID", "CB_APP_SIG_ANDROID");
      #elif UNITY_IPHONE
      // Substitua com seu próprio ID e assinatura do app iOS do portal Chartboost web
       CBBinding.init("CB_APP_ID_IOS", "CB_APP_SIG_IOS");
      #endif
      }
      
    9. Remova qualquer código de ciclo de vida do Chartboost específico do Android (manipulação de botão voltar, pausar, destruir, etc.) conforme encontrado nas seguintes funções Unity:
    10. #if UNITY_ANDROID
      public void Update() {
       if (Input.GetKeyUp(KeyCode.Escape)) {
       if (CBBinding.onBackPressed())
       return;
       else
       Application.Quit();
       }
      }
      
      void OnApplicationPause(bool paused) {
      // Gerenciar ciclo de vida do plug-in Chartboost
       CBBinding.pause(paused);
      }
      
      void OnDisable() {
      // Encerrar o plug-in Chartboost
       CBBinding.destroy();
      }
      #endif
      
    11. Edite chamadas antigas do Chartboost de CBBinding.showInterstitial(SEULOCALAQUI); para Chartboost.showInterstitial(SEULOCALAQUI);
      • CBBinding renomeado para Chartboost
      • Para todos os locais nulos e () vazios, use CBLocation.Default
      • Considere o uso dos vários valores predefinidos de CBLocation, por exemplo: CBLocation.Startup, CBLocation.LevelComplete ou CBLocation.MainMenu
      • Se ainda estiver usando sequências de local personalizado, passe-as através de CBLocation: CBBinding.showInterstitial("localpersonalizado"); se torna Chartboost.showInterstitial(CBLocation.locationFromName("localpersonalizado"));
    12. Se estiver verificando anúncios já em cache, o método usado para isso teve o nome alterado:
      • Edite suas chamadas de CBBinding.hasCachedInterstitial(SEULOCALAQUI) para Chartboost.hasInterstitial(SEULOCALAQUI)
    13. Se você está escutando eventos do Chartboost, eles usam Chartboost em vez de CBManager e não têm mais "Event" no fim dos nomes:
      • Por exemplo, CBManager.didDismissInterstitialEvent += didDismissInterstitialEvent; se torna Chartboost.didDismissInterstitial += didDismissInterstitial;
    14. Se você está escutando eventos do Chartboost, dois eventos receberam mudanças de nome mais significativas que você precisa atualizar:
      • didShowInterstitialEvent deve ser substituído com didDisplayInterstitial
      • didShowMoreAppsEvent deve ser substituído com didDisplayMoreApps
    15. Se você está escutando eventos do Chartboost, métodos relacionados a MoreApps agora recebem um parâmetro adicional de local da sequência, que afeta:
      • didFailToLoadMoreApps
      • didDismissMoreApps
      • didCloseMoreApps
      • didClickMoreApps
      • didCacheMoreApps
      • Por exemplo, void didFailToLoadMoreAppsEvent(CBManager.CBImpressionError error) deve ser substituído por void didFailToLoadMoreApps(string location, CBImpressionError error)

Análises pós-instalação

Se você pretende oferecer compras no aplicativo em seu jogo, considere integrar Análises pós-instalação: você obterá dados úteis, como receita, ARPU, retenção, níveis e mais, para otimizar campanhas de publicidade UA ou construir grupos de usuários personalizados para redirecionamento e segmentação.