Integração de análises pós-instalação para Unity

Última atualização:
Pré-requisitos

Antes de iniciar, você precisa:

Se você está configurando PIA e o seu jogo construído com Unity irá para a Amazon Appstore ou Google Play Store, você também precisa adicionar a sua chave Amazon Developer Secret à chave pública do seu app, respectivamente, a um destes campos na página Configurações do app do jogo:

Amazon Appstore

Google Play Store

(Você encontra a chave Secret aqui. Para encontrar sua chave pública do Google Play: entre no Console do Desenvolvedor do Google Play, acesse a página Detalhes do Aplicativo, clique no link Serviço e APIs e localize a seção Licenciamento e cobrança no aplicativo. Você verá aqui a sua chave pública para cobrança no aplicativo.)

Integração com Unity PIA

Há várias maneiras de lidar com o fluxo de compras em jogos construídos com Unity. Abaixo os passos que você deve adotar para enviar as informações de compras no aplicativo ao Chartboost após eventos de compra bem sucedidos:

Unity iOS

1) Para poder chamar o método de acompanhamento do Chartboost para compras no aplicativo, primeiro você precisa incluir a classe usando ChartboostSDK se ainda não o fez

2) Enviar informações de compras no aplicativo ao Chartboost SDK:

Chartboost.trackInAppAppleStorePurchaseEvent(receipt, productTitle, productDescription, productPrice, productCurrency, productIdentifier);

Unity Google Play

1) Para poder chamar o método de acompanhamento do Chartboost para compras no aplicativo, primeiro você precisa incluir a classe usando ChartboostSDK se ainda não o fez

2) Enviar informações de compras no aplicativo ao Chartboost SDK:

Chartboost.trackInAppGooglePlayPurchaseEvent(title,description,price,currency,productID,purchaseData,purchaseSignature);

Unity Amazon

1) Para poder chamar o método de acompanhamento do Chartboost para compras no aplicativo, primeiro você precisa incluir a classe usando ChartboostSDK se ainda não o fez

2) Enviar informações de compras no aplicativo ao Chartboost SDK:

Chartboost.trackInAppAmazonStorePurchaseEvent(title,description,price,currency,productID,userID,purchaseToken);

Você encontra definições de parâmetros no arquivo Chartboost.cs do projeto de amostra (Assets/Chartboost/Scripts/):

namespace ChartboostSDK {

#if UNITY_ANDROID
/// <resumo>
/// Acompanhar um evento de compra no aplicativo na Google Play Store.
/// Acompanha compras no aplicativo para uso posterior com segmentação e direcionamento de usuários.
/// </resumo>
/// <param name="title">O título localizado do produto.</param>
/// <param name="description">A descrição localizada do produto.</param>
/// <param name="price">O preço do produto.</param>
/// <param name="currency">A moeda localizada do produto.</param>
/// <param name="productId">O identificador no google play do produto.</param>
/// <param name="purchaseData">A sequência de dados de compra para a transação.</param>
/// <param name="purchaseSignature">A assinatura de compra para a transação.</param>
 public static void trackInAppGooglePlayPurchaseEvent(string title, string description, string price, string currency, string productID, string purchaseData, string purchaseSignature) {
 CBExternal.trackInAppGooglePlayPurchaseEvent(title,description,price,currency,productID,purchaseData,purchaseSignature);
 }

/// <resumo>
/// Acompanhar um evento de compra no aplicativo na Amazon Store.
/// Acompanha compras no aplicativo para uso posterior com segmentação e direcionamento de usuários.
/// </resumo>
/// <param name="title">O título localizado do produto.</param>
/// <param name="description">A descrição localizada do produto.</param>
/// <param name="price">O preço do produto.</param>
/// <param name="currency">A moeda localizada do produto.</param>
/// <param name="productID">O identificador amazon do produto.</param>
/// <param name="userID">O identificador do usuário para a transação.</param>
/// <param name="purchaseToken">O token de compra para a transação.</param>
 public static void trackInAppAmazonStorePurchaseEvent(string title, string description, string price, string currency, string productID, string userID, string purchaseToken) {
 CBExternal.trackInAppAmazonStorePurchaseEvent(title,description,price,currency,productID,userID,purchaseToken);
 }

#elif UNITY_IPHONE
/// <resumo>
/// Acompanhar um evento de compra no aplicativo na iOS App Store.
/// Acompanha compras no aplicativo para uso posterior com segmentação e direcionamento de usuários.
/// </resumo>
/// <param name="receipt">O recibo de transação usado para validar a compra.</param>
/// <param name="productTitle">O título localizado do produto.</param>
/// <param name="productDescription">A descrição localizada do produto.</param>
/// <param name="productPrice">O preço do produto.</param>
/// <param name="productCurrency">A moeda localizada do produto.</param>
/// <param name="productIdentifier">O identificador iOS do produto.</param>
 public static void trackInAppAppleStorePurchaseEvent(string receipt, string productTitle, string productDescription, string productPrice, string productCurrency, string productIdentifier) {
 CBExternal.trackInAppAppleStorePurchaseEvent(receipt, productTitle, productDescription, productPrice, productCurrency, productIdentifier);
 }
#endif

}
Testando sua configuração PIA (jogos de iOS construídos com Unity)

Após concluir a integração PIA, você pode entrar no modo de teste para testar o trabalho antes de enviar o jogo para aprovação na App Store.

Para fazer isso, será necessário ativar um indicador de modo de teste no Chartboost SDK através de uma variável de ambiente no Xcode. Faça o seguinte:

1. Abra a seção de esquema no canto superior esquerdo do Xcode e escolha Editar esquema no menu suspenso:

2. Clique em Executar no menu do lado esquerdo e alterne para a aba Argumentos:

3. Clique no símbolo + na seção Variáveis de Ambiente e digite CB_TEST_MODE no campo Nome que aparece:

4. Clique duas vezes no espaço abaixo do título Valor e digite ativado no campo que aparece:

Após isso, clique em OK, execute seu projeto e faça uma compra no modo de desenvolvimento. Você deverá ver o app aparecer no Painel de análises pós-instalação dentro de alguns minutos, se já integrou o PIA em um outro jogo. (Se este é o seu primeiro app com PIA, aguarde até um dia para obter acesso ao painel PIA).

(Note que como o modo de teste está ativado, você não verá nenhum dado sobre compras no aplicativo no painel).

Remova a variável de ambiente CB_TEST_MODE antes de iniciar o jogo!