Migração de outros fornecedores para a AppsFlyer

O SDK da AppsFlyer integrado ao aplicativo é a conexão entre o aplicativo e a plataforma da AppsFlyer. Ele relata instalações de aplicativos, abertura de aplicativos, 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ê quer registrar usando os esquemas da AppsFlyer.
   Isso pode ser feito via SDK ou S2S.
3. Remova o SDK do fornecedor de atribuição do concorrente.
   Você pode fazer isso imediatamente e mudar exclusivamente para a AppsFlyer, ou executar os dois SDKs simultaneamente por algumas semanas. Veja os detalhes sobre essas opções na tabela abaixo.
   

   Opção	O que acontece após o lançamento da versão atualizada do aplicativo	Impacto
   Remova o SDK do concorrente (recomendado)	Apenas a AppsFlyer registra novas instalações e a atualização 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 dupla.
   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 dupla, 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. 
   Observaçã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 na internet o nome do pacote do seu aplicativo para saber). Os sites de APK levam algum tempo para atualizar para a versão mais recente, portanto 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 app stores 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 dispositivos é o processo de fazer upload de uma lista de IDs de dispositivos dos seus usuários existentes (IDFA, IDFV, GAID, CUID) para a 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ção: assim como as Reinstalações, os dispositivos migrados não têm dados de instalação. As instalações de dispositivos migrados não são exibidas na AppsFlyer.
• Eventos in-app e dados de sessões: são registrados e exibidos como orgânicos para o método de migração de dispositivo não atribuído ou atribuído à fonte de mídia e campanha, caso esteja usando o método atribuído. 
• Retargeting: reatribuições e reengajamentos são exibidos normalmente.
• Dados da atividade: exibidos normalmente.
• Dados de retenção e cohort: dispositivos migrados não têm data 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. Escolha qual população de usuários migrar. Você pode migrar todos os usuários existentes (o que pode impedir que você receba dados de reatribuição precisos da AppsFlyer) ou apenas os usuários que instalaram seu aplicativo recentemente (o que pode levar a cobranças duplas de usuários mais antigos).
   Recomendamos migrar 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 SRN, mídias próprias etc.) até depois da migração do dispositivo.
   Se você decidir não pausar as campanhas, migre as IDs de dispositivo que permaneceram no outro fornecedor assim que a versão atualizada do aplicativo com o SDK da AppsFlyer for lançada para as 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 IDs de dispositivo para a AppsFlyer. 

Os dispositivos migrados para a AppsFlyer com esse método têm seus eventos in-app e sessões gravados e exibidos de acordo com a fonte de mídia reportada 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 ID de dispositivo e ID do aplicativo em várias 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. Observaçã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é 20 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 registrados e exibidos como orgânicos.

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

Colunas	Quando usar	Exemplo
ID do aplicativo + IDFA/GAID/IDFV	Se todos os usuários Android tiverem identificadores GAID. Somente usuários do iOS
ID do aplicativo+ ID do dispositivo + Tipo de ID do dispositivo	Se alguns dos seus usuários Android tiverem apenas IMEI ou ID Android, 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. Observação: Use as strings específicas para a coluna do 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 ID de dispositivo único por aplicativo. 
• Os arquivos devem incluir todos os cabeçalhos de coluna, conforme descrito abaixo:
  • Opção 1: o arquivo deve incluir todos os cabeçalhos de coluna da seguinte maneira: 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 aos Parceiros de Mensuração Mobile (MMPs) quando consultados sobre engajamentos de dispositivos específicos. Se duas 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 SRN:

• Ative e configure as SRNs relevantes na AppsFlyer.

Os links de atribuição de ad networks registram os engajamentos dos usuários e, posteriormente, são usados para a atribuição dos 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ídia própria se refere aos links de atribuição que você usa em:

• Compartilhamento de conteúdo
• Web-to-app
• E-mail
• SMS
• Posts de mídia social
• Blogs
• Comunidades da Internet (Quora etc.)
• e outros...

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

Para trocar os seus links de outros fornecedores por OneLinks da AppsFlyer:

• Entre em contato com seu CSM, que auxiliará na migração em massa de todos os seus links. 

Para a atribuição da SKAdNetwork (SKAN), você só pode ter um SDK para atualizar o valor da conversão. Caso contrário, os dados de 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 os que são relevantes para você.

Os métodos de relatório incluem:

• Exportar CSV
• API de push
• Pull API
• Data Locker