Configure um parceiro integrado

A imagem abaixo mostra os diferentes tipos de parceiros que compõem o ecossistema de atribuição.

Leitura relacionada: O Performance Index da AppsFlyer classifica as fontes de mídia mobile por categoria e região.

Todos os parceiros, fontes de mídia e outras plataformas integradas à AppsFlyer são encontrados na página do marketplace. Você pode encontrar seus parceiros ativos e inativos e procurar novos parceiros para se conectar.  

Para procurar e filtrar todos os parceiros, fontes de mídia ou outras plataformas no Marketplace de Parceiros:

• Na AppsFlyer, no menu lateral, selecione Colaboração > Marketplace de Parceiros. Você pode usar os vários filtros de pesquisa.

Convide novos parceiros para a AppsFlyer

Se o parceiro com quem você está trabalhando ainda não estiver integrado à AppsFlyer, você poderá enviar um link de convite.

A página integrações ativas no Partner Marketplace mostra todos os seus parceiros integrados ativos . Nessa página, você pode saber mais sobre um parceiro e gerenciar sua integração.  

Para ver todos os seus parceiros ativos:

• na AppsFlyer, no menu lateral, selecione Colaborar > Integrações Ativas.

Veja o que você pode fazer na página de integrações ativas.

A página está estruturada da seguinte forma:

• Header, contendo:
  • Nome do parceiro
  • Link para um artigo dedicado ao parceiro. Caso não exista um artigo dedicado, será apresentado este artigo.
  • Status da integração
  • Aplicativo selecionado
• Abas de configurações: as abas disponíveis dependem do tipo de parceiro e dos recursos compatíveis.
• Footer:
  • Voltar à lista: retorne à lista de Integrações ativas usando as opções de filtro selecionadas anteriormente.
  • Mensagem de status: status atual dos dados da aba (por exemplo, salvando, salvo, erro, alterações não salvas).
  • Descartar alterações: desfaz as últimas alterações, sem salvar.
  • Salvar: salva apenas as configurações da aba atual.

Abas de configurações aplicáveis por tipo de parceiro

As integrações dos parceiros variam nos seus requisitos e podem conter um subconjunto de todas as opções descritas nesta seção. Existem algumas diferenças entre as configurações do iOS e do Android. 

Complete as seções conforme necessário.  

Seções de integração

A tabela a seguir inclui diferentes seções da página de integração. Algumas seções estão disponíveis para todos, outras são específicas por integração.

Gere e salve links de atribuição para o uso de ad networks de cliques (não SRN) e envie o link de atribuição ao parceiro para atribuir determinadas campanhas, conjuntos de anúncios ou anúncios únicos.

Atenção: SRNs não implementam links de atribuição gerados pelos anunciantes, portanto, essa aba não é relevante para as campanhas de SRN.

Para gerar um link de atribuição:

1. Selecione usar um link de plataforma única ou usar OneLink.

   Selecione usar um link de plataforma única no caso de uma das seguintes situações:

   • Você planeja usar apenas esquemas de URI para abrir o aplicativo.
   • Você não precisa usar um deep link com a URL.

   Selecione Usar o OneLink no caso de uma das seguintes situações:

   • Você quer um único link tanto para aplicativos Android quanto para iOS.
   • Você quer usar App Links do Android ou Universal Links do iOS para abrir o aplicativo.
   • Você quer recursos de deep linking.

   Atenção: selecionar OneLink altera a gravação de links de clique do aplicativo específico para uma URL do OneLink.

2. Se você selecionou Usar OneLink: 
   1. Selecione qual template do OneLink você deseja usar para abrir o aplicativo (e potencialmente o deep link).
   2. [Opcional] Insira o valor do deep link.
   3. [Opcional] Insira o valor adicional do deep link.
3. Adicione parâmetros para Android e iOS, conforme necessário.
4. [Opcional] Selecione parâmetros de atribuição adicionais.

Parâmetros do link de atribuição

Adicionar parâmetros ao link de atribuição permite que você faça análises detalhadas. Os parâmetros que já estão definidos no link de atribuição podem ser editados adicionando-os e incluindo seus novos valores aqui. Ao salvar o link de atribuição, todos os parâmetros configurados nesta aba são salvos.

Selecione quais parâmetros você deseja adicionar ao link de atribuição.

Parâmetros do link de atribuição

Você pode adicionar outros parâmetros ao link de atribuição digitando-o em uma nova caixa de parâmetros. Você pode usar todos os parâmetros de URL disponíveis da AppsFlyer. Observe que apenas o esquema de URI e os parâmetros do OneLink são codificados no link de atribuição.

Configurações de retargeting

