[Beta]{class="badge informative"}
Acquisire dati batch da Talon.One in Experience Platform utilizzando l'interfaccia utente
L'origine Talon.One per i dati batch riceve gli eventi registrati per un'applicazione Talon.One. Un caso d'uso comune è quello di filtrare per talon_session_closed la ricezione di transazioni completate, inclusi punti fedeltà ottenuti o rimborsati, cedole rimborsate, sconti concessi e così via. Per ulteriori informazioni sull'API, leggere la Talon.One documentazione dell'API di gestione.
Segui questa esercitazione per scoprire come acquisire i dati batch dall'account Talon.One in Adobe Experience Platform utilizzando l'area di lavoro origini nell'interfaccia utente.
Introduzione
Questo tutorial richiede una buona conoscenza dei seguenti componenti di Experience Platform:
-
Experience Data Model (XDM) Sistema: framework standardizzato tramite il quale Experience Platform organizza i dati sull'esperienza del cliente.
- Nozioni di base sulla composizione dello schema: scopri i blocchi predefiniti di base degli schemi XDM, inclusi i principi chiave e le best practice nella composizione dello schema.
- Esercitazione sull'editor di schemi: scopri come creare schemi personalizzati utilizzando l'interfaccia utente dell'editor di schemi.
-
Real-Time Customer Profile: fornisce un profilo consumer unificato e in tempo reale basato su dati aggregati provenienti da più origini.
Navigare nel catalogo delle origini
Nell'interfaccia utente di Experience Platform, selezionare Sources dal menu di navigazione a sinistra per accedere all'area di lavoro Sources. Selezionare la categoria appropriata nel pannello Categories. In alternativa, utilizza la barra di ricerca per passare all’origine specifica che desideri utilizzare.
Per acquisire i dati da Talon.One, selezionare la scheda di origine Talon.One Batch Source Connector in Loyalty, quindi selezionare Add data.
Crea un nuovo account
Per creare un nuovo account per l'origine Talon.One, selezionare New account e fornire un nome e una descrizione facoltativa per l'account. Quindi, fornisci il dominio Talon.One e Talon.One Management API Key. Al termine, selezionare Connect to source e attendere alcuni istanti per consentire la connessione.
Usa un account esistente
Per utilizzare un account esistente, selezionare Existing account e selezionare l'account Talon.One che si desidera utilizzare dall'interfaccia account.
Selezionare i dati
Dopo aver eseguito l'autenticazione, fornire i valori per applicationId e sessionType. Durante questo passaggio, puoi utilizzare le funzionalità di anteprima per controllare la struttura dei dati. Al termine, selezionare Next per continuare.
talon_session_closed. Per informazioni dettagliate sul filtraggio degli eventi per tipo, fare riferimento al parametro di query "type" nella Talon.One documentazione API.
Configurare i dettagli del set di dati e del flusso di dati
Quindi, devi fornire informazioni relative al set di dati e al flusso di dati.
Dettagli set di dati
Un set di dati è un costrutto di archiviazione e gestione per una raccolta di dati, in genere una tabella, che contiene uno schema (colonne/campi) e record (righe). I dati acquisiti correttamente in Experience Platform vengono memorizzati nel data lake come set di dati.
Durante questo passaggio, puoi utilizzare un set di dati esistente o crearne uno nuovo.
Se il set di dati è abilitato per Real-Time Customer Profile, durante questo passaggio puoi attivare/disattivare Profile dataset per abilitare i dati per l'acquisizione del profilo. È inoltre possibile utilizzare questo passaggio per abilitare Error diagnostics e Partial ingestion.
- Error diagnostics: selezionare Error diagnostics per indicare all'origine di produrre diagnostica degli errori a cui fare successivamente riferimento durante il monitoraggio dell'attività del set di dati e dello stato del flusso di dati.
- Partial ingestion: l'acquisizione in batch parziale consente di acquisire dati contenenti errori, fino a una determinata soglia configurabile. Questa funzione consente di acquisire correttamente in Experience Platform tutti i dati accurati, mentre tutti i dati errati vengono raggruppati separatamente con informazioni sul motivo della validità.
Dettagli del flusso di dati
Una volta configurato il set di dati, devi quindi fornire dettagli sul flusso di dati, tra cui un nome, una descrizione facoltativa e le configurazioni degli avvisi.
Experience Platform può generare avvisi basati su eventi a cui gli utenti possono abbonarsi; queste opzioni consentono a un flusso di dati in esecuzione di attivarli. Per ulteriori informazioni, leggere la panoramica degli avvisi
- Inizio esecuzione flusso di dati origini: selezionare questo avviso per ricevere una notifica all'inizio dell'esecuzione del flusso di dati.
- Esecuzione del flusso di dati origini completata: selezionare questo avviso per ricevere una notifica se il flusso di dati termina senza errori.
- Errore di esecuzione del flusso di dati di origini: selezionare questo avviso per ricevere una notifica se l'esecuzione del flusso di dati termina con errori.
Mappatura
Con i dettagli del set di dati e del flusso di dati configurati, ora puoi procedere con la mappatura dei campi di dati di origine ai campi XDM di destinazione appropriati. Utilizza l’interfaccia di mappatura per mappare i dati di origine sui campi dello schema appropriati prima di acquisire i dati in Experience Platform. Per ulteriori informazioni, leggere la guida alla mappatura nell'interfaccia utente.
Pianificare l’acquisizione del flusso di dati
Viene visualizzato il passaggio Scheduling. Utilizza l’interfaccia per configurare una pianificazione di acquisizione in modo da acquisire automaticamente i dati di origine selezionati utilizzando le mappature configurate. Per impostazione predefinita, la pianificazione è impostata su Once. Per regolare la frequenza di acquisizione, selezionare Frequency, quindi selezionare un'opzione dal menu a discesa.
Se imposti la frequenza di acquisizione su Minute, Hour, Day o Week, devi impostare un intervallo per stabilire un intervallo di tempo impostato tra ogni acquisizione. Ad esempio, se la frequenza di acquisizione è impostata su Day e l'intervallo è impostato su 15, il flusso di dati verrà pianificato in modo da acquisire i dati ogni 15 giorni.
Durante questo passaggio, puoi anche abilitare backfill e definire una colonna per l'acquisizione incrementale dei dati. La retrocompilazione viene utilizzata per acquisire i dati storici, mentre la colonna definita per l’acquisizione incrementale consente di distinguere i nuovi dati dai dati esistenti.
Per ulteriori informazioni sulle configurazioni di pianificazione, consulta la tabella seguente.
Configura la frequenza per indicare la frequenza con cui deve essere eseguito il flusso di dati. Puoi impostare la frequenza su:
- Una volta: imposta la frequenza su
onceper creare un'acquisizione unica. Le configurazioni di intervallo e backfill non sono disponibili quando crei un flusso di dati di acquisizione una tantum. Per impostazione predefinita, la frequenza di pianificazione è impostata su una volta. - Minuti: imposta la frequenza su
minuteper pianificare il flusso di dati in modo da acquisire i dati al minuto. - Ora: imposta la frequenza su
hourper pianificare il flusso di dati per acquisire i dati su base oraria. - Giorno: imposta la frequenza su
dayper pianificare il flusso di dati in modo da acquisire i dati su base giornaliera. - Settimana: imposta la frequenza su
weekper pianificare il flusso di dati in modo da acquisire i dati su base settimanale.
Dopo aver selezionato una frequenza, puoi configurare l’impostazione dell’intervallo per stabilire l’intervallo di tempo tra ogni acquisizione. Ad esempio, se imposti la frequenza su giorno e configuri l’intervallo su 15, il flusso di dati verrà eseguito ogni 15 giorni. Impossibile impostare l'intervallo su zero. Il valore dell'intervallo minimo accettato per ciascuna frequenza è il seguente:
- Una volta: n/d
- Minuto: 15
- Ora: 1
- Giorno: 1
- Settimana: 1
Rivedi
Viene visualizzato il passaggio Review, che consente di rivedere i dettagli del flusso di dati prima che venga creato. I dettagli sono raggruppati nelle seguenti categorie:
- Connection: mostra il nome dell'account, la piattaforma di origine e il nome di origine.
- Assign dataset and map fields: mostra il set di dati di destinazione e lo schema a cui il set di dati aderisce.
Dopo aver confermato che i dettagli sono corretti, selezionare Finish.
Monitorare il flusso di dati
Una volta creato il flusso di dati, puoi monitorare i dati che vengono acquisiti tramite di esso per visualizzare informazioni su tassi di acquisizione, successo ed errori. Per ulteriori informazioni su come monitorare il flusso di dati, consulta l'esercitazione su account di monitoraggio e flussi di dati nell'interfaccia utente.
Limitazioni note
Durante il mapping dei dati dallo schema di Talon.One a Adobe Experience Platform, attualmente non è possibile acquisire più effetti dello stesso tipo in una singola transazione. Ad esempio, se una transazione include più effetti setDiscount (ad esempio sconti da campagne diverse), solo uno di questi effetti verrà mantenuto durante la mappatura e gli altri verranno sovrascritti.