Creare un Marketo Engage connessione di origine e flusso di dati per i dati di attività personalizzati nell’interfaccia utente

NOTE
Questa esercitazione fornisce passaggi specifici su come impostare e portare attività personalizzata dati da Marketo all'Experience Platform. Per i passaggi su come portare attività standard dati, leggi Marketo Guida all’interfaccia utente.

Oltre a attività standard, è inoltre possibile utilizzare Marketo per inserire dati di attività personalizzati in Adobe Experience Platform. Questo documento descrive come creare una connessione di origine e un flusso di dati per i dati delle attività personalizzate utilizzando 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: l’utility di generazione automatica degli spazi dei nomi B2B e dello schema consente di utilizzare Postman per generare automaticamente i valori per gli spazi dei nomi e gli schemi B2B. Prima di creare uno schema e uno spazio dei nomi B2B, devi completare Marketo connessione sorgente e flusso di dati.
  • Sorgenti: un Experience Platform consente di acquisire dati da varie origini, consentendoti allo stesso tempo di strutturare, etichettare e migliorare i dati in arrivo tramite i servizi di Platform.
  • Experience Data Model (XDM): framework standardizzato tramite il quale Experienci Platform organizza i dati sull’esperienza del cliente.
  • Spazi dei nomi delle 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: Experienci Platform fornisce sandbox virtuali che permettono di suddividere 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 importare dati di attività personalizzati da Marketo Ad Experience Platform, per recuperare il nome API e il nome visualizzato dell’attività personalizzata.

Accedi al tuo account utilizzando Marketo di rete. Nel menu di navigazione a sinistra, sotto 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.

L’interfaccia Attività personalizzate nell’interfaccia 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.

La pagina Dettagli campi attività personalizzati di Marketo nell’interfaccia utente del Marketo Engage.

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

In Schemi dashboard dell’interfaccia utente di Experienci Platform, seleziona Sfoglia e quindi seleziona Attività B2B dall’elenco degli schemi.

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

L’area di lavoro degli schemi nell’interfaccia utente Experienci Platform con lo schema di attività B2B selezionato.

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

Quindi, aggiungi un nuovo gruppo di campi al B2B Activity schema. 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, seleziona + Aggiungi accanto al Gruppi di campi pannello in Composizione.

Struttura dello schema.

Il Aggiungi gruppi di campi viene visualizzata la finestra. Seleziona Crea nuovo gruppo di campi quindi specifica lo stesso nome visualizzato per l’attività personalizzata recuperata in un passaggio precedente e, facoltativamente, una descrizione per il nuovo gruppo di campi. Al termine, seleziona 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 Gruppi di campi catalogo.

Struttura dello schema con un nuovo gruppo di campi aggiunto nel pannello 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. Una voce per Campo senza titolo | Tipo viene visualizzato. Quindi, configura le proprietà del campo utilizzando Proprietà campo pannello. Imposta il nome del campo come nome API dell'attività personalizzata e imposta il nome visualizzato come nome visualizzato dell'attività personalizzata. Quindi, impostate il tipo come object e assegna il gruppo di campi al gruppo di campi attività personalizzato creato nel passaggio precedente. Al termine, seleziona Applica.

La struttura dello schema con il segno più () selezionato per consentire laggiunta di 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.

Un gruppo di sottocampi aggiunti a un campo all’interno 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 Sorgenti dalla barra di navigazione a sinistra per accedere al Sorgenti Workspace. Il Catalogo Nella schermata vengono 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.

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

Catalogo delle origini nell’interfaccia utente di Experienci Platform con l’origine del Marketo Engage selezionata.

Selezionare i dati

Seleziona Attività dall’elenco di Marketo set di dati e quindi seleziona Successivo.

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

Dettagli del flusso di dati

Avanti, fornire informazioni per il flusso di dati, inclusi nomi e descrizioni per il set di dati e il flusso di dati, lo schema che verrà utilizzato e le configurazioni per Profile acquisizione, diagnostica degli errori e 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 di attività personalizzati, seleziona Nuovo tipo di campo e quindi seleziona Aggiungi nuovo campo.

Il 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, seleziona 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, seleziona Successivo.

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

Revisione

Il Revisione viene visualizzato un passaggio che consente di rivedere il nuovo flusso di dati prima di crearlo. I dettagli sono raggruppati nelle seguenti categorie:

  • Connessione: mostra il tipo di origine, il percorso pertinente dell’entità di origine scelta e l’importo delle colonne all’interno di tale entità di origine.
  • Assegna set di dati e mappa campi: mostra in quale set di dati vengono acquisiti i dati di origine, incluso lo schema a cui aderisce il set di dati.

Dopo aver rivisto il flusso di dati, seleziona Salva e acquisisci e lascia un po’ di tempo per creare il flusso di dati.

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

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 su aggiornamento dei flussi di dati nell’interfaccia utente.

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

Una volta completato il flusso di dati, puoi utilizzare Servizio query 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. Utilizzare eventType={API_NAME} per filtrare i dati di attività personalizzati.

SELECT * FROM with_custom_activities_ds_today WHERE eventType='aepCustomActivityDemo1'

Utilizza il IN clausola per filtrare più attività personalizzate:

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

L'immagine seguente mostra un esempio di istruzione SQL nella Editor query che filtra i dati di attività personalizzati.

Nell’interfaccia utente di Platform viene visualizzato un esempio di query per attività personalizzate.

Passaggi successivi

Seguendo questa esercitazione, hai impostato uno schema di Platform per Marketo ha personalizzato i dati di attività e creato un flusso di dati per trasferirli a Platform. Per informazioni generali su Marketo sorgente, leggi Marketo panoramica dell’origine.

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