Migre da Adjust para a AppsFlyer

Para criar uma conta na AppsFlyer

1. Crie uma conta na AppsFlyer. 
2. Adicione usuários à conta, atribuindo as permissões necessárias.

Para adicionar seu app à AppsFlyer:

1. Adicione seu app à AppsFlyer.
2. [Opcional] Altere a janela de reatribuição padrão de 90 dias para seguir a sua definição do que são usuários ativos.
3. Como parte do assistente de onboarding da AppsFlyer, prepare e envie um e-mail para seu desenvolvedor com instruções e tarefas para a integração do SDK e o mapeamento de eventos no aplicativo.

O SDK integrado ao aplicativo é a conexão entre o aplicativo e a plataforma da AppsFlyer. Ele relata instalações, aberturas do app, eventos in-app e outros.

Para fazer a integração do SDK da AppsFlyer:

1. Verifique se recebeu o e-mail enviado pelo profissional de marketing com instruções e tarefas para a integração do SDK e o mapeamento de eventos no aplicativo.
2. Siga as instruções do e-mail e use o assistente de integração do SDK da AppsFlyer para integrar o SDK ao aplicativo.
   • O assistente ajuda o desenvolvedor desde a instalação até o teste bem-sucedido da integração. Ele também orienta o desenvolvedor durante a configuração de eventos in-app e testes da sua transmissão para a AppsFlyer. Saiba mais sobre o assistente de integração do SDK
   • Veja guias adicionais para a integração do SDK para Android e iOS.
   • Mapeie os eventos in-app que você deseja registrar usando os esquemas da AppsFlyer.
     Isso pode ser feito via SDK ou S2S.
3. Remova o SDK da Adjust.
   Você pode fazer isso imediatamente e mudar exclusivamente para a AppsFlyer, ou executar os dois SDKs simultaneamente por algumas semanas. Veja mais detalhes sobre essas opções na tabela abaixo.

   Opção	O que acontece depois do lançamento da versão atualizada do aplicativo?	Impacto
   Remover o SDK da Adjust (recomendado)	Somente a AppsFlyer registra novas instalações e atualiza o número de usuários. O concorrente ainda mostra eventos realizados pelos usuários, até que os usuários também atualizem o app.	Transição rápida. Sem atribuição duplicada.
   Manter o SDK da Adjust por um período de transição	A AppsFlyer e a Adjust atribuem novas instalações e registram eventos. Posteriormente, remova o SDK da Adjust.	A validação de dados é possível. Ou seja, você pode comparar dados da AppsFlyer com os dados da Adjust. Atribuição duplicada, que pode causar cobranças duplas com ad networks. Veja o exemplo abaixo. Maior carga de trabalho.

4. Depois que todas as outras tarefas nesse artigo de migração forem concluídas, libere a versão do aplicativo com o SDK da AppsFlyer. Novos usuários são atribuídos pela AppsFlyer.  
   Atenção:
   • Certifique-se de atualizar o aplicativo para iOS, Google Play e outros mercados relevantes fora da loja Android.
   • Seu aplicativo Android pode existir em sites de APK não oficiais, mesmo que você não os conheça (pesquise pelo nome do pacote do seu aplicativo para descobrir se esse é o caso).  Os sites de APK levam algum tempo para atualizar para a versão mais recente. Por isso, eles podem trazer usuários orgânicos, que instalam versões antigas sem o SDK da AppsFlyer.
   • Os lançamentos de atualizações do aplicativo nas lojas podem levar alguns dias para serem totalmente concluídos. Os usuários que fizerem a instalação durante essa fase ainda podem obter a versão anterior.

A migração de dispositivo é o processo de upload de uma lista de device IDs de usuários existentes (IDFA, IDFV, GAID) na AppsFlyer. (se você não tiver todos os device IDs necessários, entre em contato com seu CSM para que ele possa te orientar no processo de migração usando o CUID.) Você deve realizar esse processo antes de lançar a nova versão do aplicativo, que incluirá o SDK da AppsFlyer. Há duas opções ao migrar dispositivos: migração atribuída ou não atribuída.

A migração de dispositivos resolve os problemas de dados relacionados aos usuários existentes do aplicativo, que fizeram o download do app e foram atribuídos pela Adjust. Por exemplo, as cobranças duplicadas da SRN, que ocorrem quando os usuários originalmente atribuídos a uma SRN pela Adjust, e que ainda estão dentro da janela de lookback, são reivindicados pela SRN novamente na AppsFlyer.

