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 Guida di riferimento all’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, seleziona Origini dal menu di navigazione a sinistra per accedere all’area di lavoro Origini. Seleziona la categoria appropriata nel pannello Categorie. 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 Connettore Source Batch Talon.One in Fedeltà, quindi selezionare Aggiungi dati.
Crea un nuovo account
Per creare un nuovo account per l’origine Talon.One, selezionare Nuovo account e fornire un nome e una descrizione facoltativa per l’account. Quindi, fornisci il tuo dominio Talon.One e la tua chiave API di gestione Talon.One. Al termine, selezionare Connetti all’origine e attendere alcuni istanti prima di stabilire la connessione.
Usa un account esistente
Per utilizzare un account esistente, selezionare Account esistente 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 Avanti 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 il set di dati profilo per abilitare i dati per l’acquisizione del profilo. È inoltre possibile utilizzare questo passaggio per abilitare Diagnostica errori e Acquisizione parziale.
- Diagnostica errori: selezionare Diagnostica errori per indicare all’origine di produrre diagnostica errori a cui fare successivamente riferimento durante il monitoraggio dell’attività del set di dati e dello stato del flusso di dati.
- Acquisizione parziale: l’acquisizione parziale in batch 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 Pianificazione. 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, seleziona Frequenza, quindi scegli 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 Rivedi, che consente di rivedere i dettagli del flusso di dati prima che venga creato. I dettagli sono raggruppati nelle seguenti categorie:
- Connessione: mostra il nome dell’account, la piattaforma di origine e il nome dell’origine.
- Assegna set di dati e mappa campi: mostra il set di dati di destinazione e lo schema a cui il set di dati è conforme.
Dopo aver confermato che i dettagli sono corretti, selezionare Fine.
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.