Análises pós-instalação - terceiros

Última atualização:

Para ter uma análise mais completa de dados de compras no aplicativo (IAP) entre plataformas ou redes, você também pode configurar uma integração S2S para importar informações de compras de serviços de acompanhamento de terceiros. Após a integração, você poderá ver os dados de terceiros no painel Chartboost.

Usando Chartboost SDK e uma integração de terceiros?

O comportamento padrão é continuar escutando o SDK para eventos PIA e ignorar eventos S2S PIA. Você pode consultar o Suporte ou o gerente da conta e pedir para trocar do SDK para a integração de terceiros, e nesse momento começamos a escutar eventos S2S e ignorar os eventos Chartboost SDK. Isso previne a duplicação de eventos e mantém um único canal para dados de entrada. Apps podem ser trocados de volta a qualquer momento através do Suporte.

Conteúdo


Instruções de Adjust

1. Abra o app cujos dados de compras no aplicativo você deseja enviar ao Chartboost

2. Clique em Configurações, depois Configuração de parceiro

3. EmRedes , escolha Chartboost

4. Defina o Encaminhamento de receita como ATIVADO e somente atribuído como DESATIVADO.  Encaminhamento de parâmetro também deve ser deixado de fora, a menos que você esteja mapeando o valor Rótulo do evento no SDK Adjust.

5. Digite "purchase" no campo EVENT LABEL para qualquer evento de compra no aplicativo que você esteja acompanhando com Adjust, na seção Vinculação de evento Chartboost.  Deixe em branco os campos EVENT FIELD, MAIN LEVEL e SUB LEVEL.

FAQ de Adjust

Todos os campos mostrados na seção "Vinculação de evento" no painel Adjust são enviados ao Chartboost automaticamente no Postback IAP?

Não, somente Rótulo do evento é enviado como "product_id" para o Chartboost. 

Para que servem os campos de texto à direita de cada nome de evento?

Adicione o valor do evento a estes campos. Quando esses eventos são enviados ao Chartboost, são marcados com o valor do evento no campo de texto.

Existe um limite de eventos que podem ser relacionados na seção Vinculação de eventos?

Não. A janela é rolante, para que você possa adicionar todos os eventos de compra que já acompanha com Adjust.


Instruções de AppsFlyer

1. Entre no painel do seu app AppsFlyer e clique em Configuração de origem de mídia à esquerda

2. Procure e clique em Chartboost S2S, depois alterne para a aba Eventos no app

3. Preencha a seção Enviar eventos no app ao Chartboost conforme mostrado abaixo e adicione seu próprio ID do app Chartboost ao campo chartboost_app_id.

4. Você também precisa contatar o Suporte para receber o token que adicionará ao campo Identificador de evento Chartboost:

Obs.: o AppsFlyer só suporta atualmente o envio de eventos de compra ao Chartboost.  O acompanhamento de Nível/Evento será suportado no futuro.


Instruções de Apsalar

Para receber dados de compras no aplicativo do Apsalar, você deve criar um novo postback (Configuração > Acompanhamento de atribuição > Criar novo postback) com as seguintes configurações:

  • Destinatário do postback: Chartboost
  • Aplicativo: Selecione o aplicativo
  • Tipo de evento: Evento personalizado (depois selecione o evento de receita específico no menu suspenso)
  • Status de Postback: Ativo, começar a enviar imediatamente
  • Regras de atribuição: Enviar todos eventos de todas as origens

Você também precisa adicionar seu ID do app do Chartboost,, token (contate Suporte se ainda não possui) e a chave que identifica nomes de produtos de compras em aplicativo aos três campos na seção Visualização:


Instruções de Kochava

Você encontra instruções de postback de evento na Central de Suporte Kochava.


Instruções de TUNE

  • Abra o painel de configuração do Chartboost configuration na abaParceiros integrados.
  • Selecione Postbacks e clique em Adicionar URL de Postback.

 

 

  • Pesquise Chartboost na seção Modelo de postback de parceiro de publicidade.
  • Na seção Modelo de postback do Chartboost, escolha iOS ou Android no menu suspenso Plataforma.
  • Escolha Postback do Chartboost IAP | compra | Tudo no menu suspenso Modelo de postback.
  • Adicione o ID do app e assinatura do app Chartboost e salve.

 

 


