Resumen: Los socios integrados, como redes publicitarias y agencias, pueden visualizar el fraude relacionado con el tráfico que ha sido identificado y bloqueado por los motores ProtectLITE y Protect360, así como también por las reglas de validación definidas manualmente por el cliente.
Visión general
AppsFlyer detecta y bloquea el fraude a través de:
- ProtectLITE: Protección básica contra fraudes para todos los clientes.
- Protect360: Protección avanzada contra fraudes para anunciantes con un plan de suscripción premium.
Los anunciantes deben otorgar:
- Permisos a las redes publicitarias para acceder al panel de Protect360 y a los informes de datos sin procesar (incluyendo ProtectLITE) y acceder a datos agregados de eventos in-app (para fraudes en eventos in-app).
- Permisos a las agencias para acceder al panel de control y a los datos sin procesar de Protect360.
Con los permisos adecuados, los socios integrados pueden:
- Visualizar datos relacionados con el tráfico que generan.
- Descargar informes de datos en bruto relacionados.
Además, hay informes de datos sin procesar accesibles para redes publicitarias sobre límites de clics e impresiones, así como firmas de clics fallidos, que no requieren permisos de los anunciantes.
Nota
Para anunciantes que trabajan con redes publicitarias a través de una agencia, es necesario que tanto la red publicitaria como la agencia tengan acceso a los datos. Por lo tanto, el anunciante debe integrar a ambos en AppsFlyer y concederles permiso para acceder a los datos.
Si solo la agencia está integrada y tiene permisos, la red publicitaria no podrá acceder a los datos.
Vista del panel de control
Requisitos previos: Permiso del anunciante para acceder a ProtectLITE y Protect360.
Los socios integrados pueden ver el panel y los gráficos; consulte la captura de pantalla que se muestra a continuación.
Obtenga más información acerca de los datos disponibles en los paneles de control ProtectLITE y Protect360 .
Limitaciones:
- Las redes publicitarias no tienen acceso al panel de anomalías. Las agencias tienen acceso pero solo verán datos si el tráfico proviene de fuentes confiables por AppsFlyer por tener bajas tasas de fraude. Esto permite crear una referencia para comparar con otras fuentes de medios.
Informes de datos sin procesar
Requisitos previos: Permiso del anunciante para acceder a ProtectLITE y Protect360.
Los informes de datos brutos de Protect360 muestran el fraude identificado y bloqueado a través de ProtectLITE, Protect360 y las reglas de validación.
Los informes están disponibles a través de:
- Exportar datos: En AppsFlyer, desde el menú lateral, seleccione Informes > Exportación de Datos Brutos
- API: Consulte la sección API de informes de redes publicitarias que se encuentra a continuación.
Obtenga más información sobre los informes de datos brutos de Protect360.
API de informes de redes publicitarias de Protect360
- Los informes de datos brutos que se describen en esta sección están disponibles para las redes publicitarias a través de API.
- Informes equivalentes están accesibles desde el panel de control en la página de Exportar Datos.
- Si el anunciante no posee una suscripción a Protect360, solo estará disponible el informe de Instalaciones.
Requisitos previos
- Para acceder a los datos del anunciante mediante API, el anunciante concede a la red publicitaria permisos para acceder a su panel de control y a los datos de Protect360 mediante API. Las redes publicitarias con acceso al panel de control están autorizadas a usar la API. No se requiere ninguna acción por parte del anunciante.
- Para obtener una lista de aplicaciones para las que tiene permisos de Protect360, utilice la API de lista de aplicaciones.
- El administrador debe obtener un token de autenticación de AppsFlyer V2.0 disponible en el panel.
Informes de la API de Protect360
| Informe | Actualización de datos | Descripción |
|---|---|---|
| Fraude en eventos dentro de la aplicación posteriores a la atribución |
Diariamente a las 10:00 UTC |
El informe puede filtrarse opcionalmente por tipo de evento en la aplicación, como se describe en la tabla de parámetros que se presenta a continuación. Tema del informe: |
| Instalaciones posteriores a la atribución |
Diariamente a las 10:00 UTC |
Tema del informe: detección |
| Instalaciones |
En tiempo real |
Instalaciones bloqueadas con motivo del bloqueo Tema del informe: blocked_installs_report |
| Evento en la aplicación | En tiempo real |
Eventos dentro de la aplicación realizados por usuarios bloqueados Tema del informe: |
| Clics | En tiempo real |
Clics realizados por usuarios bloqueados Tema del informe: |
Procedimiento para que las redes publicitarias obtengan informes de Protect360 a través de descarga
Para obtener un informe mediante la API:
- Identifique el informe necesario de la lista anterior.
- Utilice el ejemplo relevante de curl (en la siguiente sección) para preparar su script.
- Asegúrese de reemplazar los siguientes marcadores de posición:
- ID de la aplicación
- Desde la fecha
- Hasta la fecha
- Token de portador (token de autenticación de AppsFlyer V2.0)
- Algunas llamadas tienen parámetros opcionales, como se describe en este artículo.
Ejemplos de curl
Instalaciones (blocked_installs_report)
Sustituya los marcadores de posición app_id, desde, hasta y 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.}' \
Instalaciones tras la atribución (detección)
Sustituya los marcadores de posición para el ID de la aplicación, desde, hasta y 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 dentro de la aplicación (blocked_in_app_events_report)
Sustituya los marcadores de posición para el ID de la aplicación, desde, hasta y 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 en eventos dentro de la aplicación tras la atribución (fraud_post_inapps)
Sustituya los marcadores de posición para el ID de la aplicación, desde, hasta y 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.}' \
Clics (blocked-clicks_report)
Sustituya los marcadores de posición para el ID de la aplicación, desde, hasta y 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.}' \
Guía de referencia de la API de la red publicitaria Protect360
Conceptos básicos de la API
Conceptos básicos de la API de la red publicitaria Protect360:
| Ruta |
|
| Método | GET |
| Parámetros de ruta (obligatorios) |
|
| Tipos de contenido aceptados |
application/json |
| Autorización |
|
| Limitación de velocidad | Limitaciones de velocidad |
| Limitación del rango de fechas |
|
| Limitaciones de filas | 200K filas |
| Características del informe |
|
Parámetros de la API
Parámetros de la API de Protect360:
| Parámetro | Descripción | Formato | Obligatorio |
|---|---|---|---|
| app_id | ID de la aplicación tal como aparece en AppsFlyer | Cadena | Sí |
| desde |
Inicio del rango de fechas:
|
AAAA-MM-DD | Sí |
| hasta |
Fin del rango de fechas:
|
AAAA-MM-DD | Sí |
| nombre_del_evento |
[Opcional para fraudes en eventos dentro de la aplicación tras la atribución] Filtrar eventos por evento en la aplicación. Limite el informe a eventos específicos. Se pueden incluir uno o más eventos. Ejemplo de uso: |
Cadena |
No
|
| detectar desde |
[Opcional para instalaciones posteriores a la atribución] Inicio del rango de fechas para la detección de fraude. (Por defecto es 'desde'). |
AAAA-MM-DD | No |
| detectar-hasta |
[Opcional para instalaciones posteriores a la atribución] Fin del rango de fechas para la detección de fraude. (Por defecto es 'hasta'.) |
AAAA-MM-DD | No |
Códigos de retorno HTTP de Protect360 API
Códigos de error y soluciones:
| Estado | Código | Síntoma/mensaje | Solución |
|---|---|---|---|
| Correcto | 200 | Archivo CSV vacío |
|
| Correcto |
200 |
Archivo CSV vacío |
Asegúrese de que las fechas de inicio y fin estén en el formato aaaa-mm-dd |
| Correcto |
200 |
La página de inicio de sesión en HTML de AppsFlyer devuelve |
Falta el token en el encabezado de Bearer token |
| Solicitud incorrecta |
400 |
Solicitud incorrecta |
|
| No autorizado |
401 |
No autorizado |
Se encontró un token, pero no es válido. Verifique que dispone del token actual V2.0 para su cuenta. Solicite al administrador que recupere el token actual desde el panel de control. |
| No encontrado |
404 |
|
|
Limitación de impresiones y clics
Si una red de anuncios presenta tasas extremadamente altas de fraude en impresiones o clics, Protect360 bloquea estas acciones de la red durante un ciclo de 24 horas. Esto significa que cualquier impresión o clic que ocurra después de alcanzar el umbral no se registra en AppsFlyer ni es elegible para atribución. Las impresiones/clics bloqueados aparecen en el panel de control y en los informes de Protect360.
El algoritmo de protección contra el fraude de AppsFlyer considera diversos parámetros al detectar este fraude, como el volumen de impresiones/clics, CVR, tasa de fraude detectada, fluctuaciones normales en la actividad, puntos de referencia industriales y geográficos, y parámetros propios. El algoritmo es dinámico y se actualiza cada hora para considerar las tendencias cambiantes.
Activar repetidamente los umbrales de inundación de impresiones o clics puede conllevar la eliminación definitiva de la integración del socio en la plataforma de AppsFlyer.
Umbrales para limitar impresiones y clics:
- Se aplican equitativamente a todas las redes publicitarias. Es decir, ninguna red publicitaria se salva de una limitación si exhibe tasas extremadamente altas de fraude en impresiones o clics.
- Operan a nivel de aplicación/red publicitaria. Es decir, el análisis del fraude considera todas las campañas de una red publicitaria en una aplicación, y el bloqueo afecta los reportes y la atribución de todas ellas (independientemente de si la cuenta tiene Protect360 o no).
- Se restablecen tras un ciclo de 24 horas y los bloqueos permanecen hasta que finaliza dicho ciclo. AppsFlyer no revela detalles sobre cuándo comienzan o terminan los ciclos.
- No se pueden modificar ni detener. Protect360 está meticulosamente calibrado y es exacto en la detección de fraude, y el algoritmo no se puede ajustar ni desactivar manualmente.
- Se pueden evitar deteniendo campañas y editores con actividad anómala.
Preguntas frecuentes
Preguntas frecuentes sobre umbrales de impresiones y clics:
|
P: ¿Cuál es el umbral de la red? R: Los detalles del mecanismo de limitación de clics están protegidos para evitar intentos de elusión. Dicho esto, el umbral solo se alcanza si hay un volumen extremo de impresiones o clics, completamente alejado de un comportamiento humano normal. Revisar los volúmenes diarios de impresiones, clics e instalaciones le proporcionará una idea clara de si existe un problema de inundación provocado por uno o más editores. |
|
P: ¿Cómo puede una red desbloquearse? R: Una red puede evitar alcanzar el umbral si detiene las campañas y los editores que muestran actividad anómala. Una vez que se bloquea, la red debe esperar hasta que termine el ciclo de 24 horas para que los registros de clics puedan reanudarse. |
|
P: ¿El bloqueo afecta a los clientes de AppsFlyer que no tienen Protect360? R: Sí, la limitación afectará independientemente de si el cliente posee Protect360. El mecanismo de limitación protege a todos los clientes del abuso de clics e impresiones. |
|
Q: Esto no es fraude. La red trabaja con fuentes económicas y a veces su calidad es baja. R: El bajo rendimiento a una escala normal de fuentes no sospechosas no desencadena la limitación de clics. El algoritmo detecta un rendimiento que no podría ser humano. |
|
Q: Esto nos impide escalar campañas y no queremos que se bloqueen estas impresiones o clics. R: El algoritmo de protección contra fraudes de AppsFlyer protege a los clientes de casos extremos y claros de inundación. No afecta la capacidad de crecimiento, ya que se dirige a impresiones o clics no humanos, donde la mayoría de los bloqueos solo causan problemas. Si tiene preocupaciones, por favor comuníquese con AppsFlyer para tratar sus problemas. |
|
Q: Esto no es fraude. ¿Podría ser que AppsFlyer tenga dificultades para manejar el volumen de impresiones o clics? R: No tenemos problemas para gestionar el volumen. Damos soporte a algunos de los anunciantes de mayor escala del mundo y procesamos miles de millones de puntos de datos en tiempo real diariamente, incluyendo una gran cantidad de clics legítimos. Como parte de nuestro compromiso de apoyar un crecimiento a gran escala con datos ricos y precisos, actuamos en el mejor interés de nuestros clientes y bloqueamos casos claros de inundación de clics.
|
|
P: ¿Cuál es la razón para el cambio de enfoque, limitando los clics además de las instalaciones? A: Constantemente mejoramos nuestros mecanismos de prevención de fraudes como parte de nuestro compromiso permanente de proteger a los clientes. Hasta ahora, aceptábamos impresiones y clics y solo bloqueábamos las instalaciones. Sin embargo, en situaciones extremas, la tasa de clics puede ser excesivamente alta y, en tales casos, no tiene sentido integrarlas en nuestros sistemas. |
|
P: ¿Qué podemos hacer si prevemos un aumento considerable en el tráfico y el volumen de impresiones/clics, por ejemplo, debido a nuevas campañas? ¿Cómo podemos prevenir el bloqueo? R: El algoritmo es dinámico y se actualiza de forma horaria para considerar las diferentes tendencias. Es suficientemente sofisticado para gestionar picos y no se activa con fluctuaciones normales de actividad, incluso con incrementos súbitos y significativos en el volumen. Dicho esto, los colaboradores pueden utilizar sus datos e informes de impresiones/clicks para identificar fuentes sospechosas y detener esas campañas. |
|
P: ¿Cómo podemos detectar tráfico problemático y mejorar el rendimiento de las campañas? R: Los socios pueden utilizar sus datos e informes de impresiones y clics para identificar fuentes sospechosas y detener esas campañas. Adicionalmente, pueden ver datos de clics e impresiones bloqueados en el panel de control de Protect360/ProtectLITE en las columnas dedicadas, siempre que el anunciante les haya concedido el permiso necesario para ver los datos de fraude en el panel.
|
|
P: ¿Las redes reciben correos electrónicos de notificación sobre la limitación de clics? R: Para la limitación de clics, AppsFlyer envía una notificación por correo electrónico a la red publicitaria cada vez que se alcanza el umbral establecido. |
Firma de clics
Las redes publicitarias pueden agregar firmas HMAC-SHA256 a sus clics.
Estas firmas permiten a AppsFlyer validar los clics, asegurándose de que la información no haya sido manipulada por estafadores.
- Los clics validados se registran y se atribuyen a la red publicitaria.
-
Los clics inválidos se rechazan y:
- Se incluyen en los informes de Protect360 que están disponibles para la red publicitaria (excluyendo a los anunciantes).
- No afectan la tasa de conversión ni el umbral de limitación de clics de la red publicitaria