Testando a integração do SDK para profissionais de marketing

O Visualizador de Eventos ao Vivo é uma ferramenta de teste que mostra dados em tempo real enviados do SDK para a AppsFlyer, como eventos de instalação e outros eventos in-app. Para cada evento capturado, você pode ver o log de eventos e os detalhes.

Para exibir eventos no Visualizador de Eventos ao Vivo:

1. Na AppsFlyer, no menu lateral, selecione configurações > Testes de Integração do SDK.

   

2. Clique em Eventos ao vivo.

   

3. Na lista de Aplicativos , selecione o app que você deseja testar.
4. Na lista de Dispositivos de teste , selecione o dispositivo que você quer usar para testar seu aplicativo. Se você não tiver um dispositivo de teste, poderá registrar um clicando no link Adicionar um dispositivo de teste.
5. Clique em Continuar para começar a registrar os eventos do seu aplicativo.

6. Inicie o aplicativo e interaja com ele para gerar sessões e eventos in-app.

   

7. Clique em um item de evento para exibir os detalhes do evento no painel direito.
8. Se você quiser parar de gravar os eventos, clique em Parar. Clique em Começar novamente quando você quiser continuar.

Para testar instalações não orgânicas:

1. Na AppsFlyer, no menu lateral, selecione configurações > Testes de Integração do SDK. 

   

2. Clique em testar Instalações não orgânicas.

   

3. Na lista de Aplicativos , selecione o app que você deseja testar.
4. Na lista de Dispositivos de teste , selecione o dispositivo que você quer usar para testar seu aplicativo. Se você não tiver um dispositivo de teste, poderá registrar um clicando no link Adicionar um dispositivo de teste.
5. Se o aplicativo testado estiver instalado no seu dispositivo de teste, desinstale-o.
6. Selecione Removi o aplicativo do dispositivo testado.
7. Clique em Continuar e siga as etapas do assistente.

Se o aplicativo não registrar uma instalação não-orgânica, os possíveis motivos podem ser:

• O IDFA está disponível, mas o dispositivo de teste não foi registrado com esse identificador na página de Dispositivos de teste.
• Você tem mais de 1 dos seus aplicativos, além do aplicativo de teste, instalado no dispositivo de teste, mas o dispositivo de teste não foi registrado com o IDFV na página de Dispositivos de teste.
• Uma instalação orgânica foi gravada.
• O teste foi realizado em uma versão do aplicativo que não inclui o SDK.

Para erros de integração, entre em contato com o desenvolvedor.

Antes de começar:

• Inicie o aplicativo de teste pelo menos 3 vezes.
• Para testar o deep linking (retargeting), o OneLink deve ser definido para o seu aplicativo. Para mais informações, consulte o guia de configuração do OneLink. 
• Verifique se o retargeting está ativado.

Para testar deep links:

1. Na AppsFlyer, no menu lateral, selecione configurações > Testes de Integração do SDK.

   

2. Clique em retargeting.

   

3. Na lista de Aplicativos , selecione o app que você deseja testar.
4. Na lista de Dispositivos de teste , selecione o dispositivo que você quer usar para testar seu aplicativo. Se você não tiver um dispositivo de teste, poderá registrar um clicando no link Adicionar um dispositivo de teste.
5. Clique em Continuar e siga as etapas do assistente.

Testar instalações permite que você verifique se o SDK da AppsFlyer está atribuindo instalações corretamente a vários canais de mídia.

Para testar a atribuição de instalação:

1. Copie o link a seguir (Android ou iOS) e faça as seguintes alterações:

   1. Valor app_id: adicione o seu app ID na AppsFlyer. 
   2. Parâmetro pid: especifique o nome do canal de mídia ao qual a instalação é atribuída.
   3. Parâmetro c: especifique o nome da campanha.
   4. Se você estiver testando um aplicativo disponível em uma loja externa do Android: adicione o parâmetro af_r ao link de atribuição.  
   5. Substitua o GAID, o IDFA ou o IDFV pelo identificador de dispositivo específico.
   Android iOS

   https://app.appsflyer.com/<app_id>?pid=Test&c=Test&advertising_id=<GAID>

   IDFA

   https://app.appsflyer.com/<app_id>?pid=Test&c=Test&idfa=<IDFA>

   IDFV

   https://app.appsflyer.com/<app_id>?pid=Test&c=Test&idfv=<IDFV>

   Abaixo estão exemplos de links de atribuição com valores específicos:

   Android iOS

   https://app.appsflyer.com/com.my.app?pid=Test&c=Test&advertising_id=12345f9*-eba*-421*-876*-7654ac67876*

   https://app.appsflyer.com/id123456789?pid=Test&c=Test&idfa=1A2B****-9128-4***-123*-04E***654321

   Observação:

   Se você estiver testando um aplicativo iOS sem registrar um dispositivo de teste, seu clique de teste poderá ser sinalizado como fraudulento pelo P360.

   Para evitar que esse evento seja detectado como fraude, adicione o seguinte parâmetro de consulta ao seu link: pid=”ios_testing”

2. Copie o link atualizado, envie-o para o dispositivo de teste e clique no link.

   Observação:

   No iOS, use o iMessage ou o e-mail para enviar o link para o dispositivo. Não cole o link no aplicativo iOS Notes e clique no link. Essa ação pode fazer com que o link quebre.

3. Siga um dos procedimentos abaixo:

   • Se o aplicativo estiver ativo, realize a instalação.
   • Se o aplicativo estiver pendente, a seguinte mensagem será exibida: "O aplicativo que você está procurando ainda não está disponível no mercado."Este é o resultado esperado. Como o aplicativo não está ativo, o link de atribuição não leva a nenhuma loja de aplicativos. No entanto, o link de atribuição ainda é válido para fins de atribuição e você deve instalar o aplicativo da seguinte maneira:
     • Para Android A partir de um arquivo APK (ou Android Studio para desenvolvedores)
     • Para iOS: Do TestFlight (ou Xcode para desenvolvedores)

   Você verá uma instalação atribuída à campanha de teste no canal de mídia chamado Test. Aguarde até 30 minutos para que a instalação apareça no dashboard do aplicativo.

   

O teste de eventos in-app permite verificar se a receita associada a um evento é exibida e se os eventos in-app são atribuídos ao canal de mídia que gera a instalação.

Para testar a atribuição de eventos in-app:

1. Abra o aplicativo e, em seguida, gere alguns eventos in-app.

2. Abra o dashboard do aplicativo e clique em Eventos.

   Você verá os eventos, a receita (se a receita estiver associada a eles) e o canal de mídia ao qual eles estão associados. Aguarde entre 60 a 70 minutos para que os eventos apareçam no dashboard.

   

Dica! Considere fazer o download do relatório de dados brutos de eventos in-app para verificar se os eventos foram atribuídos corretamente. Esse relatório leva vários minutos para ser baixado.

Para fazer o download do relatório:

1. Na AppsFlyer, no menu lateral, selecione relatório > exportação de dados brutos.
2. Na seção Relatórios de dados brutos, faça o download do relatório de dados brutos de eventos in-app.

O OneLink permite que você configure um único link de atribuição tanto para o iOS quanto para o Android. O OneLink reconhece o dispositivo do usuário e o redireciona para a loja de aplicativos relevante.

Além do mais, o OneLink habilita o deep linking. O deep linking permite que você abra o aplicativo em um destino específico do app enquanto fornece conteúdos personalizados.

Para mais informações, consulte nosso guia de teste de URLs do OneLink.

A atribuição de retargeting ocorre quando um usuário engaja com uma campanha de retargeting clicando em um link de atribuição de retargeting. Isso resulta em um evento de reatribuição ou reengajamento. Para mais informações, consulte o Guia de atribuição de retargeting.

Os testes de retargeting incluem:

• Para reatribuição: Desinstalação e reinstalação do aplicativo. Depois, verifique no dashboard se uma instalação foi registrada.
• Para reengajamento: Clique em um link de atribuição de retargeting ou em um deep link e verifique se um reengajamento foi atribuído ao canal de mídia correto.

Antes de executar testes de retargeting, a seguinte configuração é necessária:

• O retargeting deve estar ativado para o aplicativo que você está testando.
• Crie um link específico do aplicativo ou recupere um link personalizado do OneLink. Esses links devem incluir o parâmetro de retargeting.

