Iniezione parziale del batch

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

Questo documento fornisce un’esercitazione per la gestione dell’assimilazione parziale dei batch.

Introduzione

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

  • Caricamentobatch: Metodo che Platform raccoglie e memorizza i dati dai file di dati, come CSV e Parquet.
  • Experience Data Model (XDM): Il framework standard con cui Platform organizzare i dati relativi all'esperienza del cliente.

Le sezioni seguenti forniscono informazioni aggiuntive che sarà necessario conoscere per eseguire correttamente le chiamate alle 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 richieste formattati correttamente. Viene inoltre fornito un JSON di esempio restituito nelle risposte API. Per informazioni sulle convenzioni utilizzate nella documentazione per le chiamate API di esempio, vedete la sezione come leggere chiamate API di esempio nella guida alla Experience Platform risoluzione dei problemi.

Raccogli valori per le intestazioni richieste

Per effettuare chiamate alle Platform API, è prima necessario completare l'esercitazione sull'autenticazione. Completando l'esercitazione sull'autenticazione, vengono forniti i valori per ciascuna delle intestazioni richieste in tutte le chiamate Experience Platform API, come illustrato 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 Platform API richiedono un'intestazione che specifica il nome della sandbox in cui avrà luogo l'operazione:

  • x-sandbox-name: {SANDBOX_NAME}
NOTE

Per ulteriori informazioni sulle sandbox in Platform, consultate la documentazione sulla panoramica dellasandbox.

Abilitare un batch per l'assimilazione parziale dei batch nell'API

NOTE

Questa sezione descrive come abilitare un batch per l'assimilazione parziale dei batch mediante l'API. Per istruzioni sull’utilizzo dell’interfaccia utente, leggete il passaggio Abilita batch per l’inserimento parziale dei batch nell’interfaccia utente .

Potete creare un nuovo batch con l’assimilazione parziale abilitata.

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

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercentage": 5
}
Proprietà Descrizione
enableErrorDiagnostics Flag che consente Platform di generare messaggi di errore dettagliati sul batch.
partialIngestionPercentage Percentuale di errori accettabili prima che l'intero batch non riesca. Quindi, in questo esempio, un massimo del 5% del batch può essere costituito da errori, prima che venga meno.

Abilitare un batch per l’assimilazione parziale dei batch nell’interfaccia utente

NOTE

Questa sezione descrive come abilitare un batch per l’assimilazione parziale dei batch utilizzando l’interfaccia utente. Se avete già attivato un batch per l'assimilazione parziale dei batch utilizzando l'API, potete passare alla sezione successiva.

Per abilitare un batch per l’assimilazione parziale nell’ Platform interfaccia utente, potete creare un nuovo batch tramite connessioni sorgente, creare un nuovo batch in un set di dati esistente o creare un nuovo batch tramite ilMap CSV to XDM flow".

Creare una nuova connessione di origine

Per creare una nuova connessione di origine, segui i passaggi elencati nella panoramica Origini. Una volta raggiunto il Dataflow detail passaggio, prendete nota dei Partial ingestion campi e Error diagnostics .

L’ Partial ingestion interruttore consente di attivare o disattivare l’inserimento parziale dei batch.

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

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

Utilizzare un dataset esistente

Per utilizzare un set di dati esistente, iniziare selezionando un set di dati. La barra laterale a destra include informazioni sul set di dati.

L’ Partial ingestion interruttore consente di attivare o disattivare l’inserimento parziale dei batch.

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

Consente di Error threshold 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 tramite il pulsante Aggiungi dati e li assimilerai parzialmente.

Utilizzare il flusso "Map CSV to XDM schema"

Per usare il flussoMap CSV to XDM schema"di prova", segui i passaggi elencati nell’esercitazione Mappa un file CSV. Una volta raggiunto il Add data passaggio, prendete nota dei Partial ingestion campi e Error diagnostics .

L’ Partial ingestion interruttore consente di attivare o disattivare l’inserimento parziale dei batch.

L' Error diagnostics interruttore viene visualizzato solo quando l' Partial ingestion interruttore è disattivato. Questa funzione consente Platform di generare messaggi di errore dettagliati sui batch acquisiti. Se l' Partial ingestion interruttore è attivato, la diagnostica degli errori avanzata 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

In questa esercitazione è stato illustrato come creare o modificare un dataset per abilitare l’assimilazione parziale dei batch. Per ulteriori informazioni sull'assimilazione batch, leggere la guida per gli sviluppatori diinserimento batch.

Per informazioni sul monitoraggio degli errori di assimilazione parziale, consultate la guida alla diagnostica degli errori di assimilazionebatch.

In questa pagina