At a glance: Enable attribution recording and postback sending to partners by connecting AppsFlyer to your integrated partners.
Setting up integrated partners
AppsFlyer integrates with your partners by API. This article contains the generic instructions to enable partner-integrations and to generate attribution links of non-SRN partners.
- This guide is not applicable to SRNs. Use the links that follow to access SRN articles.
- Some partners (including non-SRNs) have dedicated articles. To search for these articles:
- In the breadcrumbs, in the header of this article, click Campaign management, to see the list of articles per partner.
- In AppsFlyer, go to Configuration > Integrated partners. Search for a partner, then click Learn how to integrate this partner.
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Google Marketing Platform | Apple Search Ads | Google Ads | Snapchat | Tencent Social Ads | Yahoo! Search Ads | Verizon Media |
First steps
To begin working with a partner:
- Set-up an account with the partner
- Configure the partner in AppsFlyer according to this guide.
- Begin to attribute ad network installs and to record post-install events.
Partner types in the ecosystem
Related reading: AppsFlyer Performance Index ranks mobile media sources by category and region.
Partner type | Descrição |
---|---|
Ad networks |
Run campaigns on your behalf |
Agências | Use their expertise to get high-quality users by running campaigns on your behalf. You can have a transparent or non-transparent relationship. |
Parceiros de marketing | Marketing partners specialize in working with specific ad networks. Examples: Facebook marketing partners, Apple Search Ads marketing partners, Twitter official ads partners |
Redes de retargeting | Redes de anúncios especializadas na execução de campanhas de redirecionamento |
Plataformas de terceiros | Provide BI-related services like analytics and marketing automation platforms |
Atribuição de TV | Parceiros que permitem atribuição mais precisa de novas instalações para anúncios de TV exibidos |
Detecção de fraude | Sistemas antifraudes de terceiros não fazem parte do Protect360, solução antifraudes da AppsFlyer |
The list of AppsFlyer integrated partners is available in the dashboard. Filter the list by partner name or other attributes as described in the section that follows.
Partner list by capability
To search and view the integrated partner list:
- In AppsFlyer, go to Configuration > Integrated Partners.
- Filter and view using the controls in the dashboard.
Opção | Descrição |
---|---|
Pesquisa de texto | Insira texto para procurar um parceiro |
Filtros |
|
Capacidade do parceiro |
|
Riqueza de dados |
Riqueza de dados
Componentes da pontuação
|
Tipo de parceiro |
A maioria dos parceiros integrados têm como objetivo obter usuários de qualidade para os profissionais de marketing mobile. Os tipos de parceiros integrados considerados como fontes de mídia são as redes de anúncios, redes afiliadas, publishers diretos, anúncios programáticos e redes de anúncios internas da China. |
Select a partner, the individual partner's setup page displays. The page consists of the following parts:
-
Header containing:
- Integrated partner name
- Link to request an introduction to the partner
- Link to a dedicated partner article. If no dedicated article exists, this article displays.
- Partner capability badges
- Settings tabs: The tabs available depend on the partner type and capabilities.
-
Footer :
- Back to list: Return to the Integrated Partners list using the filtering options selected previously.
- Status message: Current status of the tab data (e.g., saving, saved , error, there are unsaved changes).
- Discard Changes: Undo the last changes without saving.
- Save: Save the settings of the current tab only.
- Antes de executar campanhas com um parceiro recém-adicionado, teste a integração.
- É mais provável que ocorram erros durante a configuração inicial. Testar com antecedência evita o risco de gastar recursos consideráveis apenas para descobrir que seus dados de atribuição estão faltando ou apresentam erros.
- Certifique-se de antes testar o aplicativo para a integração básica do SDK para instalações orgânicas e não-orgânicas.
Cabeçalho da página de configuração do parceiro
Settings tabs available by partner type
Settings tab | |||
---|---|---|---|
Tipo de parceiro | Integração | Permissões | Observações |
Fonte de mídia | S | S |
Abas adicionais disponíveis: custo, receita de anúncios, link de atribuição Incluindo redes de anúncios, redes afiliadas, publishers diretos, anúncios programáticos, redes de anúncios internas da China e redes de redirecionamento. |
Agência | N | S | Agências independentes que não funcionam como redes de anúncios |
Terceiro | S | N | Plataformas de automação de análise ou de marketing |
Parceiro de marketing | S | N |
Guias de configuração do parceiro
To set up attribution with a partner, complete the following steps:
- Integrate with a partner in the integration tab:
- Activate the partner
- Complete the General settings section.
- For non-SRN ad networks, attribution link parameters are mandatory. See Attribution link tab.
- Complete the remaining settings tabs as requried
Guia Integração
As integrações de parceiros diferem nos seus requisitos e geralmente contêm um subconjunto de todas as seções possíveis. Complete as seções mencionadas conforme necessário.
Section | Descrição | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Configurações gerais | Essa seção é usada para conectar o parceiro à AppsFlyer. | ||||||||||
Ativação de parceiros |
Para ativar um parceiro integrado:
|
||||||||||
ID do parceiro | Alguns parceiros exigem conexão à AppsFlyer por meio de um ID exclusivo oferecido ao anunciante pelo parceiro. O ID é muitas vezes chamado de ID do aplicativo, ID da conta, ID do usuário ou ID da rede. | ||||||||||
Habilitar a atribuição de exibição (view-through) |
|
||||||||||
Postbacks padrão |
Se a atribuição/integração estiver ativada para o parceiro, a AppsFlyer poderá enviar postbacks relacionados a ações do usuário, como instalações, lançamentos, reengajamentos e eventos rejeitados. Eventos rejeitados são eventos in-app bloqueados pelo Protect360 ou eventos considerados não compatíveis com a validação do destino. No caso de eventos rejeitados, confirme com o parceiro se a integração de eventos de rejeição com a AppsFlyer foi ativada. To configure default postbacks for the partner, define the user source that postbacks are sent for:
Agencies, having permission, are limited to selecting Only events attributed to this partner for default postbacks. |
||||||||||
Definições de evento in-app e postbacks de evento in-app |
Para configurar postbacks de eventos in-app:
Observações:
Para obter mais informações sobre a configuração de postbacks de eventos in-app, acesse aqui. |
Guia link de atribuição
The tab is applicable to non-srns. This means it's not applicable to SRNs because SRN's don't use advertiser provided attribution links.
Create attribution links, to share with the partner. Send the attribution link to the partner to attribute specific campaigns, ad sets, or even single ads.
Parâmetros de link de atribuição
Adding parameters to the attribution link enables you to perform thorough drill-down analyses. Parameters that are already defined on the attribution link can be edited by adding them and their new values here.
Selecione quais parâmetros você deseja adicionar ao link de atribuição.
Nome | Descrição | Parâmetros de link de atribuição |
---|---|---|
Campanha | Compare diferentes campanhas em execução com a fonte de mídia. | C |
Conjunto de anúncios | Compare diferentes conjuntos de anúncios em campanhas específicas da fonte de mídia. | af_adset |
Nome do anúncio | Compare diferentes criativos em conjuntos de anúncios específicos em campanhas específicas da fonte de mídia. | af_ad |
ID do site e ID do subsite | Defina o ID do site para atribuir instalações a publishers específicos. Se houver muitos publishers, aconselhamos que você limite o número de IDs de sites usados e use o parâmetro de ID do subsite para evitar exceder as limitações de ID do site. |
af_siteid and af_sub_siteid |
Parâmetros do assinante | Use qualquer um dos 5 parâmetros de assinante para inserir valores úteis. Observe que esses parâmetros são analisados e aparecem no relatório de dados brutos, o que os torna muito úteis para a realização de agregação ou filtragem de dados. | af_sub1, af_sub2, af_sub3, af_sub4, af_sub5 |
You can add other parameter to the attribution link by typing it in a new parameter box. You can use all AppsFlyer available URL parameters.
Configurações de retargeting
When retargeting is on: AppsFlyer recognizes a link as a retargeting attribution link, rather than a user acquisition link, by adding the &is_retargeting=true
to the attribution link.
Attribution link parameter: is_retargeting
For retargeting attribution complete the following:
-
Link padrão vs. OneLink
Selecione a opção de link de atribuição padrão se:
- Não for necessário realizar link direto com a URL ou
- Planeja usar somente esquemas da URI para links diretos
Selecione Usar OneLink para:
- Usar um único link para aplicativos Android e iOS ou
- Links diretos usando links universais ou do aplicativo
Observe que a seleção de OneLink altera o link de gravação de clique do aplicativo específico para um URL do OneLink.
-
URL de links diretos (deep link)
Use esse campo se o link for destinado ao deep link de usuários a qualquer atividade específica em seu aplicativo.
Parâmetro do link de atribuição: af_dp
Saiba mais sobre soluções de links diretos. -
Janela de reengajamento
Defina o período após o reengajamento, onde os eventos in-app do usuário são atribuídos à fonte de mídia de retargeting. Você pode definir os valores em dias (1 a 90), horas (até 23) ou até mesmo vitalício.
Parâmetro de links de atribuição: af_reengagement_window
Atribuição de cliques
Use the setting to set the maximum time from click to install. Only installs (first launches) that take place within the lookback window are attributed.
Permitted range: 1-23 hours or 1-30 days.
Parâmetro de link de atribuição: af_click_lookback
Saiba mais sobre a janela de lookback de cliques.
Link de atribuição de cliques
Este é o link de atribuição que contém todas as informações de configuração definidas para ele.
As AppsFlyer doesn't save partner attribution links, copy the generated link and send it to the partner to be activated when your leads click on a corresponding ad.
Janela retroativa de atribuição por visualização
Set the maximum time from impression to install. Only installs (first launches) that take place within this lookback window, following an ad impression, are attributed to the partner, providing there was no other relevant ad click.
Você pode personalizar esse valor para 1 a 23 horas ou 1 a 7 dias.
Parâmetro de links de atribuição: af_viewthrough_lookback
Learn more about view-through attribution.
Link de atribuição de impressões
O link de atribuição de impressão contém dados de atribuição semelhantes ao link de gravação de clique (além da janela de lookback diferente). Envie-o ao parceiro para ser ativado quando um anúncio correspondente for visto, normalmente durante um segundo ou mais.
Guia Cost (Custo)
- Os dados de custo são reportados por parceiros integrados no clique ou pela Cost API.
- A melhor prática é implementar a Cost API.
- A API de custo inclui relatórios de cliques e impressões.
Ativando dados de custo pela API
To enable cost API:
- Na aba Custo do parceiro integrado, ative Obter dados de custo.
As credenciais necessárias para conectar-se ao parceiro são exibidas. - Obtenha as credenciais necessárias no painel do parceiro ou conforme indicado na interface do usuário da AppsFlyer.
- Preencha os campos da credencial.
- Se a configuração de custo do parceiro tiver Mapeamento de ID do site, selecione a configuração desejada de ID do site no menu suspenso.
- Clique em Salvar custo.
- Clique em Testar conexão.
- Se a mensagem:
- Se a mensagem Conexão de API verificada aparece, você concluiu o procedimento com sucesso. A API está ativa. A AppsFlyer coleta dados do parceiro 6 vezes por dia, em média uma vez a cada quatro horas.
- Credenciais inválidas aparecer, verifique as credenciais e repita o procedimento.
- Se a mensagem Algo deu errado aparecer, tente novamente mais tarde.
Mapeamento de ID do site
Ao reportar dados de custo, algumas integrações de parceiros permitem que você selecione como o campo ID do site é preenchido. Isso significa que você pode configurar a ID do site para que corresponda às macros de ID do site da AppsFlyer da forma como estão no link de atribuição.
- Por padrão, o mapeamento de ID do site está alinhado com as macros da AppsFlyer no link de atribuição.
- Se o link de atribuição que você usa tiver macros diferentes das opções de mapeamento de ID do site, os dados de ID do site não serão preenchidos corretamente.
Para selecionar um método de configuração de ID de site:
- Na aba Custo do parceiro integrado, acesse Mapeamento de ID do site e selecione uma configuração no menu suspenso.
- Clique em Salvar custo.A alteração entrará em vigor a partir do dia seguinte UTC. Por exemplo, se o mapeamento de ID do site ocorrer na segunda-feira, isso será refletido nos dados de terça-feira UTC.
Status de sincronização dos dados de custo
A aba "custo" mostra o status da integração de custos e a última vez que a AppsFlyer extraiu os dados de custo correspondentes. Isso é importante para as redes que oferecem suporte à captação de dados de custo pela API.
Última extração de dados bem-sucedida
A aba de custo mostra a última vez em que os dados de custo foram extraídos. Se os dados de custo nunca tiverem sido extraídos, a mensagem de sincronização que aparecerá será: Os dados de custo nunca foram extraídos com sucesso.
Exemplos
Cenário 1: campanhas interrompidas
A AppsFlyer extrai custos para várias campanhas executadas com a rede de anúncios A. Na aba Custo, a mensagem Última sincronização bem-sucedida há 2 horas será exibida no mesmo dia em que você decidir parar de executar campanhas com a rede de anúncios A. Duas semanas depois, a aba Custo exibirá a mensagem: Última sincronização bem-sucedida há 14 dias atrás.
Cenário 2: problemas na API da ad network
A AppsFlyer extrai o custo de várias campanhas executadas com a rede de anúncios B. A aba Custo exibe a mensagem: Última sincronização bem-sucedida há 2 horas. Em seguida, a rede de anúncios encontra problemas em sua API. Serão necessárias algumas horas para consertá-la. Quando você olhar na aba de custo, verá a mensagem Última sincronização bem-sucedida há 8 horas atrás.
Redes OAuth
As redes OAuth (Google, Facebook) permitem que você sincronize várias contas para extração de dados de custo. Para cada conta sincronizada, a AppsFlyer exibe o status da integração de custo e a última vez que a AppsFlyer extraiu dados de custo correspondentes.
Guia Ad Revenue (Receita publicitária)
Caso você atue como um publisher que exibe anúncios em seu aplicativo, a função de receita de anúncios permitirá que você atribua a receita de anúncios à fonte de mídia que trouxe o usuário. Saiba mais sobre a atribuição de receita de anúncios.
Ativar atribuição de receita publicitária
- Verifique para ver para qual método, agregação ou atribuição a nível do usuário, o parceiro tem suporte.
- Siga o método apropriado no guia de integração da receita publicitária.
Mensagens de status da API de receita publicitária
Status | Observações/ação necessária |
---|---|
Active (Ativa) | A conexão está em tempo real e extraindo dados. |
Nenhum dado encontrado para extrair. | A conexão foi bem sucedida. O parceiro não tinha nenhum dado relacionado a esse aplicativo. |
A API do parceiro não está respondendo. Entre em contato com o suporte da AppsFlyer. | O servidor do parceiro não está respondendo à AppsFlyer. |
Credenciais inválidas. Inserir credenciais atualizadas. | |
Algo deu errado. Entre em contato com o suporte da AppsFlyer. | Há um problema técnico. Entre em contato com o suporte da AppsFlyer. |
Os dados do parceiro ainda não estão prontos. Se o problema persistir, entre em contato com o suporte da AppsFlyer. | |
Os dados estão sendo processados e estarão disponíveis em breve. | No momento estamos processando os dados recebidos do parceiro. Os dados estarão disponíveis nos painéis e relatórios. |
Os dados nunca foram extraídos com sucesso | Se esse status persistir por mais uma hora, entre em contato com o suporte da AppsFlyer. |
Guia Permissões
- Permita que o parceiro realize várias ações e acesse seus dados de acordo com as permissões disponíveis.
- Você não precisa manter a integração de atribuição ativada com um parceiro para conceder permissões a ele.
- Rede de anúncios configurada por uma agência: quando a configuração do parceiro é executada por uma agência, o anunciante não pode visualizar o status de ativação da rede de anúncios ou as permissões concedidas.
- Se seu relacionamento com o parceiro for apenas de agência, desconsidere a seção Permissões da rede de anúncios e defina a seção Permissões de agência.
Permissões da rede de anúncios
Para conceder permissões para uma rede de anúncios:
- Ative Permissões de ad networks.
- O aplicativo aparece no painel da ad network.
- As permissões são concedidas apenas para a rede de anúncios especificada.
- O administrador da ad network pode ver dados básicos sobre o aplicativo
- Conceder permissões para membros da equipe da rede de anúncios
- [Padrão] O administrador da rede de anúncios tem acesso ao seu aplicativo por padrão.
- Para conceder permissões específicas para membros da equipe, você precisa adicioná-los usando seus endereços de e-mail.
Para adicionar um membro da equipe:- Clique em Adicionar membro da equipe.
- Insira o e-mail do membro da equipe da rede de anúncios
- Clique em Adicionar.
- Selecione permissões adicionais para conceder à rede de anúncios:
Permissão
Recurso concedido. O parceiro pode...
Permitir configuração da integração
Alterar parâmetros da integração
Postback de evento in-app
- Criar, definir e alterar as definições de postbacks.
- Atenção! Quando esta permissão e a opção Permitir configuração de integração estão ativadas simultaneamente: a rede de anúncios tem acesso a todos os eventos de atribuição. Isso inclui tráfego orgânico e tráfego não-orgânico de todas as fontes de mídia.
Permitir acesso ao seu relatório de retenção
Acessar o relatório de retenção de aplicativos.
Eles verão apenas dados relacionados às suas sessões.
Permitir acesso aos seus dados agregados de usuários fidelizados
Acessar sua própria métrica de usuários fidelizados.
Permitir acesso aos seus dados agregados de eventos in-app
- Acesso a dados de eventos in-app (o parceiro tem acesso a todos os dados de eventos in-app, não apenas aos eventos mapeados na configuração de postback).
- Acessar dados de monetização de anúncios, que podem incluir eventos de monetização de anúncios de outras fontes de mídia.
Permitir acesso aos seus dados de receita agregados
- Acessar dados de receita de anúncios e receita in-app atribuídos aos usuários trazidos pela rede de anúncios. Observação: essa permissão não identifica diretamente o parceiro de receita de anúncios. No entanto, se você definiu o nome do evento de monetização para incluir o nome do parceiro, você pode inadvertidamente divulgar a identidade da rede de monetização.
Permitir ingestão de gastos
- Acessar a janela Ingestão de Gastos com Anúncios.
- A janela Ingestão de Gastos com Anúncios exibe apenas os aplicativos para os quais eles têm permissão.
- Enviar arquivos de gasto com anúncios para ingestão.
Permitir acesso ao seu dashboard do Protect360 e dados brutos via API
- Acessar seu Protect360 e dados brutos.
- O Protect360 precisa estar ativado no aplicativo.
Permissões da agência
- Quando você concede permissões a agências, elas podem conceder permissões a ad networks para que gerenciem seus aplicativos. É o mesmo que conceder permissões para ad networks.
- Se sua agência também trabalha com essa ad network, ambos podem editar a permissão dos membros da equipe da ad network para visualizar o painel do aplicativo.
- Se você vir novos membros da equipe da ad network ou membros ausentes da equipe que você não adicionou ou removeu, é possível que sua agência os tenha adicionado ou removido.
- Atenção: as instalações da agência que ocorrem enquanto o controle está desativado não são atribuídas à agência e não aparecem no dashboard e nos dados da agência. Saiba mais sobre ativação de agência.
Para conceder permissões a uma agência:
- Ative Permissões de agência.
- Selecione as permissões que deseja conceder à agência:
Permissão Capacidade concedida. A agência pode... Permitir acesso ao seu painel Protect360 - A agência pode acessar seu dashboard do Protect360.
- O Protect360 precisa estar ativado no aplicativo.
Permitir acesso aos seus relatórios de retenção e cohort Dados de retenção/cohort criados apenas por usuários trazidos pela agência. Permitir acesso a dados orgânicos agregados Allow access to raw-data reports. Permitir configuração dos postbacks de eventos in-app.
Permitir que a agência configure o mapeamento de postbacks de eventos in-app para si mesma na aba de integração.
-
Permissões de compartilhamento de eventos:
- Somente este parceiro: enviar apenas eventos do tráfego trazido pela própria agência para o aplicativo.
- Todas as fontes de mídia, inclusive orgânicas: enviar eventos de todas as fontes do seu tráfego, inclusive de outras fontes de mídia, agências e usuários orgânicos.
- Permitir o envio de receita de eventos: permitir que a agência envie eventos, incluindo seu valor monetário.
-
Nome do evento do SDK: clique em Adicionar evento e selecione o evento no menu suspenso.
Certifique-se de selecionar eventos específicos para os quais deseja conceder permissão à agência.
Saiba mais sobre como trabalhar com agências.
Links de atribuição teste
Ad networks regulares, que consistem em 99,5% de todas as ad networks integradas, usam links de atribuição da AppsFlyer. O mesmo ocorre com a atribuição de mídia própria, que é realizada usando links de atribuição personalizados da AppsFlyer.
Como a atribuição correta depende dos parâmetros nos seus links de atribuição, execute testes antes de iniciar qualquer nova campanha com uma rede de anúncio regular ou um link de atribuição personalizado.
Para testar links de atribuição:
- Crie um link de atribuição.
- Envie o novo link de atribuição para o seu dispositivo de teste registrado (por e-mail ou QR code).
- Clique no link e certifique-se de que você é redirecionado para a app store.
- Instale o aplicativo.
- Inicie o aplicativo.
- Verifique se a instalação aparece no painel da AppsFlyer, embaixo do nome da fonte de mídia do parceiro.
- Navegue até o nível de campanha (selecionando o parceiro no Filtro de fonte de mídias no topo da página de visão geral) para verificar se a instalação aparece embaixo do nome de campanha correto.
- Se necessário, continue navegando e verifique o conjunto de anúncios e também os níveis de anúncios únicos.
Testar redes com autorrelatório
SRNs, Facebook, Apple Search Ads, Google Ads, Snapchat, etc, não dependem de links externos de atribuição para fins de atribuição. Em vez disso, os SRNs recebem consultas da AppsFlyer, fazem a atribuição por si próprios e retornam a resposta. Portanto, não é viável testar a integração separadamente do sistema da rede como é feito com ad networks regulares. Você deve testar a integração com cada SRN adicional com o qual começar a trabalhar.
Para testar a integração com SRN:
- Execute a configuração completa do SRN na AppsFlyer de acordo com o guia de configuração do determinado parceiro: Facebook, Google Ads, Twitter, Apple Search Ads, Snapchat.
- Execute uma nova campanha de baixo orçamento com o parceiro de SRN.
- Quando o painel do parceiro mostrar novas instalações, verifique se elas aparecem no painel da AppsFlyer embaixo do nome da fonte de mídia do parceiro
- Navegue até o nível de campanha (selecionando o parceiro no Filtro de fonte de mídias no topo da página Visão geral) para verificar se a instalação aparece embaixo do nome de campanha correto.
- Se necessário, continue navegando e verifique o conjunto de anúncios e níveis de anúncios únicos também.
Se tudo estiver certo, você pode começar a executar novas campanhas de orçamento elevado com o parceiro. Além do mais, não há necessidade de repetir este teste com novas campanhas.
Testes avançados com dados brutos
Nos dados brutos você pode encontrar as joias ocultas de seus esforços de marketing. Desta forma, se sua conta da AppsFlyer inclui acesso a dados brutos, eles devem ser incluídos em seus testes envolvendo parceiros.
- Após realizar o teste mencionado acima, acesse a página Exportar Dados
- Certifique-se de selecionar a fonte de mídia testada
- Aguarde 15 minutos para a instalação e baixe o Relatório de instalação de dados brutos.
- Verifique se o registro de instalações do parceiro existe e inclui parâmetros, como fonte de mídia, nome da campanha, tipo e hora do toque, ID do dispositivo (IDFA ou ID de publicidade), nome da agência (chamada de "Parceiro" no relatório), etc.
Algumas redes de anúncios requerem ações especiais para permitir a coleta de dados brutos de nível de usuário.
Se você visualizar uma nova instalação no painel, mas não a visualizar nos dados brutos, consulte o guia da Central de Ajuda específico da rede de anúncios (por exemplo, Facebook, Twitter).