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 de atividades: mostrados como parte dos dados orgânicos.
• 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.
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 através desse método são registrados de acordo com a atribuição determinada. Seus eventos in-app e dados de sessões também são registrados e exibidos de acordo.

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. 
• 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
• Cada linha deve conter exatamente 9 campos separados por vírgulas.
• Deixe 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.
  

Dispositivos migrados para a AppsFlyer através desse método são registrados 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

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. Use as sequências exatas para a coluna Tipo de ID: advertiserId, idfa, android_id, imei.

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

As SRNs respondem a MMPs (Mobile Measurement Partners ou Parceiros de Mensuração Mobile), 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 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. 

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 vários 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