Ferramentas de sandbox

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 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 do Real-time Customer Data Platform real-time-cdp-objects

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 deduplicará automaticamente os 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 abobe-journey-optimizer-objects

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

Plataforma
Objeto
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 utilizar uma já existente.
Adobe Journey Optimizer
Jornada - detalhes da tela
A representação da jornada na tela inclui os objetos na jornada, como condições, ações, eventos, públicos-alvo de leitura e assim por diante, que são copiados. A atividade de salto é excluída da cópia.
Adobe Journey Optimizer
Evento
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. Ações personalizadas e detalhes de ação usados na jornada também são copiados. Ele sempre criará uma nova versão na sandbox de destino.
Adobe Journey Optimizer
Jornada
Adicionar uma jornada inteira a um pacote copiará a maioria dos objetos dos quais a jornada depende, incluindo públicos, esquemas, eventos e ações.
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
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.

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

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

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

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

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

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

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

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 import-package-to-target-sandbox

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 objetos do Real-time Customer Data Platform são suportados 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 export-entire-sandbox

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 Publish 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 import-entire-sandbox-package

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

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

Próximas etapas

Este documento demonstrou como usar o recurso de ferramenta 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
e243ad8f-a318-46b3-9930-159a80f82b42