Acquisizione batch parziale

L’acquisizione in batch parziale consente di acquisire dati contenenti errori, fino a una determinata soglia. Con questa funzionalità, gli utenti possono inserire correttamente in Adobe Experience Platform tutti i dati corretti, mentre tutti i dati errati vengono raggruppati in batch separatamente, insieme ai dettagli sul motivo per cui non sono validi.

Questo documento fornisce un’esercitazione per gestire l’acquisizione in blocco parziale.

Introduzione

Questo tutorial richiede una conoscenza operativa dei vari servizi Adobe Experience Platform coinvolti nell’acquisizione in blocco parziale. Prima di iniziare questo tutorial, consulta la documentazione dei seguenti servizi:

Le sezioni seguenti forniscono informazioni aggiuntive che è necessario conoscere per effettuare correttamente chiamate alle API Platform.

Lettura delle chiamate API di esempio

Questa guida fornisce esempi di chiamate API per illustrare come formattare le richieste. Questi includono percorsi, intestazioni richieste e payload di richieste formattati correttamente. Viene inoltre fornito un codice JSON di esempio restituito nelle risposte API. Per informazioni sulle convenzioni utilizzate nella documentazione per le chiamate API di esempio, consulta la sezione su come leggere chiamate API di esempio nella guida alla risoluzione dei problemi di Experience Platform.

Raccogliere i valori per le intestazioni richieste

Per effettuare chiamate alle API Platform, devi prima completare l'esercitazione di autenticazione. Completando il tutorial sull’autenticazione si ottengono i valori per ciascuna delle intestazioni richieste in tutte le chiamate API di Experience Platform, come mostrato di seguito:

Tutte le risorse in Experience Platform sono isolate in specifiche sandbox virtuali. Tutte le richieste alle API Platform richiedono un'intestazione che specifichi il nome della sandbox in cui verrà eseguita l'operazione:

Abilitare un batch per l’acquisizione in blocco parziale nell’API enable-api

Puoi creare un nuovo batch con l’acquisizione parziale abilitata.

Per creare un nuovo batch, segui i passaggi descritti nella guida per gli sviluppatori sull'acquisizione batch. Una volta raggiunto il passaggio Crea batch, aggiungi il seguente campo nel corpo della richiesta:

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercent": 5
}

Abilitare un batch per l’acquisizione in blocco parziale nell’interfaccia utente enable-ui

Per abilitare un batch per l'acquisizione parziale tramite l'interfaccia utente Platform, è possibile creare un nuovo batch tramite le connessioni di origine, creare un nuovo batch in un set di dati esistente o creare un nuovo batch tramite il "Flusso CSV-XDM".

Crea una nuova connessione sorgente new-source

Per creare una nuova connessione di origine, seguire i passaggi elencati nella Panoramica origini. Una volta raggiunto il passaggio Dettagli flusso di dati, prendi nota dei campi Acquisizione parziale e Diagnostica errori.

L'opzione Acquisizione parziale consente di abilitare o disabilitare l'utilizzo dell'acquisizione batch parziale.

L'interruttore Diagnostica errori viene visualizzato solo quando l'interruttore Acquisizione parziale è disattivato. Questa funzione consente a Platform di generare messaggi di errore dettagliati sui batch acquisiti. Se l'opzione Acquisizione parziale è attivata, la diagnostica avanzata degli errori viene applicata automaticamente.

La soglia di errore consente di impostare la percentuale di errori accettabili prima che l'intero batch abbia esito negativo. Per impostazione predefinita, questo valore è impostato su 5%.

Usa un set di dati esistente existing-dataset

Per utilizzare un set di dati esistente, inizia selezionandone uno. La barra laterale a destra contiene informazioni sul set di dati.

L'opzione Acquisizione parziale consente di abilitare o disabilitare l'utilizzo dell'acquisizione batch parziale.

L'interruttore Diagnostica errori viene visualizzato solo quando l'interruttore Acquisizione parziale è disattivato. Questa funzione consente a Platform di generare messaggi di errore dettagliati sui batch acquisiti. Se l'opzione Acquisizione parziale è attivata, la diagnostica avanzata degli errori viene applicata automaticamente.

La soglia di errore consente di impostare la percentuale di errori accettabili prima che l'intero batch abbia esito negativo. Per impostazione predefinita, questo valore è impostato su 5%.

Ora puoi caricare i dati utilizzando il pulsante Aggiungi dati, che verrà acquisito tramite l'acquisizione parziale.

Utilizza il flusso "Mappatura di CSV a schema XDM" map-flow

Per utilizzare il flusso "Mappare il file CSV su schema XDM", segui i passaggi elencati nell'esercitazione Mappare un file CSV. Una volta raggiunto il passaggio Aggiungi dati, prendi nota dei campi Acquisizione parziale e Diagnostica errori.

L'opzione Acquisizione parziale consente di abilitare o disabilitare l'utilizzo dell'acquisizione batch parziale.

L'interruttore Diagnostica errori viene visualizzato solo quando l'interruttore Acquisizione parziale è disattivato. Questa funzione consente a Platform di generare messaggi di errore dettagliati sui batch acquisiti. Se l'opzione Acquisizione parziale è attivata, la diagnostica avanzata degli errori viene applicata automaticamente.

Soglia di errore consente di impostare la percentuale di errori accettabili prima che l'intero batch abbia esito negativo. Per impostazione predefinita, questo valore è impostato su 5%.

Passaggi successivi next-steps

Questa esercitazione illustra come creare o modificare un set di dati per abilitare l’acquisizione in blocco parziale. Per ulteriori informazioni sull'acquisizione batch, consulta la guida per gli sviluppatori sull'acquisizione batch.

Per informazioni sul monitoraggio degli errori di acquisizione parziale, leggere la guida alla diagnostica degli errori di acquisizione batch.