Etapas de registo

1. Navegue até Ferramentas de desenvolvedor → Console de testena 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: Utilizar o IDFA quando disponível (requer o consentimento da ATT); caso contrário, utilizar o IDFV
4. Introduzir o ID do dispositivo capturado do dispositivo
5. Forneça um nome de dispositivo distinto para facilitar a identificação
6. Clique em Guardar dispositivo para concluir o registo

Identificadores de dispositivos Android

Método recomendado: Utilizar a aplicação Singular Device Assist(Android) para recuperar GAID/aifa.

Método alternativo: Habilitar o registro do Singular SDK e capturar o identificador do LogCat do Android:

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

Exemplo de saída 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 dispositivos iOS

Captura de IDFA: Usar quando a estrutura ATT estiver implementada e o rastreamento autorizado.

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

Método 2: Registar o IDFA na consola 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: Usar quando a ATT não estiver implementada ou o rastreamento não for autorizado.

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

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

Objetivo

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

Procedimento de teste

1. Registrar o dispositivo no Console de teste
2. Abrir o aplicativo no dispositivo de teste
3. Acionar ação que envia a ID de usuário (por exemplo, login) se não for enviada automaticamente
4. Expandir os detalhes do evento na Consola de Testes e verificar se o campo custom_user_idcontém o valor esperado

Resolução de problemas

Se o ID de utilizador personalizado não aparecer:

• Verifique se o método que define a ID de usuário é realmente chamado no momento apropriado no fluxo do aplicativo
• Adicione um evento SDK Singular denominado "setting_custom_user_id" para obter visibilidade na Consola de Testes
• Verificar os registos do SDK para confirmação da atribuição do ID de utilizador

Objetivo

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

Procedimento de teste

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

1. Acionar o evento no aplicativo e verificar se o evento aparece no Console de teste com o nome correto
2. Clique na linha do evento para expandir os detalhes e confirmar que a seção Dados do eventocontém os atributos esperados

Resolução de problemas

Se o evento não aparecer:

• Verificar se a aplicação foi aberta depois de o dispositivo estar completamente registado na Consola de Testes
• Verifique os registos de exportaçãodo evento (disponíveis após um atraso de cerca de 3 horas)
• Confirme se o código de disparo do evento foi executado corretamente no aplicativo

Recursos adicionais

• Compreender a medição de eventos
• Referência de eventos padrão singulares

Objetivo

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

Procedimento de teste

Para cada tipo de evento de receita implementado:

1. Acionar o evento de receitas na aplicação e verificar se o evento aparece na Consola de Testes
2. Expandir a linha do evento e confirmar a presença dos seguintes campos:
   • pcc - Código da moeda (por exemplo, USD, EUR)
   • r - Valor da receita
   • Atributos adicionais do evento de receita, se implementados

Recursos adicionais

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

Objetivo

Verificar se a implementação de links diretos lida corretamente com Links Singulares e direciona os usuários para os destinos in-app pretendidos.

1. Configurar destino de teste

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

2. Criar link de teste

1. Vá para Atribuição → Gerir ligações e selecione a aplicação
2. Clique em Criar link
3. Em Link Type, selecione "Custom Source" e em Source Name, selecione "Email"
4. Forneça o nome do link
5. Expanda a secção Definições do link e Redireccionamentos
6. Selecione o destino de teste no menu pendente Deep Link
7. Introduza o URL do Web site no campo Fallback Destination for Other Platforms (Destino de recurso para outras plataformas)
8. Clique em Generate (Gerar ) e copie o link do campo Click-Through Tracking Link (Link de rastreamento de cliques)

3. Testar a funcionalidade do link

1. Assegurar que a aplicação está instalada no dispositivo de teste
2. Enviar por correio eletrónico o link copiado para o dispositivo de teste
3. A partir do dispositivo, abra o e-mail e clique no link - a aplicação deve abrir exibindo a página/conteúdo pretendido
4. Na Consola de Testes, verifique se o valor do Deep Link aparece nos argumentos da sessão

Alternativa de teste do Android

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

Pré-requisitos:

• Instalar o ADB (incluído nas ferramentas da plataforma SDK do Android)
• Habilitar as Opções do desenvolvedor e a depuração USB no dispositivo
• Conectar 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"

Resolução de problemas

Problema: A ligação direta abre uma nova instância da aplicação em vez de mudar para uma instância existente.

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

android:launchMode="singleTask"

Consulte a documentação <activity> do Googlepara obter as opções de launchMode.

Objetivo

Verificar se o deferred deep linkingtrata corretamente os links clicados antes da instalação do aplicativo, direcionando os usuários para o destino pretendido na primeira inicialização.

Procedimento de teste

1. Verifique o evento da sessão no Console de teste para confirmar que a vinculação profunda adiada está ativada
2. Configure o destino de teste e o link seguindo as etapas de links diretos acima
3. Desinstalar a aplicação do dispositivo de teste
4. Repor o identificador de publicidade do dispositivo
5. Adicionar novo identificador à Consola de Testes
6. Enviar por correio eletrónico a ligação direta para o dispositivo e clicar na ligação a partir do dispositivo
7. A ligação deve redirecionar para a loja de aplicações - instale a aplicação (para compilações locais, faça o sideload do Android Studio ou do Xcode em vez da versão da loja)
8. Após a instalação, abra a aplicação - deve apresentar a página/conteúdo pretendido especificado na ligação direta
9. Na Consola de Testes, verifique se o valor da ligação direta diferidaaparece no evento da primeira sessão

Objetivo

Validar se a implementação do rastreamento de desinstalação detecta e relata corretamente as desinstalações de aplicativos para análise de rotatividade.

Pré-requisitos

Antes de testar, verifique:

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

Procedimento de teste

1. Instale o aplicativo no dispositivo real (não no emulador)
2. Abra o aplicativo para instalar registrado com o Singular
3. Desinstalar o aplicativo do dispositivo
4. Verifique o evento de desinstalação usando um dos seguintes métodos:
   • Exportar logs de atribuiçãoe encontrar o evento de desinstalação (pode levar alguns dias para aparecer)
   • Se os postbacksestiverem configurados para o sistema interno de BI, receber postback sobre a desinstalação
   • Contactar o Singular Supportou o Customer Success Manager para obter assistência na validação

Causas comuns

Se o dispositivo estiver registado e não aparecerem eventos no registo de eventos, verifique o seguinte:

• Monitorização em direto necessária: A Consola de Teste só mostra eventos em direto quando o dispositivo está selecionado e o indicador 🟢 Live visível. Não recupera eventos históricos
• Aplicação aberta: Certifique-se de que a aplicação foi aberta no dispositivo de teste para gerar um evento de sessão
• Eventos acionados: Se estiver a testar eventos específicos, certifique-se de que as acções de acionamento são executadas na aplicação
• Exatidão da ID do dispositivo: Verificar novamente se a ID do dispositivo introduzida na Consola de Teste está correta
• Tipo de ID do dispositivo: Para iOS sem prompt ATT, não pode usar IDFA - deve usar IDFV

Versão do SDK 12.0.0+

A partir do Singular SDK 12.0.0, não é necessário testar o evento _InstallReferrer. Quando a aplicação é enviada para a loja, o SDK coloca automaticamente os dados _InstallReferrer na primeira sessão. Só é necessário verificar se a sessão aparece no Console de teste.

Versão do SDK <12.0.0>

Para versões mais antigas do SDK do Android, ainda é necessário verificar o evento _InstallReferrerno Console de teste para obter a atribuição de instalação adequada.

Etapas de verificação

Verifique novamente a precisão do IDFA:

• Usar o aplicativo Singular Device Assist (iOS) com permissão de rastreamento concedida
• Registrar o IDFA no console de depuração do Xcode
• Verificar os registos de exportação (após mais de 1 hora) com o campo "App Tracking Transparency status" - o valor 0 (Indeterminado) significa que o aviso ATT não é apresentado

Verificações de configuração

