Strumenti sandbox
Per utilizzare la funzionalità strumenti sandbox, è necessario disporre delle due autorizzazioni di controllo dell'accesso basate sul ruolo seguenti:
-
manage-sandbox
o view-sandbox
-
manage-package
Migliora la precisione della configurazione nelle sandbox ed esporta e importa facilmente le configurazioni sandbox tra sandbox con la funzione di strumenti sandbox. Utilizza gli strumenti sandbox per ridurre il time-to-value per il processo di implementazione e spostare le configurazioni corrette tra le sandbox.
È possibile utilizzare la funzione degli strumenti sandbox per selezionare oggetti diversi ed esportarli in un pacchetto. Un pacchetto può essere costituito da uno o più oggetti. Tutti gli oggetti inclusi in un pacchetto devono appartenere alla stessa sandbox.
Oggetti supportati per gli strumenti sandbox supported-objects
La funzionalità di strumenti sandbox consente di esportare Adobe Real-Time Customer Data Platform e Adobe Journey Optimizer oggetti in un pacchetto.
Oggetti di Real-time Customer Data Platform real-time-cdp-objects
Modifiche alle importazioni di tipi di pubblico con più entità
Con gli aggiornamenti dell'architettura B2B, non sarà più possibile importare tipi di pubblico con più entità con attributi B2B ed eventi di esperienza se un pacchetto che includeva tali tipi di pubblico è stato pubblicato prima dell'aggiornamento. Questi tipi di pubblico non verranno importati e non potranno essere convertiti automaticamente nella nuova architettura.
Per ovviare a questo limite, è necessario creare un nuovo pacchetto con i tipi di pubblico aggiornati e quindi importarli nelle rispettive sandbox di destinazione utilizzando gli strumenti sandbox.
Nella tabella seguente sono elencati Adobe Real-Time Customer Data Platform oggetti attualmente supportati per gli strumenti sandbox:
- Le credenziali dell’account di origine non vengono replicate nella sandbox di destinazione per motivi di sicurezza e sarà necessario aggiornarle manualmente.
- Per impostazione predefinita, il flusso di dati di origine viene copiato in stato di bozza.
- È supportato solo il tipo Pubblico cliente Servizio di segmentazione.
- Le etichette esistenti per il consenso e la governance verranno copiate nello stesso processo di importazione.
- Il sistema selezionerà automaticamente il criterio di unione predefinito nella sandbox di destinazione con la stessa classe XDM durante il controllo delle dipendenze dei criteri di unione.
- Se durante l’importazione di tipi di pubblico viene rilevato un oggetto esistente con lo stesso nome, gli strumenti Sandbox riutilizzeranno sempre l’oggetto esistente per evitare la proliferazione degli oggetti.
- Durante la creazione nella sandbox di destinazione, il sistema deduplica automaticamente gli spazi dei nomi di identità standard di Adobe.
- I tipi di pubblico possono essere copiati solo quando tutti gli attributi nelle regole del pubblico sono abilitati nello schema di unione. Gli schemi necessari devono prima essere spostati e abilitati per il profilo unificato.
- Le etichette esistenti per il consenso e la governance verranno copiate nello stesso processo di importazione.
- Puoi importare gli schemi in modo flessibile anche se l’opzione Profilo unificato non è abilitata. Il caso edge delle relazioni di schema non è incluso nel pacchetto.
- Se durante l’importazione di schemi o gruppi di campi viene rilevato un oggetto esistente con lo stesso nome, gli strumenti Sandbox riutilizzeranno sempre l’oggetto esistente per evitare la proliferazione degli oggetti.
I seguenti oggetti vengono importati ma sono in stato bozza o disabilitato:
Oggetti Adobe Journey Optimizer abobe-journey-optimizer-objects
Nella tabella seguente sono elencati Adobe Journey Optimizer oggetti attualmente supportati per gli strumenti e le limitazioni della sandbox:
I seguenti oggetti utilizzati nel percorso vengono copiati come oggetti dipendenti. Durante il flusso di lavoro di importazione, puoi scegliere tra Crea nuovo o Usa esistente per ciascuno:
- Tipi di pubblico
- Dettagli area di lavoro
- Modelli di contenuto
- Azioni personalizzate
- Origini dati
- Eventi
- Gruppi di campi
- Frammenti
- Schemi
Il percorso copia gli eventi e i dettagli dell'evento utilizzati e crea una nuova versione nella sandbox di destinazione.
È possibile copiare l'azione di aggiornamento del profilo utilizzata nel percorso. Le azioni personalizzate possono essere aggiunte a un pacchetto in modo indipendente. Vengono copiati anche i dettagli delle azioni utilizzati nel percorso. Crea sempre una nuova versione nella sandbox di destinazione.
Le azioni personalizzate possono essere aggiunte a un pacchetto in modo indipendente. Una volta assegnata a un percorso, un’azione personalizzata non può più essere modificata. Per apportare aggiornamenti alle azioni personalizzate, devi:
- spostare le azioni personalizzate prima di eseguire la migrazione di un percorso
- aggiorna le configurazioni (come intestazioni di richiesta, parametri di query e autenticazione) per le azioni personalizzate dopo la migrazione
- esegui la migrazione degli oggetti percorso con le azioni personalizzate aggiunte durante il primo passaggio
I seguenti oggetti utilizzati nella campagna vengono copiati come oggetti dipendenti:
- Campagne
- Tipi di pubblico
- Schemi
- Modelli di contenuto
- Frammenti
- Messaggio/Contenuto
- Configurazione dei canali
- Oggetti decisionali unificati
- Impostazioni/varianti esperimento
- Le campagne possono essere copiate insieme a tutti gli elementi relativi al profilo, al pubblico, allo schema, ai messaggi in linea e agli oggetti dipendenti. Alcuni elementi non vengono copiati, ad esempio le etichette di utilizzo dei dati e le impostazioni della lingua. Per un elenco completo degli oggetti che non possono essere copiati, fare riferimento alla guida esportazione di oggetti in un'altra sandbox.
- Se esiste una configurazione identica, il sistema rileva e riutilizza automaticamente un oggetto di configurazione del canale esistente nella sandbox di destinazione. Se non viene trovata alcuna configurazione corrispondente, la configurazione del canale viene ignorata durante l’importazione e gli utenti devono aggiornare manualmente le impostazioni del canale nella sandbox di destinazione per questo percorso.
- Gli utenti possono riutilizzare gli esperimenti e i tipi di pubblico esistenti nella sandbox di destinazione come oggetti dipendenti delle campagne selezionate.
Prima di copiare gli oggetti Decisioning, nella sandbox di destinazione devono essere presenti i seguenti oggetti:
- Attributi di profilo utilizzati negli oggetti Decisioning
- Gruppo di campi di Attributi offerta personalizzati
- Gli schemi di flussi di dati utilizzati per gli attributi di contesto tra regole, classificazione o limite.
- La copia delle formule di classificazione che utilizzano modelli AI non è attualmente supportata.
- Gli elementi decisionali (elementi offerta) non vengono inclusi automaticamente. Per assicurarsi che siano trasferiti, aggiungili manualmente utilizzando l'opzione Aggiungi al pacchetto.
- I criteri che utilizzano una strategia di selezione richiedono l’aggiunta manuale degli elementi decisionali associati durante il processo di copia. I criteri che utilizzano elementi di decisione manuali o di fallback includeranno automaticamente tali elementi come dipendenze dirette.
- Gli elementi decisionali devono essere copiati prima di qualsiasi altro oggetto correlato.
Attributi di profilo utilizzati negli oggetti Decisioning,
Il gruppo di campi Attributi offerta personalizzati,
Gli schemi di flussi di dati utilizzati per gli attributi di contesto tra regole, classificazione o limite.
Le superfici (ad esempio i predefiniti) non vengono copiate. Il sistema seleziona automaticamente la corrispondenza più simile possibile nella sandbox di destinazione in base al tipo di messaggio e al nome della superficie. Se nella sandbox di destinazione non è presente alcuna superficie, la copia della superficie avrà esito negativo e la copia del messaggio avrà esito negativo perché un messaggio richiede che una superficie sia disponibile per l’impostazione. In questo caso, affinché la copia funzioni, è necessario creare almeno una superficie per il canale destro del messaggio.
I tipi di identità personalizzati non sono supportati come oggetti dipendenti durante l’esportazione di un percorso.
Esportare oggetti in un pacchetto export-objects
Questo esempio documenta il processo di esportazione di uno schema e di aggiunta a un pacchetto. È possibile utilizzare lo stesso processo per esportare altri oggetti, ad esempio set di dati, percorsi e molto altro.
Aggiungi oggetto a un nuovo pacchetto add-object-to-new-package
Seleziona Schemi dal menu di navigazione a sinistra, quindi seleziona la scheda Sfoglia, in cui sono elencati gli schemi disponibili. Quindi, selezionare i puntini di sospensione (...
) accanto allo schema selezionato e un menu a discesa visualizza i controlli. Seleziona Aggiungi al pacchetto dal menu a discesa.
Dalla finestra di dialogo Aggiungi al pacchetto, seleziona l'opzione Crea nuovo pacchetto. Fornisci un Nome per il pacchetto e una Descrizione facoltativa, quindi seleziona Aggiungi.
Sei tornato all'ambiente Schemi. È ora possibile aggiungere altri oggetti al pacchetto creato seguendo i passaggi successivi elencati di seguito.
Aggiungere un oggetto a un pacchetto esistente e pubblicarlo add-object-to-existing-package
Per visualizzare un elenco degli schemi disponibili, seleziona Schemi dal menu di navigazione a sinistra, quindi seleziona la scheda Sfoglia. Selezionare quindi i puntini di sospensione (...
) accanto allo schema selezionato per visualizzare le opzioni di controllo in un menu a discesa. Seleziona Aggiungi al pacchetto dal menu a discesa.
Viene visualizzata la finestra di dialogo Aggiungi al pacchetto. Seleziona l'opzione Pacchetto esistente, quindi seleziona il menu a discesa Nome pacchetto e il pacchetto richiesto. Infine, seleziona Aggiungi per confermare le scelte.
Viene elencato l'elenco degli oggetti aggiunti al pacchetto. Per pubblicare il pacchetto e renderlo disponibile per l'importazione in sandbox, selezionare Pubblica.
Seleziona Pubblica per confermare la pubblicazione del pacchetto.
Sei tornato alla scheda Pacchetti nell'ambiente Sandbox, dove puoi vedere il nuovo pacchetto pubblicato.
Importare un pacchetto in una sandbox di destinazione import-package-to-target-sandbox
Per importare il pacchetto in una sandbox di destinazione, passa alla scheda Sandbox Sfoglia e seleziona l'opzione più (+) accanto al nome della sandbox.
Dal menu a discesa, seleziona il Nome pacchetto da importare nella sandbox di destinazione. Aggiungi un nome processo, che verrà utilizzato per il monitoraggio futuro. Per impostazione predefinita, il profilo unificato viene disabilitato quando vengono importati gli schemi del pacchetto. Attiva Abilita gli schemi per il profilo per abilitare questo, quindi seleziona Successivo.
La pagina Oggetto pacchetto e dipendenze fornisce un elenco di tutte le risorse incluse nel pacchetto. Il sistema rileva automaticamente gli oggetti dipendenti necessari per la corretta importazione degli oggetti padre selezionati. Eventuali attributi mancanti vengono visualizzati nella parte superiore della pagina. Seleziona Visualizza dettagli per un raggruppamento più dettagliato.
Per utilizzare un oggetto esistente, selezionare l'icona della matita accanto all'oggetto dipendente.
Vengono visualizzate le opzioni per creare nuovi o utilizzare quelli esistenti. Seleziona Usa esistente.
Nella finestra di dialogo Gruppo di campi viene visualizzato un elenco di gruppi di campi disponibili per l'oggetto. Seleziona i gruppi di campi richiesti, quindi seleziona Salva.
Sei tornato alla pagina Oggetto pacchetto e dipendenze. Da qui, selezionare Fine per completare l'importazione del pacchetto.
Esportare e importare un’intera sandbox
Puoi esportare tutti i tipi di oggetto supportati in un pacchetto sandbox completo, quindi importare il pacchetto in varie sandbox per replicare le configurazioni degli oggetti. Ad esempio, questa funzionalità consente di:
- Se devi reimpostare la sandbox, reimporta una sandbox per riprodurre tutte le configurazioni dell’oggetto
- Importa il pacchetto in altre sandbox e utilizzalo come sandbox blueprint per accelerare il processo di sviluppo.
Esportare un’intera sandbox export-entire-sandbox
Per esportare un'intera sandbox, passa alla scheda Sandbox Pacchetti e seleziona Crea pacchetto.
Selezionare Tutta la sandbox per il Tipo di pacchetto nella finestra di dialogo Crea pacchetto. Fornisci un nome pacchetto per il nuovo pacchetto e seleziona Sandbox dal menu a discesa. Infine, seleziona Crea per confermare le tue voci.
Creazione del pacchetto completata. Selezionare Pubblica per pubblicare il pacchetto.
Sei tornato alla scheda Pacchetti nell'ambiente Sandbox, dove puoi vedere il nuovo pacchetto pubblicato.
Importare l’intero pacchetto sandbox import-entire-sandbox-package
Per importare il pacchetto in una sandbox di destinazione, passa alla scheda Sandbox Sfoglia e seleziona l'opzione più (+) accanto al nome della sandbox.
Utilizzando il menu a discesa, seleziona la sandbox completa utilizzando il menu a discesa Nome pacchetto. Aggiungi un Nome processo, che verrà utilizzato per il monitoraggio futuro e una Descrizione processo facoltativa, quindi seleziona Successivo.
Si viene indirizzati alla pagina Oggetto pacchetto e dipendenze in cui è possibile visualizzare il numero di oggetti e dipendenze importati ed esclusi. Da qui, seleziona Importa per completare l'importazione del pacchetto.
Attendere il completamento dell'importazione. Il tempo necessario per il completamento può variare a seconda del numero di oggetti nel pacchetto. Puoi monitorare il processo di importazione dalla scheda Sandbox Processi.
Monitorare i dettagli di importazione view-import-details
Per visualizzare i dettagli importati, passare alla scheda Sandbox Processi e selezionare il pacchetto dall'elenco. In alternativa, utilizza la barra di ricerca per cercare il pacchetto.
Seleziona Visualizza riepilogo importazione dal riquadro dei dettagli a destra nella scheda Processi nell'ambiente Sandbox.
La finestra di dialogo Riepilogo importazione mostra un raggruppamento delle importazioni con avanzamento in percentuale.
Al termine dell’importazione, viene ricevuta una notifica nell’interfaccia utente di Experience Platform. Puoi accedere a queste notifiche dall’icona degli avvisi. Se un processo non riesce, puoi passare alla risoluzione dei problemi da qui.
Trasferimento degli aggiornamenti delle configurazioni di oggetti iterativi tra sandbox tramite strumenti sandbox move-configs
È possibile utilizzare gli strumenti sandbox per trasferire le configurazioni degli oggetti tra sandbox diverse. In precedenza, per poter essere trasferiti ad altre sandbox, gli aggiornamenti della configurazione degli oggetti (come schemi, gruppi di campi e tipi di dati) dovevano essere ricreati o importati manualmente. Con questa funzionalità, puoi utilizzare gli strumenti sandbox per accelerare i flussi di lavoro e ridurre i potenziali errori trasferendo facilmente gli aggiornamenti della configurazione tra diverse sandbox.
- Le autorizzazioni appropriate per accedere agli strumenti sandbox.
- Un oggetto appena creato o aggiornato (ad esempio uno schema) nella sandbox di origine.
Tipi di oggetto supportati per l'operazione di aggiornamento
Di seguito sono riportati i tipi di oggetto supportati per l'aggiornamento:
- Schemi
- Gruppi di campi
- Tipi di dati
- Aggiunta di nuovi campi o gruppi di campi alla risorsa.
- Impostazione di un campo obbligatorio come facoltativo.
- Introduzione di nuovi campi obbligatori.
- Introduzione di un nuovo campo di relazione.
- Introduzione di un nuovo campo di identità.
- Modifica del nome visualizzato e della descrizione della risorsa.
- Rimozione dei campi definiti in precedenza.
- Ridefinizione dei campi esistenti quando lo schema è abilitato per Real-Time Customer Profile.
- Rimozione o limitazione dei valori dei campi precedentemente supportati.
- Spostamento dei campi esistenti in una posizione diversa nella struttura dello schema: questo comando crea un nuovo campo nella sandbox di destinazione, ma il campo precedente non viene rimosso.
- Abilitazione o disabilitazione dello schema per la partecipazione al profilo: questa operazione verrà ignorata nel confronto delle differenze.
- Etichette per il controllo degli accessi.
Segui i passaggi seguenti per scoprire come utilizzare gli strumenti sandbox per trasferire le configurazioni degli oggetti tra diverse sandbox.
Oggetti importati in precedenza
Segui questi passaggi se il caso d’uso coinvolge oggetti esistenti nella sandbox di origine che richiedono aggiornamenti della configurazione, dopo essere già stati assemblati e importati in altre sandbox.
Innanzitutto, aggiorna l’oggetto nella sandbox di origine. Ad esempio, passa all'area di lavoro Schemi, seleziona lo schema e aggiungi un nuovo gruppo di campi.
Dopo aver aggiornato lo schema, passa a Sandbox, seleziona Pacchetti, quindi individua il pacchetto esistente.
Utilizza l’interfaccia dei pacchetti per verificare le modifiche. Seleziona Controlla aggiornamenti per visualizzare eventuali modifiche agli artefatti nel pacchetto. Quindi, seleziona Visualizza diff per ricevere un riepilogo dettagliato di tutte le modifiche eseguite sugli artefatti.
Viene visualizzata l'interfaccia Visualizza diff. Per informazioni sugli artefatti di origine e di destinazione e sulle modifiche da applicare, consulta questo pedaggio.
Durante questo passaggio, puoi anche selezionare Riepiloga con IA per un riepilogo dettagliato di tutte le modifiche.
Al termine dell'operazione, selezionare Aggiorna pacchetto, quindi selezionare Conferma nella finestra popup visualizzata. Una volta completato il processo, puoi aggiornare la pagina e selezionare Visualizza cronologia per verificare la versione del pacchetto.
Per importare le modifiche, torna alla directory Pacchetti e seleziona i puntini di sospensione (...
) accanto al pacchetto, quindi seleziona Importa pacchetto. Experience Platform seleziona automaticamente Aggiorna oggetti esistenti. Verificare le modifiche, quindi selezionare Fine.
Per convalidare ulteriormente il processo di importazione, accedi alla sandbox di destinazione e visualizza manualmente l’oggetto aggiornato all’interno di tale sandbox.
Oggetti creati manualmente nella sandbox di destinazione
Segui questi passaggi se il tuo caso d’uso prevede l’applicazione di modifiche alla configurazione a oggetti creati manualmente in sandbox separate.
Innanzitutto, crea e pubblica un nuovo pacchetto con l’oggetto aggiornato.
Quindi, importa il pacchetto nella sandbox di destinazione che contiene gli oggetti che desideri aggiornare. Durante il processo di importazione, selezionare Aggiorna oggetti esistenti, quindi utilizzare il Navigatore oggetti per selezionare manualmente gli oggetti di destinazione a cui si desidera applicare gli aggiornamenti.
- È facoltativo selezionare una mappatura di destinazione in una sandbox diversa per gli oggetti dipendenti. Se non è selezionato alcun elemento, ne viene creato uno nuovo.
- Per lo spazio dei nomi delle identità, il sistema rileva automaticamente se è necessario creare una nuova identità se una esistente deve essere riutilizzata nella sandbox di destinazione.
Dopo aver identificato gli oggetti di destinazione da aggiornare, selezionare Fine.
Esercitazione video
Il video seguente illustra gli strumenti della sandbox e spiega come creare un nuovo pacchetto, pubblicarlo e importarlo.
Passaggi successivi
Questo documento illustra come utilizzare la funzione di strumenti sandbox nell’interfaccia utente di Experience Platform. Per informazioni sulle sandbox, consulta la guida utente sulle sandbox.
Per i passaggi relativi all'esecuzione di diverse operazioni tramite l'API Sandbox, consulta la guida per gli sviluppatori di sandbox. Per una panoramica di alto livello delle sandbox in Experience Platform, consulta la documentazione sulla panoramica.