Quando o retargeting está ativado: A AppsFlyer reconhece um link como de retargeting, em vez de aquisição de usuário, ao adicionar &is_retargeting=true ao link de atribuição.
Parâmetro do link de atribuição: is_retargeting

Para usar o seu link para retargeting:

1. Ative as configurações de retargeting.
2. [Opcional] Insira um esquema de URI se quiser que um esquema de URI abra o aplicativo.
   Atenção:
   • Os esquemas de URI são recomendados como um método alternativo para abrir o aplicativo se os Universal Links e App Links falharem.
   • Se você adicionar um esquema de URI aqui, ele substituirá quaisquer outros esquemas de URI que já estiverem nas configurações do template do OneLink.
   • O esquema URI é adicionado ao link através do parâmetro af_dp.
3. [Opcional] Ative Ignorar usuários ativos para retargeting.
4. Defina a janela inativa para determinar quais usuários são considerados ativos e inativos.
5. Configure a janela de reengajamento para determinar o período após o reengajamento, onde os eventos in-app do usuário são atribuídos ao canal de mídia de retargeting.
   • Você pode definir o valor em dias (1 a 90), horas (até 23) ou até mesmo vitalício.
   • A janela de reengajamento é adicionada ao link no parâmetro af_reengagement_window.

Atribuição de click-through

Use a configuração para definir o tempo máximo do clique à instalação. Somente instalações (primeiras inicializações) que ocorrem dentro da janela de lookback são atribuídas.

Intervalo permitido: 1-23 horas ou 1-30 dias.

Parâmetro do link de atribuição: af_click_lookback

Saiba mais sobre a janela de lookback de cliques.

Clique no link de atribuição

Esse é o link de atribuição que contém todas as informações de configuração definidas para ele. Você pode salvar o link para futuras referências clicando em Salvar link de atribuição.

Para copiar o link de atribuição de cliques:

1. Clique em Salvar link de atribuição.
2. Copie o link gerado.

Envie o link para o parceiro para ser ativado quando seus leads clicarem em um anúncio correspondente.

Janela de lookback de atribuição de view-through

Defina o tempo máximo entre a impressão e a instalação. Somente instalações (primeiras inicializações) que acontecerem durante essa janela de lookback, após uma impressão de anúncio, serão atribuídas ao parceiro, desde que não haja outros clique em anúncio relevante. 

Você pode personalizar esse valor para 1-24 horas.

Parâmetro do link de atribuição: af_viewthrough_lookback

Saiba mais sobre a atribuição de view-through.

Link de atribuição para impressões

O link de atribuição para impressões contém dados semelhantes aos do link de registo de cliques, com exceção da diferente janela de retroatividade. Você pode salvar o link para futuras referências clicando em Salvar link de atribuição.

Clique em Salvar link de atribuição e copie o link gerado.

Para copiar o link de atribuição de impressões:

1. Clique em Salvar link de atribuição.
2. Copie o link gerado.

Envie-o ao parceiro para ser ativado quando um anúncio correspondente for visto, normalmente durante um segundo ou mais.

• Os dados de custo são reportados pelos seus parceiros integrados com base nos cliques ou através da Cost API.
• A prática recomendada é implementar a API de custo (requer assinatura do ROI360).
• A Cost API inclui relatórios de cliques e impressões. Consulte a tabela de integração de custos da ad network para obter detalhes completos sobre as dimensões, métricas e recursos compatíveis.

Ativação de dados de custo por API

Para ativar a Cost API:

• Siga essas instruções de integração.

Status de sincronização dos dados de custo

Veja o status da Cost API e a última vez que a AppsFlyer conseguiu extrair os dados de custo correspondentes no dashboard de status da integração de custo (e receita de anúncios) ou no dashboard individual da ad network.

Se você atua como um publisher exibindo anúncios no seu aplicativo, a função de receita de anúncios permite atribuir a receita de anúncios à fonte de mídia que trouxe o usuário. Sobre a atribuição de receitas de anúncios.

Ativar atribuição da receita de anúncios

1. Verifique para ver para qual método, agregação ou atribuição a nível do usuário, o parceiro oferece suporte.
2. Siga o método apropriado no guia de integração de receitas de anúncios.

Mensagens de status da Ad Revenue API

Conceda permissões específicas para que as networks e agências acessem seus dados e realizarem várias ações.

• Você não precisa que a integração com o parceiro esteja ativa para conceder permissões.
• Rede de anúncios configurada por uma agência: quando a configuração do parceiro é executada por uma agência, o anunciante não consegue visualizar o status de ativação da ad network ou as permissões concedidas. 
• Se a sua associação com o parceiro for unicamente como agência, use as Permissões da agência em vez das Permissões da ad network.
• As permissões são atribuídas ao aplicativo atualmente selecionado.

Permissões da ad network

