Creare un Marketo Engage connessione di origine e flusso di dati per i dati di attività personalizzati nell’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.
- Creare e modificare gli schemi nell’interfaccia utente: scopri come creare e modificare gli schemi nell’interfaccia utente di.
- 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.
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.
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.
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.
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.
Una volta creato, il nuovo gruppo di campi per l’attività personalizzata viene visualizzato nel Gruppi di campi catalogo.
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.
Il nuovo campo viene visualizzato nello 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.
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.
Selezionare i dati
Seleziona Attività dall’elenco di Marketo set di dati e quindi seleziona Successivo.
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.
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.
Passa alla struttura dei dati di origine e trova il campo attività personalizzato da acquisire. Al termine, seleziona Seleziona.
Per aggiungere un campo di destinazione, seleziona l’icona schema
Ripeti i passaggi per aggiungere gli altri campi personalizzati di mappatura attività. Al termine, seleziona Successivo.
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.
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.
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.