Visão geral: Os parceiros integrados, como redes de publicidade e agências, podem visualizar fraudes relacionadas com o seu tráfego, identificadas e bloqueadas pelos motores ProtectLITE e Protect360, bem como observar as regras de validação definidas manualmente pelo cliente.
Visão geral
A AppsFlyer identifica e bloqueia fraudes através de:
- ProtectLITE: Oferece uma proteção básica contra fraudes para todos os clientes.
- Protect360: Oferece uma proteção avançada contra fraudes para os anunciantes com um plano de subscrição premium.
Os anunciantes devem conceder:
- Permissões às redes de anúncios para aceder ao painel do Protect360 e aos relatórios de dados brutos (incluindo o ProtectLITE) e para visualizar dados agregados de eventos na aplicação (em casos de fraude de eventos na aplicação).
- Permissões às agências para aceder ao painel e aos dados brutos do Protect360.
Com as permissões adequadas, os parceiros integrados podem:
- Visualizar dados referentes ao tráfego que geraram.
- Descarregar os relatórios de dados brutos correspondentes.
Além disso, estão disponíveis relatórios de dados brutos para redes de publicidade sobre limites de cliques e impressões e assinaturas de cliques com falha, sem necessidade de permissões dos anunciantes.
Nota
Para anunciantes que colaboram com redes de anúncios através de uma agência, para que tanto a rede de anúncios quanto a agência possam aceder aos dados, o anunciante deve integrar ambas na AppsFlyer e conceder-lhes permissão para aceder aos dados.
Se somente a agência for integrada e receber permissões, a rede de anúncios não terá acesso aos dados.
Visualização do painel
Pré-requisitos: Permissão do anunciante para aceder ao ProtectLITE e o Protect360.
Os parceiros integrados podem visualizar o painel e os gráficos; consulte a captura de ecrã abaixo.
Saiba mais sobre os dados disponíveis nos painéis ProtectLITE e Protect360 .
Limitações:
- As redes de publicidade não têm acesso ao painel de anomalias. As agências têm acesso, mas só conseguirão visualizar dados caso exista tráfego de fontes confiáveis pela AppsFlyer, com baixas taxas de fraude, permitindo assim criar uma base de comparação para outras fontes de media.
Relatórios de dados brutos
Pré-requisitos: Permissão do anunciante para aceder ao ProtectLITE e o Protect360.
Os relatórios de dados brutos do Protect360 mostram fraudes identificadas e bloqueadas através do ProtectLITE, Protect360 e Regras de Validação.
Os relatórios podem ser acedidos através de:
- Exportar dados: Na AppsFlyer, no menu lateral, escolha Relatório > Exportação de Dados Brutos
- API: Veja a próxima secção dedicada à API de relatórios da rede de anúncios.
Saiba mais sobre os relatórios de dados brutos do Protect360.
API de Relatórios da Rede de Anúncios Protect360
- Os relatórios de dados brutos listados nesta secção estão acessíveis para redes de anúncios através da API.
- Relatórios equivalentes estão disponíveis no painel, na página Exportar Dados.
- Caso o anunciante não tenha uma subscrição do Protect360, apenas o relatório de Instalações está disponível.
Pré-requisitos
- Para obter acesso aos dados do anunciante via API, o anunciante deve conceder à rede de anúncios permissões para aceder ao painel do Protect360 e aos dados através da API. Redes de anúncios com acesso ao painel estão autorizadas a usar a API. O anunciante não precisa de tomar qualquer ação adicional.
- Para listar as aplicações para as quais tem permissões do Protect360, utilize a API para obter lista de aplicações.
- O administrador deve obter um token de autenticação V2.0 disponível no painel AppsFlyer.
Relatórios da API Protect360
| Relatório | Relevância dos dados | Descrição |
|---|---|---|
| Fraude de eventos na aplicação pós-atribuição |
Diariamente às 10h00 UTC |
O relatório pode ser filtrado opcionalmente por tipo de evento na aplicação, como descrito na tabela de parâmetros que se segue. Tema do relatório: |
| Instalações pós-atribuição |
Diariamente às 10h00 UTC |
Tema do relatório: detecção |
| Instalações |
Em tempo real |
Instalações bloqueadas com a razão para o bloqueio Tema do relatório: blocked_installs_report |
| Evento na aplicação | Em tempo real |
Eventos na aplicação realizados por utilizadores bloqueados Tema do relatório: |
| Cliques | Em tempo real |
Cliques realizados por utilizadores bloqueados Tema do relatório: |
Procedimento para redes de anúncios obterem relatórios do Protect360 através de download
Para obter um relatório utilizando a API:
- Identifique o relatório necessário na lista anterior.
- Use o exemplo curl adequado (na secção seguinte) para preparar o seu script.
- Garanta que substitui os seguintes espaços reservados:
- ID da aplicação
- Data de início
- Data de fim
- Token de autenticação (token V2.0 da AppsFlyer)
- Algumas chamadas têm parâmetros opcionais, conforme descrito neste artigo.
Exemplos de curl
Instalações (relatório_de_instalações_bloqueadas)
Substitua os espaços reservados app_id, from, to e token.
curl --location --request GET 'https://hq1.appsflyer.com/api/adnets-data/v1/export/blocked_installs_report/app/{app_id}?from={2020-07-10}&to={2020-07-20}&additional_fields=keyword_id,store_reinstall,deeplink_url,oaid,blocked_reason,blocked_reason_value,blocked_reason_rule,blocked_sub_reason,match_type,device_category,gp_referrer,gp_click_time,gp_install_begin,amazon_aid,keyword_match_type' \
-H 'Authorization: Bearer {V2.0 api token placeholder. Note: The token has more than 700 characters.}' \
Instalações pós-atribuição (deteção)
Substitua os espaços reservados app_id, from, to e token.
curl --location --request GET 'https://hq1.appsflyer.com/api/adnets-data/v1/export/detection/app/{app-id}?from={2020-06-10}&to={2020-07-20}&additonal-fields=fraud_reason,fraud_sub_reason,match_type,device_category,gp_referrer,gp_click_time,gp_install_begin,detection_date' \
-H 'Authorization: Bearer {V2.0 api token placeholder. Note: The token has more than 700 characters.}' \
Evento na aplicação (relatório_de_eventos_na_app_bloqueados)
Substitua os espaços reservados app_id, from, to e token.
curl --location --request GET 'https://hq1.appsflyer.com/api/adnets-data/v1/export/blocked_in_app_events_report/app/?from=YYYY-MM-DD&to=YYYY-MM-DD&additional_fields=keyword_id,store_reinstall,deeplink_url,oaid,blocked_reason,blocked_reason_value,blocked_reason_rule,blocked_sub_reason,match_type,device_category,gp_referrer,gp_click_time,gp_install_begin,amazon_aid,keyword_match_type' \
-H 'Authorization: Bearer {V2.0 api token placeholder. Note: The token has more than 700 characters.}' \
Fraude em eventos na aplicação pós-atribuição (fraude_eventos_na_app_pós_atribuição)
Substitua os espaços reservados app_id, from, to e token.
curl --location --request GET 'https://hq1.appsflyer.com/api/adnets-data/v1/export/fraud-post-inapps/app/{app-id}?from={2020-06-10}&to={2020-07-20}&additional_fields=match_type,device_category,gp_referrer,gp_click_time,gp_install_begin,fraud_reason,fraud_sub_reason,detection_date' \
-H 'Authorization: Bearer {V2.0 api token placeholder. Note: The token has more than 700 characters.}' \
Cliques (relatório_de_cliques_bloqueados)
Substitua os espaços reservados app_id, from, to e token.
curl --location --request GET 'https://hq1.appsflyer.com/api/adnets-data/v1/export/blocked_clicks_report/app/{app-id}?from={2020-06-10}&to={2020-07-20}&additional_fields=keyword_id,store_reinstall,deeplink_url,oaid,blocked_reason,blocked_reason_value,blocked_reason_rule,blocked_sub_reason,gp_referrer,gp_click_time,gp_install_begin,amazon_aid,keyword_match_type' \
-H 'Authorization: Bearer {V2.0 api token placeholder. Note: The token has more than 700 characters.}' \
Guia de referência API da rede de anúncios Protect360
Noções básicas da API
Noções básicas da API da rede de anúncios Protect360:
| Caminho |
|
| Método | GET |
| Parâmetros de caminho (obrigatórios) |
|
| Tipos de conteúdo aceitos |
application/json |
| Autorização |
|
| Limitação de taxa | Limitações de taxa |
| Limitação de intervalo de datas |
|
| Limitações de linha | 200 mil linhas |
| Características do relatório |
|
Parâmetros da API
Parâmetros da API Protect360:
| Parâmetro | Descrição | Formato | Obrigatório |
|---|---|---|---|
| ID_da_app | ID da aplicação conforme aparece na AppsFlyer | Texto | Sim |
| início |
Início do período:
|
AAAA-MM-DD | Sim |
| para |
Fim do período:
|
AAAA-MM-DD | Sim |
| nome_do_evento |
[Opcional para fraude em eventos na aplicação pós-atribuição] Filtrar eventos por eventos na aplicação. Limite o relatório a eventos específicos. Um ou mais eventos podem ser incluídos. Exemplo de uso: |
Texto |
Não
|
| detetar de |
[Opcional para instalações pós-atribuição] Início do intervalo de datas para deteção de fraude. (A predefinição é a partir de.) |
AAAA-MM-DD | Não |
| detetar até |
[Opcional para instalações pós-atribuição] Fim do intervalo de datas para deteção de fraude. (O valor predefinido é até.) |
AAAA-MM-DD | Não |
Códigos de retorno HTTP da API Protect360
Códigos de erro e soluções:
| Estado | Código | Sintoma/mensagem | Solução |
|---|---|---|---|
| OK | 200 | Ficheiro CSV vazio |
|
| OK |
200 |
Ficheiro CSV vazio |
Assegure-se de que as datas 'de' e 'até' estão no formato aaaa-mm-dd |
| OK |
200 |
A página de login HTML da AppsFlyer retorna |
Não há token no cabeçalho do token bearer |
| Pedido incorreto |
400 |
Pedido incorreto |
|
| Não autorizado |
401 |
Não autorizado |
Foi encontrado um token, mas não é válido. Verifique se possui o token V2.0 atual para a sua conta. Peça ao administrador para obter o token atual no painel de controlo. |
| Não encontrado |
404 |
|
|
Limitação de impressões e cliques
Se uma rede de anúncios apresentar taxas extremamente altas de impressão ou fraude de cliques, o Protect360 bloqueará as impressões ou cliques da rede durante um ciclo de 24 horas. Isso significa que quaisquer impressões/cliques que ocorram após atingir o limite não serão registados pela AppsFlyer nem serão elegíveis para atribuição. As impressões/cliques bloqueados aparecem no painel e nos relatórios do Protect360.
O algoritmo de proteção contra fraudes da AppsFlyer considera vários parâmetros na deteção de fraudes, incluindo volume de impressões/cliques, CVR, taxa de fraude detetada, flutuações normais na atividade, benchmarks da indústria e geográficos, além de parâmetros proprietários. O algoritmo é dinâmico e atualizado hora a hora para considerar as mudanças nas tendências.
Acionar repetidamente limites de inundação de impressões ou cliques pode resultar na remoção permanente da integração do parceiro da plataforma AppsFlyer.
Limites de impressões e cliques:
- Aplicam-se de igual forma a todas as redes de publicidade. Ou seja, não há rede de anúncios para a qual taxas extremamente altas de fraude de impressões ou cliques não resultem em limitações.
- Aplicam-se ao nível da aplicação/rede de anúncios. Ou seja, a análise de fraude considera todas as campanhas da rede de anúncios numa aplicação, e o bloqueio afeta relatórios e atribuição para todas as campanhas dessa rede numa aplicação (independentemente de a conta possuir o Protect360).
- São reiniciados após um ciclo de 24 horas e os bloqueios aplicam-se até ao final do ciclo. Os detalhes de quando começa e termina o ciclo são mantidos em sigilo pela AppsFlyer.
- Não podem ser alterados ou interrompidos. O Protect360 é minuciosamente ajustado e preciso na deteção de fraudes, e o algoritmo não pode ser ajustado ou desligado manualmente.
- Podem ser evitados interrompendo campanhas e editores com atividade anómala.
Perguntas Frequentes
Perguntas Frequentes sobre Limitação de Impressões e Cliques:
|
Questão: Qual é o limite da rede? Resposta: Os detalhes do mecanismo de limitação de cliques são protegidos para evitar tentativas de contornar o sistema. Dito isto, o limite só é atingido se houver um volume extremo de impressões/cliques, além do que seria esperado de um comportamento humano. Analisar o número diário de impressões, cliques e instalações dar-lhe-á uma ideia clara se há um problema de inundação resultado de um ou mais editores. |
|
Questão: Como pode uma rede ser novamente ativada? Resposta: Uma rede pode evitar o limite parando campanhas e editores com atividades anómalas. Uma vez bloqueada, a rede precisa aguardar até ao final do ciclo de 24 horas para que os cliques voltem a ser registados. |
|
Questão: O bloqueio afeta os clientes da AppsFlyer sem o Protect360? Resposta: Sim, o limite afetará independentemente de o cliente ter ou não o Protect360. O mecanismo de limitação protege todos os clientes contra o abuso de cliques/impressões. |
|
P: Isto não é fraude. A rede trabalha com fontes económicas e por vezes a qualidade delas é baixa. Resposta: O fraco desempenho em escala normal de fontes não suspeitas não aciona o limite de cliques. O algoritmo identifica desempenhos que não podem ser humanos. |
|
P: Isto impede-nos de aumentar campanhas, e não queremos que essas impressões/cliques sejam bloqueados. Resposta: O algoritmo de proteção contra fraudes da AppsFlyer protege os clientes de casos extremos e flagrantes de cliques em excesso. Não afeta a capacidade de escalar, pois lida com impressões/cliques não gerados por humanos, onde a maioria dos bloqueios só causa problemas detalhados. Se tiver preocupações, contacte a AppsFlyer para resolver as suas questões. |
|
P: Isto não é fraude. Será que a AppsFlyer tem dificuldades em lidar com o volume de impressões/cliques? Resposta: Não temos dificuldades em lidar com o volume. Apoiamos alguns dos maiores anunciantes globais e processamos bilhões de pontos de dados em tempo real diariamente, incluindo enormes quantidades de cliques legítimos. Como parte do nosso compromisso para sustentar um crescimento em larga escala com dados ricos e precisos, agimos no melhor interesse dos nossos clientes, bloqueando casos claros de cliques em excesso.
|
|
Questão: Qual é a razão para a mudança de abordagem, limitando cliques além das instalações? R: Estamos constantemente a melhorar os nossos mecanismos de prevenção de fraudes, como parte do nosso compromisso contínuo de proteger os clientes. Até agora, aceitávamos impressões/cliques e apenas bloqueávamos as instalações. No entanto, em casos extremos, a taxa de cliques pode ser de tal forma elevada que deixa de fazer sentido aceitá-las nos nossos sistemas. |
|
Questão: O que podemos fazer se anteciparmos um aumento significativo no tráfego e no volume de impressões/cliques (por exemplo, devido a novas campanhas)? Como podemos evitar ser bloqueados? Resposta: O algoritmo é dinâmico e atualizado a cada hora, para considerar as diferentes tendências. É bastante sofisticado para lidar com picos e não é acionado por flutuações normais de atividade, incluindo aumentos bruscos e significativos de volume. Nesse sentido, os parceiros podem usar seus dados e relatórios de impressões/cliques para identificar fontes suspeitas e interromper essas campanhas. |
|
Questão: Como podemos verificar o tráfego problemático e melhorar o desempenho das campanhas? Resposta: Os parceiros podem utilizar os seus dados e relatórios de impressões/cliques para identificar fontes suspeitas e interromper essas campanhas. Além disso, os parceiros conseguem ver dados de impressões e cliques bloqueados no painel do Protect360/ProtectLITE, nas colunas dedicadas, desde que tenham autorização do anunciante para visualizar dados de fraude no painel.
|
|
Questão: As redes recebem e-mails de notificação sobre limites? Resposta: Para controlo de cliques, a AppsFlyer envia uma notificação por e-mail para a rede de publicidade cada vez que o limite de cliques é atingido. |
Assinatura de cliques
As redes de publicidade podem adicionar assinaturas HMAC-SHA256 aos seus cliques.
Essas assinaturas permitem à AppsFlyer validar os cliques e assegurar que a informação dos cliques não foi adulterada por fraudadores.
- Os cliques validados são registados e atribuídos à rede de publicidade.
-
Os cliques invalidados são rejeitados e:
- São incluídos em relatórios do Protect360 disponibilizados para a rede de publicidade.
- Não afetam a taxa de conversão nem o limite de cliques da rede de publicidade.