Depois de migrar os dispositivos, os dados são refletidos na AppsFlyer da seguinte maneira:

• Dados de instalações: assim como as reinstalações, dispositivos migrados não têm dados de instalação. As instalações de dispositivos migrados não são exibidas na AppsFlyer.
• Dados de eventos e sessões in-app: são registrados e exibidos como orgânicos para o método de migração de dispositivo não atribuído ou são atribuídos ao canal de mídia e campanha, quando o método atribuído é usado. 
• Retargeting: eatribuições e reengajamentos são exibidos normalmente.
• Dados de atividade: mostrados normalmente.
• Dados de retenção e de cohort: dispositivos migrados não têm registros de instalação. Assim, eles não sãp associados a nenhum cohort e não podem ser exibidos nos relatórios de retenção e cohort.  

Para migrar dispositivos: 

1. Decida qual população de usuários você deseja migrar. Você pode migrar todos os usuários existentes (o que pode impedir que você acesse dados precisos de reatribuição da AppsFlyer) ou usuários que instalaram seu aplicativo recentemente (o que pode levar a cobranças duplicadas de usuários um pouco mais antigos).
   Recomendamos que você migre usuários ativos durante o período da janela de reatribuição atual.  Por exemplo, se o aplicativo tiver uma janela de reatribuição de 90 dias, migre os usuários que tiveram pelo menos uma sessão durante os 90 dias anteriores.
2. [Opcional] Peça ao profissional de marketing/gerente de UA para pausar campanhas de marketing existentes (de SRNs, ad networks não-SRNs, mídias próprias, etc.) até depois da migração do dispositivo.
   Se você decidir não pausar as campanhas, migre os device IDs que permaneceram no outro fornecedor assim que a versão atualizada do aplicativo com o SDK da AppsFlyer for lançada nas lojas de aplicativos. 
3. Prepare um arquivo CSV com base na população de usuários selecionada, usando a estrutura de migração atribuída ou não atribuída. Veja um exemplo de CSV
4. Envie o CSV ao seu CSM da AppsFlyer.
   Seu CSM migrará os device IDs para a AppsFlyer.  

Transfira as campanhas de marketing existentes para a AppsFlyer para ativar a atribuição da AppsFlyer, evitando cobranças duplicadas e perda de dados de atribuição.

Atenção: você pode optar por migrar apenas algumas campanhas de marketing de cada vez. Nesse caso, você pode segmentar as que deseja migrar por canal de mídia (por exemplo, ad network ou agência), geolocalização ou campanha. 

As seções a seguir explicam os passos necessários para ativar a mensuração da AppsFlyer para diferentes tipos de canais de mídia: SRNs, ad networks não-SRNs, mídia própria e SKAN. 

SRNs

As SRNs respondem às parceiras de mensuração mobile (MMPs) quando consultados sobre engajamentos de dispositivos específicos. Se a AppsFlyer e a Adjust consultarem a mesma SRN sobre a mesma instalação, você poderá receber cobranças duplas. 

Para migrar campanhas de SRN:

• Ative e configure as SRNs relevantes na AppsFlyer.

Ad networks que não são SRNs

Os links de atribuição das ad networks registram os engajamentos dos usuários e, posteriormente, são usados para a atribuição desses engajamentos, que se tornam instalações reais.

Para migrar campanhas de ad networks que não são SRNs:

1. Ative as ad networks relevantes na AppsFlyer.
2. Gere links de atribuição da AppsFlyer para cada ad network.
3. Troque os links existentes em cada uma das suas campanhas pelos links de atribuição da AppsFlyer.  

Mídias próprias

Mídias próprias se referem aos links de atribuição que você usa em:

• Compartilhamento de conteúdo
• Web-to-app
• E-mail
• SMS
• Posts em redes sociais
• Blogs
• Comunidades virtuais (Quora, etc.)
• E mais...

Para essas campanhas, a AppsFlyer usa links do OneLink. Os links do OneLink redirecionam os usuários com base em seus dispositivo para a loja correta, diretamente para o aplicativo ou para uma URL/landing page na web.

Para migrar seus links da Adjust para links do OneLink da AppsFlyer:

• Entre em contato com seu CSM, que o ajudará a transformar seus links de mídias própria em links do OneLink de acordo com os canais e ferramentas que você usa atualmente.

