Etapas de registro

1. Navegue até Ferramentas do desenvolvedor → Console de testes na plataforma Singular
2. Clique no botão Adicionar dispositivo
3. Selecione o Tipo de dispositivo no menu suspenso:
   • Android: Prefira o Google Advertising ID (GAID/aifa), AppSetID (asid) ou AndroidID (andi) nessa ordem
   • iOS: Use o IDFA quando disponível (requer consentimento do ATT); caso contrário, use o IDFV
4. Insira o ID do dispositivo capturado no dispositivo
5. Forneça um nome de dispositivo distintivo para fácil identificação
6. Clique em Salvar dispositivo para concluir o registro

Identificadores de dispositivo Android

Método recomendado: Use o aplicativo Singular Device Assist ( Android ) para obter o GAID/aifa.

Método alternativo: Ative o registro do SDK da Singular e capture o identificador no Android LogCat:

SingularConfig config = new SingularConfig(SdkKey, SdkSecret)
    .withLoggingEnabled()
    .withLogLevel(1);

Saída de exemplo do LogCat:

2023-06-01 15:48:32.224 27442-27560/com.singular.test D/Singular: DeviceInfo [worker] - andi : 8868adc2f7ffffff
2023-06-01 15:48:32.224 27442-27560/com.singular.test D/Singular: DeviceInfo [worker] - asid : 12dc3652-5e46-f2bb-a93a-b3c092ffffff
2023-06-01 15:48:32.224 27442-27560/com.singular.test D/Singular: DeviceInfo [worker] - aifa : 3bbc76b0-cebb-4a9f-b6ec-10ca1affffff

Identificadores de dispositivo iOS

Captura de IDFA: Use quando o framework ATT estiver implementado e o rastreamento autorizado.

Método 1: Aplicativo Singular Device Assist ( iOS ) — conceda permissão de rastreamento quando solicitado.

Método 2: Registre o IDFA no console de depuração do Xcode:

// Example in Swift
print("IDFA", ASIdentifierManager.shared().advertisingIdentifier.uuidString)

// Example in Objective-C
NSString *IDFA = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
NSLog(@"IDFA: %@", IDFA);

Captura de IDFV: Use quando o ATT não estiver implementado ou o rastreamento não estiver autorizado.

// Example in Swift
print("IDFV", UIDevice.current.identifierForVendor!.uuidString)

// Example in Objective-C
NSString *IDFV = [[[UIDevice currentDevice] identifierForVendor] UUIDString];
NSLog(@"IDFV: %@", IDFV);

Finalidade

Validar que o ID de usuário personalizado é transmitido corretamente para a Singular para rastreamento de usuários entre dispositivos e análises.

Procedimento de teste

1. Registre o dispositivo no Console de testes
2. Abra o aplicativo no dispositivo de teste
3. Acione a ação que envia o ID de usuário (p. ex., login) se não for enviado automaticamente
4. Expanda os detalhes do evento no Console de testes e verifique se o campo custom_user_id contém o valor esperado

Solução de problemas

Se o ID de usuário personalizado não aparecer:

• Verifique se o método que define o ID de usuário é realmente chamado no momento apropriado no fluxo do aplicativo
• Adicione um evento do SDK da Singular chamado "setting_custom_user_id" para maior visibilidade no Console de testes
• Verifique os logs do SDK para confirmação da atribuição do ID de usuário

Finalidade

Verificar que a implementação do rastreamento de eventos envia eventos com os nomes e atributos corretos para a Singular.

Procedimento de teste

Para cada evento implementado na integração do SDK:

1. Acione o evento no aplicativo e verifique se ele aparece no Console de testes com o nome correto
2. Clique na linha do evento para expandir os detalhes e confirme que a seção Dados do evento contém os atributos esperados

Solução de problemas

Se o evento não aparecer:

• Verifique se o aplicativo foi aberto depois que o dispositivo foi completamente registrado no Console de testes
• Consulte os Registros de exportação para ver o evento (disponíveis após ~3 horas de atraso)
• Confirme que o código de acionamento do evento foi executado corretamente no aplicativo

Recursos adicionais

• Entender a medição de eventos
• Referência de eventos padrão da Singular

Finalidade

Validar que a implementação do rastreamento de receita reporta corretamente os valores de compra, a moeda e os detalhes adicionais de receita.

Procedimento de teste

Para cada tipo de evento de receita implementado:

1. Acione o evento de receita no aplicativo e verifique se ele aparece no Console de testes
2. Expanda a linha do evento e confirme que os seguintes campos estejam presentes:
   • pcc — Código de moeda (p. ex., USD, EUR)
   • r — Valor da receita
   • Atributos adicionais do evento de receita se implementados

Recursos adicionais

• Perguntas frequentes sobre validação de compras no aplicativo

Finalidade

Verificar que a implementação de deep links lida corretamente com os Singular Links e direciona os usuários ao destino desejado dentro do aplicativo.

1. Configurar destino de teste

1. Navegue até Configurações → Aplicativos na plataforma Singular
2. Encontre o aplicativo e clique para abrir a configuração
3. Adicione um destino de deep link que corresponda ao código do manipulador de destino na integração do SDK

