Crea una connessione di origine Marketo Engage e un flusso di dati per i dati di attività personalizzati nell'interfaccia utente

NOTE
Questa esercitazione fornisce passaggi specifici su come impostare e portare all'Experience Platform dati attività personalizzati da Marketo. Per i passaggi su come portare i dati di attività standard, consulta la Marketo guida dell'interfaccia utente.

Oltre alle attività standard, puoi anche utilizzare l'origine Marketo per inserire dati di attività personalizzati in Adobe Experience Platform. In questo documento vengono descritti i passaggi necessari per creare una connessione di origine e un flusso di dati per i dati delle attività personalizzate utilizzando l'origine Marketo nell'interfaccia utente.

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.
  • 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.

Recuperare i dettagli dell’attività personalizzata

Il primo passaggio per portare i dati delle attività personalizzate da Marketo a Experience Platform consiste nel recuperare il nome API e il nome visualizzato dell'attività personalizzata.

Accedi al tuo account utilizzando l'interfaccia Marketo. Nel menu di navigazione a sinistra, in Database Management, seleziona Attività personalizzate Marketo.

L’interfaccia viene aggiornata con una visualizzazione delle attività personalizzate, che include informazioni sui rispettivi nomi visualizzati e nomi API. Puoi anche utilizzare la barra a destra per selezionare e visualizzare altre attività personalizzate dal tuo account.

Interfaccia attività personalizzata nellinterfaccia utente di Adobe Marketo Engage.

Seleziona Campi dall'intestazione superiore per visualizzare i campi associati all'attività personalizzata. In questa pagina puoi visualizzare i nomi, i nomi API, le descrizioni e i tipi di dati dei campi nell’attività personalizzata. I dettagli relativi ai singoli campi verranno utilizzati in un passaggio successivo, durante la creazione di uno schema.

Pagina Dettagli campi attività personalizzati di Marketo nellinterfaccia utente del Marketo Engage.

Impostare gruppi di campi per attività personalizzate nello schema delle attività B2B

Nel dashboard Schemi dell'interfaccia utente di Experience Platform, seleziona Sfoglia, quindi seleziona Attività B2B dall'elenco degli schemi.

TIP
Utilizza la barra di ricerca per accelerare la navigazione nell’elenco degli schemi.

Larea di lavoro degli schemi nellinterfaccia utente Experience Platform con lo schema di attività B2B selezionato.

Crea un nuovo gruppo di campi per l’attività personalizzata

Aggiungere quindi un nuovo gruppo di campi allo schema B2B Activity. Questo gruppo di campi deve corrispondere all’attività personalizzata che desideri acquisire e deve utilizzare il nome visualizzato dell’attività personalizzata recuperato in precedenza.

Per aggiungere un nuovo gruppo di campi, selezionare + Aggiungi accanto al pannello Gruppi di campi in Composizione.

Struttura dello schema.

Viene visualizzata la finestra Aggiungi gruppi di campi. Selezionare Crea nuovo gruppo di campi, quindi fornire lo stesso nome visualizzato per l'attività personalizzata recuperata in un passaggio precedente e fornire una descrizione facoltativa per il nuovo gruppo di campi. Al termine, selezionare Aggiungi gruppi di campi.

Finestra per letichettatura e la creazione di un nuovo gruppo di campi.

Una volta creato, il nuovo gruppo di campi per l'attività personalizzata viene visualizzato nel catalogo Gruppi di campi.

Struttura dello schema con un nuovo gruppo di campi aggiunto nel pannello del gruppo di campi.

Aggiungere un nuovo campo alla struttura dello schema

Quindi, aggiungi un nuovo campo allo schema. Questo nuovo campo deve essere impostato su type: object e conterrà i singoli campi dell'attività personalizzata.

Per aggiungere un nuovo campo, selezionare il segno più (+) accanto al nome dello schema. Voce per Campo senza titolo | Viene visualizzato il tipo. Quindi, configura le proprietà del campo utilizzando il pannello Proprietà campo. Imposta il nome del campo come nome API dell'attività personalizzata e imposta il nome visualizzato come nome visualizzato dell'attività personalizzata. Quindi, imposta il tipo come object e assegna il gruppo di campi al gruppo di campi attività personalizzato creato nel passaggio precedente. Al termine, selezionare Applica.

Struttura dello schema con il segno più () selezionato in modo da poter aggiungere un nuovo campo.

Il nuovo campo viene visualizzato nello schema.

È stato aggiunto un nuovo campo allo schema.