Outros terceiros

Se você é desenvolvedor e quer tirar proveito desta funcionalidade, mas não vê o seu serviço de acompanhamento de terceiros acima, envie as informações abaixo ao serviço:

Chamadas S2S PIA de terceiros contêm informações sobre compras no aplicativo e um token API (entre em contato conosco para obter o token) para verificar a solicitação:

{

    "app_id": "54ecc0535beacdc1e1eff778"
    "ifa": "8c2d20ef2f4248209f65b35e3c398731"
    "iap": {
        "product_id": "com.sample.gems.001"
"currency": "EUR", "price": 3.99, "localized_description": "TheFirstGemsPack", "localized_title": "GemsPack" } }

Abaixo encontram-se informações sobre a chamada S2S; para receber seu token API, entre em contato conosco.

Dados de solicitação PIA S2S

Método

POST

Ponto de extremidade

https://live.chartboost.com

Caminho

/event_service/v3/track

Cabeçalhos

(Note que os cabeçalhos contêm informações de autenticação.)

Nome do cabeçalho Exemplo Descrição
X-Chartboost-Token 2782f24948b6dff2551ff321f70266c415e0d251 Seu token API
X-Chartboost-Signature 173e6aeff28e4b76b488d5acf49ed8ebb8e95559 Veja este gist para gerar. Este NÃO é o mesmo valor da sua assinatura do app Chartboost!

Corpo JSON: parâmetros do objeto IAP

Parâmetros Apps iOS Apps Android Exemplo Descrição
currency Necessário Necessário "USD" Código de moeda ISO 4217 de 3 letras
localized_description Opcional Opcional "Um pequeno pacote de moedas" Descrição do item no idioma do jogador
price Necessário Necessário 0.99 Preço do item na moeda definida no parâmetro currency
localized_title Opcional Opcional "Pequeno pacote de moedas" Título do item no idioma do jogador
product_id Necessário Necessário "com.app.exampleapp.1234" SKU

Corpo JSON: solicitar parâmetros

Parâmetros Apps iOS Apps Android Exemplo Descrição
app_id
Necessário Necessário "54ecc0535b1acdc1e1eff778" Id do app Chartboost (encontrado no painel Chartboost) 
ifa Necessário N/D "61109b4c0f164fbc82ec5475313ae000" (32 caracteres; traços OK; não diferencia maiúsculas e minúsculas) Identificador para anúncios 
gaid N/D Necessário "38400000-8cf0-11bd-b23e-10b96e40000d" (32 caracteres mais 4 traços) Google Services Advertising ID (somente Android)
uuid N/D Opcional (se GAID não foi enviado ou se for app Amazon) "358414046356276" Para Android IDs ou jogos Amazon de legado
iap Necessário Necessário   Detalhes de JSON de compras no aplicativo; veja a seção IAP abaixo

Chave pública/Chave secreta (somente Google Play/Amazon)

Se você está configurando S2S PIA para jogos Google Play ou Amazon Appstore, você também precisa adicionar a sua chave pública ou Amazon Developer Secret, respectivamente, a um campo na página Editar app do jogo:

Construção da solicitação

Primeiro, comece com o ponto de extremidade:

https://live.chartboost.com/event_service/v3/track

Adicione os cabeçalhos e adicione os parâmetros ao corpo JSON:

{

    "app_id": "54ecc0535b1acdc1e1eff778"
    "ifa": "61109b4c0f164fbc82ec5475313ae000"
    "iap": {
        "product_id": "com.sample.gems.001"
"currency": "EUR", "price": 3.99, "localized_description": "TheFirstGemsPack", "localized_title": "GemsPack" } }

E pronto – as solicitações com êxito receberão: {"status":200,"message":"Success"}.

Se a sua chamada receber um código de erro 500 HTTP, o seu servidor deve tentar novamente a chamada S2S, porém mais tarde: tente novamente em 2 segundos, depois 4 segundos, depois 8 segundos, depois 16 segundos, até obter êxito.