[Beta]{class="badge informative"}
Crea una connessione di origine Merkury Enterprise Identity Resolution e un flusso di dati nell'interfaccia utente
Questo tutorial illustra i passaggi necessari per creare una connessione di origine Merkury Enterprise Identity Resolution e un flusso di dati utilizzando l'interfaccia utente di Adobe Experience Platform.
Introduzione
Questo tutorial richiede una buona conoscenza dei seguenti componenti di Experience Platform:
-
Experience Data Model (XDM) Sistema: framework standardizzato in base al 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.
Raccogli le credenziali richieste
Per accedere al bucket in Experience Platform, devi fornire valori validi per le seguenti credenziali:
Per ulteriori informazioni sulla configurazione per Merkury e altri prerequisiti, leggere la Merkury panoramica origine.
Connetti il tuo account Merkury
Nell'interfaccia utente di Platform, seleziona Origini dalla barra di navigazione a sinistra per accedere all'area di lavoro Origini. Nella schermata Catalogo sono visualizzate diverse origini per le quali è possibile creare un account con.
Puoi selezionare la categoria appropriata dal catalogo sul lato sinistro dello schermo. In alternativa, è possibile trovare l’origine specifica che si desidera utilizzare utilizzando l’opzione di ricerca.
Nella categoria Partner dati, selezionare Merkury, quindi Configurazione.
Viene visualizzata la pagina Connetti a Merkury. In questa pagina è possibile utilizzare nuove credenziali o credenziali esistenti.
Crea un nuovo account
Se utilizzi nuove credenziali, seleziona Nuovo account. Nel modulo di input visualizzato, fornire un nome, una descrizione facoltativa e le credenziali Merkury. Al termine, selezionare Connetti all'origine e quindi attendere un po' di tempo per stabilire la nuova connessione.
Usa un account esistente
Per utilizzare un account esistente, selezionare Account esistente, quindi selezionare l'account Merkury che si desidera utilizzare. Seleziona Avanti per procedere.
Formati di file supportati
È possibile acquisire i seguenti formati di file con l'origine Merkury:
- Valori delimitatori separati (DSV): qualsiasi valore a carattere singolo può essere utilizzato come delimitatore per i file di dati in formato DSV.
- JavaScript Object Notation (JSON): i file di dati in formato JSON devono essere conformi a XDM.
- Apache Parquet: i file di dati in formato Parquet devono essere conformi a XDM.
- File compressi: JSON e file delimitati possono essere compressi come:
bzip2,gzip,deflate,zipDeflate,tarGzipetar.
Aggiungi dati
Dopo aver creato l'account Merkury, viene visualizzato il passaggio Aggiungi dati, che fornisce un'interfaccia per esplorare la gerarchia dei file Merkury e selezionare la cartella o il file specifico da portare in Experience Platform.
- La parte sinistra dell'interfaccia è un browser di directory, che visualizza la gerarchia dei file Merkury.
- La parte destra dell’interfaccia consente di visualizzare in anteprima fino a 100 righe di dati da una cartella o un file compatibile.
Seleziona la cartella principale per accedere alla gerarchia delle cartelle. Da qui, puoi selezionare una singola cartella per acquisire tutti i file in essa contenuti in modo ricorsivo. Quando acquisisci un’intera cartella, assicurati che tutti i file in essa contenuti condividano lo stesso formato e schema di dati.
Dopo aver selezionato una cartella, l’interfaccia a destra viene aggiornata con un’anteprima del contenuto e della struttura del primo file della cartella selezionata.
Durante questo passaggio, puoi effettuare diverse configurazioni dei dati prima di procedere. Selezionare innanzitutto Formato dati, quindi selezionare il formato dati appropriato per il file nel pannello a discesa visualizzato.
Nella tabella seguente vengono visualizzati i formati di dati appropriati per i tipi di file supportati:
Seleziona un delimitatore di colonna
Dopo aver configurato il formato dati, puoi impostare un delimitatore di colonna durante l’acquisizione di file delimitati. Selezionare l'opzione Delimitatore, quindi selezionare un delimitatore dal menu a discesa. Il menu visualizza le opzioni utilizzate più di frequente per i delimitatori, tra cui una virgola (,), una tabulazione (\t) e una barra verticale (|).
Se preferisci utilizzare un delimitatore personalizzato, seleziona Personalizzato e immetti un delimitatore a carattere singolo nella barra di input a comparsa.
Acquisire file compressi
Puoi anche acquisire file JSON o delimitati compressi specificandone il tipo di compressione.
Nel passaggio Seleziona dati, seleziona un file compresso per l'acquisizione, quindi seleziona il tipo di file appropriato e se è conforme o meno a XDM. Selezionare Tipo di compressione, quindi selezionare il tipo di file compresso appropriato per i dati di origine.
Per portare un file specifico su Platform, seleziona una cartella e quindi il file da acquisire. Durante questo passaggio, potete anche visualizzare in anteprima il contenuto di altri file all'interno di una determinata cartella utilizzando l'icona di anteprima accanto al nome di un file.
Al termine, selezionare Avanti.
Fornisci i dettagli del flusso di dati
La pagina Dettagli flusso di dati consente di scegliere se utilizzare un set di dati esistente o nuovo. Durante questo processo, puoi anche configurare i dati da acquisire nel profilo e abilitare impostazioni come Diagnostica errori, Acquisizione parziale e Avvisi.
Usa un set di dati esistente
Per acquisire dati in un set di dati esistente, seleziona Set di dati esistente. Puoi recuperare un set di dati esistente utilizzando l'opzione Ricerca avanzata oppure scorrendo l'elenco dei set di dati esistenti nel menu a discesa. Dopo aver selezionato un set di dati, fornisci un nome e una descrizione per il flusso di dati.
Utilizza un nuovo set di dati
Per acquisire in un nuovo set di dati, seleziona Nuovo set di dati, quindi fornisci un nome per il set di dati di output e una descrizione facoltativa. Quindi, seleziona uno schema a cui mappare utilizzando l'opzione Ricerca avanzata o scorrendo l'elenco degli schemi esistenti nel menu a discesa. Dopo aver selezionato uno schema, fornisci un nome e una descrizione per il flusso di dati.
Abilita diagnostica profili ed errori
Quindi, seleziona il Set di dati profilo per abilitare il set di dati per Real-Time Customer Profile. Questo consente di creare una vista olistica degli attributi e dei comportamenti di un’entità. I dati di tutti i set di dati abilitati per il profilo verranno inclusi nel profilo e le modifiche verranno applicate al momento del salvataggio del flusso di dati.
Diagnostica errori consente la generazione di messaggi di errore dettagliati per eventuali record errati che si verificano nel flusso di dati, mentre L'acquisizione parziale consente di acquisire dati contenenti errori, fino a una determinata soglia definita manualmente. Per ulteriori informazioni, consulta la panoramica sull'acquisizione batch parziale.
Abilita avvisi
Puoi abilitare gli avvisi per ricevere notifiche sullo stato del flusso di dati. Seleziona un avviso dall’elenco per abbonarti e ricevere notifiche sullo stato del flusso di dati. Per ulteriori informazioni sugli avvisi, consulta la guida su abbonamento agli avvisi di origini tramite l'interfaccia utente.
Dopo aver fornito i dettagli al flusso di dati, seleziona Avanti.
Mappare i campi dati su uno schema XDM
Viene visualizzato il passaggio Mappatura che fornisce un'interfaccia per mappare i campi sorgente dallo schema sorgente ai campi XDM di destinazione appropriati nello schema di destinazione.
Platform fornisce consigli intelligenti per campi mappati automaticamente in base allo schema o al set di dati di destinazione selezionato. Puoi regolare manualmente le regole di mappatura in base ai tuoi casi d’uso. In base alle tue esigenze, puoi scegliere di mappare i campi direttamente o utilizzare le funzioni di preparazione dati per trasformare i dati sorgente in modo da derivare valori calcolati o calcolati. Per i passaggi completi sull'utilizzo dell'interfaccia mapper e dei campi calcolati, consulta la guida dell'interfaccia utente della preparazione dati.
Una volta mappati correttamente i dati di origine, seleziona Avanti.
Pianificazione esecuzioni dell’acquisizione
Viene visualizzato il passaggio Pianificazione, che consente di configurare una pianificazione di acquisizione per 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
Al termine della configurazione della pianificazione di acquisizione, seleziona Avanti.
Verifica il flusso di dati
Viene visualizzato il passaggio Rivedi, che consente di rivedere il nuovo flusso di dati prima che venga creato. I dettagli sono raggruppati nelle seguenti categorie:
- Connessione: mostra il tipo di origine, il percorso pertinente del file di origine scelto e la quantità di colonne all'interno di tale file di origine.
- Assegna set di dati e mappa i campi: mostra in quale set di dati vengono acquisiti i dati di origine, incluso lo schema a cui il set di dati aderisce.
- Pianificazione: mostra il periodo, la frequenza e l'intervallo attivi della pianificazione di acquisizione.
Dopo aver rivisto il flusso di dati, fai clic su Fine e attendi un po' di tempo per la creazione del flusso di dati.
Passaggi successivi
Seguendo questa esercitazione, è stato creato un flusso di dati per portare i dati batch dall'origine Merkury all'Experience Platform. Per ulteriori risorse, consulta la documentazione descritta di seguito.
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, visita l'esercitazione su account di monitoraggio e flussi di dati nell'interfaccia utente.
Aggiornare il flusso di dati
Per aggiornare le configurazioni per la pianificazione, la mappatura e le informazioni generali dei flussi di dati, visita il tutorial su aggiornamento dei flussi di dati di origine nell'interfaccia utente
Eliminare il flusso di dati
È possibile eliminare i flussi di dati non più necessari o creati in modo errato utilizzando la funzione Elimina disponibile nell'area di lavoro Flussi di dati. Per ulteriori informazioni su come eliminare i flussi di dati, consulta l'esercitazione su eliminazione dei flussi di dati nell'interfaccia utente.