Para configurar testes de retargeting:

1. Habilitar o retargeting nas configurações do aplicativo

   No dashboard do aplicativo, clique em Configurações do aplicativo e habilite a opção Ativar atribuição de retargeting.

   

2. Siga um dos procedimentos abaixo: 
   • Crie um link de atribuição específico do aplicativo. Certifique-se de incluir o parâmetro de redirecionamento, is_retargeting=truee o ID de publicidade. Para visualizar o GAID, IDFA ou IDFV, siga as instruções Registrando um dispositivo de teste.  
     Veja a seguir um exemplo de um link de atribuição que inclui um parâmetro específico do Android como o identificador de dispositivo (GAID). Para mais informações sobre como adicionar outros parâmetros de identificador de dispositivo, como IDFA ou IDFV, consulte Estrutura e parâmetros do link de atribuição.  

     https://app.appsflyer.com/<app_id>?pid=Test&c=Test&is_retargeting=true&advertising_id=<GAID>

   • Recupere a URL longa do link personalizado de um template do OneLink. Certifique-se de ativar a campanha de retargeting. A imagem a seguir mostra um exemplo de uma URL longa personalizada:

Agora você pode prosseguir e testar a reatribuição e o reengajamento.

Antes de começar:

• Siga as instruções para configurar testes de retargeting.
• Certifique-se de que seu dispositivo de teste não está registrado.

Para testar a reatribuição:

1. Desinstale o aplicativo do dispositivo. Se você acabou de instalar o aplicativo, aguarde alguns minutos.
2. Copie o link de atribuição criado anteriormente, o link de atribuição específico do aplicativo ou o link longo personalizado do template do OneLink, envie-o para o dispositivo de teste e clique no link.

   Observação:

   No iOS, use o iMessage ou o e-mail para enviar o link para o dispositivo. Não cole o link no aplicativo iOS Notes e clique no link. Essa ação pode fazer com que o link quebre.

3. Siga um dos procedimentos abaixo:
   • Se o aplicativo estiver ativo, realize a instalação.
   • Se o aplicativo estiver pendente, instale-o da seguinte forma:
     • Para Android Instale a partir do Android Studio ou de um arquivo APK.
     • Para iOS: Instale a partir do TestFlight.
4. Abra o dashboard do aplicativo e, em Tipo de visualização, selecione Retargeting.

5. Em Tipo de atribuição, selecione Reatribuições.

   Você deve ver a instalação atribuída ao canal de mídia e à campanha. Aguarde até 30 minutos para que a instalação de retargeting apareça no dashboard.

   

Antes de começar:

• Siga as instruções para configurar testes de retargeting. 
• Para fins de teste, defina o tempo mínimo entre as conversões para Nenhum. Isso permite que todas as conversões de reengajamento sejam registradas e atribuídas durante o teste.
• Certifique-se de que o aplicativo esteja instalado no seu dispositivo de teste e tenha sido inicializado várias vezes. Se você acabou de instalar o aplicativo, aguarde alguns minutos.

Para testar o reengajamento (deep linking direto):

Certifique-se de que seu app esteja configurado para deep linking e, em seguida, siga esse procedimento de teste.

Para testar o reengajamento (deep linking indireto):

1. Copie o link de atribuição que você criou anteriormente, seja o link de atribuição específico do aplicativo ou o link longo personalizado do template do OneLink.
2. Envie o link para o dispositivo de teste e clique no link.

3. Para abrir o aplicativo, siga um desses procedimentos:

   • Na loja de aplicativos, clique em Abrir.
   • Inicialize o aplicativo do seu dispositivo.

   No dashboard, você deve ver um reengajamento atribuído ao canal de mídia e à campanha. Espere até 30 minutos para que o reengajamento apareça.

   

Dica! Considere fazer o download do relatório de dados brutos de conversões para verificar se o reengajamento foi atribuído ao canal de mídia correto. Esse relatório leva vários minutos para ser baixado.

Para fazer o download do relatório:

1. Na AppsFlyer, no menu lateral, selecione relatório > exportação de dados brutos.
2. Na seção Retargeting, faça o download do relatório Conversões (reengajamentos e reatribuições).