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:

  • Acquisizione in batch: il metodo che Platform acquisisce e memorizza dati da file di dati, come CSV e Parquet.
  • Experience Data Model (XDM): il quadro standardizzato mediante il quale Platform organizza i dati sull’esperienza del cliente.

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

Lettura delle 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 il 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 esempi di chiamate API nel Experience Platform guida alla risoluzione dei problemi.

Raccogli i valori per le intestazioni richieste

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

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

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

  • x-sandbox-name: {SANDBOX_NAME}
NOTE
Per ulteriori informazioni sulle sandbox in Platform, vedere documentazione di panoramica sulla sandbox.

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

NOTE
Questa sezione descrive come abilitare un batch per l’acquisizione in blocco parziale utilizzando l’API. Per istruzioni sull’utilizzo dell’interfaccia utente, leggi la sezione abilitare un batch per l’acquisizione in blocco parziale nell’interfaccia utente passaggio.

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

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

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercent": 5
}
Proprietà
Descrizione
enableErrorDiagnostics
Un flag che consente Platform per generare messaggi di errore dettagliati sul batch.
partialIngestionPercent
Percentuale di errori accettabili prima che l'intero batch abbia esito negativo. Quindi, in questo esempio, un massimo del 5% del batch può essere un errore, prima che abbia esito negativo.

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

NOTE
Questa sezione descrive come abilitare un batch per l’acquisizione in blocco parziale tramite l’interfaccia utente di. Se hai già abilitato un batch per l’acquisizione in blocco parziale utilizzando l’API, puoi passare alla sezione successiva.

Per abilitare un batch per l’acquisizione parziale tramite Platform interfaccia utente, 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 il "Mappare il flusso CSV a XDM".

Crea una nuova connessione sorgente new-source

Per creare una nuova connessione sorgente, segui i passaggi elencati in Panoramica sulle origini. Una volta raggiunto il Dettagli del flusso di dati , prendi nota della Acquisizione parziale e Diagnostica degli errori campi.

Il Acquisizione parziale consente di abilitare o disabilitare l’utilizzo dell’acquisizione in blocco parziale.

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

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

Il Acquisizione parziale consente di abilitare o disabilitare l’utilizzo dell’acquisizione in blocco parziale.

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

Il 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 è possibile caricare i dati utilizzando Aggiungi dati e verrà acquisito tramite l’acquisizione parziale.

Utilizza la "Mappa lo schema CSV a XDMFlusso " map-flow

Per utilizzare la funzione "Mappa lo schema CSV a XDM", segui i passaggi elencati in Tutorial su come mappare un file CSV. Una volta raggiunto il Aggiungi dati , prendi nota della Acquisizione parziale e Diagnostica degli errori campi.

Il Acquisizione parziale consente di abilitare o disabilitare l’utilizzo dell’acquisizione in blocco parziale.

Il Diagnostica degli errori viene visualizzato solo quando Acquisizione parziale l'interruttore è disattivato. Questa funzione consente Platform per generare messaggi di errore dettagliati sui batch acquisiti. Se il Acquisizione parziale l'interruttore è attivato, 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 guida per gli sviluppatori sull’acquisizione batch.

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

recommendation-more-help
2ee14710-6ba4-4feb-9f79-0aad73102a9a