Integrar a Adjust: verificar Meta, Google, Apple e X Ads
Uma integração da Adjust está pronta para orientar decisões quando o app envia os eventos previstos, as redes envolvidas os recebem e custos e receitas se conciliam no nível necessário. Instale e teste o SDK, configure cada parceiro e valide as conexões separadamente. Apple Ads usa caminhos diferentes para atribuição e custos; Google exige ações de conversão além do Link ID. Alinhar janelas ajuda a comparação, mas não garante números idênticos em todas
Uma compra pode aparecer na Adjust sem que seu valor chegue à rede que disputa aquele cliente. Uma campanha pode ter instalações atribuídas enquanto a importação de custos está desconectada. Trate atribuição, envio de eventos e coleta de custos como partes distintas
Este guia usa documentação oficial da Adjust consultada em 9 de outubro de 2026. Organiza a passagem de trabalho entre desenvolvimento, aquisição e responsável pelos relatórios. Se ainda está escolhendo um parceiro de mensuração mobile (MMP), comece pela comparação entre Adjust e AppsFlyer.
Prepare o app e defina os eventos
Siga o guia inicial da Adjust para o kit de desenvolvimento de software (SDK) adequado ao app. Confira os IDs, os ambientes de produção e teste, o tratamento do consentimento e as permissões de cada conta. É possível configurar e testar eventos antes de comprar tráfego. Um teste de atribuição da rede pode exigir uma interação válida com anúncio; registre-o como uma etapa separada
Entregue uma especificação de eventos ao desenvolvimento. Só nomes como purchase não bastam. Para cada evento, registre o gatilho, valor, moeda, identificador único da transação e sistema emissor: app, servidor ou plataforma de assinaturas. Uma renovação enviada pelo app e pelo servidor pode dobrar a receita informada se a deduplicação não tiver
Separe receita de compras, receita publicitária e valores líquidos das taxas das lojas. Defina como reembolsos e renovações entram no relatório. Ao migrar de outro MMP, planeje o tratamento de usuários existentes antes de publicar a versão, para que não apareçam como
Meta: conecte a fonte de dados dos dois lados
Em Campaign Lab > Partners, adicione o parceiro identificado como Facebook, selecione o app e informe seu ID de aplicativo no portal de desenvolvedores da Meta. Novos apps, novas contas da Adjust e migrações também precisam conectar a Adjust como fonte em Meta Events Manager. A documentação da integração com a Meta informa que, sem essa conexão, a Meta não consegue reivindicar as interações medidas
Mapeie os eventos que serão compartilhados para os eventos adequados da Meta e confira a opção de envio de receita. Número de compras e valor de compras são sinais diferentes. Revise o escopo do compartilhamento, inclusive eventos orgânicos e de outras redes, conforme o desenho de consentimento e uso de dados
Para dados brutos de atribuição no Android, consulte os requisitos de Google Play Install Referrer e Meta Install Referrer. O caminho da Meta exige o SDK Android da Adjust v5, o plugin Meta Install Referrer e a configuração da chave de descriptografia. A chave sozinha não garante dados brutos de campanha para todas as
Google Ads: confirme as ações de conversão
Crie o Link ID para o app e a plataforma corretos no nível adequado da conta Google Ads. Insira-o na configuração do Google Ads no Campaign Lab. O guia de contas diferencia contas individuais e de administrador, o que importa quando várias contas anunciam o
Depois, confira as ações de conversão no Google Ads. O guia de integração da Adjust exige first_open e session_start, além dos eventos mapeados necessários. Ele diferencia a importação automática dos eventos criados após 3 de dezembro de 2025 das ações anteriores que exigem importação manual. Acione os eventos e verifique as ações resultantes. Ter o Link ID não conclui
Para informar valores de compra, confira o mapeamento e a opção de receita no app. Conecte os custos separadamente em DataWorks > Connections. Verifique também a opção de janela de atribuição do Google Ads de 30 dias: ela pode substituir ajustes de níveis inferiores. Mensuração no dispositivo ou probabilística no iOS tem seus próprios requisitos atuais. Adicionar um parâmetro de clique não garante atribuição completa nem conformidade com as regras
Apple Ads: separe atribuição e enriquecimento dos relatórios
O fluxo de atribuição do Apple Ads começa no SDK da Adjust e no framework AdServices da Apple. O app obtém um token que a Adjust usa para solicitar a resposta de atribuição da Apple. Essa conexão é diferente da API de relatórios do
Vincule Apple Ads em DataWorks > Connections para obter nomes de campanhas e os serviços de relatório necessários, seguindo o guia de configuração. Se a atribuição tem IDs, mas não nomes, investigue essa conexão. Se faltam custos, confira permissões, serviço selecionado e última importação bem-sucedida antes de alterar o código
Apple Ads não usa o mesmo fluxo de mapeamento de eventos de parceiros da Meta. Analise a aquisição junto com o trabalho de conversão na loja. Nosso caso Kleo relata aumento de 127% nos downloads em 30 dias de otimização da App Store. Esse resultado separado não valida uma configuração da Adjust nem demonstra a contribuição incremental do
X Ads: confira contas e restrições da migração
O guia de X da Adjust ainda usa Twitter em partes da interface. Adicione o parceiro no Campaign Lab, conclua a conexão da conta no DataWorks, selecione as contas publicitárias pretendidas e configure eventos e opções
O X aceita apenas uma conexão com MMP por vez. Uma integração antiga pode explicar uma falha de migração. Planeje a troca com o responsável pela conta e confirme qual sistema enviará os eventos. Conexão, contas selecionadas, envio de eventos e regras de atribuição precisam, cada um, de um resultado de
Comprove a integração antes de confiar nos relatórios
Use um registro pequeno de teste que desenvolvimento e marketing consigam acompanhar juntos. Para uma compra de teste hipotética de US$ 4,99, registre versão do app, dispositivo, horário do evento, identificador da transação e moeda esperada. Acompanhe o envio do app ou servidor até a Adjust e, quando houver suporte, até a rede de destino. Mantenha a receita de teste fora dos relatórios
| Observação | Próxima verificação |
|---|---|
| Evento ausente na Adjust | IDs de app e ambiente, gatilho, solicitação do SDK ou servidor e consentimento |
| Evento na Adjust, ausente no parceiro | Ativação do parceiro, mapeamento, escopo do envio e diagnóstico da plataforma receptora |
| Contagem de compras presente, valor ausente | Opção de envio de receita, valor e moeda |
| Receita duplicada | Emissores múltiplos, novas tentativas e deduplicação das transações |
| Instalações presentes, custos ausentes | Conexão separada de custos, permissões e atualização da importação |
São pontos de partida para investigar, não causas comprovadas. Use ferramentas de teste e registros para distinguir falha de configuração, restrição de privacidade e atraso nos relatórios. O guia do Google da Adjust exige um teste de atribuição com campanha ativa e considera o tempo de chegada dos dados. Um evento do SDK no ambiente de teste não comprova
No iOS, mapeie os eventos de negócio escolhidos no Conversion Hub com a documentação de SKAN. SKAdNetwork (SKAN) retorna informações de atribuição limitadas e atrasadas. Registre a versão do esquema e qual SDK atualiza os valores. Concilie SKAN e as outras visões antes de somá-las, pois podem representar as
Diferencie três medidas de tempo
A janela de atribuição determina qual interação publicitária anterior pode receber o crédito. O atraso de relatório indica quando o resultado chega ao painel. A idade da coorte mede o tempo desde a instalação e, portanto, quanto tempo os usuários tiveram para gerar receita. Uma janela de clique de sete dias não transforma uma coorte de sete dias em resultado completo do
Antes de comparar canais, registre datas de instalação, data de corte, fuso horário, janelas de clique e impressão, regras de reengajamento, moeda e definição de receita. Compare coortes com a mesma idade. Marque dias incompletos como provisórios e preserve a exportação usada em
Mudar a janela pode redistribuir instalações e receitas atribuídas sem alterar as compras dos clientes. A direção do retorno informado depende dos eventos que mudam de atribuição. Um relatório distribui crédito segundo regras; comprovar vendas incrementais exige um
O que entregar ao concluir a implementação
Entregue a especificação de eventos, os mapeamentos dos parceiros, os ajustes de compartilhamento, o estado das conexões de custos, os resultados dos testes e as limitações conhecidas. Defina um responsável por revisar isso após versões do SDK ou mudanças dos parceiros. Estime o prazo a partir dessas tarefas e do processo de publicação do app, sem prometer horas fixas
Nossa visão geral da implementação da Adjust descreve o mapeamento de eventos e a passagem ao time de campanhas. Para conciliar atribuição, receita e registros das lojas, consulte dados e atribuição mobile. Se a mensuração já está correta e o próximo trabalho é aquisição, nosso serviço de publicidade paga cobre