2. Criar link de teste

1. Acesse Atribuição → Gerenciar links e selecione o aplicativo
2. Clique em Criar link
3. Em Tipo de link , selecione "Fonte personalizada" e em Nome da fonte , selecione "Email"
4. Forneça um nome para o link
5. Expanda a seção Configurações do link e redirecionamentos
6. Selecione o destino de teste no menu suspenso Deep Link
7. Insira a URL do site no campo Destino alternativo para outras plataformas
8. Clique em Gerar e copie o link do campo Link de rastreamento de cliques

3. Testar a funcionalidade do link

1. Certifique-se de que o aplicativo esteja instalado no dispositivo de teste
2. Envie o link copiado para o dispositivo de teste por e-mail
3. No dispositivo, abra o e-mail e clique no link — o aplicativo deve abrir exibindo a página ou o conteúdo desejado
4. No Console de testes, verifique se o valor do Deep Link aparece nos argumentos da sessão

Alternativa para testes no Android

Teste deep links do Android usando ADB (Android Debug Bridge) para validação pela linha de comando.

Pré-requisitos:

• Instale o ADB (incluído nas ferramentas de plataforma do SDK do Android)
• Ative as Opções do desenvolvedor e a depuração USB no dispositivo
• Conecte o dispositivo ao computador via USB

Comando de teste:

adb shell am start -W -a android.intent.action.VIEW -d "https://yourdomain.sng.link/xxxxx?_dl=yourapp://deeplink"

Solução de problemas

Problema: O deep link abre uma nova instância do aplicativo em vez de alternar para a instância existente.

Solução: Adicione o seguinte à atividade no AndroidManifest.xml:

android:launchMode="singleTask"

Consulte a documentação do <activity> do Google para ver as opções de launchMode.

Finalidade

Verificar que os deep links diferidos lidam corretamente com links clicados antes da instalação do aplicativo, direcionando os usuários ao destino desejado no primeiro lançamento.

Procedimento de teste

1. Verifique o evento de sessão no Console de testes para confirmar que os deep links diferidos estão ativados
2. Configure o destino de teste e o link seguindo as etapas de deep link acima
3. Desinstale o aplicativo do dispositivo de teste
4. Redefina o identificador de publicidade do dispositivo
5. Adicione o novo identificador ao Console de testes
6. Envie o deep link para o dispositivo por e-mail e clique no link a partir do dispositivo
7. O link deve redirecionar para a loja de aplicativos — instale o aplicativo (para builds locais, faça o sideload pelo Android Studio ou Xcode em vez da versão da loja)
8. Após a instalação, abra o aplicativo — ele deve exibir a página ou o conteúdo especificado no deep link
9. No Console de testes, verifique se o valor do deep link diferido aparece no primeiro evento de sessão

Finalidade

Validar que a implementação do rastreamento de desinstalações detecta e reporta corretamente as desinstalações do aplicativo para análise de abandono.

Pré-requisitos

Antes de testar, verifique:

• Token FCM/APNS enviado para a Singular (consulte SDK do Android: Rastreamento de desinstalações e SDK do iOS: Rastreamento de desinstalações )
• Chave do servidor FCM (Android) ou Certificado de push do iOS inserido na página de configuração do aplicativo

Procedimento de teste

1. Instale o aplicativo em um dispositivo real (não emulador)
2. Abra o aplicativo para que a instalação seja registrada na Singular
3. Desinstale o aplicativo do dispositivo
4. Verifique o evento de desinstalação usando um dos seguintes métodos:
   • Exporte os registros de atribuição e encontre o evento de desinstalação (pode levar alguns dias para aparecer)
   • Se os postbacks estiverem configurados para o sistema BI interno, receba o postback sobre a desinstalação
   • Entre em contato com o Suporte da Singular ou com o Customer Success Manager para assistência na validação

Causas comuns

Se o dispositivo estiver registrado e nenhum evento aparecer no Registro de eventos, verifique o seguinte:

• Monitoramento ao vivo necessário: O Console de testes só mostra eventos ao vivo quando o dispositivo está selecionado e o indicador 🟢 Ao vivo está visível. Não recupera eventos históricos
• Aplicativo aberto: Certifique-se de que o aplicativo foi aberto no dispositivo de teste para gerar o evento de sessão
• Eventos acionados: Se estiver testando eventos específicos, certifique-se de ter realizado as ações de acionamento no aplicativo
• Precisão do ID do dispositivo: Verifique se o ID do dispositivo inserido no Console de testes está correto
• Tipo do ID do dispositivo: Para iOS sem aviso ATT, não é possível usar o IDFA — deve-se usar o IDFV em vez disso

SDK versão 12.0.0 ou posterior

A partir do SDK da Singular 12.0.0, não é necessário testar o evento _InstallReferrer . Depois que o aplicativo é publicado na loja, o SDK coloca os dados do _InstallReferrer na primeira sessão automaticamente. Basta verificar se a sessão aparece no Console de testes.

SDK versão <12.0.0>

