Documentação Experience Platform Guia de sandoxes

Ferramentas de sandbox

20 de maio de 2025

Tópicos:

Criado para:

Desenvolvedor
Usuário
Administrador
Líder

NOTE

A ferramenta de sandbox é um recurso fundamental que oferece suporte ao Real-Time Customer Data Platform e ao Journey Optimizer para melhorar a eficiência do ciclo de desenvolvimento e a precisão da configuração.

Você precisa ter as duas seguintes permissões de controle de acesso baseado em função para usar o recurso de ferramenta de sandbox:
- manage-sandbox ou view-sandbox
- manage-package

Melhore a precisão da configuração em sandboxes e exporte e importe configurações de sandbox facilmente entre sandboxes com o recurso de ferramenta de sandbox. Use as ferramentas de sandbox para reduzir o tempo de retorno do processo de implementação e mover configurações bem-sucedidas entre sandboxes.

Você pode usar o recurso de ferramenta sandbox para selecionar objetos diferentes e exportá-los em um pacote. Um pacote pode consistir em um único objeto ou em vários objetos. Todos os objetos incluídos em um pacote devem ser da mesma sandbox.

Objetos compatíveis com as ferramentas de sandbox

O recurso de ferramenta de sandbox fornece a capacidade de exportar objetos Adobe Real-Time Customer Data Platform e Adobe Journey Optimizer para um pacote.

Objetos da Real-time Customer Data Platform

A tabela abaixo lista Adobe Real-Time Customer Data Platform objetos que atualmente têm suporte para ferramentas de sandbox:

Plataforma	Objeto	Detalhes
Plataforma de dados do cliente	Origens	As credenciais da conta de origem não são replicadas na sandbox de destino por motivos de segurança e precisarão ser atualizadas manualmente. O fluxo de dados de origem é copiado em um status de rascunho por padrão.
Plataforma de dados do cliente	Públicos-alvo	Somente o Público-alvo do cliente do tipo Serviço de segmentação é suportado. Os rótulos existentes para consentimento e governança serão copiados no mesmo trabalho de importação. O sistema selecionará automaticamente a Política de mesclagem padrão na sandbox de destino com a mesma classe XDM ao verificar as dependências da política de mesclagem.
Plataforma de dados do cliente	Identidades	O sistema eliminará automaticamente a duplicação de namespaces de identidade padrão do Adobe ao criar na sandbox de destino. Os públicos só podem ser copiados quando todos os atributos nas regras de público-alvo estão habilitados no esquema de união. Os esquemas necessários devem ser movidos e ativados para o perfil unificado primeiro.
Plataforma de dados do cliente	Esquemas	Os rótulos existentes para consentimento e governança serão copiados no mesmo trabalho de importação. O usuário tem a flexibilidade de importar esquemas sem a opção Perfil unificado ativada. O caso de borda das relações de esquema não está incluído no pacote.
Plataforma de dados do cliente	Conjuntos de dados	Os conjuntos de dados são copiados com a configuração de perfil unificado desativada por padrão.
Plataforma de dados do cliente	Políticas de consentimento e governança	Adicionar políticas personalizadas criadas por um usuário a um pacote e movê-las para sandboxes.

Os seguintes objetos são importados, mas estão em um rascunho ou estão desabilitados:

Recurso	Objeto	Status
Status da importação	Fluxo de dados do Source	Rascunho
Status da importação	Jornada	Rascunho
Perfil unificado	Conjunto de dados	Perfil unificado desabilitado
Políticas	Políticas de governança de dados	Desabilitado

Objetos do Adobe Journey Optimizer

A tabela abaixo lista Adobe Journey Optimizer objetos que atualmente têm suporte para ferramentas e limitações de sandbox:

