Acquisizione batch parziale

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

Questo documento fornisce un'esercitazione per la gestione dell'acquisizione batch parziale.

Introduzione

Questa esercitazione richiede una buona conoscenza dei vari servizi Adobe Experience Platform coinvolti nell’acquisizione parziale dei batch. Prima di iniziare questa esercitazione, consulta la documentazione relativa ai seguenti servizi:

Le sezioni seguenti forniscono informazioni aggiuntive che sarà necessario conoscere per effettuare correttamente le chiamate a Platform API.

Lettura di chiamate API di esempio

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

Raccogli i valori delle intestazioni richieste

Per effettuare chiamate a Platform API, devi prima completare l’ esercitazione sull'autenticazione. Il completamento dell’esercitazione sull’autenticazione fornisce i valori per ciascuna delle intestazioni richieste in tutte le Experience Platform Chiamate API, come mostrato di seguito:

  • Autorizzazione: Portatore {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

Tutte le risorse in Experience Platform sono isolate in sandbox virtuali specifiche. Tutte le richieste a Platform Le API richiedono un’intestazione che specifichi il nome della sandbox in cui avrà luogo l’operazione:

  • x-sandbox-name: {SANDBOX_NAME}
NOTA

Per ulteriori informazioni sulle sandbox in Platform, vedi documentazione panoramica su sandbox.

Abilitare un batch per l’acquisizione parziale in batch nell’API

NOTA

In questa sezione viene descritta l’abilitazione di un batch per l’acquisizione parziale dei batch utilizzando l’API. Per istruzioni sull'utilizzo dell'interfaccia utente, leggere il abilitare un batch per l’acquisizione parziale in batch nell’interfaccia utente passo.

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

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

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercent": 5
}
Proprietà Descrizione
enableErrorDiagnostics Flag che consente Platform per generare messaggi di errore dettagliati sul batch.
partialIngestionPercent La percentuale di errori accettabili prima dell'intero batch non riuscirà. Quindi, in questo esempio, un massimo del 5% del batch può essere errori, prima che fallisca.

Abilitare un batch per l’acquisizione parziale in batch nell’interfaccia utente

NOTA

In questa sezione viene descritta l’abilitazione di un batch per l’acquisizione parziale in batch tramite l’interfaccia utente. Se hai già abilitato un batch per l’inserimento parziale dei batch utilizzando l’API, puoi passare alla sezione successiva.

Per abilitare un batch all’acquisizione parziale tramite Platform Nell’interfaccia utente, puoi creare un nuovo batch tramite connessioni sorgente, creare un nuovo batch in un set di dati esistente o creare un nuovo batch tramite "Flusso da CSV a XDM".

Crea una nuova connessione sorgente

Per creare una nuova connessione sorgente, segui i passaggi elencati nella sezione Panoramica delle origini. Una volta raggiunto il Dettaglio flusso di dati , prendere atto del Acquisizione parziale e Diagnostica degli errori campi.

La Acquisizione parziale consente di abilitare o disabilitare l’utilizzo dell’acquisizione batch parziale.

La Diagnostica degli errori compare solo quando Acquisizione parziale l'interruttore è disattivato. Questa funzione consente Platform per generare messaggi di errore dettagliati sui batch acquisiti. Se la Acquisizione parziale l’opzione è attivata, la diagnostica degli errori migliorata viene applicata automaticamente.

La Soglia di errore consente di impostare la percentuale di errori accettabili prima che l’intero batch non riesca. Per impostazione predefinita, questo valore è impostato su 5%.

Utilizzare un set di dati esistente

Per utilizzare un set di dati esistente, inizia selezionando un set di dati. La barra laterale a destra si riempie di informazioni sul set di dati.

La Acquisizione parziale consente di abilitare o disabilitare l’utilizzo dell’acquisizione batch parziale.

La Diagnostica degli errori compare solo quando Acquisizione parziale l'interruttore è disattivato. Questa funzione consente Platform per generare messaggi di errore dettagliati sui batch acquisiti. Se la Acquisizione parziale l’opzione è attivata, la diagnostica degli errori migliorata viene applicata automaticamente.

La Soglia di errore consente di impostare la percentuale di errori accettabili prima che l’intero batch non riesca. Per impostazione predefinita, questo valore è impostato su 5%.

Ora puoi caricare i dati utilizzando la Aggiungi dati e verrà acquisito tramite acquisizione parziale.

Utilizza il "Mappatura di CSV su schema XDM" flusso

Per utilizzare "Mappatura di CSV su schema XDM" flusso, segui i passaggi elencati nel Esercitazione sulla mappatura di un file CSV. Una volta raggiunto il Aggiungi dati , prendere atto del Acquisizione parziale e Diagnostica degli errori campi.

La Acquisizione parziale consente di abilitare o disabilitare l’utilizzo dell’acquisizione batch parziale.

La Diagnostica degli errori compare solo quando Acquisizione parziale l'interruttore è disattivato. Questa funzione consente Platform per generare messaggi di errore dettagliati sui batch acquisiti. Se la Acquisizione parziale l’opzione è attivata, la diagnostica degli errori migliorata viene applicata automaticamente.

Soglia di errore consente di impostare la percentuale di errori accettabili prima che l’intero batch non riesca. Per impostazione predefinita, questo valore è impostato su 5%.

Passaggi successivi

Questa esercitazione spiega come creare o modificare un set di dati per abilitare l’acquisizione parziale di batch. Per ulteriori informazioni sull’acquisizione in batch, leggere il guida per gli sviluppatori di batch ingestion.

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

In questa pagina