Migração de outros fornecedores para a AppsFlyer

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. Integre o SDK da AppsFlyer ao aplicativo.
   Consulte os guias de integração do SDK para Android e iOS.
2. Mapeie os eventos in-app que você quiser registrar usando os esquemas da AppsFlyer.
   Isso pode ser feito via SDK ou S2S.
3. Remova o SDK do fornecedor de atribuição concorrente.
   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
   Remova o SDK do concorrente (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 seu aplicativo.	Transição rápida. Sem atribuição duplicada.
   Mantenha o SDK do concorrente para um período de transição	A AppsFlyer e o concorrente atribuem novas instalações e registram eventos. Após determinado tempo, remova o SDK do concorrente.	A validação de dados é possível. Ou seja, você pode comparar dados da AppsFlyer e do outro fornecedor. 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 no escopo do trabalho forem concluídas, atualize a versão do aplicativo com o SDK da AppsFlyer para o mercado. 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. 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 aplicativo e foram atribuídos pelo fornecedor anterior. Por exemplo, as cobranças duplas da SRN, que ocorrem quando os usuários originalmente atribuídos a uma SRN pelo seu fornecedor anterior, 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. Portanto, eles não estão associados a qualquer 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.  

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	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 
• IDs de aplicativos em letras minúsculas
• Identificadores Android em letras minúsculas
• IDFA/IDFV em maiúsculas
• Até 25 milhões de linhas permitidas

Veja um exemplo de CSV

As SRNs respondem às parceiras de mensuração mobile (MMPs) quando consultados sobre engajamentos de dispositivos específicos. Se dois MMPs, como a AppsFlyer e um fornecedor de atribuição concorrente, consultarem a mesma SRN sobre a mesma instalação do dispositivo, isso poderá resultar em cobranças duplas.

Para migrar campanhas de SRN:

• Ative e configure as SRNs relevantes na AppsFlyer.

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 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 mudar seus links de mídia própria atuais para links do OneLink:

• 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.

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.

Antes da migração, seus sistemas armazenam seus dados de atribuição do fornecedor atual de acordo com as estruturas, campos e parâmetros de relatórios que você configurou com eles. 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 o CSM da AppsFlyer para obter ajuda para adaptar/migrar rapidamente as estruturas de dados dos seus relatórios do Adjust, Branch/Tune ou Kochava para a 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