Plataforma	Objeto	Objetos Dependentes Compatíveis	Detalhes
Adobe Journey Optimizer	Público-alvo		Um público-alvo pode ser copiado como um objeto dependente do objeto de jornada. Você pode selecionar criar um novo público ou reutilizar um existente na sandbox de destino.
Adobe Journey Optimizer	Esquema		Os esquemas usados na jornada podem ser copiados como objetos dependentes. Você pode selecionar criar um novo esquema ou reutilizar um existente na sandbox de destino.
Adobe Journey Optimizer	Política de mesclagem		As políticas de mesclagem usadas na jornada podem ser copiadas como objetos dependentes. Na sandbox de destino, você não pode criar uma nova política de mesclagem, você só pode usar uma existente.
Adobe Journey Optimizer	Jornada	Os seguintes objetos usados na jornada são copiados como objetos dependentes. Durante o fluxo de trabalho de importação, você pode selecionar Criar novo ou Usar existente para cada: Públicos-alvo Esquemas Ações personalizadas Eventos Fragmentos Modelos de conteúdo Detalhes da tela	Ações personalizadas: ao selecionar Usar existente durante o processo de importação ao copiar uma jornada para outra sandbox, as ações personalizadas existentes selecionadas devem ser iguais à ação personalizada de origem. Se não forem as mesmas, a nova jornada terá erros que não poderão ser resolvidos. Os eventos e detalhes do evento usados na jornada são copiados. Ele sempre criará uma nova versão na sandbox de destino.
Adobe Journey Optimizer	Ação		As mensagens de email e de push usadas na jornada podem ser copiadas como objetos dependentes. As atividades de ação de canal usadas nos campos de jornada, que são usadas para personalização na mensagem, não são verificadas para verificação de integridade. Os blocos de conteúdo não são copiados. A ação de atualização de perfil usada na jornada pode ser copiada. As ações personalizadas podem ser adicionadas a um pacote independentemente. Os detalhes da ação usados na jornada também são copiados. Ele sempre criará uma nova versão na sandbox de destino.
Adobe Journey Optimizer	Ações Personalizadas		As ações personalizadas podem ser adicionadas a um pacote independentemente. Depois que uma ação personalizada é atribuída a uma jornada, ela não pode mais ser editada. Para atualizar ações personalizadas, você deve: mover ações personalizadas antes de migrar uma jornada atualizar configurações (como cabeçalhos de solicitação, parâmetros de consulta e autenticação) para ações personalizadas após a migração migrar objetos do jornada com as ações personalizadas adicionadas durante a primeira etapa
Adobe Journey Optimizer	Modelo de conteúdo		Um template de conteúdo pode ser copiado como um objeto dependente do objeto de jornada. Modelos independentes permitem reutilizar facilmente o conteúdo personalizado em campanhas e jornadas do Journey Optimizer.
Adobe Journey Optimizer	Fragmento	Todos os fragmentos aninhados.	Um fragmento pode ser copiado como um objeto dependente do objeto de jornada. Os fragmentos são componentes reutilizáveis que podem ser referenciados em um ou mais emails em campanhas e jornadas do Journey Optimizer.
Adobe Journey Optimizer	Campanhas	Os seguintes objetos usados na campanha são copiados como objetos dependentes: Campanhas Públicos-alvo Esquemas Modelos de conteúdo Fragmentos Mensagem/Conteúdo Configuração de canais Objetos de decisão unificados Configurações/variantes de experimentos	As campanhas podem ser copiadas junto com todos os itens relacionados ao perfil, público-alvo, esquema, mensagens embutidas e objetos dependentes. Alguns itens não são copiados, como rótulos de uso de dados e configurações de idioma. Para obter uma lista completa de objetos que não podem ser copiados, consulte o guia exportação de objetos para outra sandbox. O sistema detectará e reutilizará automaticamente um objeto de configuração de canal existente na sandbox de destino se existir uma configuração idêntica. Se nenhuma configuração correspondente for encontrada, a configuração do canal será ignorada durante a importação e os usuários deverão atualizar manualmente as configurações do canal na sandbox de destino para essa jornada. Os usuários podem reutilizar experimentos e públicos-alvo existentes na sandbox de destino como objetos dependentes de campanhas selecionadas.

As superfícies (por exemplo, predefinições) não são copiadas. O sistema seleciona automaticamente a correspondência mais próxima possível na sandbox de destino com base no tipo de mensagem e no nome da superfície. Se não houver superfícies encontradas na sandbox de destino, a cópia de superfície falhará, fazendo com que a cópia da mensagem falhe, pois uma mensagem requer que uma superfície esteja disponível para configuração. Nesse caso, pelo menos uma superfície precisa ser criada para o canal direito da mensagem para que a cópia funcione.

Os tipos de identidade personalizados não são suportados como objetos dependentes ao exportar uma jornada.

Exportar objetos em um pacote

NOTE

Todas as ações de exportação são registradas nos logs de auditoria.

NOTE

Você só poderá importar um pacote se tiver permissão para acessar os objetos.

Este exemplo documenta o processo de exportação de um esquema e sua adição a um pacote. Você pode usar o mesmo processo para exportar outros objetos, por exemplo, conjuntos de dados, jornadas e muito mais.

Adicionar objeto a um novo pacote

Selecione Esquemas na navegação à esquerda e selecione a guia Procurar, que lista os esquemas disponíveis. Em seguida, selecione as reticências (...) ao lado do esquema selecionado, e uma lista suspensa exibe controles. Selecione Adicionar ao pacote na lista suspensa.

Lista de esquemas mostrando o menu suspenso destacando o controle Adicionar ao pacote.