1. Definições do dispositivo: Verificar Definições → Privacidade → Rastreio mostra "Permitir que as aplicações peçam para rastrear" ativado
2. Aviso ATT: Confirmar se o aviso ATT apareceu durante o teste - se não for mostrado, o IDFA não é rastreado
3. Repor IDFA: Se o dispositivo tiver sido utilizado anteriormente, repor o identificador de publicidade através de Definições → Privacidade → Seguimento
4. Versão do SDK: Verificar se a versão mais recente do Singular SDK foi integrada corretamente
5. Inicialização do SDK: Confirmar a inicialização do SDK em AppDelegate ou SceneDelegate de acordo com a documentação
6. Verificar erros: Verificar a consola do Xcode quanto a erros de inicialização ou de seguimento do SDK

Se os problemas persistirem após as etapas a seguir, consulte a documentação da Apple ATTou entre em contato com o engenheiro de integração da Singular.

Processo de exclusão

1. Clique no ícone Editar ao lado do dispositivo no Console de teste
2. Na barra lateral que aparece, clique em Excluir dispositivo
3. A exclusão limpa todos os logs de eventos e remove os dados de atribuição do dispositivo do Singular

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

Requisitos de redefinição

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

Etapas de redefinição do Android

1. Feche o aplicativo e confirme que não está em execução (use Forçar parada, se disponível)
2. Aceder ao menu Definições
3. Navegue até Apps, prima longamente na app, selecione App Info
4. Selecione Armazenamento e clique em Limpar Cache e Limpar Dados
5. Na Consola de Testes, selecione o dispositivo e clique no ícone Editar e, em seguida, em Eliminar dispositivo para remover a atribuição

Passos de reposição do iOS

1. Fechar a aplicação e desinstalar do dispositivo
2. Na Consola de Testes, encontre o dispositivo e clique no ícone Editar e, em seguida, em Eliminar dispositivo para remover a atribuição

Interface do registo de eventos

Depois de registar o dispositivo e enviar eventos, os eventos aparecem no Registo de Eventos da Consola de Testes com actualizações em tempo real.

Detalhes do evento

Clique na linha do evento para expandir e visualizar os detalhes completos do evento, conforme enviado pela aplicação, incluindo todos os parâmetros e atributos.

Prioridade de resolução

Deve ser resolvido antes da versão de produção - esses problemas impedem a funcionalidade principal.

Problemas de erro comuns

• Nenhuma sessão recebida: SDK não inicializado ou não enviando dados para a Singular
• Chaves de SDK inválidas: Chave ou segredo do SDK configurado incorretamente
• Incompatibilidade de plataforma: App reportando identificador de plataforma errado

Abordagem de resolução

1. Rever a descrição do erro para obter orientações específicas
2. Consultar o guia de integração do SDK para a plataforma afetada
3. Verificar a configuração do SDK e o código de inicialização
4. Voltar a testar utilizando a Consola de Testes após as correcções
5. Executar nova auditoria do SDK para confirmar a resolução

Prioridade de resolução

Deve ser resolvido para as melhores práticas - funções de integração, mas recomenda-se a introdução de melhorias.

Problemas comuns de aviso

• Sem ID de utilizador personalizado: ID de usuário personalizado não implementado para rastreamento entre dispositivos
• Problemas de rastreamento de receita: Eventos de receita que não seguem as práticas recomendadas
• Atributos de evento ausentes: Eventos rastreados sem os atributos recomendados

Abordagem de resolução

1. Avaliar o impacto comercial do recurso ausente
2. Rever a documentação de implementação da funcionalidade
3. Implementar se a funcionalidade estiver de acordo com os requisitos
4. Testar a implementação utilizando a Consola de Testes

Prioridade de resolução

Rever e decidir - caraterísticas opcionais que podem não se aplicar a um caso de utilização específico.

Problemas comuns de informações

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

Abordagem de resolução

1. Rever o Nome de Validação para identificar a caraterística opcional
2. Determinar se a caraterística é relevante para os requisitos comerciais
3. Se não for relevante, ignorar o problema com segurança
4. Se for relevante, implementar seguindo a documentação do SDK