Ferramentas de sandbox

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 supported-objects

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 real-time-cdp-objects

Alterações nas importações de público-alvo de várias entidades

Com as atualizações de arquitetura B2B, você não poderá mais importar públicos de várias entidades com atributos B2B e Eventos de Experiência se um pacote que inclui esses públicos tiver sido publicado antes da atualização. Esses públicos-alvo não serão importados e não poderão ser convertidos automaticamente para a nova arquitetura.

Para contornar essa limitação, você deve criar um novo pacote com os públicos atualizados e, em seguida, importá-los para suas respectivas sandboxes de destino usando as ferramentas da sandbox.

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

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

Objetos do Adobe Journey Optimizer abobe-journey-optimizer-objects

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

Atributos de perfil usados em objetos de Decisão,
O grupo de campos de atributos de oferta personalizados,
Os esquemas de sequências de dados usados para atributos de contexto em regras, classificação ou limite.

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 export-objects

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 add-object-to-new-package

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.

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.

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 add-object-to-existing-package

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.

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

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

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

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

Importar um pacote para uma sandbox de destino import-package-to-target-sandbox

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.

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 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.

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

As opções para criar um novo ou usar um existente são exibidas. Selecione 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.

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

Exportar e importar uma sandbox inteira

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:

Exportar uma sandbox inteira export-entire-sandbox

Para exportar uma sandbox inteira, navegue até a guia Sandboxes Pacotes e selecione 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.

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

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

Importar todo o pacote de sandbox import-entire-sandbox-package

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.

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.

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.

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 view-import-details

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.

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

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

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.

Transferir atualizações de configurações de objetos iterativos em sandboxes por meio da ferramenta sandbox move-configs

Você pode usar as ferramentas de sandbox para transferir configurações de objetos entre diferentes sandboxes. Anteriormente, as atualizações de configuração de seus objetos (como esquemas, grupos de campos e tipos de dados) precisavam ser recriadas ou reimportadas manualmente para serem transferidas para outras sandboxes. Com esse recurso, você pode usar ferramentas de sandbox para acelerar seus fluxos de trabalho e reduzir possíveis erros, transferindo facilmente suas atualizações de configuração em diferentes sandboxes.

Tipos de objeto compatíveis com a operação de atualização

Os seguintes tipos de objetos são compatíveis com a atualização:

Siga as etapas abaixo para saber como usar ferramentas de sandbox para transferir suas configurações de objeto em diferentes sandboxes.

Objetos importados anteriormente

Siga estas etapas se seu caso de uso envolver objetos existentes em sua sandbox de origem que exigem atualizações de configuração, após já terem sido empacotados e importados para outras sandboxes.

Primeiro, atualize o objeto na sandbox de origem. Por exemplo, navegue até o espaço de trabalho Esquemas, selecione seu esquema e adicione um novo grupo de campos.

Depois de atualizar o esquema, navegue até Sandboxes, selecione Pacotes e localize o pacote existente.

Use a interface de pacotes para verificar as alterações. Selecione Verificar atualizações para exibir as alterações nos artefatos do pacote. Em seguida, selecione Exibir comparação para receber um resumo detalhado de todas as alterações realizadas em relação aos artefatos.

A interface Exibir comparação é exibida. Consulte essa ferramenta para obter informações sobre os artefatos de origem e de destino, bem como as alterações a serem aplicadas a eles.

Durante esta etapa, você também pode selecionar Resumir com IA para obter um resumo passo a passo de todas as alterações.

Quando estiver pronto, selecione Atualizar pacote e Confirmar na janela pop-up exibida. Quando o trabalho for concluído, você poderá atualizar a página e selecionar Exibir histórico para verificar a versão do seu pacote.

Para importar as alterações, volte para o diretório Pacotes e selecione as reticências (...) ao lado do pacote e selecione Importar pacote. O Experience Platform seleciona automaticamente Atualizar objetos existentes. Verifique as alterações e selecione Concluir.

Para validar ainda mais seu processo de importação, navegue até a sandbox de destino e visualize manualmente o objeto atualizado nessa sandbox.

Objetos criados manualmente na sandbox de destino

Siga estas etapas se o caso de uso envolver a aplicação de alterações de configuração a objetos que foram criados manualmente em sandboxes separadas.

Primeiro, crie e publique um novo pacote com o objeto atualizado.

Em seguida, importe o pacote para a sandbox de destino que contém os objetos que você também deseja atualizar. Durante o processo de importação, selecione Atualizar objetos existentes e use o navegador de objetos para selecionar manualmente os objetos de destino aos quais você deseja aplicar as atualizações.

Depois de identificar os objetos de destino que você deseja atualizar, selecione Concluir.

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.

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.