Na caixa de diálogo Adicionar ao pacote, selecione a opção Criar novo pacote. Forneça um Nome para o pacote e uma Descrição opcional e selecione Adicionar.

A caixa de diálogo Adicionar ao pacote com Criar novo pacote selecionada e destacando Adicionar.

Você retornou ao ambiente Esquemas. Agora é possível adicionar outros objetos ao pacote criado seguindo as próximas etapas listadas abaixo.

Adicionar um objeto a um pacote existente e publicar

Para exibir uma lista de esquemas disponíveis, selecione Esquemas na navegação à esquerda e selecione a guia Procurar. Em seguida, selecione as reticências (...) ao lado do esquema selecionado para ver as opções de controle em um menu suspenso. Selecione Adicionar ao pacote na lista suspensa.

Lista de esquemas mostrando o menu suspenso destacando o controle Adicionar ao pacote.

A caixa de diálogo Adicionar ao pacote é exibida. Selecione a opção Pacote existente, selecione a lista suspensa Nome do pacote e selecione o pacote necessário. Finalmente, selecione Adicionar para confirmar suas escolhas.

Caixa de diálogo Adicionar ao pacote, mostrando um pacote selecionado na lista suspensa.

A lista de objetos adicionados ao pacote é listada. Para publicar o pacote e disponibilizá-lo para importação em sandboxes, selecione Publicar.

Uma lista de objetos no pacote, destacando a opção Publicar.

Selecione Publicar para confirmar a publicação do pacote.

Caixa de diálogo de confirmação de publicação do pacote, destacando a opção Publicar.

NOTE

Após a publicação, o conteúdo do pacote não pode ser alterado. Para evitar problemas de compatibilidade, verifique se todos os ativos necessários foram selecionados. Se for necessário fazer alterações, você precisará criar um novo pacote.

Você retornará à guia Pacotes no ambiente Sandboxes, onde poderá ver o novo pacote publicado.

Lista de pacotes de sandbox que destaca o novo pacote publicado.

Importar um pacote para uma sandbox de destino

NOTE

Todas as ações de importação são registradas nos logs de auditoria.

Para importar o pacote para uma sandbox de destino, navegue até a guia Sandboxes Browse e selecione a opção de adição (+) ao lado do nome da sandbox.

A guia Procurar das sandboxes que destaca a seleção do pacote de importação.

Usando o menu suspenso, selecione o Nome do pacote que deseja importar para a sandbox direcionada. Adicione um Nome do trabalho, que será usado para monitoramento futuro. Por padrão, o perfil unificado será desativado quando os schemas do pacote forem importados. Ative Habilitar esquemas para o perfil para habilitar isso e selecione Avançar.

A página de detalhes da importação mostrando a seleção suspensa Nome do pacote

A página Dependências e objeto de pacote fornece uma lista de todos os ativos incluídos neste pacote. O sistema detecta automaticamente objetos dependentes que são necessários para a importação bem-sucedida de objetos pai selecionados. Todos os atributos ausentes são exibidos na parte superior da página. Selecione Exibir detalhes para obter um detalhamento mais detalhado.

A página Dependências e objeto de pacote mostra atributos ausentes.

NOTE

Objetos dependentes podem ser substituídos por objetos existentes na sandbox de destino, que permitem reutilizar objetos existentes em vez de criar uma nova versão. Por exemplo, ao importar um pacote incluindo esquemas, você pode reutilizar grupos de campos personalizados existentes e namespaces de identidade na sandbox de destino. Como alternativa, ao importar um pacote incluindo Jornadas, você pode reutilizar segmentos existentes na sandbox de destino.

Atualmente, as ferramentas de sandbox não permitem a atualização ou substituição de objetos existentes. Você pode optar por criar um novo objeto ou continuar a usar o objeto existente sem modificações.

Para usar um objeto existente, selecione o ícone de lápis ao lado do objeto dependente.

A página Dependências e objeto de pacote mostra uma lista de ativos incluídos no pacote.

As opções para criar um novo ou usar um existente são exibidas. Selecione Usar existente.

A página Dependências e objeto de pacote mostrando as opções de objeto dependente Criar novo e Usar existente.

A caixa de diálogo Grupo de campos mostra uma lista de grupos de campos disponíveis para o objeto. Selecione os grupos de campos necessários e selecione Salvar.

Uma lista de campos mostrados na caixa de diálogo Grupo de campos, destacando a seleção Salvar.

Você retornou à página Dependências e objeto de pacote. Aqui, selecione Concluir para concluir a importação do pacote.

A página Dependências e objeto de pacote mostra uma lista dos ativos incluídos no pacote, destacando Término.

