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-packageMigliora 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
Nella tabella seguente sono elencati Adobe Real-Time Customer Data Platform oggetti attualmente supportati per gli strumenti sandbox:
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 selezionare Crea nuovo o Usa esistente per ciascuno:
- Tipi di pubblico
- Schemi
- Azioni personalizzate
- Eventi
- Frammenti
- Modelli di contenuto
- Dettagli area di lavoro
- Azioni personalizzate: quando selezioni Usa esistente durante il processo di importazione durante la copia di un percorso in un'altra sandbox, le azioni personalizzate esistenti selezionate devono essere le stesse dell'azione personalizzata di origine. In caso contrario, il nuovo percorso presenterà errori irrisolvibili.
- Gli eventi e i dettagli dell’evento utilizzati nel percorso vengono copiati. Crea sempre 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.
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.
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.