Redefinindo o ID de publicidade do seu dispositivo de teste

Se o seu dispositivo móvel já foi usado anteriormente em testes de atribuição da Singular ou tem o aplicativo Singular Device Assist instalado, você precisa limpar os dados do dispositivo antes de testar novamente. Se esta for a primeira vez que você usa o aplicativo Singular Device Assist, pode pular esta etapa.

Etapas para limpar os dados do dispositivo:

1. Desinstale ou exclua o aplicativo Singular Device Assist do dispositivo.

2. Redefina o identificador de publicidade do seu dispositivo: 

   • Para dispositivos Apple:
     • Abra Ajustes > Privacidade e Segurança
     • Selecione Rastreamento e desative e ative novamente Permitir que os apps solicitem rastreamento. 
   • Para dispositivos Android:
     • Abra Configurações > Google > Anúncios
     • Selecione Redefinir ID de publicidade

Localizando o seu novo ID de publicidade

Depois de redefinir o ID de publicidade do seu dispositivo, você precisará encontrar o novo ID. Você pode usar aplicativos de terceiros, como o aplicativo de teste Device Assist da Singular para iOS e Android, ou verificar diretamente nas configurações do dispositivo:

Para dispositivos Apple:

• Nas versões recentes do iOS, o ID de publicidade (IDFA) só pode ser acessado por meio de um aplicativo de terceiros.
• Em versões mais antigas do iOS, você pode acessar Ajustes > Privacidade > Publicidade para visualizar o IDFA.

Para dispositivos Android:

• Acesse Configurações > Google > Anúncios para encontrar o AAID / AIFA (ID de publicidade do Android), também chamado de GAID (ID de publicidade do Google).

Usando o link da Singular (fornecido pela Singular)

Você deve ter recebido um link de rastreamento da equipe da Singular, semelhante ao exemplo abaixo.

Detalhes importantes sobre o link de rastreamento:

• O link inclui parâmetros como "aifa", "idfa", "cl" e "pcid".
• Os valores entre {chaves} são macros: marcadores que o parceiro de mídia substitui por valores reais ao veicular o anúncio.

Lembrete importante:

Certifique-se de remover do link de rastreamento todas as macros que não receberão um valor.

• Se as macros forem enviadas no lugar dos valores reais, a Singular não registrará o clique e não haverá atribuição. 

https://singularassist.sng.link/D59c0/tpa9?aifa={google_advertising_id}
&idfa={idfa}&cl={click_id}&pcid={campaign_id}&pcn={campaign_name}
&pshid={publisher_id}&psn={publisher_site_name}&psid={publisher_site_id}
&pcrid={creative_id}&pcrn={publisher_creative_name}

Métodos de teste de atribuição: preparando o link de rastreamento

Determinística: inserir o ID de publicidade no link

1. Substitua o marcador do ID de publicidade:
   
   • Para dispositivos Apple: substitua a macro do IDFA (por exemplo, {idfa}) pelo IDFA real do seu dispositivo. 
   • Para dispositivos Android: substitua o ID de publicidade do Android (por exemplo, {google_advertising_id}) pelo AIFA real do seu dispositivo.
2. Remova ou substitua os demais marcadores:
   • Exclua todos os marcadores não utilizados, a menos que sejam obrigatórios para a sua URL de postback.
   • Por exemplo, se a sua plataforma exigir Click ID ou Transaction ID, substitua o parâmetro correspondente (por exemplo, cl) por um valor válido.
3. Exemplo de um link completo (para Android): 

https://singularassist.sng.link/D59c0/tpa9?aifa=0f9f9e46-df3b-
4012-8b1e-639ebc39a20f&idfa=&cl=123&pcid=&pcn=&pshid=&psn=&psid=
&pcrid=&pcrn=

Probabilística: para canais em que nenhum ID de publicidade está disponível

1. Redefina a atribuição do seu dispositivo:
   • Siga as instruções em Redefinir um dispositivo e limpar a atribuição de instalação para garantir que o seu dispositivo seja redefinido corretamente.
2. Modifique o link de rastreamento:
   • Copie o link de rastreamento novamente, mas remova todos os valores das macros, incluindo o ID do dispositivo. Todas as macros devem ficar em branco, como neste exemplo:

   • https://singularassist.sng.link/D59c0/tpa9?_smtype=3&aifa=
     &idfa=&cl=&pcid=&pcn=&pshid=&psn=&psid=&pcrid=&pcrn=

3. Envie e teste o link:
   • Envie o link de rastreamento modificado para o seu dispositivo móvel de teste.
   • Clique no link a partir do seu dispositivo e siga as mesmas etapas do teste anterior para verificar os resultados. 

Seguindo essas etapas, você pode testar o processo de atribuição em canais onde nenhum ID de publicidade está disponível, contando com métodos de atribuição probabilística.

Acionando o link de rastreamento

1. Envie o link de rastreamento para o seu dispositivo de teste.
2. Abra o link no dispositivo móvel clicando nele.

Ao clicar no link, você será redirecionado para a Apple App Store ou para a Google Play Store, dependendo do dispositivo.

Instalando, abrindo e testando o aplicativo

1. Baixe e instale o aplicativo
   • Acesse a loja de aplicativos e baixe o aplicativo Singular Device Assist.
   • Instale o aplicativo no seu dispositivo de teste.
2. Abra o aplicativo
   • Abra o aplicativo para acionar o processo de atribuição da Singular. O processo de atribuição começa somente quando o aplicativo é aberto.
3. Acione eventos pós-instalação
   • Realize ações pós-instalação dentro do aplicativo para testar os postbacks desses eventos.
   • Ao usar um link de teste fornecido pela equipe de integração da Singular junto com o aplicativo Singular Device Assist, use os botões do aplicativo para acionar eventos de teste:
     • Copy IDFA/GAID
     • Share IDFA/GAID
     • Start Testing.
   • Essas ações enviarão eventos de teste por meio do postback de teste.
4. Nomes de eventos esperados nos postbacks:
   • Para iOS:
     • "copy IDFA" e/ou "share IDFA" (eventos de teste)
     • "start Testing" (evento de receita de teste*)
   • Para Android:
     • "Copy GAID" e/ou "Share GAID" (eventos de teste)
     • "Start Testing" (evento de receita de teste*)

*Eventos de receita exigem que o postback seja configurado para incluir um valor de receita. Certifique-se de que o seu template de postback contenha a macro {AMOUNT} ou uma equivalente da documentação da Singular para receber um valor de receita no postback. 

Verificando a atribuição

Para confirmar que a instalação foi atribuída corretamente pela Singular:

1. Compartilhe o seu AIFA (ID de publicidade do Android) ou IDFA (Identifier for Advertisers) com o engenheiro de integração da Singular.
2. O engenheiro da Singular analisará os dados e enviará um retorno, incluindo os logs de teste relevantes.

Esse processo garante a precisão da configuração de atribuição.