O que é uma Dev Key?

A Developer Key (Dev Key) é um identificador exclusivo do seu aplicativo, usado para autenticar os dados de evento enviados pelo SDK e por integrações server-to-server (S2S) para a AppsFlyer. Ela é essencial para permitir a atribuição, as sessões e a mensuração de eventos in-app.
Por padrão, todos os aplicativos da sua conta compartilham a mesma Dev Key. Mas, se necessário, você pode criar uma Dev Key exclusiva para cada aplicativo.
Para dar a você mais controle, a página Dev Keys nas configurações do aplicativo permite que usuários administradores visualizem e gerenciem as Dev Keys, inclusive atualizando ou substituindo uma Dev Key existente.

Onde encontrar suas Dev Keys

Na AppsFlyer, no menu lateral, selecione Configurações > Configurações do aplicativo. Na seção Chaves de desenvolvimento, clique em Gerenciar chaves de desenvolvimento. 

Gerenciamento de Dev Key

Os administradores podem usar a página Dev Keys para:

• Gerar uma Dev Key exclusiva para um aplicativo específico.
• Atribuir uma Dev Key já em uso por outro aplicativo na conta.
• Executar até 2 Dev Keys por aplicativo ao mesmo tempo. Ao atingir o limite, a opção + Adicionar chave de desenvolvimento fica desativada até que você revogue uma das chaves existentes.

Por que talvez você precise alterar sua Dev Key

Você pode querer alterar sua Dev Key por vários motivos:

• Segurança: altere a chave se ela tiver sido exposta para evitar o acesso não autorizado.
• Transferências de conta: Gere uma nova Dev Key após mover um aplicativo para uma conta diferente, para alinhá-la com a conta atual.
• Granularidade: atribua chaves exclusivas por aplicativo para simplificar o monitoramento, a solução de problemas ou o controle de acesso.

Como executar duas Dev Keys em paralelo

Você pode executar duas Dev Keys em paralelo por até 90 dias durante a migração. As duas chaves funcionam ao mesmo tempo. Assim, você não perde tráfego enquanto a atualização é disponibilizada aos usuários.

1. Na AppsFlyer, no menu lateral, selecione Configurações > Configurações do aplicativo. Na seção Chaves de desenvolvimento, clique em Gerenciar chaves de desenvolvimento.

2. Clique em + Adicionar chave de desenvolvimento.

   

3. Escolha uma opção:
   • Gerar uma nova chave de desenvolvimento: cria uma chave nova e exclusiva para este aplicativo.
   • Usar uma chave de desenvolvimento existente: atribui uma chave já usada por outro aplicativo da sua conta.

4. Se quiser, dê um nome à chave (por exemplo, "Chave de produção de agosto de 2026"). Se você pular esta etapa, uma chave será gerada automaticamente. Você pode alterar o rótulo de qualquer chave a qualquer momento, inclusive de uma chave revogada.

   

5. Confirmar. As duas chaves agora estão ativas. Sua chave anterior passa a exibir imediatamente uma contagem regressiva, e a AppsFlyer a revoga automaticamente após 90 dias, a menos que você a revogue antes.
6. Na etapa Enviar ao desenvolvedor, clique no ícone de cópia para copiar a nova chave. A chave aparece mascarada na tela, e cada chave da lista Chaves de desenvolvedor também tem um ícone de cópia.

7. Forneça a nova chave ao desenvolvedor para que ele a adicione à configuração do SDK do seu aplicativo. Em seguida, lance a versão atualizada do aplicativo.

   

8. Quando a nova versão estiver disponível e o tráfego tiver migrado, volte à página Chaves de desenvolvedor e revogue a chave antiga (consulte "Revogar uma chave de desenvolvedor" abaixo — esta etapa é manual, tem efeito imediato e não pode ser desfeita).

9. Se você não revogar a chave antiga manualmente, a AppsFlyer a revoga automaticamente 90 dias depois que você gerar a nova chave.

   

Revogar uma chave de desenvolvedor

A revogação de uma chave de desenvolvedor é imediata e permanente.

• Assim que você clicar em Revogar e confirmar, a chave para de aceitar tráfego imediatamente. A partir desse momento, a AppsFlyer rejeita qualquer evento, sessão ou chamada S2S que ainda use essa chave.
• Você só pode revogar uma chave enquanto existirem duas chaves ativas.
• Você verá esta confirmação antes de revogar: "Tem certeza de que deseja revogar esta chave de desenvolvedor? [Rótulo da outra chave] continuará sendo sua chave de desenvolvedor ativa para este aplicativo. Isso entra em vigor imediatamente e não pode ser desfeito."
• Se você revogar a chave errada por engano: não poderá restaurá-la por conta própria. Entre em contato com o suporte, que pode encaminhar o caso para P&D para uma reativação manual no backend. No entanto, isso só pode ser feito até 90 dias após a revogação. Depois dessa janela, a AppsFlyer exclui permanentemente o valor subjacente à chave, e ninguém pode restaurá-la.

Revogação automática, reversão e limites

Revogação automática após 90 dias

• Se você não revogar manualmente a chave antiga, a AppsFlyer a revogará automaticamente 90 dias após o momento em que você gerar a nova chave — não após integrá-la nem lançar o aplicativo.
• A revogação automática funciona exatamente como a revogação manual: é imediata, não há período de carência e se aplicam as mesmas regras de reativação em até 90 dias após a revogação.
• Se a atualização do seu aplicativo não tiver sido disponibilizada para todos até o 90º dia, as versões que ainda usam a chave antiga deixarão de reportar dados quando a AppsFlyer revogar a chave automaticamente.

As duas chaves ficam ativas automaticamente, sem uma etapa de ativação manual

• Assim que você gera uma segunda chave ou atribui uma chave existente como segunda chave, ela fica ativa e pronta para receber tráfego. Não há uma etapa de ativação.
• O prazo de 90 dias para sua chave atual começa a contar assim que você gera a nova chave, mesmo que ainda não a tenha implementado. Por isso, gere a segunda chave quando estiver pronto para integrá-la.

Reverter uma rotação

• Se houver algum problema com a integração da nova chave, revogue a chave nova. Sua chave antiga volta a ser a única chave ativa, e o prazo de 90 dias deixa de contar.
• Você pode fazer isso a qualquer momento durante a janela de 90 dias, desde que não tenha revogado a chave antiga.
• Se você já revogou a chave antiga, não pode revertê-la por conta própria. Entre em contato com o suporte até 90 dias após a revogação para solicitar a reativação.

Você nunca ficará sem uma chave funcional

A AppsFlyer nunca permite que uma revogação manual, automática ou acionada por API deixe um aplicativo sem uma chave de desenvolvedor funcional. 

Chaves de desenvolvedor pendentes legadas (antes de 2 de novembro de 2026)

Antes de 2 de novembro de 2026, uma segunda Dev Key permanecia Pendente até que alguém a ativasse. Esse estado não existe mais. As novas chaves de desenvolvedor ficam ativas assim que você as gera.

Se você tinha uma chave Pending em 2 de novembro de 2026, a AppsFlyer a cancelou automaticamente. Sua chave ativa original não foi afetada e continua sendo sua principal chave de desenvolvedor.

Uma chave cancelada deixa de funcionar e não aparece mais na sua lista de chaves de desenvolvedor. A AppsFlyer mantém esse registro. Para restaurar uma chave cancelada, entre em contato pelo e-mail hello@appsflyer.com, e o suporte da AppsFlyer coordenará essa restauração.

Para fazer a rotação de uma chave, siga as etapas em Como executar duas chaves de desenvolvedor em paralelo.