Su AgentExchange (precedentemente AppExchange) per Marketing Cloud Engagement è apparso un nuovo tool chiamato Marketing Cloud Schema Explorer, fornito da Salesforce Labs.
Nota: i prodotti Salesforce Labs sono sviluppati dai dipendenti Salesforce come parte del loro lavoro o delle loro attività nella community, e non sono prodotti Salesforce ufficiali. Tieni presente quindi che non sono coperti dal supporto Salesforce ufficiale.
Questo tool è pensato per visualizzare le strutture dei dati e consente di verificare, ad esempio:
- Le dipendenze tra Data Extension
- Le relazioni tra Journey e Data Extension
- Diversi tipi di analisi d’impatto
- Le relazioni di riferimento tra gli oggetti
Se utilizzi Marketing Cloud Engagement da molti anni, probabilmente hai già dedicato parecchio tempo a domande come:
- “Da dove viene aggiornata questa Data Extension?”
- “Cosa verrebbe impattato se modificassi questa Query?”
Ed è proprio qui che questo tool può rivelarsi utile.
Si tratta di un tool relativamente nuovo, appena rilasciato il 10 aprile 2026, ma essendo un prodotto Salesforce Labs è disponibile gratuitamente.
L’installazione avviene a proprio rischio, ma se dopo aver letto questo articolo pensi che sia proprio il tipo di funzionalità che stavi aspettando, puoi installarlo seguendo i passaggi indicati di seguito.
Passaggi di configurazione
Configurazione in Marketing Cloud Engagement
1. Dalla schermata Setup di Marketing Cloud Engagement, naviga fino a:
- Platform Tools > Apps > Installed Packages
2. Crea un nuovo package.
3. Il nome del package può essere quello che preferisci.
- Ad esempio: Schema Explorer
4. Scorri verso il basso nell’Installed Package appena creato e clicca su Add Component.
5. Seleziona API Integration come tipo di componente.
6. Seleziona Web App come tipo di integrazione.
Configurazione API Integration
7. Imposta il seguente valore come Redirect URI: https://schema.somil.org/auth/callback
Configurazione OAuth Scope
8. Abilita i seguenti permessi:
- Email: Read
- Web: Read
- Documents and Images: Read
- Saved Content: Read
- Automations: Read
- Journeys: Read
- Audiences: Read
- List and Subscribers: Read
- Market Audience: View
- Data Extensions: Read
- File Locations: Read
- Assets: Read
Recupero delle informazioni del package
9. Dopo aver salvato la configurazione, annota le seguenti informazioni:
- Client ID
- Client Secret
- Authentication Base URI
Esempio: https://your-subdomain.auth.marketingcloudapis.com - Account ID (Business Unit MID)
Registrazione in Schema Explorer
1. Una volta registrato l’Installed Package e annotate tutte le informazioni necessarie, puoi procedere con l’installazione.
2. Spunta la casella e clicca su Visit Provider.
3. Inserisci il tuo subdomain e il MID (Business Unit ID), poi prosegui.
- Il subdomain corrisponde alla parte seguente dell’Authentication Base URI annotato precedentemente:
Esempio: https://your-subdomain.auth.marketingcloudapis.com
4. Inserisci le seguenti informazioni e completa la registrazione:
- Nome dell’organizzazione
- Email di contatto (il tuo indirizzo email)
- Business Unit ID (MID)
- Auth Base URI corrispondente al tuo subdomain di Marketing Cloud
- Subdomain di Marketing Cloud
- Client ID
- Client Secret
Dopo la registrazione
1. Una volta inviato il modulo, Schema Explorer registra l’applicazione OAuth. Procedi con il login.
2. Clicca sul pulsante di login.
3. Se sei già loggato in Marketing Cloud Engagement, puoi accedere direttamente a Schema Explorer.
Se invece la sessione è scaduta, verrai reindirizzato alla schermata di login di Marketing Cloud Engagement. Effettua qui l’accesso utilizzando le tue credenziali di Marketing Cloud Engagement.
4. Completato il login, si aprirà la pagina di Schema Explorer. Aprendo la tab Insights, potrai verificare la tua Business Unit.
È utile salvare questo URL nei preferiti: da questo momento potrai accedere semplicemente utilizzando il tuo subdomain e le tue credenziali di autenticazione di Marketing Cloud Engagement.
5. Dalla tab Object Explorer puoi avviare la sincronizzazione con il tuo account.
6. Dopo un’attesa di circa 30 minuti, la sincronizzazione dei dati inizierà.
La sincronizzazione iniziale richiede un po’ di tempo. Da quel momento in poi, la sincronizzazione avverrà automaticamente a ogni login.
Cosa si può fare con Schema Explorer?
Completata la sincronizzazione dei dati, vediamo concretamente cosa si può fare con Marketing Cloud Schema Explorer.
Quando Marketing Cloud Engagement viene utilizzato per lungo tempo, asset come Data Extension, Query, Automation, Journey ed Email continuano ad accumularsi.
Di conseguenza, ci si trova sempre più spesso a dover investigare domande come:
- “Dove viene utilizzata questa Data Extension?”
- “È sicuro modificare questo campo?”
- “Vorrei vedere in un unico posto tutte le Automation e le Journey attive oggi.”
- “Ci sono ancora molte Data Extension inutilizzate?”
Schema Explorer può essere descritto come un tool progettato per supportare questo tipo di investigazione e la gestione operativa quotidiana.
Il ruolo di questo tool può essere sintetizzato attorno a queste quattro domande principali:
- Cosa abbiamo? — Cosa è collegato a cosa?
- Cosa sta succedendo oggi? — Qual è la situazione operativa attuale?
- Cosa si romperebbe se cambiassimo qualcosa? — Quali sarebbero gli impatti di una modifica?
- Cosa richiede attenzione? — Cosa devo verificare ora?
Vediamo ciascuna di queste aree.
① Object Explorer — Cosa è collegato a cosa?
La funzionalità principale è Object Explorer.
Object Explorer permette di esaminare i vari asset presenti in Marketing Cloud Engagement e di investigarne le dipendenze e le relazioni di riferimento.
Ad esempio, è possibile vedere come asset come:
- Data Extension
- Query
- Automation
- Journey
siano collegati tra loro.
Quando Marketing Cloud Engagement viene utilizzato da lungo tempo, una preoccupazione comune è:
- “È sicuro eliminare questa Data Extension?”
Anche se una Data Extension sembra non essere utilizzata, potrebbe in realtà essere richiamata da una Query oppure utilizzata da un’Automation, una Journey o un altro asset.
Prima di eliminarla, quindi, occorre verificare uno per uno gli asset correlati, un’operazione che può richiedere sorprendentemente molto tempo.
Con Object Explorer è possibile verificare visivamente dove le Data Extension e gli altri asset vengono utilizzati o richiamati.
In altre parole, è utile quando si deve investigare:
- “È davvero sicuro eliminare questa Data Extension?”
② Today — Cosa sta succedendo oggi?
Today è una dashboard che permette di rivedere in un unico posto lo stato operativo giornaliero di Marketing Cloud Engagement.
In Marketing Cloud Engagement, ogni giorno vengono eseguiti numerosi invii email, Automation, Journey e altri processi.
Invece di verificare ognuno singolarmente, Today permette di avere una visione d’insieme della giornata.
Ad esempio, si può verificare:
- Cosa è stato inviato oggi
- Cosa è attualmente in esecuzione
- Cosa è programmato per l’esecuzione successiva
- Le email che oggi stanno ricevendo un engagement particolarmente elevato
In altre parole, è una schermata pensata per rispondere alla domanda:
- “Cosa sta succedendo oggi in Marketing Cloud?”
Per gli amministratori e gli operatori di Marketing Cloud Engagement, può quindi essere utilizzata come dashboard per il controllo dello stato operativo quotidiano.
③ Field Impact — Cosa verrebbe impattato?
Personalmente, una delle funzionalità che considero particolarmente utile per le operazioni su Marketing Cloud Engagement è Field Impact.
Supponiamo, ad esempio, che una Data Extension contenga il seguente campo:
- FirstName
Se si vuole modificare il nome o la struttura di questo campo, semplicemente cambiare la Data Extension potrebbe non essere sufficiente.
Questo perché il campo potrebbe essere richiamato da:
- Query SQL
- AMPscript
- SSJS
- Altri asset correlati
Se la modifica viene effettuata senza rendersi conto che il campo è richiamato altrove, le Query SQL potrebbero non funzionare più, oppure la personalizzazione delle email potrebbe interrompersi.
Con Field Impact è possibile verificare quali asset utilizzano un determinato elemento o campo.
In altre parole, questa funzionalità permette di investigare in anticipo:
- “Se modifico questo campo, cosa verrebbe impattato?”
Può essere utilizzata per l’analisi d’impatto prima di effettuare modifiche in un ambiente di produzione di Marketing Cloud Engagement.
④ Insights / Risk Intelligence — Cosa richiede attenzione?
Quando Marketing Cloud Engagement viene utilizzato per un lungo periodo di tempo, asset come Data Extension, Query, Automation ed Email continuano ad aumentare.
Di conseguenza, asset non più utilizzati o configurazioni che dovrebbero essere rivisitate dal punto di vista operativo possono rimanere nell’ambiente senza che nessuno se ne accorga.
Insights / Risk Intelligence è una funzionalità progettata per individuare questo tipo di rischi operativi e di governance.
Ad esempio, è in grado di rilevare elementi come:
- Data Extension non utilizzate
- Query Activity con problemi nella Data Extension di origine o destinazione
- Contenuti privi di impostazioni di fallback per la Personalizzazione
- Contenuti che contengono parole chiave configurate come oggetto di rischio
- Automation inattive
- Contenuti non aggiornati da lungo tempo
È difficile, per una persona, rivedere periodicamente l’intero ambiente di Marketing Cloud Engagement e identificare manualmente tutti questi elementi.
Utilizzando Schema Explorer, diventa più semplice individuare:
- “Cosa dovrei verificare proprio ora in questo ambiente?”
Più che una semplice visualizzazione degli asset, può quindi essere utilizzata come funzionalità per organizzare e migliorare continuamente il proprio ambiente Marketing Cloud Engagement.
Extra: MC Next Readiness — Preparazione alla migrazione
Marketing Cloud Schema Explorer include anche una funzionalità chiamata MC Next Readiness, che analizza quanto il proprio ambiente Marketing Cloud Engagement attuale sia pronto per la migrazione a Marketing Cloud Next.
Questa funzionalità analizza le Data Extension attualmente in uso e aiuta a determinare come ciascuna di esse dovrebbe essere gestita in Marketing Cloud Next.
Ad esempio, ogni Data Extension viene classificata in categorie come le seguenti:
- Sendable
Candidata per il mapping a Contact Point Email DMO o Contact Point Phone DMO. - Lookup
Candidata per il mapping a un DMO correlato o a un oggetto custom. - Suppression
Candidata per la migrazione a record relativi a consensi o preferenze. - Transactional
Candidata per la migrazione a flow trigger o messaggistica event-driven. - Staging
Candidata per una riprogettazione tramite Data Stream, calcoli, flow intermedi o meccanismi simili. - Transit
Utilizzata per il passaggio di dati tra step di elaborazione, potrebbe richiedere una riprogettazione tramite Data Cloud o Flow. - Archive
Candidata che potrebbe essere ritirata senza migrazione. - Mixed Use
Utilizzata per più scopi, potenzialmente da suddividere prima della migrazione a Marketing Cloud Next. - Unknown
Informazioni insufficienti per una classificazione automatica: è necessaria una verifica manuale.
Inoltre, per ogni Data Extension è possibile consultare informazioni come Confidence (livello di affidabilità della classificazione), Readiness (grado di preparazione alla migrazione) e Recommended Target (destinazione di migrazione consigliata).
Ad esempio, per una Data Extension sendable si potrebbe vedere:
- Recommended Target: Contact Point Email DMO
In questo modo, il tool arriva a suggerire persino il modello dati che si prevede di utilizzare in Marketing Cloud Next.
Non si limita però a classificare le Data Extension: tenendo conto delle dipendenze, è in grado di identificare le Data Extension con relativamente poche dipendenze, che potrebbero essere adatte a una migrazione in una fase più precoce, come candidate per una Migration Wave.
Nella migrazione da Marketing Cloud Engagement a Marketing Cloud Next, non si tratta semplicemente di migrare ogni Data Extension tale e quale.
Occorre prendere decisioni come:
- “Con cosa dovrebbe essere sostituita questa Data Extension in Marketing Cloud Next?”
- “Questa Data Extension deve davvero essere migrata?”
- “Da quali Data Extension dovremmo iniziare la migrazione?”
Il modo più semplice per inquadrare MC Next Readiness è quindi come una funzionalità di supporto a questo tipo di inventario pre-migrazione e di pianificazione della migrazione stessa.
Non è solo un tool per visualizzare le dipendenze
Dal nome, si potrebbe pensare che Marketing Cloud Schema Explorer sia semplicemente un tool per verificare le strutture dati e le dipendenze in Marketing Cloud.
In realtà, osservando le funzionalità effettivamente offerte, il tool va ben oltre.
- Usa Object Explorer per comprendere la struttura attuale.
- Usa Today per verificare lo stato operativo quotidiano.
- Usa Field Impact per investigare l’impatto prima di effettuare modifiche.
- Usa Insights / Risk Intelligence per individuare potenziali problematiche.
Il modo più corretto per inquadrare Marketing Cloud Schema Explorer è quindi come un tool che supporta in modo ampio l’investigazione, le operazioni, l’analisi d’impatto delle modifiche e la governance per Marketing Cloud Engagement.
Sembra particolarmente utile negli ambienti in uso da molti anni, che hanno accumulato un numero elevato di Data Extension, Query, Automation, Journey e altri asset.
Considerazioni sulla sicurezza
Quando si collega un tool esterno come questo a Marketing Cloud Engagement, alcuni potrebbero avere dubbi in termini di sicurezza e chiedersi:
- “I dati di Marketing Cloud verranno inviati fuori dalla piattaforma?”
Ho verificato direttamente questo punto con lo sviluppatore, Alok Behera.
Ciò che Schema Explorer gestisce principalmente sono i metadati di Marketing Cloud Engagement, non i dati di clienti o subscriber.
Ad esempio, sincronizza metadati relativi a:
- Data Extension
- Query
- Automation
- Journey
- Cartelle
- Informazioni correlate a questi asset
e li utilizza per fornire l’analisi delle dipendenze e gli insight operativi.
Nel normale funzionamento, Schema Explorer non invia email né attiva Journey.
Non ha inoltre bisogno di sincronizzare i dati dei subscriber o i dati di tracking per fornire le sue funzionalità principali.
Per l’autenticazione viene utilizzato Marketing Cloud OAuth, e l’ambito di accesso si basa sulla Business Unit di Marketing Cloud autenticata e sui permessi dell’utente.
Anche le credenziali e i token vengono gestiti lato server e non sono esposti al browser.
Tuttavia, Schema Explorer memorizza i metadati recuperati da Marketing Cloud Engagement, allo scopo di fornire l’analisi delle dipendenze e gli insight.
Pertanto, prima di introdurlo in un ambiente aziendale reale, è opportuno valutare se possa essere utilizzato in conformità con le politiche di sicurezza della propria azienda, tenendo presente anche il fatto che si tratta di un tool Salesforce Labs.
In particolare, le regole relative alle connessioni con servizi esterni variano da azienda ad azienda: consiglio quindi di verificare con il proprio team di sicurezza o con le figure competenti prima dell’utilizzo, se necessario.
Conclusione
Marketing Cloud Schema Explorer è un tool che visualizza le relazioni complesse tra gli asset all’interno di Marketing Cloud Engagement e supporta investigazioni che, nell’operatività quotidiana, spesso richiedono tempi considerevoli, come:
- “Dove viene utilizzato questo?”
e
- “Cosa verrebbe impattato se lo modificassi?”
Può essere particolarmente utile negli ambienti in uso da molti anni, dove Data Extension, Query, Automation, Journey e altri asset continuano ad accumularsi.
È disponibile gratuitamente da Salesforce Labs: se sei interessato, provalo tu stesso.
Per questa volta è tutto.
Restate sintonizzati per altri consigli su Salesforce Marketing Cloud! 😎
Nobuyuki Watanabe
Tradotto e adattato da SFMC Tips #339 : Dependency / Impact Analysis Tool: Marketing Cloud Schema Explorer di Nobuyuki Watanabe (@marketingcloudtips), pubblicato originariamente su Medium. Traduzione autorizzata dall’autore.