Protect360 para partners integrados

De un vistazo: Los partners integrados (redes de publicidad y agencias) pueden ver el fraude relacionado con su tráfico identificado y bloqueado por los motores ProtectLITE y Protect360, así como las reglas de validación definidas manualmente por el cliente.

Información general

AppsFlyer identifica 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 a los partners integrados (redes de publicidad y agencias) permiso para acceder al panel de control de Protect360 y a los reportes de raw data (que incluyen ProtectLITE) y acceder a los datos agregados de eventos in-app. Con permiso, los partners integrados pueden:

  • Ver datos relacionados con el tráfico que generaron.
  • Descargar los reportes de raw data relacionados.

 Nota

Para los anunciantes que trabajan con redes de publicidad a través de una agencia, para que tanto la red de publicidad como la agencia puedan acceder a los datos, el anunciante debe integrar tanto la agencia como la red de publicidad en AppsFlyer, y otorgarles permiso para acceder a los datos.

Si solo la agencia está integrada y se le otorga el permiso, la red de publicidad no tiene acceso a los datos.

Vista del panel de control

Requisitos previos: permiso del anunciante para acceder a ProtectLITE y Protect360. 

Los partners integrados pueden ver el panel de control y los gráficos; mira la captura de pantalla que sigue.

Obtén más información sobre qué datos están disponibles en los paneles de control de ProtectLITE y Protect360.

Limitaciones:

  • Las redes de publicidad no pueden acceder al panel de control de Anomalías. Las agencias tienen acceso, pero solo verán datos si hay tráfico de fuentes en las que AppsFlyer confía que tienen tasas de fraude bajas, de modo que se pueda crear una línea de base para comparar otras fuentes de medios.
  • Las agencias no pueden acceder al panel de control de eventos in-app (CPA) de Protect360. 

p360_dashboard_1.jpg

Reportes de raw data

Requisitos previos: permiso del anunciante para acceder a ProtectLITE y Protect360. 

Los reportes de raw data de Protect360 muestran el fraude identificado y bloqueado a través de ProtectLITE, Protect360 y las reglas de validación.

Los reportes están disponibles a través de:

Aprender más sobre los reportes de raw data de Protect360.

API de reportes de redes de publicidad de Protect360

  • Los reportes de raw data enumerados en esta sección están disponibles para las redes de publicidad a través de API.
  • Los reportes equivalentes están disponibles en el panel de control de la página Datos exportados.
  • Si el anunciante no tiene una suscripción a Protect360, solo estará disponible el reporte Instalaciones.

Requisitos previos

  • Para acceder a los datos de los anunciantes por API, el anunciante otorga permiso a la red de publicidad para acceder a su panel de control de Protect360 y a los datos por API. Las redes de publicidad que tienen acceso al panel de control pueden usar la API. El anunciante no requiere ninguna acción. 
  • Para obtener una lista de las aplicaciones para las que tienes permiso de Protect360, usa obtener API de lista de aplicaciones. 
  • El administrador debe obtener un token de autenticación de AppsFlyer V2.0 disponible en el panel de control.
Reporte Actualización de los datos Descripción
Reportes de API Protect360
Fraude de eventos in-app posterior a la atribución

Diariamente a las 10:00 UTC

  • Los eventos in-app realizados por instalaciones identificadas como fraudulentas.
  • Cualquier otro evento in-app juzgado como fraudulento independientemente de la instalación.

El reporte puede filtrarse opcionalmente por tipo de evento in-app, como se describe en la tabla de parámetros que figura a continuación. 

Tema del reporte: fraud-post-inapps

Instalaciones post-atribución

Diariamente a las 10:00 UTC

  • Instalaciones identificadas como fraudulentas posterior a la atribución. 
  • El reporte puede filtrarse opcionalmente por fecha de detección, como se describe en la sección a continuación. 

Tema del reporte: detection

Instalaciones

Tiempo real

Instalaciones bloqueadas con el motivo del bloqueo

Tema del reporte: blocked_installs_report

Evento in-app Tiempo real