SKAN

Para a atribuição da SKAdNetwork (SKAN), você deve ter um único SDK para atualizar o valor de conversão. Caso contrário, os dados da SKAN não têm utilidade. Portanto, certifique-se de que, após a migração, apenas o SDK da AppsFlyer poderá atualizar o valor de conversão da SKAN.

Saiba mais sobre como configurar o valor de conversão da SKAN na AppsFlyer.

Você pode obter dados brutos e agregados dos relatórios da AppsFlyer usando diversos métodos. Familiarize-se com os métodos e configure aqueles que são relevantes para você.

Os métodos incluem:

• Dashboards
• Exportação de relatórios
• Push API
• Pull API
• Data Locker

Antes da migração, seus sistemas armazenam seus dados de atribuição da Adjust de acordo com as estruturas, campos e parâmetros de relatórios que você configurou com ela. Para que a AppsFlyer relate corretamente os dados, você deve adaptar e mapear suas estruturas de relatório atuais para a estrutura, campos e parâmetros de relatório da AppsFlyer.

Para adaptar/mapear suas estruturas de relatório:

• Entre em contato com seu CSM da AppsFlyer para obter ajuda para adaptar/migrar rapidamente as estruturas de dados dos seus relatórios da Adjust para a AppsFlyer.

Os dispositivos migrados para a AppsFlyer com esse método têm seus eventos in-app e sessões registrados e exibidos de acordo com o canal de mídia relatado pelo fornecedor de atribuição anterior, e de acordo com as políticas de retenção de dados das ad networks.

Estrutura CSV de migração de dispositivo atribuído

Regras de arquivo CSV:

• O arquivo CSV pode conter dispositivos de usuários de vários aplicativos.
• Não duplique a mesma combinação de device ID e app ID em múltiplas linhas. Se ocorrer duplicação, a última ocorrência no arquivo será usada.
• Todos os cabeçalhos de coluna devem ser incluídos: app_id, platform, device_id, id_type, install_time, media_source, integrated_partner, campaign, campaign_id. Atenção: a ordem dos campos é importante e deve ser mantida.
• Você pode adicionar o IDFV e o IDFA para o mesmo dispositivo, mas eles devem estar em linhas separadas. Todos os campos nas linhas separadas devem ser os mesmos, exceto device_id.
• Cada linha deve conter exatamente 9 campos separados por vírgulas.
• Deixe os campos não obrigatórios vazios (em branco).
• Os arquivos podem conter até 5 milhões de linhas.
• Caso você tenha vários arquivos, dê a cada arquivo um nome exclusivo.
• Codifique dados usando UTF-8.
• [Opcional] Compacte arquivos usando ZIP ou GZIP. 

Veja um exemplo de CSV

Os dispositivos migrados para a AppsFlyer com esse método são registrados (mas não são exibidos) como usuários orgânicos. Seus eventos in-app e dados de sessões também são gravados e exibidos como orgânicos.

Estrutura de arquivo CSV de migração de dispositivos não atribuídos

Opção	Colunas	Quando utilizar	Exemplo
1	App ID + IDFA/GAID/IDFV	Se todos os usuários Android tiverem identificadores GAID. Somente usuários do iOS
2	App ID + Device ID + tipo do Device ID	Se alguns dos seus usuários Android tiverem apenas IMEI ou Android ID, mas não GAID (mercados fora da loja, versões Android anteriores à versão 4.4.2). O Android ID precisa ter um formato hexadecimal. Atenção: Use as strings específicas para a coluna de tipo de ID: advertiserId (também compatível com amazon_aid), idfa, idfv, android_id, imei. Se você usar android_id ou imei e, posteriormente, a AppsFlyer receber um identificador melhor, uma nova atribuição poderá ser registrada.

Regras de arquivo CSV:

• O arquivo CSV pode conter dispositivos de usuários de vários aplicativos.
• Cada linha contém um device ID único por aplicativo. 
• Dependendo da opção de estrutura de arquivo escolhida, as colunas de arquivo devem ser as seguintes (na ordem listada):
  • Opção 1: app_id, device_id 
  • Opção 2: app_id, device_id, id_type  
• App IDs em letras minúsculas.
• Identificadores Android em letras minúsculas.
• IDFA/IDFV em letras maiúsculas.
• Até 25 milhões de linhas permitidas

Veja um exemplo de CSV