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:

  • Caricamento batch: 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 dei clienti.

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, consultate la sezione relativa a come leggere chiamate API di esempio nella guida alla risoluzione dei problemi di Experience Platform.

Raccogli valori per le intestazioni richieste

Per effettuare chiamate alle Platform API, è innanzitutto necessario completare l'esercitazione sull'autenticazione a2/>. Completando l'esercitazione sull'autenticazione, vengono forniti i valori per ciascuna delle intestazioni richieste in tutte le chiamate API Experience Platform, 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 verrà eseguita l'operazione:

  • x-sandbox-name: {SANDBOX_NAME}
NOTA

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

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

NOTA

Questa sezione descrive come abilitare un batch per l'assimilazione parziale dei batch mediante l'API. Per istruzioni sull'utilizzo dell'interfaccia utente, leggere il passaggio abilita un 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, seguire i passaggi descritti nella guida per gli sviluppatori di assimilazione batch. Una volta raggiunto il passaggio Create batch, aggiungete 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 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'inserimento parziale dei batch nell'interfaccia utente

NOTA

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 tramite l'interfaccia utente di Platform, è possibile creare un nuovo batch mediante connessioni di origine, creare un nuovo batch in un dataset esistente o creare un nuovo batch tramite "Map CSV to XDM flow".

Creare una nuova connessione di origine

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

L'interruttore Partial ingestion consente di abilitare o disabilitare l'inserimento parziale dei batch.

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 da inserire. Se l'interruttore Partial ingestion è 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%.

Utilizza un set di dati 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'interruttore Partial ingestion consente di abilitare o disabilitare l'inserimento parziale dei batch.

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 da inserire. Se l'interruttore Partial ingestion è 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%.

Ora puoi caricare i dati utilizzando il pulsante Aggiungi dati, che verrà assimilato parzialmente.

Utilizzare il flusso "Map CSV to XDM schema"

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

L'interruttore Partial ingestion consente di abilitare o disabilitare l'inserimento parziale dei batch.

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 da inserire. Se l'interruttore Partial ingestion è 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 di assimilazione batch.

Per informazioni sul monitoraggio degli errori di assimilazione parziale, leggere la guida per la diagnostica degli errori di caricamento batch.

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now