Eventos in-app que realizaron usuarios bloqueados

Tema del reporte: blocked_in-app_events_report

Clics Tiempo real

 Clics realizados por usuarios bloqueados

Tema del reporte: blocked_clicks_report

Procedimiento para que las redes de publicidad obtengan reportes de Protect360 mediante descarga

Para obtener un reporte usando la API:

  1. Identifica el reporte requerido de la lista anterior.
  2. Utiliza el ejemplo de curl relevante (en la siguiente sección) para preparar tu script.
  3. Asegúrate de reemplazar los siguientes marcadores de posición:
    1. ID de aplicación
    2. Desde la fecha
    3. Hasta la fecha
    4. Token de portador (token de autenticación de AppsFlyer V2.0)
  4. Algunas llamadas tienen parámetros opcionales, como se describe en este artículo. 

Ejemplos de curl

Instalaciones (blocked_installs_report)

Reemplaza los marcadores de posición app_id, desde, hasta y del 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 posteriores a la atribución (detección)

Reemplaza el ID de la aplicación, desde, hasta y los marcadores de posición del 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 in-app (block_in_app_events_report)

Reemplaza el ID de la aplicación, desde, hasta y los marcadores de posición del 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 de eventos in-app posteriores a la atribución (fraud_post_inapps)

Reemplaza el ID de la aplicación, desde, hasta y los marcadores de posición del 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)

Reemplaza el ID de la aplicación, desde, hasta y los marcadores de posición del 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 red de publicidad Protect360

Conceptos básicos de la API

Aspectos básicos de la API de red de publicidad Protect360
Ruta

https://hq1.appsflyer.com/api/adnets-data/v1/export/report_topic/app/app_id

Método GET
Parámetros de ruta (obligatorio)
  • app_id:
    • Es el identificador de la aplicación tal y como se encuentra en el panel de control de AppsFlyer. Insértalo exactamente como se muestra en el panel de control.
    • Asegúrate de prefijar las aplicaciones de iOS con id.
  • report_topic
Tipos de contenido aceptado application/json 
Autorización
  • Token de portador en el encabezado de la solicitud.
  • AppsFlyerAdmin_us-en.pngPide al administrador que obtenga el token V2.0 en la página tokens . Este token tiene aproximadamente 700 caracteres de longitud. 
Limitación de velocidad Limitaciones de velocidad
Limitación del rango de fechas
  • Fecha más temprana admitida, 90 días antes de la fecha actual
  • 31 días de los 90 días anteriores
Limitaciones de filas 200 mil filas
Características del reporte
  • Zona horaria: UTC
  • Moneda: USD

Parámetros de API

Parámetros de la API Protect360
Parámetro Descripción Formato Obligatorio
app_id  ID de la aplicación como se muestra en AppsFlyer String
desde

Inicio del rango de fechas:

  • Para las instalaciones, esta es la fecha de instalación.
  • Para los eventos in-app, esta es la fecha del evento.
AAAA-MM-DD
a

Fin del rango de fechas:

  • Para las instalaciones, esta es la fecha de instalación.
  • Para los eventos in-app, esta es la fecha del evento.
AAAA-MM-DD
event_name

[Opcional para el fraude de eventos in-app posterior a la atribución]

Filtra los eventos por evento in-app. Limita el reporte a eventos específicos. Se pueden incluir uno o más eventos.

Ejemplo de uso: &event_name=af_purchase,af_login

String

No

 

detect-from

[Opcional para instalaciones posteriores a la atribución]

Comienzo del rango de fechas de detección de fraude. (Por defecto es from [desde].) 

AAAA-MM-DD No
detect-to

[Opcional para instalaciones posteriores a la atribución]

Fin del rango de fechas de detección de fraude. (Por defecto es to [hasta]. )

AAAA-MM-DD No

Códigos de retorno HTTP de la API de Protect360

Estado Código Síntoma/mensaje SOLUCIÓN
Códigos de error y soluciones
OK 200 Archivo CSV vacío

addtional_fieldsse utiliza más de una vez en el URI

OK

