Crea una connessione di origine Marketo Engage e un flusso di dati nell'interfaccia utente
Questa esercitazione descrive i passaggi per la creazione di un connettore di origine Marketo Engage (di seguito "Marketo") nell'interfaccia utente per l'inserimento di dati B2B in Adobe Experience Platform.
Introduzione
Questo tutorial richiede una buona conoscenza dei seguenti componenti di Adobe Experience Platform:
- Spazi dei nomi B2B e utilità di generazione automatica dello schema: gli spazi dei nomi B2B e l'utilità di generazione automatica dello schema consentono di utilizzare Postman per generare automaticamente i valori per gli spazi dei nomi B2B e gli schemi. Prima di creare una connessione di origine e un flusso di dati Marketo, è necessario completare gli spazi dei nomi e gli schemi B2B.
- Origini: Experience Platform consente di acquisire dati da varie origini e allo stesso tempo di strutturare, etichettare e migliorare i dati in arrivo tramite i servizi di Platform.
- Experience Data Model (XDM): framework standardizzato in base al quale Experience Platform organizza i dati sull'esperienza del cliente.
- Creare e modificare gli schemi nell'interfaccia utente: scopri come creare e modificare gli schemi nell'interfaccia utente.
- Spazi dei nomi di identità: gli spazi dei nomi di identità sono un componente di Identity Service che fungono da indicatori del contesto a cui si riferisce un'identità. Un’identità completa include un valore ID e uno spazio dei nomi.
- Real-Time Customer Profile: fornisce un profilo consumer unificato e in tempo reale basato su dati aggregati provenienti da più origini.
- Sandbox: Experience Platform fornisce sandbox virtuali che suddividono una singola istanza Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.
Raccogli le credenziali richieste
Per accedere all'account Marketo su Experience Platform, è necessario fornire i seguenti valori:
munchkinIdclientIdclientSecretPer ulteriori informazioni sull'acquisizione di questi valori, consultare la Marketo guida all'autenticazione.
Dopo aver raccolto le credenziali richieste, puoi seguire i passaggi descritti nella sezione successiva.
Connetti il tuo account Marketo
Nell'interfaccia utente di Platform, seleziona Origini dal menu di navigazione a sinistra per accedere all'area di lavoro Origini. 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 applicazioni di Adobe, selezionare Marketo Engage, quindi Aggiungi dati.
Viene visualizzata la pagina Connetti account di Marketo Engage. In questa pagina è possibile utilizzare un nuovo account o accedere a un account esistente.
Per creare un nuovo account, selezionare Nuovo account e fornire un nome, una descrizione facoltativa e le credenziali.
Al termine, selezionare Connetti all'origine e quindi attendere un po' di tempo per stabilire la nuova connessione.
Per utilizzare un account esistente, selezionare Account esistente, quindi selezionare l'account che si desidera utilizzare dal catalogo degli account esistente.
Seleziona Avanti per procedere.
Selezionare un set di dati
Dopo aver creato l'account Marketo, il passaggio successivo fornisce un'interfaccia per esplorare Marketo set di dati.
La metà sinistra dell'interfaccia è un browser di directory che visualizza i 10 Marketo set di dati. Una connessione di origine Marketo completamente funzionante richiede l'acquisizione dei nove diversi set di dati. Se utilizzi anche la funzione di marketing basato su account Marketo, devi creare anche un decimo flusso di dati per acquisire il set di dati Account denominati.
Seleziona il set di dati da acquisire. Questo aggiorna l’interfaccia in modo da visualizzare un’anteprima del set di dati. Al termine, selezionare Avanti.
Fornisci i dettagli del set di dati e del flusso di dati provide-dataset-and-dataflow-details
Quindi, devi fornire informazioni sul set di dati e sul flusso di dati.
Dettagli del set di dati dataset-details
Un set di dati è un costrutto di archiviazione e gestione per una raccolta di dati, in genere una tabella, che contiene uno schema (colonne) e dei campi (righe). I dati acquisiti correttamente in Experience Platform vengono memorizzati nel data lake come set di dati. Durante questo passaggio, puoi creare un nuovo set di dati o utilizzare un set di dati esistente.
Per utilizzare un nuovo set di dati, selezionare Nuovo set di dati, quindi specificare un nome e una descrizione facoltativa per il set di dati. Devi anche selezionare uno schema Experience Data Model (XDM) a cui aderisce il set di dati.
Se disponi già di un set di dati, seleziona Set di dati esistente e quindi utilizza l'opzione Ricerca avanzata per visualizzare una finestra di tutti i set di dati dell'organizzazione, inclusi i rispettivi dettagli, ad esempio se sono abilitati o meno per l'acquisizione in Real-Time Customer Profile.
Configurazioni del flusso di dati dataflow-configurations
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à.
Durante questo passaggio, puoi abilitare Flusso di dati di esempio per limitare l'acquisizione dei dati ed evitare costi aggiuntivi associati all'acquisizione di tutti i dati storici, incluse le identità delle persone.
Guida rapida all'utilizzo del flusso di dati di esempio
Il flusso di dati di esempio è una configurazione che puoi impostare per il flusso di dati Marketo in modo da limitare il tasso di acquisizione, quindi prova le funzionalità di Experience Platform senza dover acquisire grandi quantità di dati.
- Abilita il flusso di dati di esempio per limitare i dati storici acquisendo fino a 100.000 record (dal più grande ID record) o fino agli ultimi 10 giorni di attività durante il processo di backfill.
- Quando utilizzi la configurazione del flusso di dati di esempio per tutte le entità B2B, devi tenere presente che alcuni record correlati potrebbero mancare perché l’intera cronologia dei dati di origine non viene acquisita.
Inoltre, se si acquisiscono dati dal set di dati aziendali, è possibile abilitare Escludi account non rivendicati per escludere gli account non rivendicati dall'acquisizione.
Quando i singoli utenti compilano un modulo, Marketo crea un record account fantasma in base al Nome società che non contiene altri dati. Per i nuovi flussi di dati, l’opzione per escludere gli account non rivendicati è abilitata per impostazione predefinita. Per i flussi di dati esistenti, puoi abilitare o disabilitare la funzione, con le modifiche che si applicano ai dati appena acquisiti e non ai dati esistenti.
Mappa i campi di origine del set di dati Marketo ai campi XDM di destinazione
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.
Ogni set di dati Marketo ha le proprie regole di mappatura specifiche da seguire. Per ulteriori informazioni su come mappare Marketo set di dati su XDM, vedere:
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 di mappatura, consulta la Guida dell'interfaccia utente della preparazione dati.
Quando i set di mappatura sono pronti, seleziona Successivo e attendi alcuni istanti per la creazione del nuovo flusso di dati.
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 dell'entità di origine selezionata e la quantità di colonne all'interno di tale entità 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.
Dopo aver rivisto il flusso di dati, seleziona Salva e acquisisci e lascia un po' di tempo per la creazione del flusso di dati.
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 i flussi di dati, consulta l'esercitazione sul monitoraggio dei flussi di dati nell'interfaccia utente.
Eliminare gli attributi
Gli attributi personalizzati nei set di dati non possono essere nascosti o rimossi retroattivamente. Se desideri nascondere o rimuovere un attributo personalizzato da un set di dati esistente, devi creare un nuovo set di dati senza questo attributo personalizzato, un nuovo schema XDM e configurare un nuovo flusso di dati per il nuovo set di dati creato. È inoltre necessario disabilitare o eliminare il flusso di dati originale costituito dal set di dati con l’attributo personalizzato che si desidera nascondere o rimuovere.
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, vedere l'esercitazione sull'eliminazione di flussi di dati nell'interfaccia utente.
Passaggi successivi
Seguendo questa esercitazione, hai creato un flusso di dati per acquisire dati B2B dall'origine Marketo Engage all'Experience Platform.
Appendice appendix
Le sezioni seguenti forniscono ulteriori linee guida che è possibile seguire quando si utilizza l'origine Marketo.
Messaggi di errore nell’interfaccia utente error-messages
Quando Platform rileva dei problemi nella configurazione, nell’interfaccia vengono visualizzati i seguenti messaggi di errore:
Munchkin ID non è mappato all'organizzazione appropriata
L'autenticazione verrà negata se Munchkin ID non è mappato all'organizzazione Platform in uso. Configura la mappatura tra Munchkin ID e l'organizzazione utilizzando l'Marketo interfaccia.
Identità primaria mancante
Se manca un’identità primaria, il flusso di dati non viene salvato e acquisito. Prima di tentare di configurare un flusso di dati, assicurati che esista un'identità primaria nello schema XDM.