Ao ativar as permissões da ad network, você permite que a ad network acesse o seu dashboard, possibilitando a concessão de permissões adicionais, conforme detalhado na tabela abaixo.

Para conceder permissões a uma ad network e aos membros da sua equipe:

1. Ative as permissões da ad network.
   • Seu aplicativo aparece no dashboard da ad network.
   • O administrador da ad network tem permissão para acessar dados básicos sobre o aplicativo.
2. Conceder permissões para membros da equipe da ad network:
   • 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:
     1. Clique em Adicionar membro da equipe.
     2. Insira o e-mail do membro da equipe da ad network.
     3. Clique em Adicionar.
     4. Se você receber uma mensagem de erro, geralmente é porque o endereço de e-mail especificado não foi adicionado como um membro da equipe pelo parceiro à conta do parceiro. Seu parceiro deve adicionar o e-mail à sua conta antes que você possa conceder permissões a esse usuário.
3. Selecione permissões adicionais para conceder à ad network:

   Permissão	Recurso concedido
   Configurar integração	A ad network pode alterar parâmetros na aba de integração, exceto ao configurar postbacks de eventos in-app.
   Configurar postbacks de eventos in-app	A ad network pode /span>configurar postbacks de eventos in-app Isso significa que ela pode criar, configurar (mapear) e alterar as configurações de postback. Atenção! Quando esse recurso e a permissão de configurar integração estão ativados, o parceiro tem acesso a todos os eventos. Isso inclui tráfego orgânico e não-orgânico de todos os canais de mídia.
   Acesso ao relatório de retenção	A ad network pode acessar o relatório de retenção que contém apenas os seus dados de retenção.
   Acesse dados agregados de usuários fidelizados	A ad network pode acessar sua própria métrica de usuários fidelizados .
   Acessar dados agregados de conversões	A ad network pode acessar seus relatórios de métricas de eventos de conversão agregados. Isso inclui instalações, reengajamentos, reinstalações e reatribuições. Exemplo: Relatório agregado de performance de campanhas para ad networks.
   Acessar dados agregados de eventos in-app	A ad network pode: Acessar relatórios de dados agregados de eventos in-app. O acesso inclui todos os dados de eventos in-app do aplicativo selecionado, incluindo os do Protect360. Isso significa que eles podem acessar eventos além daqueles definidos na configuração de postback. Acessar relatórios agregados de dados de monetização de anúncios, que podem incluir eventos de monetização de anúncios de outros canais de mídia.
   Ver regras de validação	A ad network pode visualizar informações da regra de validação.
   Acessar dados agregados de receita	A ad network pode acessar relatórios agregados de receitas de anúncios e in-app atribuídos aos usuários que eles trouxeram. Atençã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 com o nome do parceiro, você pode revelar, sem querer, a identidade da rede de monetização.
   Use a ingestão de gastos com anúncios	A ad network pode: Acessar a janela Ingestão de Gastos com Anúncios. Essa janela apresenta apenas os aplicativos para os quais eles têm permissão de acesso. Envie os arquivos de gastos de anúncios para processamento.
   Acessar o dashboard do Protect360 e dados brutos	A ad network pode: Acessar o dashboard do Protect360 (incluindo ProtectLITE). Acessar o Protect360, Regras de Validação e dados brutos, se fizerem parte do plano de assinatura/span> O ProtectLITE não inclui acesso a dados brutos. Atenção: quando você tem uma assinatura do Protect360, a ad network pode ver o dashboard completo. Sem uma assinatura do Protect360, eles podem ver o dashboard lite.
   Acesse os dados brutos de receita de anúncios	A ad network pode acessar seus dados de receita de anúncios para otimizar a aquisição de usuários. Atenção: essa permissão está disponível somente para apps com uma assinatura do ROI360.

Permissões da agência

Leia tudo sobre o que as agências podem fazer quando recebem permissões.

Cuidado: 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 a ativação da agência.

Para conceder permissões a uma agência:

