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
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.
NOTA: Attualmente, gli strumenti sandbox supportano solo flussi di dati di origine basati su batch. I flussi di dati di origine basati su streaming non sono supportati.
- È supportato solo il tipo Customer Audience Segmentation service.
- 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 Create new o Use existing 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
Selezionare Schemas dal menu di navigazione a sinistra, quindi selezionare la scheda Browse 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 Add to package dal menu a discesa.
Dalla finestra di dialogo Add to package, seleziona l'opzione Create new package. Fornisci Name per il pacchetto e un Description facoltativo, quindi seleziona Add.
Sei tornato all'ambiente Schemas. È 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, selezionare Schemas dal menu di navigazione a sinistra, quindi selezionare la scheda Browse. Selezionare quindi i puntini di sospensione (...) accanto allo schema selezionato per visualizzare le opzioni di controllo in un menu a discesa. Seleziona Add to package dal menu a discesa.
Viene visualizzata la finestra di dialogo Add to package. Seleziona l'opzione Existing package, quindi seleziona il menu a discesa Package name e il pacchetto richiesto. Infine, selezionare Add per confermare le scelte.
Finestra di dialogo
Viene elencato l'elenco degli oggetti aggiunti al pacchetto. Per pubblicare il pacchetto e renderlo disponibile per l'importazione in sandbox, selezionare Publish.
Selezionare Publish per confermare la pubblicazione del pacchetto.
Si è tornati alla scheda Packages nell'ambiente Sandboxes, dove è possibile visualizzare 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 Browse e seleziona l’opzione più (+) accanto al nome della sandbox.
Utilizzando il menu a discesa, seleziona Package name da importare nella sandbox di destinazione. Aggiungi Job name, 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 Next.
La pagina Package object and dependencies fornisce un elenco di tutte le risorse incluse in questo 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 View details 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 Use existing.
La finestra di dialogo Field group mostra un elenco di gruppi di campi disponibili per l'oggetto. Selezionare i gruppi di campi richiesti, quindi selezionare Save.
Sei tornato alla pagina Package object and dependencies. Da qui, selezionare Finish 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, passare alla scheda Sandboxes Packages e selezionare Create package.
Selezionare Entire sandbox per Type of package nella finestra di dialogo Create package. Fornisci Package name per il nuovo pacchetto e seleziona Sandbox dal menu a discesa. Infine, selezionare Create per confermare i dati immessi.
Creazione del pacchetto completata. Selezionare Publish per pubblicare il pacchetto.
Si è tornati alla scheda Packages nell'ambiente Sandboxes, dove è possibile visualizzare 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 Sandboxes Browse e seleziona l'opzione più (+) accanto al nome della sandbox.
Utilizzando il menu a discesa, seleziona la sandbox completa utilizzando il menu a discesa Package name. Aggiungi un Job name, che verrà utilizzato per il monitoraggio futuro e un Job description facoltativo, quindi seleziona Next.
Viene visualizzata la pagina Package object and dependencies in cui è possibile visualizzare il numero di oggetti e dipendenze importati ed esclusi. Da qui, selezionare Import 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. È possibile monitorare il processo di importazione dalla scheda Sandboxes Jobs.
Monitorare i dettagli di importazione view-import-details
Per visualizzare i dettagli importati, passare alla scheda Sandboxes Jobs e selezionare il pacchetto dall'elenco. In alternativa, utilizza la barra di ricerca per cercare il pacchetto.
Seleziona View import summary dal riquadro dei dettagli a destra nella scheda Jobs nell'ambiente Sandbox.
La finestra di dialogo Import summary 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. Passare ad esempio all'area di lavoro Schemas, selezionare lo schema e aggiungere un nuovo gruppo di campi.
Dopo aver aggiornato lo schema, passa a Sandboxes, seleziona Packages, quindi individua il pacchetto esistente.
Utilizza l’interfaccia dei pacchetti per verificare le modifiche. Seleziona Check for updates per visualizzare eventuali modifiche agli artefatti nel pacchetto. Quindi, seleziona View diff per ricevere un riepilogo dettagliato di tutte le modifiche eseguite sugli artefatti.
Viene visualizzata l'interfaccia View diff. Per informazioni sugli artefatti di origine e di destinazione e sulle modifiche da applicare, consulta questo pedaggio.
Durante questo passaggio, puoi anche selezionare Summarize with AI per un riepilogo dettagliato di tutte le modifiche.
Al termine, selezionare Update package e quindi Confirm nella finestra popup visualizzata. Una volta completato il processo, puoi aggiornare la pagina e selezionare View history per verificare la versione del pacchetto.
Per importare le modifiche, tornare alla directory Packages e selezionare i puntini di sospensione (...) accanto al pacchetto, quindi selezionare Import package. Experience Platform seleziona automaticamente Update existing objects. Verificare le modifiche, quindi selezionare Finish.
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 Update existing objects, 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 Finish.
Tutorial 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.