Best practice per la gestione avanzata del ciclo di vita dei dati
Utilizza l’interfaccia utente di Advanced Data Lifecycle Management e l’API di igiene dei dati per gestire in modo efficiente le richieste di pulizia e rimuovere i dati dai servizi Adobe Experience Platform. Segui queste best practice per semplificare l’elaborazione delle richieste e ottimizzare i tempi di risposta per il completamento.
Prerequisiti prerequisites
Questa guida richiede una buona conoscenza dell’area di lavoro del ciclo di vita dei dati e dell’API per l’igiene dei dati. Prima di continuare questo documento, acquisisci familiarità con le guide di Advanced Data Lifecycle Management e creazione di richieste di eliminazione record o scadenze di set di dati nell’interfaccia utente o tramite l’API.
Linee guida per la creazione di ordini di lavoro work-order-creation-guidelines
È possibile utilizzare l’endpoint /workorder nell’API di igiene dei dati per gestire in modo programmatico le richieste di eliminazione dei record in Experience Platform. Con questo endpoint, puoi creare una richiesta di eliminazione, controllarne lo stato o aggiornare una richiesta esistente. Per informazioni su come eseguire queste azioni utilizzando l’API, consulta il documento Endpoint ordine di lavoro. Le richieste di cancellazione dei record vengono raggruppate in batch prima dell’inizio dell’elaborazione e il loro completamento può richiedere fino a 30 giorni (SLA standard) o 15 giorni (Privacy and Security Shield o Healthcare Shield). Per un’analisi completa di ciò che accade in ogni fase, vedere Timeline di elaborazione del ciclo di vita dei dati.
Segui queste linee guida per ottimizzare gli invii delle richieste di pulizia:
- Massimizza identità per richiesta: Per migliorare l’efficienza, includi fino a 100.000 identità per richiesta di pulizia. Il raggruppamento di più identità in un’unica richiesta consente di ridurre la frequenza delle chiamate API e riduce il rischio di problemi di prestazioni a causa di richieste di singole identità eccessive. Inviare richieste con il numero massimo di identità per ottenere un’elaborazione più rapida, in quanto gli ordini di lavorazione vengono raggruppati in batch per garantire l’efficienza.
- Specificare singoli set di dati: Per la massima efficienza, specificare il singolo set di dati da elaborare.
- Considerazioni sulla limitazione API: Presta attenzione alla limitazione API per evitare rallentamenti. Richieste più piccole (< 100 ID) con frequenze più alte possono dare luogo a 429 risposte e richiedere una nuova presentazione a tassi accettabili.
Gestisci errori 429 manage-429-errors
Se viene visualizzato un errore 429, significa che è stato superato il numero consentito di richieste in un determinato periodo di tempo. Segui queste best practice per gestire in modo efficace gli errori 429:
- Leggi l’intestazione ‘Retry-After’: quando viene restituito un errore 429, controlla l’intestazione di risposta ‘Retry-After’. Questa intestazione specifica il tempo di attesa prima di riprovare la richiesta.
- Implementare la logica dei tentativi: utilizzare il valore ‘Riprova dopo’ per implementare la logica dei tentativi nell’applicazione, assicurandosi che i tentativi vengano eseguiti dopo il tempo specificato per evitare errori 429 successivi.
- Blocca le richieste: evita di inviare numerose piccole richieste in rapida successione. Al contrario, raggruppa più identità in un’unica richiesta per ridurre la frequenza delle chiamate e minimizzare il rischio di raggiungere i limiti di frequenza.
Scadenza set di dati dataset-expiration
Imposta la pulizia automatica dei set di dati per dati di breve durata. Utilizza l’endpoint /ttl nell’API di igiene dei dati per pianificare le date di scadenza dei set di dati per la pulizia in base a un’ora o a una data specificata. Per informazioni su come creare una scadenza del set di dati e i parametri di query accettati, consulta la guida dell’endpoint “Dataset Exiration”.
Monitorare lo stato di scadenza dell’ordine di lavoro e del set di dati monitor
È possibile monitorare in modo efficiente l’avanzamento della gestione del ciclo di vita dei dati tramite l’utilizzo di eventi di I/O. Un evento di I/O è un meccanismo che consente di ricevere notifiche in tempo reale su modifiche o aggiornamenti apportati a vari servizi all’interno di Experience Platform.
Gli avvisi di eventi di I/O possono essere inviati a un webhook configurato per consentire l’automazione del monitoraggio delle attività. Per ricevere gli avvisi tramite webhook, devi registrarlo per gli avvisi di Experience Platform in Adobe Developer Console. Per istruzioni dettagliate, consulta la guida su abbonamento a notifiche evento Adobe I/O.
Per recuperare e monitorare in modo efficace gli stati dei processi, utilizzare i metodi e le linee guida del ciclo di vita dei dati seguenti:
Eventi I/O io-events
Per monitorare in modo efficiente l’avanzamento delle attività del ciclo di vita dei dati, impostare e utilizzare gli eventi di I/O seguendo la procedura riportata di seguito.
- Imposta i webhook per ricevere notifiche push per le modifiche di stato.
- Utilizza le notifiche per monitorare l’avanzamento e ricevere aggiornamenti al completamento.
- Evita di implementare meccanismi di polling per ridurre al minimo il traffico API.
Recuperare risposte dettagliate per un singolo ordine di lavoro retrieve-detailed-work-order-response
Per informazioni approfondite sui singoli ordini di lavorazione, utilizzare il seguente approccio:
- Effettuare una richiesta GET all’endpoint
/workorder/{work_order_id}per ottenere dati di risposta dettagliati. - Recuperare risposte specifiche per il prodotto e messaggi di successo.
- Evita di utilizzare questo metodo per le normali attività di polling.
Attenendosi a queste best practice, è possibile gestire in modo efficace le richieste di pulizia e ottimizzare i tempi di risposta nell’ambito di Advanced Data Lifecycle Management.