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:

  • Acquisizione batch: Il metodo che Platform acquisisce e memorizza i dati dai file di dati, come CSV e Parquet.
  • Experience Data Model (XDM): Il framework standardizzato in base al quale Platform vengono organizzati i dati sulla customer experience.

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

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 su come leggere le chiamate API di esempio nella guida alla risoluzione dei problemi di Experience Platform .

Raccogli i valori delle intestazioni richieste

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

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

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

  • nome x-sandbox: {SANDBOX_NAME}
NOTA

Per ulteriori informazioni sulle sandbox in Platform, consulta la documentazione di panoramica sandbox.

Abilitare un batch per l’acquisizione parziale dei 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, leggi il passaggio enable a batch for parziale ingestion (abilita un batch per l'acquisizione parziale) nell'interfaccia utente .

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

Per creare un nuovo batch, segui i passaggi descritti nella guida per gli sviluppatori di inserimento batch. Una volta raggiunto il passaggio Create batch, aggiungi il seguente campo all’interno del corpo della richiesta:

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercentage": 5
}
Proprietà Descrizione
enableErrorDiagnostics Flag che consente a Platform di generare messaggi di errore dettagliati sul batch.
partialIngestionPercentage 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 l'interfaccia utente Platform, puoi 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 "Map CSV to XDM flow".

Crea una nuova connessione sorgente

Per creare una nuova connessione sorgente, segui i passaggi elencati nella Panoramica delle sorgenti. Una volta raggiunto il passaggio Dataflow detail, prendi nota dei campi Partial ingestion e Error diagnostics .

L’opzione Partial ingestion consente di abilitare o disabilitare l’utilizzo dell’acquisizione batch parziale.

L'interruttore Error diagnostics viene visualizzato solo quando l'interruttore Partial ingestion è disattivato. Questa funzione consente a Platform di generare messaggi di errore dettagliati sui batch acquisiti. Se l'interruttore Partial ingestion è attivato, la diagnostica degli errori migliorata viene applicata automaticamente.

Il Error threshold consente di impostare la percentuale di errori accettabili prima che l'intero batch non riesca. Per impostazione predefinita, questo valore è impostato su 5%.

Utilizza 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.

L’opzione Partial ingestion consente di abilitare o disabilitare l’utilizzo dell’acquisizione batch parziale.

L'interruttore Error diagnostics viene visualizzato solo quando l'interruttore Partial ingestion è disattivato. Questa funzione consente a Platform di generare messaggi di errore dettagliati sui batch acquisiti. Se l'interruttore Partial ingestion è attivato, la diagnostica degli errori migliorata viene applicata automaticamente.

Il Error threshold consente di impostare la percentuale di errori accettabili prima che l'intero batch non riesca. Per impostazione predefinita, questo valore è impostato su 5%.

Ora è possibile caricare i dati utilizzando il pulsante Aggiungi dati e verranno acquisiti utilizzando l’acquisizione parziale.

Utilizzare il flusso "Map CSV to XDM schema"

Per utilizzare il flusso "Map CSV to XDM schema", segui i passaggi elencati nell' Esercitazione Mappa un file CSV. Una volta raggiunto il passaggio Add data, prendi nota dei campi Partial ingestion e Error diagnostics .

L’opzione Partial ingestion consente di abilitare o disabilitare l’utilizzo dell’acquisizione batch parziale.

L'interruttore Error diagnostics viene visualizzato solo quando l'interruttore Partial ingestion è disattivato. Questa funzione consente a Platform di generare messaggi di errore dettagliati sui batch acquisiti. Se l'interruttore Partial ingestion è attivato, la diagnostica degli errori migliorata viene applicata automaticamente.

Error threshold 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 batch, leggere la guida per sviluppatori per l'acquisizione batch.

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

In questa pagina