Exportar e importar uma sandbox inteira

NOTE

Atualmente, somente os objetos da Real-time Customer Data Platform são compatíveis ao exportar ou importar uma sandbox inteira. Objetos do Adobe Journey Optimizer, como jornadas, não são suportados no momento.

Você pode exportar todos os tipos de objeto compatíveis em um pacote de sandbox completo e, em seguida, importar o pacote em várias sandboxes para replicar as configurações de objeto. Por exemplo, essa funcionalidade permite:

Reimporte uma sandbox para reproduzir todas as configurações do objeto se precisar redefinir a sandbox
Importe o pacote para outras sandboxes e utilize-o como uma sandbox de blueprint para acelerar o processo de desenvolvimento.

Exportar uma sandbox inteira

Para exportar uma sandbox inteira, navegue até a guia Sandboxes Pacotes e selecione Criar pacote.

As Sandboxes Pacotes destacando a guia Criar pacote.

Selecione Toda a sandbox para o Tipo de pacote na caixa de diálogo Criar pacote. Forneça um Nome do pacote para o novo pacote e selecione a Sandbox na lista suspensa. Finalmente, selecione Criar para confirmar suas entradas.

A caixa de diálogo Criar pacote mostrando campos concluídos e destacando Criar.

O pacote foi criado com êxito, selecione Publicar para publicar o pacote.

Lista de pacotes de sandbox que destaca o novo pacote publicado.

Você retornará à guia Pacotes no ambiente Sandboxes, onde poderá ver o novo pacote publicado.

Importar todo o pacote de sandbox

NOTE

Todos os objetos serão importados para a sandbox de destino como novos objetos. É uma prática recomendada importar um pacote de sandbox completo para uma sandbox vazia.

Para importar o pacote para uma sandbox de destino, navegue até a guia Sandboxes Procurar e selecione a opção de adição (+) ao lado do nome da sandbox.

A guia Procurar das sandboxes que destaca a seleção do pacote de importação.

Usando o menu suspenso, selecione a sandbox completa usando a lista suspensa Nome do pacote. Adicione um Nome do trabalho, que será usado para monitoramento futuro e uma Descrição do trabalho opcional, depois selecione Avançar.

A página de detalhes da importação mostrando a seleção suspensa Nome do pacote

NOTE

Você deve ter permissões totais para todos os objetos incluídos no pacote. Se você não tiver permissões, a operação de importação falhará e serão exibidas mensagens de erro.

Você é levado para a página Dependências e objeto do pacote, onde é possível ver o número de objetos e dependências importados e excluídos. Aqui, selecione Importar para concluir a importação do pacote.

A página Dependências e objeto de pacote mostra a mensagem embutida de tipos de objeto sem suporte, destacando Importar.

Aguarde algum tempo para a conclusão da importação. O tempo de conclusão pode variar dependendo do número de objetos no pacote. Você pode monitorar o trabalho de importação a partir da guia Sandboxes Trabalhos.

Monitorar detalhes da importação

Para exibir os detalhes importados, navegue até a guia Sandboxes Trabalhos e selecione o pacote na lista. Como alternativa, use a barra de pesquisa para procurar o pacote.

A guia sandboxes Trabalhos destaca a seleção do pacote de importação.

Selecione Exibir resumo de importação no painel de detalhes direito na guia Trabalhos do ambiente Sandboxes.

A guia Importações das sandboxes destaca a seleção Exibir detalhes da importação no painel direito.

A caixa de diálogo Resumo de importação mostra um detalhamento das importações com o progresso como uma porcentagem.

NOTE

Você pode ver uma lista de objetos navegando até páginas específicas do inventário.

A caixa de diálogo Detalhes da importação mostrando um detalhamento das importações.

Quando a importação for concluída, uma notificação será recebida na interface do usuário do Experience Platform. Você pode acessar essas notificações pelo ícone de alertas. Você pode acessar a solução de problemas aqui se uma tarefa não for bem-sucedida.

Tutorial em vídeo

O vídeo a seguir é destinado a ajudá-lo a entender as ferramentas de sandbox e descreve como criar um novo pacote, publicar um pacote e importar um pacote.

video poster

https://video.tv.adobe.com/v/3446089/?learn=on&captions=por_br

Próximas etapas

Este documento demonstrou como usar o recurso de ferramenta de sandbox na interface do usuário do Experience Platform. Para obter informações sobre sandboxes, consulte o guia do usuário da sandbox.

Para obter etapas sobre como executar operações diferentes usando a API de sandbox, consulte o guia do desenvolvedor da sandbox. Para obter uma visão geral de alto nível das sandboxes no Experience Platform, consulte a documentação de visão geral.

recommendation-more-help