Como podemos ajudar?

Pesquisa

Gerenciamento de Dev Key

  • Atualizado

Em resumo: Controle e atualize a Dev Key do seu aplicativo diretamente nas Configurações do aplicativo. Oferecendo a você mais flexibilidade e segurança.

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 habilitar 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 guia Dev Key Management nas configurações do seu aplicativo permite que usuários administradores visualizem e gerenciem Dev Keys, incluindo a atualização ou substituição de uma Dev Key existente.

Onde encontrar suas Dev Keys

Na AppsFlyer, no menu lateral, selecione Configurações > Configurações do aplicativo > Dev Key Management. 

Gerenciamento de Dev Key

Os administradores podem usar a guia Dev Key Management para:

  • Gerar uma Dev Key exclusiva para um aplicativo específico.
  • Atribuir uma Dev Key já em uso por outro aplicativo na conta.
  • Habilitar a geração padrão de dev keys exclusivas para novos aplicativos.

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 acesso não autorizado.
  • Transferências de conta: quando um aplicativo é movido entre contas, uma nova Dev Key é gerada para alinhá-lo à conta atual.
  • Granularidade: atribua chaves exclusivas por aplicativo para simplificar o monitoramento, a solução de problemas ou o controle de acesso.

Como configurar e alterar uma Dev Key

Depois de gerar ou atribuir uma nova Dev Key, é importante:

  • Atualizar o SDK: substitua a Dev Key no código do SDK do seu aplicativo.
  • Lançar uma nova versão: envie uma nova versão do aplicativo com a chave atualizada para a loja de aplicativos.
  • Ative a chave (obrigatório) - Ativar a Dev Key é uma etapa obrigatória para que a alteração entre em vigor.
  • Depois que seu desenvolvedor atualizar o SDK com a nova Dev Key e a nova versão do aplicativo estiver disponível na loja de aplicativos, volte à seção Gerenciamento de Dev Key e clique em Ativar Dev Key.
  • Até você ativar a Dev Key:
    • A Dev Key atual permanece ativa
    • A nova Dev Key permanecerá no estado Pendente
    • Nenhuma alteração será aplicada à coleta de dados

Importante!

Ative a Dev Key somente depois que a versão atualizada do aplicativo estiver disponível. Ativar cedo demais pode fazer com que eventos in-app e sessões de versões mais antigas do aplicativo deixem de ser registrados.

  1. Na AppsFlyer, no menu lateral, selecione Configurações > Configurações do aplicativo > Autenticação do SDK.
  2. Clique em Gerenciar Dev Key.
  3. Revise o impacto de alterar sua Dev Key antes de continuar.
  4. Escolha como definir a nova Dev Key:
    1. Selecione uma Dev Key existente - Escolha uma Dev Key que já exista na sua conta (por exemplo, uma Dev Key usada por outro aplicativo).
      1. A Dev Key selecionada será atribuída a este aplicativo no estado Pendente
      2. Sua Dev Key atual permanecerá ativa até que você ative a nova
      3. A ativação é obrigatória depois que a versão atualizada do aplicativo estiver disponível

    2. Gerar nova Dev Key - Crie uma Dev Key totalmente nova e exclusiva para este aplicativo.

      1. A nova Dev Key será criada no estado Pendente
      2. Sua Dev Key atual permanecerá ativa até a ativação
      3. A ativação é obrigatória depois que a versão atualizada do aplicativo estiver disponível

      Importante!

      Independentemente da opção escolhida, a alteração da Dev Key só entra em vigor depois que você ativar manualmente a Dev Key.

  5. Clique em Avançar.
  6. Copie e envie a Dev Key para seu desenvolvedor para que ele possa implementar as alterações no SDK e enviar a nova versão do seu aplicativo para a loja.
  7. A Dev Key entrará em um estado pendente.
  8. Clique em Ativar Dev Key.
  9. A Dev Key passa de pendente para ativa.

Atenção

  • Até que os usuários atualizem para a versão mais recente do aplicativo, eventos in-app e sessões de versões anteriores não serão registrados. No entanto, as instalações (atribuição) ainda serão processadas corretamente.
  • Se você estiver usando a API S2S (API2), alterações na Dev Key podem interromper eventos servidor a servidor.
  • Depois que a Dev Key for ativada, pode levar até 30 minutos para que os dados comecem a fluir para o sistema.

Como definir uma Dev Key exclusiva para aplicativos futuros (em breve - Q2, 2026)

  1. No AppsFlyer, na barra lateral superior direita, clique em Configurações da conta.
  2. Clique na aba Conta.
  3. Em Segurança, ative Criar Dev Key exclusiva por aplicativo (para referência futura).
  4. Observação: ao ativar Dev Keys exclusivas para aplicativos futuros, os aplicativos existentes não serão afetados.

Tags