Aggiungi campi secondari al campo oggetto add-sub-fields-to-the-object-field

L’ultimo passaggio nella preparazione dello schema consiste nell’aggiungere singoli campi all’interno del campo creato nel passaggio precedente.

Gruppo di sottocampi aggiunto a un campo allinterno dello schema.

Creare un flusso di dati

Al termine dell’impostazione dello schema, ora puoi procedere con la creazione di un flusso di dati per i dati delle attività personalizzate.

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 con cui è possibile creare un account.

Puoi selezionare la categoria appropriata dal catalogo sul lato sinistro dello schermo. In alternativa, è possibile trovare la fonte specifica che si desidera utilizzare utilizzando la barra di ricerca.

Nella categoria applicazioni di Adobe, selezionare Marketo Engage. Quindi, seleziona Aggiungi dati per creare un nuovo flusso di dati Marketo.

Catalogo delle origini nellinterfaccia utente di Experience Platform con lorigine del Marketo Engage selezionata.

Selezionare i dati

Seleziona Attività dall'elenco di Marketo set di dati, quindi seleziona Successivo.

Il passaggio seleziona dati nel flusso di lavoro origini con il set di dati attività selezionato.

Dettaglio del flusso di dati

Quindi, fornisci informazioni per il flusso di dati, inclusi nomi e descrizioni per il set di dati e il flusso di dati, lo schema che utilizzerai e le configurazioni per l'acquisizione di Profile, la diagnostica degli errori e l'acquisizione parziale.

Passaggio dei dettagli del flusso di dati.

Mappatura

Le mappature per i campi attività standard vengono compilate automaticamente, ma i campi attività personalizzati devono essere mappati manualmente sui campi di destinazione corrispondenti.

Per iniziare a mappare i campi attività personalizzati, seleziona Nuovo tipo di campo, quindi seleziona Aggiungi nuovo campo.

Passaggio di mappatura con il menu a discesa per aggiungere un nuovo campo.

Passa alla struttura dei dati di origine e trova il campo attività personalizzato da acquisire. Al termine, selezionare Seleziona.

TIP
Per evitare confusione e gestire nomi di campo duplicati, i campi di attività personalizzati hanno il prefisso nome API.

Struttura dei dati di origine.

Per aggiungere un campo di destinazione, seleziona l'icona schema icona schema , quindi seleziona i campi di attività personalizzati dallo schema di destinazione.

Struttura dello schema di destinazione.

Ripeti i passaggi per aggiungere gli altri campi personalizzati di mappatura attività. Al termine, selezionare Avanti.

Tutte le mappature per i dati di origine e di destinazione.

Controlla

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.

Passaggio di revisione finale che riepiloga le informazioni sui campi di connessione, set di dati e mapping.

Aggiungere attività personalizzate a un flusso di dati di attività esistente add-to-existing-dataflows

Per aggiungere dati di attività personalizzati a un flusso di dati esistente, modifica le mappature di un flusso di dati di attività esistente con i dati di attività personalizzati che desideri acquisire. Questo consente di acquisire l’attività personalizzata nello stesso set di dati delle attività esistenti. Per ulteriori informazioni su come aggiornare le mappature di un flusso di dati esistente, consulta la guida sull'aggiornamento dei flussi di dati nell'interfaccia utente.

Utilizza Query Service per filtrare le attività per le attività personalizzate query-service-filter

Una volta completato il flusso di dati, puoi utilizzare Query Service per filtrare le attività in base ai dati delle attività personalizzate.

Quando le attività personalizzate vengono acquisite in Platform, il nome API dell'attività personalizzata diventa automaticamente il relativo eventType. Utilizza eventType={API_NAME} per filtrare i dati attività personalizzati.

SELECT * FROM with_custom_activities_ds_today WHERE eventType='aepCustomActivityDemo1'

Utilizzare la clausola IN per filtrare più attività personalizzate:

SELECT * FROM $datasetName WHERE eventType='{API_NAME}'
SELECT * FROM $datasetName WHERE eventType IN ('aepCustomActivityDemo1', 'aepCustomActivityDemo2')

Nell'immagine seguente viene mostrata un'istruzione SQL di esempio nell'Editor query che filtra i dati delle attività personalizzate.

Interfaccia utente di Platform che visualizza un esempio di query per le attività personalizzate.

Passaggi successivi

Seguendo questa esercitazione, hai impostato uno schema Platform per Marketo dati di attività personalizzati e hai creato un flusso di dati per portare tali dati in Platform. Per informazioni generali sull'origine Marketo, leggere la Marketo panoramica origine.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089