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

A partir do iOS 14.5, o IDFA só estará disponível se o usuário consentir através do prompt de AppTrackingTransparency (ATT). Se o prompt da ATT tiver sido implementado no seu aplicativo, você poderá executar testes como um usuário que consente ou que não consente.  Para mais informações, consulte as diretrizes para registrar seu dispositivo de teste com IDFA ou IDFV.

Recomendamos que você comece testando uma instalação orgânica.

Para testar uma instalação orgânica:

1. Instale o aplicativo em um dispositivo de teste registrado.
2. Inicie o aplicativo.

O dashboard do aplicativo exibe uma nova instalação orgânica. Aguarde até 30 minutos para que a instalação apareça.

Use a página Testes de integração do SDK para testar instalações não-orgânicas, eventos in-app e deep linking (retargeting) e localizar quaisquer problemas de integração no seu projeto.

Somente iOS: a página de teste de integração do SDK é aplicável apenas para aplicativos iOS que implementam ATT. Você pode testar aplicativos não ATT usando o procedimento especificado aqui.

Antes de começar:

1. Prepare um dispositivo (Android ou iOS) que não tenha o aplicativo instalado. Se necessário, desinstale o aplicativo do dispositivo.
2. Registre o dispositivo como um dispositivo de teste.

Etapa 1: teste instalações não-orgânicas

1. No dashboard, selecione o aplicativo.
2. Acesse Integração > Testes de integração do SDK. 
   A página de testes de integração do SDK é aberta. 
   
3. Execute o teste Instalação não-orgânica.
4. Selecione um dispositivo de teste da lista. 
5. Selecione a loja a partir da qual você quer instalar o aplicativo:
   • Para Android: 
     • Google Play
     • Outros (por exemplo, fora da loja, Android Studio, arquivo APK) 
   • Para iOS:
     • Loja de aplicativos
     • Outros (por exemplo, XCode, TestFlight)
6. Digitalize o código QR com o dispositivo de teste registrado e siga as instruções no dispositivo.

   Observe que, para dispositivos Android, esse teste usa o método referenciador de instalação e, por isso, o link de atribuição não inclui o GAID.

7. Se você selecionou Outros, instale o aplicativo do seu ambiente de desenvolvimento.
8. Aguarde a instalação não-orgânica ser registrada na página de Testes de Integração do SDK, indicando qual teste foi realizado com sucesso. Isso pode levar até 2 minutos.

   

   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.

Etapa 2: testar eventos in-app

Antes de começar:

• Certifique-se de usar o mesmo dispositivo de teste usado para registrar uma instalação não-orgânica.

1. Execute o teste de Eventos in-app.
2. Selecione um dispositivo de teste da lista e clique em Avançar. 
3. Inicialize seu aplicativo e comece a gerar eventos in-app.
4. Você verá um registro desses eventos conforme eles são registrados em tempo real.

   

Etapa 3: teste deep links (retargeting)

Antes de começar:

• Certifique-se de usar o mesmo dispositivo de teste usado para gravar uma instalação não orgânica. 
• Inicialize o aplicativo de teste pelo menos 3 vezes.
• Para testar o deep linking (retargeting), o OneLink deve ser definido para seu aplicativo. Para mais informações, consulte o Guia de configuração do OneLink. 
• Verifique se o retargeting está ativado.

1. Execute o teste de deep linking.
2. Selecione um dispositivo de teste da lista.
3. Selecione um tipo de teste:
   • OneLink: selecione o OneLink.
   • Esquema URI: insira o esquema URI (por exemplo, greatapps://cars).
4. Clique em Avançar.
5. Escaneie o QR code com seu dispositivo de teste registrado e siga as instruções no seu dispositivo. Assim que um teste for concluído, o Teste de deep linking será registrado como bem-sucedido.

   

Testar instalações permite que você verifique se o SDK da AppsFlyer está atribuindo instalações corretamente a várias fontes 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 ID do aplicativo na AppsFlyer. 
   2. parâmetro pid: especifique o nome da fonte de mídia à 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 Android de terceiros: 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

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." Esse é 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: 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 na fonte de mídia chamada Teste. 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 à fonte 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 a fonte de mídia à 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. No dashboard, acesse Relatórios > Exportar dados.
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 os links diretos. Os links diretos permitem que você abra o aplicativo em uma atividade específica do aplicativo enquanto fornece conte´udos personalizados.

Para obter mais informações, consulte nosso guia em 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 obter mais informações, consulte o Guia de atribuição de retargeting.

Os testes de retargeting incluem o seguinte:

• Para reatribuição: desinstale e reinstale o 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 é atribuído à fonte de mídia correta.

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

• O retargeting deve ser 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 retargeting, is_retargeting=true e o ID de publicidade. Para visualizar o GAID, o IDFA ou o IDFV, siga as instruções para  Registrar 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 obter 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 painel do aplicativo e, na caixa Tipo de visualização, selecione Retargeting.
5. Na caixa Tipo de atribuição, selecione Reatribuições.

   Você deve ver a instalação atribuída à fonte de mídia e à campanha. Aguarde até 30 minutos para que a instalação após 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 em 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 este procedimento para testar.

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 destes procedimentos:
   • Na loja de aplicativos, clique em Abrir.
   • Inicialize o aplicativo do seu dispositivo.

   No painel, você deve ver um reengajamento atribuído à fonte de mídia e à campanha. Aguarde 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 à fonte de mídia correta. Esse relatório leva vários minutos para ser baixado.

Para fazer o download do relatório:

1. No dashboard, acesse Relatórios > Exportar dados.
2. Na seção Retargeting, faça o download do relatório Conversões (reengajamentos e reatribuições).