200

Archivo CSV vacío

Asegúrate de que tanto las fechas de inicio como las de finalización tengan el formato aaaa-mm-dd.

OK 

200

Vuelve a la página de inicio de sesión HTML de AppsFlyer

No hay token en el encabezado del token del portador

Solicitud incorrecta

400

Solicitud incorrecta

  • Limitación del intervalo de fechas.
    • La fecha más temprana permitida es 90 días antes del día actual
    • El período no puede exceder los 60 días para las instalaciones y los 90 días para los reportes in-app
No autorizado

401

No autorizado

Se encontró un token, pero no es válido. Comprueba que tienes el token V2.0 actual para tu cuenta. Pide al administrador que recupere el token actual del panel de control.

No se encuentra

404

 

  • El punto de conexión especificado es incorrecto
  • Asegúrate de que el ID de aplicación es correcto
  • No tienes autorización para acceder a la aplicación

Bloqueo de impresiones y clics

Si una red de publicidad tiene tasas extremadamente altas de fraude de impresiones o clics, Protect360 bloquea las impresiones o clics de la red de publicidad durante el resto del ciclo de 24 horas. Esto significa que AppsFlyer no registra las impresiones/clics que ocurran después del umbral, ni son elegibles para la atribución. Las impresiones/clics bloqueados aparecen en el panel de control y reportes de Protect360.

El algoritmo de protección contra el fraude de AppsFlyer tiene en cuenta varios parámetros al detectar este fraude, incluido el volumen de impresiones/clics, CVR, tasa de fraude detectado, fluctuaciones normales en la actividad, puntos de referencia geográficos y de la industria y parámetros de propiedad. El algoritmo es dinámico y se actualiza cada hora para tener en cuenta las tendencias cambiantes.

La activación repetida de umbrales de inundación de impresiones o clics puede resultar en la eliminación permanente de la integración del partner de la plataforma AppsFlyer.

Umbrales de bloqueo de impresiones y clics: 

  • Se aplican a todas las redes de publicidad por igual. Es decir, no existe una red de publicidad para la cual las tasas extremadamente altas de fraude de impresiones o clics no conduzcan al bloqueo.
  • Están en el nivel de la red de publicidad (las impresiones también tienen en cuenta el nivel de la aplicación). Lo que significa que el análisis del fraude tiene en cuenta todas las campañas y los anunciantes de una red de publicidad. Y el bloqueo afecta los reportes y la atribución de todas las campañas y anunciantes de la red de publicidad (tengan o no Protect360).
  • Se restablecen después de un ciclo de 24 horas y se aplican bloqueos hasta el final del ciclo. 
  • No se puede cambiar ni detener. Protect360 es muy preciso en su detección de fraude, y el algoritmo no se puede ajustar ni desactivar manualmente. 
  • Puede evitarse deteniendo campañas y publishers con actividad anómala.

Preguntas frecuentes

Impresiones y preguntas frecuentes sobre el bloqueo de clics

P: ¿Cuál es el umbral de la red?

R : Los detalles del mecanismo de bloqueo 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/clics disparados, más allá de la posibilidad del comportamiento humano. Si observas los volúmenes de impresiones, clics e instalaciones del día, obtendrás una idea clara de si existe un problema de inundación derivado de uno o más publishers. Nota: El mecanismo de bloqueo tiene en cuenta todo el tráfico de red para todas las aplicaciones, no solo las aplicaciones de un solo anunciante.

P: ¿Cómo se puede desbloquear una red?

R: Una red puede evitar el umbral deteniendo campañas y publishers con actividad anómala. Una vez bloqueada, la red debe esperar hasta el final del ciclo de 24 horas para que se reanude el registro de clics.

P: ¿Afecta el bloqueo a los clientes de AppsFlyer sin Protect360?

R: El bloqueo de clics entra en vigencia independientemente de si un cliente tiene Protect360 o no. Esto se debe a que el bloqueo de clics se basa en la red; no en los anunciantes. El mecanismo de bloqueo protege a todos los clientes y tiene en cuenta todo el tráfico de red para todas las aplicaciones, no solo las aplicaciones de un solo anunciante.

