Migração de outros fornecedores para a AppsFlyer

Resumo: planeje sua migração para a AppsFlyer a partir de outro fornecedor de atribuição. Entenda como evitar cobranças duplas, duplicação de dados e perda de dados durante o período de migração.

fluxo de migração

Migração de outros fornecedores para a AppsFlyer

A migração de outro fornecedor para a AppsFlyer inclui as seguintes etapas:

Você pode fazer essas tarefas simultaneamente. No entanto, recomendamos que você:

  • Conclua todas as tarefas antes de lançar seu aplicativo atualizado com o SDK da AppsFlyer. 
  • Pause as campanhas de marketing existentes antes de executar a migração do device ID.

Comparando a mensuração entre a AppsFlyer e a Adjust

Ao considerar a migração para a AppsFlyer a partir de outra MMP, os anunciantes podem querer comparar as mensurações de atribuição de ambas as MMPs nas mesmas fontes de mídia e campanhas. No entanto, nem todos os canais de mídia oferecem suporte à mensuração com mais de uma MMP. Aqueles que o fazem podem apresentar certas limitações para evitar discrepâncias de atribuição. Saiba mais sobre a mensuração de atribuição com mais de uma MMP

Tarefas

A tabela a seguir descreve o escopo de trabalho necessário para cada tarefa. Para ver uma análise precisa das tarefas gerais na ordem na qual você deve realizá-las e acompanhar o seu progresso, baixe essa planilha.

Escopo do trabalho

Tarefa Ação necessária Responsável Tempo estimado Observações
Pré-requisitos
  1. Crie uma conta na AppsFlyer.
  2. Adicione o aplicativo à AppsFlyer.
  3. [Opcional] Altere a janela de reatribuição padrão de 90 dias para alinhar com a sua definição de usuários ativos.
Profissional de marketing/usuário do dashboard da AppsFlyer 2 horas  
Integração do SDK
  • Integre o SDK da AppsFlyer ao seu aplicativo.
  • Mapeie eventos in-app S2S ou SDK.
  • Atualize a versão do aplicativo nas app stores.
Desenvolvedores do app 1-2 semanas
  • Recomendado: integre o SDK da AppsFlyer em um aplicativo de pré-produção para teste.
  • O aplicativo de produção deve ser atualizado nas lojas de aplicativos depois que todas as outras tarefas forem concluídas.
Migração de dispositivos [opcional] Migre os IDs dos dispositivos para evitar a dupla atribuição dos seus usuários existentes. Engenheiro de dados 1-2 semanas
  • Considere pausar suas campanhas existentes antes da migração e retome-as depois que a versão do aplicativo for atualizada.  
  • Considere repetir a migração de dispositivos na data final da migração para garantir uma cobertura completa.  
Migração de campanhas
  • Integre suas ad networks na AppsFlyer
  • Migre campanhas existentes de: 
    • SRNs
    • Ad networks que não são SRNs
    • Mídias próprias
Profissional de marketing/Gerente de UA 1-3 semanas
Configuração do relatório de dados
  • Adapte/mapeie as estruturas dos seus relatórios atuais para as estruturas da AppsFlyer.
  • Prepare-se para receber relatórios da AppsFlyer.
Engenheiro de dados 2-4 semanas  

Integração do SDK

Integração do SDK

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.

Migração de dispositivosopcional

Sobre a migração de dispositivos

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.

Exemplo

  • Um novo usuário clica em um anúncio no Facebook e instala seu aplicativo no dia 15 de junho.
  • No dia 24 de junho, o usuário atualiza o aplicativo para a versão com o SDK da AppsFlyer e o inicializa. Para a AppsFlyer, esse é um novo usuário, que precisa ser atribuído em tempo real.
  • A AppsFlyer consulta o Meta ads com o ID do dispositivo do usuário. Como o usuário ainda está dentro da janela de lookback de 28 dias do Meta ads, o Meta ads auto-atribui o usuário. Isso causa uma cobrança dupla para o proprietário do aplicativo em relação ao mesmo usuário.

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. 

Atenção:

Se o aplicativo não for aberto dentro de 180 dias a partir da data de migração, todos os dados do dispositivo migrado serão excluídos. Consequentemente, se o aplicativo for aberto após o período de 180 dias, uma nova instalação será registrada.

Como migrar dispositivos

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.  

Migração atribuída

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

Nome da
coluna
Descrição Obrigatório Exemplos
app_id
 
App ID exibido no dashboard da AppsFlyer Sim
  • Android: com.great.app1 
  • iOS: id123456789
platform
 
Plataforma do dispositivo: ios ou android Sim
  • ios
  • android
device_id
 
  • Android: gaid ou android_id
  • iOS: IDFV (recomendado, se disponível) ou IDFA
  • 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.
Sim
  • gaid (letras minúsculas): 9c9a82fb-d5de-4cd1-90c3-527441c11828
  • android_id (letras minúsculas): f35aea8908254891
  • IDFV (letras maiúsculas): A7328D98-A973-402A-8B87-D22A8611F2AF
  • IDFA (letras maiúsculas): 9876F1SS-2983-3855-27RR-2R626772VFNB
id_type
 
  • Android: advertiserId (também compatível com amazon_aid)j, android_id
  • iOS: idfa ou idfv
  • No momento, outros identificadores, como OAID e IMEI, não são compatíveis.  
    Use a migração não atribuída para usuários Android que não vêm do Google Play.
Sim
  • advertiserId
  • android_id
  • idfa
  • idfv
install_time
 
O tempo de instalação do aplicativo original com o ISO 8601 no formato UTC:
aaaa-mm-ddTHH:MM:SS.SSS
Não 2018-01-22T08:45:33.412
media_source
 
  • Ou:
    • ID de parceiro da AppsFlyer
    • Canal de mídia personalizada (não pode ser um ID de parceiro).
  • Para obter a lista de IDs de parceiros, conforme exigido pela AppsFlyer:
  • Formato: Os valores fazem distinção entre maiúsculas e minúsculas.
Sim


Não orgânico: facebook_int, googleadwords_int

Orgânico: organic

integrated_partner
 
  • Indica se o canal de mídia é um parceiro integrado ou não. Ou seja, canal de mídia orgânica ou personalizada.
     
  • Formato: Os valores fazem distinção entre maiúsculas e minúsculas.
Sim
  • yes
  • no (se media_source for personalizado)
campaign
 

Para obter detalhes de atribuição mais granulares, forneça o nome da campanha original.

Formato: String

Não  
campaign_id
 

 Para obter detalhes de atribuição mais granulares, forneça o ID da campanha original.

Formato: Formato: string sem espaços

Não  

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

Migração não atribuída

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  
device_migration_file_option_1.png
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.
device_migration_file_option_2.png

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

Migração de campanhas

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.  

SRNs

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.

Atenção:

  • SRNs podem executar várias MMPs (exceto Meta Ads e Twitter).
  • O Meta Ads não corrige eventos in-app duplicados.

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

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.

Configuração do relatório de dados

Adaptar e mapear estruturas de relatório

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.

Preparar métodos de relatório

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