Directrices de creación de trabajos de privacidad
Para optimizar el procesamiento de solicitudes y mejorar los tiempos de respuesta, tenga en cuenta las siguientes directrices al crear trabajos de privacidad. Esto se aplica tanto a la API como a los métodos de interfaz de usuario.
- Maximizar interesados por solicitud: Incluya tantos interesados como sea posible, hasta 1000, por solicitud.
- Identificadores de grupo por eficiencia: Agrupe varios ID para un único interesado (hasta nueve) en cada solicitud. Los ID pueden provenir de diferentes servicios de Adobe en la misma solicitud.
- Combinar los trabajos de acceso y eliminación: Incluir los tipos de trabajo de "acceso" y "eliminación" en una sola solicitud si el interesado lo requiere.
- Incluir solo los productos necesarios: Incluir solo los productos requeridos o con licencia. Los productos adicionales pueden alargar el tiempo de procesamiento y aumentar los costes.
Monitorización del estado de trabajos de privacidad
Para monitorizar de forma eficaz los trabajos de privacidad y comprobar su estado, Privacy Service proporciona tres métodos. Los métodos disponibles se enumeran a continuación en orden de supervisión de la eficiencia y la productividad. Cada método incluye directrices de prácticas recomendadas para mejorar su experiencia, seguidas de un ejemplo de escenario ideal que combina todos los enfoques.
Recibir notificaciones en tiempo real
Eventos de E/S ofrecen supervisión de estado casi en tiempo real mediante eventos de estado. Este es el método más eficiente, ya que evita la necesidad de implementar mecanismos de sondeo e incurrir en tráfico de API adicional.
Recommendations:
- Configuración de webhook: Configure los webhooks para recibir notificaciones push cuando se produzcan cambios de estado en los trabajos enviados. Esto ayuda en la monitorización en tiempo real.
- Notificaciones: Use notificaciones tanto a nivel de trabajo como de producto para ayudar a supervisar el progreso de las solicitudes.
Consulte la documentación de suscripción a eventos de Privacy Service para obtener instrucciones sobre cómo configurar un registro de evento para notificaciones de Privacy Service y cómo interpretar las cargas de notificación.
Recuperar todos los trabajos basados en filtros
Para recuperar todos los datos del trabajo de privacidad en función de los filtros especificados, realice una solicitud de GET al extremo /jobs. Esta llamada de API es útil para proporcionar una vista de alto nivel del estado actual del trabajo para grandes conjuntos de ID de trabajo con una sola solicitud. No contiene respuestas detalladas al producto, pero se pueden encontrar usando el extremo /jobs/{jobID}.
Una solicitud de GET al extremo /jobs se usa mejor para recopilar o comparar los datos de estado de un gran conjunto de ID de trabajo, pero no está pensada para actividades regulares de tipo de sondeo.
Recommendations:
- Parámetros de consulta: Use filtros específicos para reducir los resultados, por ejemplo: rangos de datos, tipos de regulación y estado (procesamiento, finalización, etc.).
Puede ver una lista de todos los trabajos de privacidad actuales de su organización a través de la interfaz de usuario de Privacy Service. Consulte administración de trabajos de privacidad en la documentación de la interfaz de usuario para obtener información sobre cómo filtrar la lista de solicitudes de trabajo. Alternativamente, consulte la documentación sobre el uso del extremo /job en la API del Privacy Service.
La documentación de la API de Privacy Service contiene detalles sobre los filtros de parámetros de consulta disponibles.
Recuperar respuestas detalladas para un solo trabajo
Para recuperar respuestas detalladas para un solo trabajo, realice una solicitud de GET al extremo /jobs/{jobID}. Este método está diseñado para recopilar información más detallada, como respuestas específicas del producto y mensajes de éxito. Una llamada a este extremo es la mejor manera de ver qué productos han respondido y cuáles siguen pendientes, aunque no está destinado a la actividad de sondeo normal.
Consulte la documentación del extremo /jobs/{JOB_ID} para obtener detalles sobre cómo comprobar el estado de un trabajo específico.
Ejemplo de escenario ideal
Utilice un webhook para que el sistema pueda actualizar automáticamente los registros y proporcionar informes o alertas cuando se completen grupos de los ID de una solicitud. Si los trabajos siguen pendientes, el sistema recupera estos estados de trabajo con una solicitud de GET al extremo de la API de Privacy Service /jobs y proporciona una actualización de alto nivel de la lista.
Si un trabajo en particular sigue pendiente o ha devuelto un error, puede recuperar la respuesta detallada con una solicitud de GET al extremo /job/{jobId}.
Datos de solicitud de acceso
Cuando se solicita información del interesado, cada servicio devuelve los datos en un formato coherente con la forma en que almacenan y utilizan dichos datos. Una vez que todos los servicios hayan completado la solicitud, se proporciona una URL de archivo .ZIP en los detalles del trabajo para permitir la descarga de estos datos. Consulte la guía de solución de problemas para obtener información sobre cómo descargar los resultados de los trabajos de privacidad.
A continuación se indican algunos aspectos importantes relacionados con la gestión del archivo de datos:
- Todos los archivos de almacenamiento se eliminan de los servidores de Experience Platform pasados 30 días. No puede consultar datos de clientes anteriores a 30 días.
- La estructura del archivo de almacenamiento incluye carpetas para cada producto incluido en la solicitud y los archivos de datos contenidos en ella. Los archivos o carpetas de archivo pueden estar vacíos si no se encontraron datos para el ID especificado.
- Los datos de los trabajos creados anteriormente solo son accesibles durante 30 días después de la fecha de finalización. Después de ese tiempo, los datos se eliminan del sistema y se debe realizar una nueva solicitud.
Recommendations:
- Archivos de datos de Protect: Tanto la dirección URL como el archivo .ZIP deben estar protegidos, ya que pueden contener información personal identificable (PII) del interesado.