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

Visão geral: teste a integração do seu aplicativo Android ou iOS com a AppsFlyer. 

Leitura relacionada sobre ad networks: testes de integração de ad networks

Visão geral

Testar cuidadosamente a integração garante uma coleta de dados precisa e abrangente. Ao testar a integração do SDK, você pode verificar se o SDK está se comunicando com êxito com os servidores da AppsFlyer, e se as instalações, os eventos in-app e o retargeting estão sendo registrados e atribuídos corretamente. 

Quando a integração do SDK estiver concluída, qualquer membro da equipe com acesso ao dashboard da AppsFlyer poderá realizar testes básicos. Os desenvolvedores podem utilizar logs de depuração no ambiente de desenvolvimento.

Este artigo descreve os procedimentos de teste a partir do dashboard e fornece links para a documentação que o profissional de marketing deve fornecer ao desenvolvedor. 

Métodos de teste

As seções a seguir descrevem os vários testes a serem realizados e os métodos disponíveis.

Teste a partir do dashboard

Para testar a integração do SDK no dashboard, primeiro você deve registrar um dispositivo de teste (Android ou iOS). Isso permite que você use o mesmo dispositivo repetidamente, evitando que as instalações sejam registradas como reinstalações.  

Execute os seguintes procedimentos:

  • Teste as instalações orgânicas.
  • Teste a funcionalidade básica de integração (instalações não-orgânicas, eventos in-app e retargeting).
    Os métodos disponíveis incluem:
    • Página de teste de integração do SDK: um assistente no dashboard da AppsFlyer que orienta o usuário pelo processo de execução de cada teste.
    • Testes usando links de atribuição: todas as ad networks que não são SRN e as fontes de mídia próprias dependem do uso de links de atribuição da AppsFlyer; portanto, a realização de testes usando links de atribuição é altamente recomendável. Você cria links de atribuição e, em seguida, executa testes para verificar se o SDK está atribuindo instalações não-orgânicas e eventos in-app às fontes de mídia corretas. Além disso, você deve executar testes para verificar se o retargeting (reatribuição e reengajamento) foi registrado e atribuído às fontes de mídia corretas.

Consideração sobre os testes do iOS 14+

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.

Testes no ambiente de desenvolvimento

Um desenvolvedor pode realizar o seguinte:

  • Ative e inspecione os logs de depuração e teste cenários como validação de compra, dados de conversão e deep linking.

     Observação

    É possível que o seu desenvolvedor receber uma resposta 403 nos logs, caso você assine o pacote Zero. Este pacote não inclui dados de atribuição, apenas dados de cliques e impressões. Para obter mais informações sobre nossos pacotes, envie um e-mail para a equipe de CEM em hello@appsflyer.com ou confira a página de preços da AppsFlyer.

  • Crie um aplicativo de depuração para testar a integração do SDK. Ao realizar testes, os dados são registrados e exibidos no dashboard. Não é possível deletar os dados  após eles terem sido gravados. Se você não quiser que os dados de teste sejam registrados como parte de um aplicativo de produção, peça ao desenvolvedor para testar a integração do SDK usando aplicativos de depuração. Um aplicativo de depuração difere de um aplicativo de produção, pois ele possui um ID de aplicativo AppsFlyer diferente, o seu próprio dashboard correspondente, e não pode ser publicado nas lojas de aplicativos.

Adicionar aplicativos de depuração ao dashboard

Se o desenvolvedor criar um aplicativo de depuração, você deverá adicioná-lo ao dashboard. Quando o desenvolvedor começar a realizar testes usando o aplicativo, os dados serão exibidos no dashboard do aplicativo.

Execute um dos procedimentos a seguir para adicionar o aplicativo de depuração:

Adicionar aplicativos de depuração (Android) Adicionar aplicativos de depuração (iOS)

Para adicionar um aplicativo de depuração ao dashboard:

  1. Peça o nome do pacote do aplicativo de depuração ao seu desenvolvedor e adicione o aplicativo ao seu dashboard da AppsFlyer.
  2. Defina o status do aplicativo como um dos seguintes:
    • Pendente de aprovação
    • Não publicado