Para versões mais antigas do SDK do Android, ainda é necessário verificar o evento _InstallReferrer no Console de testes para a atribuição correta de instalação.

Etapas de verificação

Verifique a precisão do IDFA:

• Use o aplicativo Singular Device Assist (iOS) com permissão de rastreamento concedida
• Registre o IDFA no console de depuração do Xcode
• Verifique os Registros de exportação (após 1+ hora) com o campo "Status do App Tracking Transparency" — o valor 0 (Não determinado) significa que o aviso ATT não foi exibido

Verificações de configuração

1. Configurações do dispositivo: Verifique se Configurações → Privacidade → Rastreamento mostra "Permitir que apps solicitem o rastreamento" ativado
2. Aviso ATT: Confirme se o aviso ATT foi exibido durante o teste — se não foi, o IDFA não foi rastreado
3. Redefinir IDFA: Se o dispositivo foi usado anteriormente, redefina o identificador de publicidade em Configurações → Privacidade → Rastreamento
4. Versão do SDK: Verifique se a versão mais recente do SDK da Singular está integrada corretamente
5. Inicialização do SDK: Confirme se o SDK foi inicializado no AppDelegate ou SceneDelegate conforme a documentação
6. Verificar erros: Revise o console do Xcode em busca de erros de inicialização do SDK ou de rastreamento

Se o problema persistir após seguir essas etapas, consulte a documentação do Apple ATT ou entre em contato com o engenheiro de integração da Singular.

Processo de exclusão

1. Clique no ícone de edição ao lado do dispositivo no Console de testes
2. Na barra lateral exibida, clique em Excluir dispositivo
3. A exclusão apaga todos os registros de eventos e remove os dados de atribuição do dispositivo da Singular

Veja também: Como redefinir o dispositivo para testes de atribuição de instalação

Requisitos para redefinição

Para testar novamente a integração do SDK com o mesmo dispositivo, remova os dados em cache local do dispositivo e limpe a atribuição do dispositivo na plataforma Singular.

Etapas de redefinição no Android

1. Feche o aplicativo e confirme que não está em execução (use Forçar parada se disponível)
2. Acesse o menu Configurações
3. Navegue até Aplicativos , mantenha pressionado o aplicativo e selecione Informações do app
4. Selecione Armazenamento e clique em Limpar cache e Limpar dados
5. No Console de testes, selecione o dispositivo, clique no ícone de edição e em Excluir dispositivo para remover a atribuição

Etapas de redefinição no iOS

1. Feche o aplicativo e desinstale-o do dispositivo
2. No Console de testes, encontre o dispositivo, clique no ícone de edição e em Excluir dispositivo para remover a atribuição

Interface do Registro de eventos

Após registrar o dispositivo e enviar os eventos, eles aparecem no Registro de eventos do Console de testes com atualizações em tempo real.

Detalhes do evento

Clique na linha do evento para expandir e ver os detalhes completos do evento conforme enviado pelo aplicativo, incluindo todos os parâmetros e atributos.

Prioridade de resolução

Devem ser resolvidos antes do lançamento em produção — esses problemas impedem a funcionalidade principal.

Problemas de Erro comuns

• Nenhuma sessão recebida: O SDK não está inicializado ou não está enviando dados para a Singular
• Chaves do SDK inválidas: Chave do SDK ou secret configurados incorretamente
• Incompatibilidade de plataforma: O aplicativo está reportando um identificador de plataforma incorreto

Abordagem de resolução

1. Revise a Descrição do erro para obter orientação específica
2. Consulte o guia de integração do SDK para a plataforma afetada
3. Verifique a configuração e o código de inicialização do SDK
4. Teste novamente usando o Console de testes após as correções
5. Execute uma nova Auditoria do SDK para confirmar a resolução

Prioridade de resolução

Devem ser resolvidos para seguir as melhores práticas — a integração funciona, mas melhorias são recomendadas.

Problemas de Aviso comuns

• Sem ID de usuário personalizado: O ID de usuário personalizado não está implementado para rastreamento entre dispositivos
• Problemas de rastreamento de receita: Os eventos de receita não seguem as melhores práticas
• Atributos de eventos ausentes: Os eventos são rastreados sem os atributos recomendados

Abordagem de resolução

1. Avalie o impacto nos negócios do recurso ausente
2. Revise a documentação de implementação do recurso
3. Implemente se o recurso estiver alinhado com os requisitos
4. Teste a implementação usando o Console de testes

Prioridade de resolução

Revisar e decidir — recursos opcionais que podem não se aplicar ao caso de uso específico.

Problemas de Informação comuns

• Deep link diferido desativado: DDL pode não ser relevante para a estratégia de marketing
• Rastreamento de desinstalações não configurado: O rastreamento de desinstalações é opcional com base nos requisitos
• Recursos opcionais do SDK: Recursos adicionais não críticos para a funcionalidade básica

Abordagem de resolução

1. Revise o Nome de validação para identificar o recurso opcional
2. Determine se o recurso é relevante para os requisitos do negócio
3. Se não for relevante, ignore o problema com segurança
4. Se for relevante, implemente seguindo a documentação do SDK