Integrar AppsFlyer: eventos, custos e verificações
Uma integração do AppsFlyer precisa de três verificações separadas: o app registra os eventos previstos, cada parceiro de publicidade recebe os sinais permitidos e os custos das contas corretas são importados. Meta, Google, Apple Ads e X têm requisitos diferentes. Uma conta conectada, por si só, não garante um
Uma instalação pode aparecer no AppsFlyer enquanto seu evento de compra está ausente no Google Ads. A atribuição do Apple Ads pode funcionar sem que os custos das campanhas sejam importados. Tratar uma dessas conexões como concluída pode levar a decisões baseadas em um
Este guia é para o desenvolvedor e o responsável pela aquisição que configuram essas conexões juntos. Ele se baseia na documentação oficial consultada em 9 de outubro de 2026 e traz verificações de aceite que você pode aplicar ao
Defina os eventos antes de conectar os parceiros
Crie uma especificação curta com ação, gatilho, parâmetros, responsável e destinatários de cada evento. Separe o início de um teste gratuito, a primeira compra paga e a renovação. Defina como tratar cancelamentos, reembolsos e notificações duplicadas do servidor e do cliente antes de atribuir receita a
Use o guia de integração do SDK adequado ao framework do app. Confira o ID do app, a inicialização do SDK e o fluxo de consentimento. O AppsFlyer contabiliza a receita enviada em af_revenue; um parâmetro genérico chamado price não basta. O fluxo de validação de compras pode enviar um evento de compra automaticamente. Enviar esse mesmo evento manualmente também pode duplicá-lo
Para uma compra de teste hipotética de US$ 9,99, registre horário, moeda e referência da transação. Acompanhe seu percurso pelo app, pelo AppsFlyer e por cada destinatário configurado. Verifique se a receita foi registrada uma única vez e se um teste gratuito não foi contado como pagamento. Cadastre o dispositivo de teste conforme as instruções do AppsFlyer para que instalações repetidas sejam reconhecidas corretamente durante
Siga os requisitos de cada parceiro
O caminho atual é Collaborate > Partner Integrations, seguido da aba Marketplace. Selecione o parceiro e ative a integração. As conexões existentes aparecem na aba separada de integrações ativas. Mantenha um registro datado dos IDs de app, das contas abrangidas, dos mapeamentos de eventos e das janelas
Meta Ads: confira o ID, os eventos e o acesso aos dados
Insira o Facebook App ID correspondente e mapeie os eventos do AppsFlyer para os eventos pretendidos da Meta. Revise quais eventos de usuários e valores podem ser compartilhados conforme o consentimento obtido. Consulte as instruções de integração com a Meta para verificar as
No Android, confira os requisitos do Meta install referrer, incluindo SDK compatível e chave de descriptografia. Ativar essa opção não disponibiliza automaticamente todos os registros históricos
O guia atual do AppsFlyer também explica o Advanced Mobile Measurement (AMM). A aceitação dos termos afeta o acesso à atribuição por dispositivo dos usuários atribuídos a partir desse momento. Conversões antes restritas não são completadas retroativamente, e os eventos posteriores desses usuários podem manter a restrição original. Investigue essa diferença antes de interpretar campos ausentes nos dados brutos como falha
Google Ads: diferencie o ID do vínculo e as conversões importadas
Crie no Google Ads um vínculo de análise de apps de terceiros, selecionando o AppsFlyer como provedor. Escolha o app e o sistema operacional corretos e adicione o link ID à integração do Google Ads no AppsFlyer. Android e iOS precisam de
Depois, confira as ações de conversão no Google Ads. Importe first_open, session_start para reengajamento e os eventos no app que você mapeou e precisa utilizar. Os eventos devem ocorrer antes de ficarem disponíveis para importação. O AppsFlyer informa um possível atraso de até seis horas. Siga o guia de integração com o Google Ads, incluindo os testes específicos de
O guia de setembro de 2026 inclui requisitos adicionais de SDK e mensuração do Google para medição no dispositivo em iOS. Verifique a implementação compatível com o app, seja via Firebase ou pela solução independente. Um link ID, sozinho, não ativa essa capacidade. Conecte os relatórios de custos separadamente e confira qual conta do Google Ads
Apple Ads: separe atribuição e importação de custos
A atribuição do Apple Ads usa um token do AdServices obtido pelo SDK e trocado com o serviço de atribuição da Apple. A API de relatórios fornece metadados de campanha e custos. No AppsFlyer, os custos exigem acesso ao ROI360. A atribuição funcionar não confirma esse acesso. Autorize todos os grupos de campanhas necessários na conexão de relatórios. Consulte o guia de configuração do Apple Ads.
A integração padrão do Apple Ads não tem configurações de postbacks para o parceiro. Por isso, seu aceite não pode depender da mesma verificação de entrega de eventos usada para a Meta. Integrações com parceiros de marketing têm uma
Considere também uma mudança nos relatórios com data definida. O AppsFlyer documenta que, desde 1º de setembro de 2026, o Apple Ads fornece horários de interação em todas as solicitações de atribuição. Isso permite aplicar de forma mais consistente as janelas configuradas e as regras de último contato. O aviso da mudança também informa que grupos de anúncios segmentados por idade ou gênero retornam uma resposta de atribuição negativa. Verifique esse escopo ao investigar alterações próximas de 1º de setembro. A mudança nos relatórios, por si só, não comprova uma mudança na aquisição
X Ads: verifique autorizações e o escopo da migração
Siga o guia de integração com X Ads: aceite os termos de Mobile App Conversion Tracking, autorize o AppsFlyer, selecione as contas previstas e salve a integração ativa. O X exige um método de pagamento na conta. Defina as janelas de clique e visualização acordadas e examine as opções de compartilhamento de eventos. Os custos exigem conexão separada
Em uma migração, o X aceita apenas uma conexão com um MMP por vez. Planeje a transferência considerando as limitações do uso de vários MMPs. Dois SDKs ativos não fornecem automaticamente dois conjuntos de dados completos
Valide cada etapa com a evidência correspondente
Registre juntos a versão compilada do app, o dispositivo, o estado do consentimento, o horário e o evento esperado do teste. Cada verificação responde a uma
| Conexão | Evidência a conferir | O que ela demonstra |
|---|---|---|
| App para AppsFlyer | Registros de instalações e eventos, moeda e receita | O fluxo implementado no app está sendo medido |
| Meta | Mapeamento dos eventos e recebimento dos eventos permitidos no destino | O sinal autorizado chega ao destinatário configurado |
| Escopo do vínculo, ação importada e status dos relatórios | A conversão prevista está disponível no Google Ads | |
| Apple Ads | Resposta de atribuição e cobertura das contas de relatórios | A atribuição e o acesso a custos e metadados funcionam separadamente |
| X | Contas selecionadas, configurações dos eventos e status da importação de custos | As conexões necessárias de contas e relatórios estão ativas |
Um teste bem-sucedido do SDK não comprova o impacto incremental de uma campanha. Uma importação de custos ausente também não deve ser diagnosticada alterando mapeamentos de eventos. Resolva a falha na etapa afetada e repita o
Interprete os relatórios dentro dos limites da mensuração
Ao conciliar relatórios, documente período, fuso horário, janelas de clique e visualização e agrupamento pela data de instalação ou do evento. Os downloads no Apple Ads podem diferir das primeiras aberturas no AppsFlyer. As conversões reivindicadas pelas redes também podem diferir da decisão de atribuição entre redes
Para SKAdNetwork, registre o mapeamento dos valores de conversão e qual SDK os atualiza. O guia de SKAN descreve postbacks agregados, atrasados e com detalhes limitados pela privacidade. Um valor de conversão ausente não significa necessariamente uma compra ausente. Confira o suporte atual de SDK, rede e framework para sua configuração iOS. Uma declaração genérica de compatibilidade com AdAttributionKit não substitui um teste
Separe o atraso dos relatórios da maturidade da coorte. Um relatório completo sobre as instalações de ontem ainda não pode conter suas renovações do mês seguinte. Compare coortes com a mesma idade e diferencie receita observada de previsões de valor do cliente ao longo
Orce o plano e os recursos necessários
Na página de preços consultada em 9 de outubro de 2026, o Zero cobre a mensuração de mídia própria. As 12.000 conversões gratuitas no primeiro ano pertencem à oferta de boas-vindas do Growth. Depois, o Growth anuncia US$ 0,07 por conversão faturável, incluindo instalações, reengajamentos e reatribuições aplicáveis. Instalações e ações orgânicas ficam de fora. O Enterprise tem preço
Confirme ROI360, Protect360, exportações de dados brutos e acesso à API no pacote proposto. Um recurso funcionar durante o teste não comprova que esteja incluído depois. Estime as conversões faturáveis e os complementos necessários
Se ainda estiver escolhendo um fornecedor, consulte nossa comparação entre Adjust e AppsFlyer e o guia de configuração do Adjust. Se a mensuração funciona, mas o crescimento não vem, nosso diagnóstico de crescimento gratuito de 90 segundos ajuda a avaliar as quatro etapas do funil. Nossos serviços de publicidade paga e dados e atribuição mobile abrangem implementação e relatórios quando você precisa investigar uma