Resumo: ao realizar testes de atribuição, registre o seu dispositivo de teste para garantir que cada instalação seja registrada como uma nova instalação. Um dispositivo de teste registrado impede que as instalações sejam registradas como reinstalações.
Por que registrar um dispositivo de teste?
Ao executar testes de atribuição, a janela de reatribuição limita as atribuições de instalação a uma por janela de 90 dias. Portanto, se você usar o mesmo dispositivo várias vezes para testar atribuições de instalação, nada será gravado. O registro de um dispositivo de teste impede que as instalações sejam registradas como reinstalações.
Métodos para registrar um dispositivo de teste
Registrar um dispositivo de teste inclui selecionar o sistema operacional do dispositivo (Android, iOS ou Windows) e adicionar o identificador do dispositivo.
Você pode usar um dos seguintes métodos:
-
Faça o download e baixe o aplicativo My Device ID by AppsFlyer: Depois de instalar o aplicativo no dispositivo de teste, você pode registrar automaticamente o dispositivo e compartilhar os detalhes do device ID na sua conta da AppsFlyer. O dispositivo será listado automaticamente na página Dispositivos de teste.
Atenção
Em dispositivos de teste iOS 14+, você pode usar esse método somente quando a AppTransparency Tracking (ATT) foi implementada em seu aplicativo e você deseja executar testes como um usuário que permite o rastreamento. Caso contrário, use o método manual.
- Adicionar manualmente o dispositivo de teste: qualquer usuário de conta pode registrar diretamente um dispositivo de teste, adicionando o identificador do dispositivo à página Dispositivos de teste.
Lembre-se:
- Dispositivos de teste registrados estão disponíveis para todos os aplicativos hospedados na conta.
- As ad networks precisam pedir a um anunciante para adicionar dispositivos. As agências podem adicionar seus próprios dispositivos.
Identificadores de dispositivos compatíveis
Os identificadores de dispositivo incluem:
-
Android: AID (GAID ou OAID), IMEI, Android ID
Atenção
Ao registrar um dispositivo de teste, você só deve adicionar identificadores de dispositivo IMEI ou Android ID se seu app coletar e usar esses identificadores.
- iOS: IDFA, IDFV
- Windows Phone: Windows advertising ID
Gerenciar o registro do dispositivo de teste
Registrar um dispositivo usando o app de device ID da AppsFlyer
Para fazer o download do app de device ID:
- Faça o download e instale o aplicativo usando o QR code (Google Play store) ou um dos links fornecidos:
- Em um dispositivo iOS 14.5+, se você quiser permitir a coleta de IDFA, clique em Permitir quando o prompt da ATT for exibido.
- Na tela Android/iOS/Windows, clique em Registrar para registrar um dispositivo.
- Insira suas credenciais de login da AppsFlyer. O dispositivo agora está registrado.
- Clique em Compartilhar detalhes para compartilhar as informações do device ID.
Registrar um dispositivo manualmente
Os usuários da conta podem registrar manualmente um dispositivo:
- Na AppsFlyer, no menu lateral, selecione Configurações -> Dispositivos de teste.
- Selecione Testar dispositivos.
-
Clique em + Adicionar dispositivo.
- Preencha:
- Nome (use apenas letras do alfabeto romano): insira um nome de identificação exclusivo para o dispositivo.
- Sistema operacional: Selecione um sistema operacional.
- Tipo de device ID: Selecione um identificador de dispositivo.
-
Device ID: Forneça o device ID de acordo com o sistema operacional:
iOS
Como obter os identificadores IDFA ou IDFV:
- IDFA: Para obter o IDFA, instale a aplicação de ID de dispositivo da AppsFlyer no seu dispositivo de teste. Para aprender como, veja: Adicione um dispositivo utilizando a aplicação de ID de dispositivo da AppsFlyer (apenas para administradores) acima.
- IDFV: Para obter o IDFV, solicite ao seu programador para instalar a aplicação da ferramenta de teste IDFV no seu dispositivo de teste. Uma vez instalada e iniciada, a aplicação exibirá o IDFV. Atenção: a ferramenta de teste pode ser instalada somente depois que o desenvolvedor executou as etapas preliminares no X-Code.
Para saber quando usar IDFA ou IDFV consulte Registrando um dispositivo de teste iOS.
Android
Obtenha identificadores usando o app de device ID da AppsFlyer ou digitando os códigos no dispositivo:
Identificador Método de recuperação Google Play Outros AID (GAID ou OAID) Use o app ID do dispositivo da AppsFlyer Obrigatório IMEI *#06#* Não aplicável Garanta que o desenvolvedor usou setCollectImei para coletar o ID. Android ID *#*#8255#*#* (pode não funcionar em dispositivos mais recentes) Não aplicável Garanta que o desenvolvedor usou setCollectImei para coletar o ID.
- Clique em Salvar. O dispositivo é exibido na lista de dispositivos registrados. Atenção: Embora o dispositivo seja exibido na lista de dispositivos registrados imediatamente, podem levar alguns minutos para que ele seja registrado no sistema e funcione como pretendido.
Atenção
Adicionar mais de um identificador
Pode haver casos em que você deseja adicionar mais de um identificador ao seu dispositivo de teste, por exemplo, caso você queira ter IDFA e IDFV no mesmo dispositivo.
Para incluir um identificador adicional:
- Clique em Adicionar dispositivo.
- Use o mesmo nome para o dispositivo de teste e adicione o segundo identificador.
- Clique em Salvar.
Cancelar o registro de um dispositivo
Você pode registrar até 200 dispositivos por conta.
Para remover um dispositivo da lista:
- Na AppsFlyer, no canto superior direito, clique no seu endereço de e-mail.
- Selecione Testar dispositivos.
- Clique no ícone de exclusão para remover dispositivos.
Registrar um dispositivo de teste iOS
O fluxograma abaixo ilustra os possíveis cursos de ação ao registrar seus dispositivos de teste iOS.
Selecione entre as seguintes opções ao registrar seu dispositivo de teste iOS:
Registrar seu dispositivo de teste com IDFA
Quando usar o IDFA para registrar um dispositivo de teste?
Você pode registrar um dispositivo usando o IDFA se a AppTransparencyTracking (ATT) tiver sido implementada em seu aplicativo e se você quiser executar testes como um usuário que permite o rastreamento. Ao abrir o aplicativo pela primeira vez, clique em Permitir no prompt da ATT.
Como registrar seu dispositivo de teste com um IDFA?
Para isso, registre um dispositivo usando o app de device ID da AppsFlyer.
Registrar seu dispositivo de teste com IDFV
Quando usar o IDFV para registrar dispositivos de teste?
Quando o IDFA não está disponível, o IDFV é sua única opção. Você deve usar o IDFV nos seguintes casos:
- A ATT foi implementada mas você deseja executar testes como um usuário que não dá o consentimento à ATT. Ao abrir o aplicativo pela primeira vez, clique em Não permitir no prompt da ATT.
- A ATT não é implementada.
Como registrar seu dispositivo com um IDFV
- Antes de registrar o dispositivo de teste com um IDFV, seu desenvolvedor precisa instalar o aplicativo da ferramenta de teste IDFV em seu dispositivo de teste. Para instruções de desenvolvedores, consulte esse artigo.
- Depois que seu desenvolvedor instalar o aplicativo da ferramenta de teste IDFV, inicie-o e copie o IDFV exibido.
- Registre o dispositivo de teste manualmente usando o IDFV.
Atenção
Quais são os motivos para instalar o aplicativo da ferramenta de teste IDFV?
- A ferramenta de teste IDFV é usada para extrair o IDFV necessário para registrar o dispositivo de teste.
- Quando não houver outra aplicação do seu desenvolvedor instalada no dispositivo de teste. Nesse caso, o iOS atribui um novo vendor ID toda vez que você reinstala o aplicativo. Como o teste envolve, em muitos casos, a reinstalação do aplicativo, cada reinstalação aciona o iOS para redefinir o IDFV. O aplicativo utilitário, fingindo pertencer ao fornecedor, impede que o iOS crie um novo IDFV sempre que o aplicativo for reinstalado no dispositivo de teste.
Testando com um dispositivo não registrado
Use esta opção apenas se não puder registrar um dispositivo de teste com IDFA ou IDFV. Nesse caso, a modelagem probabilística é usada para atribuição. Cada instalação é registrada como uma nova instalação no dispositivo de teste. Este método pode ajudar no registro de instalações de teste repetidas para o mesmo dispositivo se pelo menos uma dos seguintes cenários:
- O SDK da AppsFlyer para iOS é a versão 6.8.0 ou versões anteriores.
- A detecção de reinstalação está desativada para o aplicativo (não recomendado para aplicativos publicados).
- O link de atribuição de teste contém
is_retargeting="true"
. Nesse caso, as instalações são registradas como reatribuições e estão disponíveis no dashboard e nos relatórios de dados brutos de retargeting. - Apenas para iOS: Para impedir que o Protect360 identifique cliques como fraudulentos, adicione o parâmetro de consulta
pid="ios_testing"
ao seu link de atribuição de teste.