1. Ative as Permissões da agência.
2. Selecione as permissões que deseja conceder à agência:

   Permissão	Capacidade concedida
   Mudar a configuração de Privacidade Avançada	A agência pode alterar a configuração de compartilhamento de dados de privacidade avançada de uma ad network.   Atenção: Essa permissão não se aplica ao TikTok for Business e Snapchat. Para estas integrações, a configuração de Privacidade Avançada fica esmaecida, refletindo a configuração do anunciante.
   Acessar aos relatórios de retenção e cohort	A agência pode acessar apenas os dados de retenção/coorte criados pelos usuários trazidos pela agência.
   Acesse dados orgânicos agregados	A agência pode acessar dados orgânicos agregados
   Ver regras de validação	A agência pode consultar os detalhes das regras de validação.
   Adicionar regras de validação	A agência pode adicionar e editar regras de validação. Disponível quando Visualizar regras de validação está ativado.  Nota: As agências não podem editar regras criadas pelos anunciantes.
   Acessar relatórios de dados brutos	A agência pode acessar relatórios de dados brutos para o tráfego atribuído a ela. Os anunciantes não podem limitar os eventos que uma agência pode ver nos relatórios.
   Acessar o dashboard do Protect360 e dados brutos	A agência pode: acessar o dashboard agregado do Protect360 acessar o Protect360, regras de validação e dados brutos se fizerem parte do plano de assinatura Atenção: Para anunciantes que trabalham com ad networks através de uma agência - para que tanto a ad network como a agência tenham acesso aos dados, o anunciante deve integrar tanto a agência quanto a ad network na AppsFlyer e conceder-lhes permissão para acessar os dados. Se apenas a agência for integrada e tiver permissão, a ad network não terá acesso aos dados.
   Configurar postbacks de eventos in-app	A agência pode configurar postbacks de eventos in-app de eventos específicos que você selecionar:   Adicionar evento: no menu suspenso, selecione os eventos que você deseja permitir que a agência acesse. As opções a seguir se aplicam aos eventos selecionados: Enviar receita dos eventos: quando ativado, a agência pode configurar o envio de eventos incluindo seu valor monetário. Opção de envio: Somente esse parceiro: quando selecionado, a agência pode configurar o envio de postbacks apenas para eventos atribuídos ao seu próprio tráfego trazido Todas as fontes de mídia, incluindo orgânicas: Quando selecionada, a agência pode configurar o envio de postbacks para eventos atribuídos a todas as outras fontes de mídia, agências e usuários orgânicos.

Saiba mais sobre trabalhar com agências.

Ad networks regulares, que consistem em 99,5% de todas as ad networks integradas, usam links de atribuição da AppsFlyer. De modo semelhante, a atribuição de mídia própria é realizada usando os links OneLink da AppsFlyer.

Como a atribuição correta depende dos parâmetros nos links de atribuição, teste esses links antes de começar a executar uma campanha com uma ad network não SRN ou um link de atribuição personalizado.

Para testar os links de atribuição:

1. Crie um link de atribuição.
2. Envie o novo link de atribuição para o seu dispositivo de teste registrado (por e-mail ou QR code).
3. Clique no link e certifique-se de que você é redirecionado para a app store.
4. Instale o aplicativo.
5. Inicie o aplicativo.
6. Verifique se a instalação aparece no dashboard da AppsFlyer, embaixo do nome da fonte de mídia do parceiro. Aguarde até 30 minutos para que a instalação apareça no dashboard.
7. Aprofunde a análise até ao nível da campanha (selecionando o parceiro no filtro de origem de mídia no topo da página de visão geral) para confirmar se a instalação aparece com o nome correto da campanha.
8. Se necessário, continue a detalhar e verifique também os níveis de conjunto de anúncios e anúncios individuais.

SRNs, como Meta Ads, Apple Search Ads e Google Ads, não dependem de links de atribuição externos para fins de atribuição. Ao invés disso, 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, ao contrário do que acontece com ad networks tradicionais. Você deve testar separadamente a integração com cada SRN com a qual você trabalha.

Para testar a integração com SRN:

1. Fa;ca a configuração completa da SRN na AppsFlyer de acordo com o guia específico de configuração da SRN.
2. Execute uma nova campanha de baixo orçamento com o parceiro de SRN.
3. Quando o dashboard do parceiro exibe novas instalações, verifique se elas aparecem no dashboard da AppsFlyer com o nome da fonte de mídia do parceiro.
4. No dashboard de Visão geral, analise detalhadamente até o nível da campanha e selecione o parceiro no Filtro de fonte de mídia para verificar se a instalação aparece sob o nome correto da campanha. Aguarde até 30 minutos para que a instalação apareça no dashboard.
5. Se necessário, continue a análise detalhada para verificar os níveis de conjunto de anúncios e de anúncio único.

Se tudo estiver certo, você pode começar a executar novas campanhas de orçamento elevado com o parceiro. Testar a integração uma vez por parceiro SRN é suficiente. Ou seja, não é necessário testar por campanha.

Se seu plano de assinatura com a AppsFlyer inclui acesso a dados brutos, eles devem ser testados.

Para testar dados brutos:

1. Depois de executar o teste mencionado anteriormente, acesse Relatórios > Exportar Dados.
2. Selecione a fonte de mídia testada.
3. Aguarde até 15 minutos a partir da instalação e, em seguida, faça o download do relatório de instalações.
4. 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, device ID (caso aplicável), nome da agência (chamada de "Parceiro" no relatório) e outros.