Casos de teste especiais

Casos de teste especiais incluem o seguinte:

  • Android TV: o SDK é compatível com Smart TVs baseadas em Android. Um profissional de marketing ou qualquer membro da equipe pode testar esses aplicativos de TV seguindo os procedimentos deste artigo.
  • Apple TV (tvOS): o SDK é compatível com o Apple TVs (tvOS). Um profissional de marketing ou qualquer membro da equipe pode testar esses aplicativos de TV seguindo os procedimentos deste artigo.
  • Aplicativos tvOS não publicados: é preciso que um profissional de marketing e um desenvolvedor trabalhem juntos (consulte Testando a integração do tvOS antes de publicar).
  • Amazon Fire TV: um profissional de marketing pode executar testes no dashboard(consulte Testando lojas Android alternativas).
  • Eventos de PBA na web: é preciso que um profissional de marketing e um desenvolvedor trabalhem juntos (consulte Testando a integração de SDK de PBA na web).

Testando a funcionalidade básica do SDK

A seção a seguir descreve os procedimentos que você deve seguir para testar a integração básica do SDK.

Testar instalações orgânicas.

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.

Test_SDK_Organic_install

Teste usando a página Testes de integração do SDK

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.

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.

    NonOrganic_install

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

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.

    Test_SDK_Integration_Inapp_events

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.

    TestSDK_DeepLinks_en-us.png

Testar usando links de atribuição

A seção a seguir descreve os procedimentos que você deve seguir para testar instalações com links de atribuição. Você pode executar esses testes mesmo se o aplicativo ainda estiver pendente (ou seja, não listado na Google Play Store ou na Apple App Store).

Testar atribuição de instalação

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>

    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*
  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: a partir do Android Studio ou de um arquivo APK
      • Para iOS: a partir do TestFlight

    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. Test_Install_Attribution_Link

 Dica

Veja abaixo formas alternativas de verificar os resultados do teste:

  • Se você tiver acesso aos relatórios de dados brutos, baixe o Relatório de dados brutos de instalações. Esse relatório demora para ser baixado.

    Para fazer o download do relatório:

    1. No dashboard, acesse RelatóriosExportar dados. 
    2. Na lista Aquisição de usuários (não orgânica), clique em Instalações e faça o download do relatório. 
  • Se você tiver acesso aos logs de depuração, poderá usar a API de teste de integração do SDK para recuperar os resultados da atribuição de uma instalação específica.

Testar atribuição de eventos in-app

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.

    Testing_InAppEvents_Attribution

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.

Testar o OneLink

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.

Testando o retargeting usando links de atribuição

As seções a seguir descrevem os procedimentos que você deve seguir para testar a atribuição de retargeting.

Sobre testes de retargeting

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.

Pré-requisitos para executar testes de retargeting

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.

    Set_Reattribution_window

  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:

      Testing_LongLink_en-us.png

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

Testar reatribuição

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 clique em Retargeting no menu do lado esquerdo.

    Você verá a instalação atribuída ao Teste de fonte de mídia com o nome de campanha Teste. Aguarde até 30 minutos para que a instalação após retargeting apareça no dashboard.

    Testing_Reattribution

 Dica

Veja abaixo formas alternativas de verificar os resultados do teste:

  • Se você tiver acesso aos relatórios de dados brutos, faça o download do relatório de dados brutos de conversões. Esse relatório demora para ser baixado.

    Para fazer o download do relatório:

    1. No dashboard, acesse RelatóriosExportar dados. 
    2. Na lista Retargeting, clique em Conversões (reengajamentos e reatribuições) e, depois, faça o download do relatório. 
  • Se você tiver acesso aos logs de depuração, poderá usar a API de teste de integração do SDK para recuperar os resultados da atribuição de uma instalação específica.

Testar o reengajamento

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.

    Testing_Reattribution_window

  • 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 dashboard, você deve ver um reengajamento atribuído à fonte de mídia Teste sob o nome da campanha Teste. Aguarde até 30 minutos para que o reengajamento apareça. Testing_ReEngagement

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).
Este artigo foi útil?