Estamos sempre publicando atualizações em nossa documentação, mas pode ser que elas ainda não estejam disponíveis em seu idioma. Para ter acesso às informações mais atualizadas, use a ​​versão em inglês.

Configuração do Piano Analytics

O Piano Analytics é um parceiro de analytics integrado à Adjust. Nossa integração permite que o Piano Analytics receba dados mensurados na Adjust por meio de callbacks automáticos. Use esses dados com as ferramentas de parceiros para analytics e insights.

Neste artigo, saiba como configurar a mensuração com o Piano Analytics para seu aplicativo. Isso inclui a ativação da integração e a escolha dos dados que a Adjust pode compartilhar com o Piano Analytics.

Antes de começar

Requisitos

iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

Credenciais

Collection Domain e Site ID

  • Para obter ajuda para encontrar suas credenciais, entre em contato com seu representante do Piano Analytics.

No painel do Piano Analytics:

Antes de habilitar a integração do Piano Analytics, você precisa criar os seguintes eventos na interface de usuário do Piano Analytics com os nomes exatos listados abaixo para garantir que seus dados sejam relatados corretamente:

  • adjust.installs
  • adjust.uninstalls
  • adjust.reinstalls
  • adjust.reattributions

As instruções sobre como criar esses eventos no Piano Analytics podem ser encontradas aqui.

Selecione Piano Analytics e o seu aplicativo no Campaign Lab

  1. Em Campaign Lab, selecione Parceiros.
  2. Selecione Novo parceiro > Piano Analytics. Selecione Próximo para ir para a próxima tela.
  3. Na tela Seleção de aplicativos, escolha o aplicativo para o qual deseja criar o link e habilite a integração para compartilhar dados com o Piano Analytics.
  4. Selecione Próximo.

Habilitar o compartilhamento de dados

Habilite o compartilhamento de dados para ativar a integração com o Piano Analytics. Para fazer isso:

  1. Insira seus Collection Domain e Site ID.

Depois que você habilitar o compartilhamento de dados com o Piano Analytics, a Adjust enviará automaticamente os seguintes dados ao Piano Analytics, por padrão:

  • instalação
  • desinstalação
  • reinstalação
  • reatribuição

Configurar suas opções de compartilhamento de dados

Se estiver trabalhando com um aplicativo multiplataforma com compartilhamento de dados habilitado para várias plataformas, você pode:

  1. Separar opções de compartilhamento de dados no nível de plataforma selecionando Usar as configurações específicas da plataforma.
  2. Definir as mesmas configurações de compartilhamento de dados para múltiplas plataformas selecionando Usar as configurações globais.

Agora, em O que será compartilhado por padrão?, revise as atividades que o Adjust compartilha com o Piano Analytics por padrão:

  • instalação
  • desinstalação
  • reinstalação
  • reatribuição

Enviar dados adicionais

Escolha a quantidade e o tipo de dados que deseja compartilhar com o Piano Analytics por meio de retornos de chamada. O Piano Analytics pode usar essas informações para otimizar o desempenho.

Para enviar dados adicionais, você pode revisar e personalizar o seguinte:

Desinstalações ou reinstalações

O compartilhamento de desinstalações ou reinstalações permite que o Piano Analytics receba os dados de desinstalação e/ou reinstalação do seu aplicativo mensurados pela Adjust.

Observação:

No caso de apps iOS, pode haver uma baixa quantia de desinstalações e/ou reinstalações. Para mais informações, confira o artigo Mensuração de desinstalações e reinstalações.

Mapear parâmetros

Normalmente é necessário mapear os parâmetros para compartilhar dados personalizados com o Piano Analytics.

Os parâmetros de parceiros (disponíveis no SDK da Adjust, versão 4.0+) permitem à Adjust coletar pontos de dados personalizados do seu aplicativo e enviá-los ao Piano Analytics. Isso permite que o Piano Analytics receba detalhes de eventos personalizados para cada um de seus eventos vinculados.

Antes de adicionar novos parâmetros do parceiro ao SDK da Adjust, confira se não há parâmetros pré-existentes que já atendem seus requisitos.

Para encaminhar parâmetros de parceiros ao Piano Analytics, siga estes passos.

  1. Configure os parâmetros do parceiro no SDK da Adjust.

    • Confira Antes de começar para ver todos os links de plataformas de desenvolvimento de SDK.
  2. Em Configure suas opções de compartilhamento de dados, selecione Parâmetros.

  3. Em Mapear parâmetros, você pode especificar como deseja enviar à rede os parâmetros do parceiro definidos no SDK:

    1. Selecione Mapear parâmetro.
    2. No campo Parâmetro do SDK, insira o nome do parâmetro de SDK que você deseja compartilhar com a rede.
    3. No campo Parâmetro do parceiro, insira o parâmetro de rede que corresponde ao parâmetro do SDK.
Observação:

Se você configurar os parâmetros do parceiro no SDK da Adjust sem configurar o compartilhamento de parâmetros no painel, a Adjust encaminhará os parâmetros conforme nomeados no SDK da Adjust.

Habilitar o Piano Analytics para seu aplicativo

Na tela Revisão da configuração, revise suas escolhas. Você também pode retornar e fazer alterações em:

  • Seu app selecionado
  • Opções de compartilhamento de dados

Selecione Habilitar parceiro para habilitar o Piano Analytics para seu aplicativo. Os parceiros de análise não trabalham com links para campanhas. Uma vez ativada, nossa integração envia dados de atribuição e de eventos no aplicativo por meio de callbacks automatizados.

Instruções de configuração de parceiros específicos

O Piano Analytics exige que o ID do visitante vincule a instalação inicial aos eventos in-app posteriores. Para isso, é preciso enviar o ID do visitante do Piano Analytics como um parâmetro global do parceiro de SDK com o nome exato PAVisitorId . Para obter mais informações sobre como vincular parâmetros globais de parceiros, confira nossas documentações:

Este é um exemplo do código de implementação para Android:

const PAVisitorId = pa.getVisitorId();

Adjust.addGlobalPartnerParameter("PAVisitorId", PAVisitorId);

Lista de todos os parâmetros encaminhados a Piano Analytics

O Piano Analytics solicita que a Adjust envie os seguintes parâmetros (pontos de dados) com seus callbacks:

PlaceholderInformação
{session_count}Número de sessões registradas pelo SDK atual da Adjust
{adgroup_name}Nome do grupo de anúncios, conforme retirado do tracker
{campaign_name}Nome da campanha, conforme retirado do tracker
{created_at}Marca temporal da atividade
{creative_name}Nome do criativo, conforme retirado do tracker
{device_manufacturer}Nome do fabricante do dispositivo
{installed_at}Marca temporal da instalação (isto é, primeira abertura do aplicativo)
{network_name}Nome da rede, conforme retirado do tracker