Protect360 para partners integrados

Para:
Redes de publicidad
Última actualización:

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 dar:

  • A las redes de publicidad permiso para Acceder al panel de control de Protect360 y a los informes de raw data (incluido ProtectLITE), y para Acceder a los datos agregados de eventos in-app (para el fraude de eventos in-app).
  • A las agencias permiso para Acceder al panel de control de Protect360 y al raw data.

Con los permisos correctos, los partners integrados pueden:

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

También hay reportes de raw data disponibles para las redes de publicidad sobre el límite de clics e impresiones, así como firmas de clics fallidas, para las que no se requieren permisos de anunciante.

 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.

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.

Reportes de API Protect360

Reporte Actualización de los datos Descripción
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 Sí
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 Sí
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 Sí
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

Códigos de error y soluciones:

Estado Código Síntoma/mensaje SOLUCIÓN
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

Limitación de clics e impresiones

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 un 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 los 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 limitación de clics e impresiones: 

  • 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 a la limitación.
  • Están al nivel de aplicación/red de publicidad. Es decir, el análisis del fraude toma en cuenta todas las campañas de la red de publicidad en una aplicación, y el bloqueo afecta a los reportes y la atribución para todas las campañas de la red de publicidad en una aplicación (independientemente de que la cuenta tenga o no Protect360).
  • Se restablecen después de un ciclo de 24 horas y se aplican bloqueos hasta el final del ciclo. AppsFlyer mantiene en privado los detalles sobre cuándo comienza y finaliza el 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

Preguntas frecuentes sobre la limitación de clics e impresiones:

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

R: Los detalles del mecanismo de bloqueo de clic 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 de comportamiento humano. Al observar la impresión del día, los volúmenes de clic e instalación te darán una idea clara de si hay un problema de inundación derivado de uno o más publishers.

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: Sí, el bloqueo afectará independientemente de si un cliente tiene o no Protect360. El mecanismo de bloqueo protege a todos los clientes del abuso de clics\impresiones.

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 la limitación 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 fraude. ¿Quizás AppsFlyer tiene problemas para lidiar con el volumen de impresiones/clics?

R: No tenemos ningún problema 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 limita 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 cada hora, para tomar en consideración diferentes tendencias. Es lo suficientemente sofisticado como para manejar picos y no se desencadena por fluctuaciones normales de actividad, incluyendo aumentos repentinos y significativos en el volumen. Estos partners pueden utilizar sus reportes y datos 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. Los partners también pueden ver los datos bloqueados de impresiones y clics en el panel de control de Protect360/ProtectLite, debajo de las columnas dedicadas, siempre y cuando hayan recibido el permiso requerido del anunciante para ver los datos de fraude en el panel de control.

 

P: ¿Se envían a las redes correos electrónicos de notificación con respecto al bloqueo?

R: Para el bloqueo de clics, AppsFlyer envía una notificación por correo electrónico a la red de publicidad cada vez que se alcanza el umbral de límite de clics.

Firma de clics

Para evitar la limitación 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 limitación de clics de la red de publicidad.