Testar a integração do Web SDK do PBA

Para:
Desenvolvedores
Última atualização:

Visão geral: Teste a integração do plug-in PBA do Web SDK.

Testar eventos da web do PBA

Princípios de uso da página de teste

O Web SDK envia eventos da web para o PBA, que são disponibilizados por meio de painéis do PBA e relatórios de dados brutos, após o processamento diário. Para habilitar um processo de teste eficiente, você envia eventos de teste sem esperar pelo processamento diário. Os eventos de teste são:

  • Analisados e validados no recebimento. 
  • Disponibilizados para você na interface do usuário. Isso inclui erros de processamento. Se existirem, envie eventos corrigidos novamente para garantir que sejam processados corretamente. 
  • São processados como qualquer outro evento durante o processamento diário. Isso significa que eles são adicionados aos painéis e dados brutos. 

Página de teste de integração do Web SDK

Visualização principal da página

TestScreen_us-en.jpg

  • Os eventos mais recentes aparecem primeiro.
  • Cache de eventos:
    • Contém até 100 eventos
    • Eventos mais antigos são excluídos para dar lugar a eventos mais recentes
    • Os eventos armazenados em cache são excluídos após 24 horas
  • Controles de página:
    • Indicador de taxa de atualização: A página é atualizada automaticamente a cada 5 segundos.
    • Limpar tudo: Limpa eventos do cache permanentemente. Atenção! O cache é comum a sites que compartilham a mesma chave do desenvolvedor web. Assim, se outro desenvolvedor estiver usando a página de teste, ele também será limpo para eles. 
    • Pausar/iniciar: Pausa a atualização automática. Novos eventos não são exibidos até que você clique em Iniciar. 

Colunas da tabela de eventos

Campo Descrição
Hora (UTC) Hora do evento
Tipo de evento

Os tipos de evento são os seguintes:

  • Eventos enviados por você:
    • EVENT
    • setCustomerUserId
    • pageLoad: Enviado pelo Web SDK sempre que uma página é carregada/atualizada em seu site
Conteúdo do evento

O payload, conforme registrado pelo PBA.
Comentários
  • Válido: O PBA recebeu e gravou o evento. Não é necessária nenhuma ação adicional.
  • Inválido: Lista de erros que requerem ação corretiva. O formato da mensagem de erro é:
    Nome do campo de evento: descrição do erro 
  • Passe o mouse sobre as mensagens de erro para ver os detalhes:

    PBAWebSDKTestingErrorMessagesPopup_en-us.png

 

Visualização detalhada

mceclip0.png

Clique em uma linha de evento para exibir seu conteúdo após o processamento. Ver Parâmetros de evento do Web SDK Para informações adicionais

Procedimentos

Conclua os procedimentos a seguir.

Habilitar o modo de teste

Pré-requisitos

Antes de testar, o Web SDK deve ser implementado em seu site ou em um site de teste.

Limitação do navegador

Se o modo de teste estiver ativado em um determinado navegador, independentemente da guia; O navegador só pode ser usado para se conectar ao site especificado e não a qualquer outro site. Use um navegador diferente, por exemplo, Safari em vez do Chrome, para se conectar da mesma máquina a um site diferente.

Para habilitar o modo de teste:

  1. Verifique se o SDK está carregado:
    1. Na AppsFlyer, no menu superior, selecione Meus aplicativos > Exibir agrupamentos de marca.
    2. Selecione o Teste de integração do Web SDK requerido.
      A página de integração é aberta. A chave do desenvolvedor web é exibida.

      pba_web_sdk_integration_test_web_dev_key_en-us.png

    3. Em uma nova aba do navegador, vá para seu site (que tem o Web SDK instalado).
    4. Clique com o botão direito do mouse e selecione inspecionar para abrir as ferramentas de desenvolvedor do navegador. 
    5. Ir para a aba Console.
    6. No console, digite:
      window.AF_SDK.initPluginsConfig.pba.webAppId

      O webAppID é exibido.

      testing_pba_integration_webappid_check_en-us.png

    7. Verifique se o webAppID é idêntico à chave do desenvolvedor web na página Teste de integração do Web SDK .
  2. Habilitar o modo de teste:
    1. Na aba do navegador do site, vá para a aba Console.
    2. Insira: 
      window.AF_SDK.PLUGINS.PBA.turnOnDevMode()
      A função retornaundefined.

      testing_pba_integration_turnondevmode.png

  3. Verifique se o modo de teste está habilitado:
    • Em Console, digite:
      window.AF_SDK.PLUGINS.PBA.isDevModeOn()

      O valor de retorno é true. Isso indica que o modo de teste está ativo. 
      PBATestingWebSDKIntegrationIsDevModeOn_en-us.png

Enviar eventos de teste

  • No modo de teste, os eventos enviados são exibidos na página de integração de teste
  • Atenção! Os eventos de teste são processados e, posteriormente, serão incluídos nos relatórios do PBA. Para evitar a distorção de relatórios, preencha eventRevenue com valores baixos (pequenos). Se nenhum valor for enviado, o PBA o preencherá com 0. 

Envie eventos de exemplo de cada um dos tipos descritos. 

Etapa

Ação

(Digite comandos)

Página de integração de teste do Web SDK

(Resultado esperado) 
1

Abra uma nova aba no navegador e vá para qualquer página do seu site.

O PBA registra um 'pageLoad' sempre que seu site abrir/atualizar:

PBATestingWebSDKPageLoadEvent_en-us.png

2

Faça login/registre-se em seu site como usuário para disparar um evento setCustomerUserId.

mceclip3.png
3

Comece a enviar eventos da web para verificar se o PBA os processa corretamente.

Observação:

Se não for especificado, eventRevenue e eventRevenueCurrency são preenchidos com valores padrão:

  • eventRevenueCurrency: "USD"
  • eventRevenue: 0

PBAWebSDKTestEventEVENT_en-us.png

Ver Parâmetros de evento do Web SDK para obter informações adicionais.

mceclip5.png

Solução de problemas

Os eventos não são exibidos na página de teste

  1. Nas ferramentas de desenvolvedor do navegador, vá para a aba Rede.
  2. No campo de filtro, digite "websdk".
  3. Com base no código de resposta HTTP, proceda da seguinte forma:
    • 200: Entre em contato com o suporte técnico da AppsFlyer.
    • 400: Verifique se todos os parâmetros estão incluídos em " ".