Documentazione Experience Platform Guida ai connettori di origini

Crea una connessione di origine Marketo Engage e un flusso di dati nell'interfaccia utente

Ultimo aggiornamento: 4 aprile 2025

Argomenti:

Creato per:

Sviluppatore

IMPORTANT

Prima di creare una connessione di origine Marketo Engage e un flusso di dati, è necessario verificare di aver mappato l'ID organizzazione Adobe in Marketo. Inoltre, devi anche assicurarti di aver completato la compilazione automatica dei tuoi Marketo spazi dei nomi e schemi B2B prima di creare una connessione di origine e un flusso di dati.

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 Experience 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 Experience Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.

Raccogli le credenziali richieste

Per accedere al tuo account Marketo su Experience Platform, devi fornire i seguenti valori:

Credenziali	Descrizione
`munchkinId`	L'ID Munchkin è l'identificatore univoco di un'istanza Marketo specifica.
`clientId`	ID client univoco dell'istanza Marketo.
`clientSecret`	Il segreto client univoco dell'istanza Marketo.

Per 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 Experience 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 Adobe, selezionare Marketo Engage, quindi Aggiungi dati.

TIP

Le origini nel catalogo delle origini visualizzano l'opzione Configura quando un'origine specificata non dispone ancora di un account autenticato. Quando esiste un account autenticato, questa opzione diventa Aggiungi dati.

Catalogo origini con origine Marketo Engage selezionata.

Viene visualizzata la pagina Connetti account Marketo Engage. In questa pagina è possibile utilizzare un nuovo account o accedere a un account esistente.

Crea un nuovo account

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.

Nuova interfaccia account per lautenticazione di un nuovo account Marketo.

Usa un account esistente

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.

Interfaccia account esistente in cui è possibile selezionare un account Marketo esistente.

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.

NOTE

Per motivi di brevità, nell'esercitazione seguente vengono utilizzate opportunità come esempio, ma i passaggi descritti di seguito si applicano a uno qualsiasi dei 10 Marketo set di dati.

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.

Interfaccia di anteprima

Fornisci i dettagli del set di dati e del flusso di dati

Quindi, devi fornire informazioni sul set di dati e sul flusso di dati.

Dettagli del 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) 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.

Utilizza un nuovo set di dati

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.

Nuova interfaccia di selezione del set di dati.

Utilizza un set di dati esistente

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.

Interfaccia di selezione del set di dati esistente.

Configurazioni del flusso di dati

IMPORTANT

L'origine Marketo utilizza l'acquisizione in batch per acquisire tutti i record storici e l'acquisizione in streaming per gli aggiornamenti in tempo reale. Questo consente all’origine di continuare lo streaming durante l’acquisizione di eventuali record errati. Abilita l'opzione Acquisizione parziale, quindi imposta la soglia di errore % su un valore massimo per evitare che il flusso di dati non riesca.

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.

recommendation-more-help

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 e provare 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.

La sezione relativa alle configurazioni del flusso di dati nella pagina dei dettagli del flusso di dati.

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.

Escludi account non rivendicati

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.

Interfaccia di mapping per i dati di Marketo.

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.

Pagina di revisione in cui puoi confermare i dettagli del flusso di dati prima dellacquisizione.

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 ad Experience Platform.

Appendice

Le sezioni seguenti forniscono ulteriori linee guida che è possibile seguire quando si utilizza l'origine Marketo.

Messaggi di errore nell’interfaccia utente

Quando Experience 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 Experience Platform in uso. Configura la mappatura tra Munchkin ID e l'organizzazione utilizzando l'Marketo interfaccia.

Messaggio di errore che indica che listanza di Marketo non è mappata correttamente allorganizzazione Adobe.

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.

Messaggio di errore che indica che lidentità primaria non è presente nello schema XDM.