P: Esto no es fraude. La red está trabajando con fuentes baratas y a veces su calidad es baja.

R: Un rendimiento deficiente a una escala normal de fuentes no sospechosas no desencadena el bloqueo de clics. El algoritmo identifica el rendimiento que posiblemente no puede ser humano.

P : Esto nos impide escalar campañas y no queremos que se bloqueen estas impresiones/clics.

R: El algoritmo de protección contra fraudes de AppsFlyer protege a los clientes de instancias extremas y ruidosas de inundaciones. No afecta la capacidad de escalado, ya que aborda impresiones/clics generados por personas no humanas, donde la gran mayoría de los bloqueos solo causan responsabilidades. Si tienes alguna duda, ponte en contacto con AppsFlyer para resolver tus problemas.

P : Esto no es un fraude. ¿Quizás AppsFlyer tiene problemas para lidiar con el volumen de impresiones/clics?
R: No tenemos problemas para manejar el volumen. Apoyamos a algunos de los anunciantes a mayor escala del mundo y procesamos miles de millones de puntos de datos en tiempo real todos los días, incluyendo un enorme número de clics legítimos. Como parte de nuestro compromiso de apoyar el crecimiento a gran escala con datos enriquecidos y precisos, actuamos en los mejores intereses de nuestros clientes y bloqueamos instancias claras de inundación de clics.

P: ¿Cuál es el motivo del cambio de enfoque, que bloquea los clics además de las instalaciones?
R: Mejoramos constantemente nuestros mecanismos de prevención del fraude como parte de nuestro compromiso continuo de proteger a los clientes. Hasta ahora, aceptamos impresiones/clics y solo bloqueábamos las instalaciones. Sin embargo, en casos extremos, la tasa de clics es imposiblemente extrema y, en esos casos, no tiene sentido aceptarlos en nuestros sistemas.
P: ¿Qué podemos hacer si esperamos un aumento significativo en el tráfico y el volumen de impresiones/clics (por ejemplo, debido a nuevas campañas)? ¿Qué se puede hacer para evitar el bloqueo?
R: El algoritmo es dinámico y se actualiza por hora, para tener en cuenta las diferentes tendencias. Es lo suficientemente sofisticado como para manejar los picos y no se activa por fluctuaciones de actividad normales, incluidos los aumentos repentinos y significativos del volumen. Dicho esto, los partners pueden usar sus datos y reportes de impresiones/clics para identificar fuentes sospechosas y detener esas campañas.
P: ¿Cómo podemos comprobar el tráfico problemático y mejorar el rendimiento de la campaña?
R: Los partners pueden utilizar sus reportes y datos de impresiones/clics para identificar fuentes sospechosas y detener esas campañas.

P: ¿Se envían correos electrónicos de notificación de bloqueo de clics a las redes?
R: Existen dos correos electrónicos de notificación potenciales. Uno alerta a la red de publicidad cuando se acercan al umbral de bloqueo de clics (diferente para cada red de publicidad). El segundo es una notificación de que se alcanza el umbral de bloqueo de clics y les informa cuándo se reanudará el registro de clics. El tiempo entre los dos correos electrónicos depende del ritmo de la inundación. A veces hay intervalos largos, lo que da tiempo a la red de publicidad para tomar medidas contra el fraude, pero otras veces los intervalos pueden ser minutos.

Firma de clics

Para evitar el bloqueo de clics, las redes de publicidad pueden agregar firmas HMAC-SHA256 a sus clics

Las firmas permiten que AppsFlyer valide los clics y asegurarse de que la información de clics no haya sido manipulada por estafadores.

  • Los clics validados se registran y se atribuyen a la red de publicidad 
  • Los clics invalidados se rechazan y: 
    • Se agregan en los reportes de Protect360 que están disponibles para la red de publicidad (no para anunciantes).
    • No afectan la tasa de conversión ni el umbral de bloqueo de clics de la red de publicidad
¿Fue útil este artículo?