Ambientes

Ambientes do Adobe Experience Platform Launch defina vários aspectos principais das builds da biblioteca que você implantou no seu site ou aplicativo:

  • O nome do arquivo da build.
  • O domínio e o caminho da build, dependendo do host atribuído pelo ambiente.
  • O formato de arquivo da build, dependendo da opção de arquivamento escolhida.

Ao criar uma build de biblioteca no Platform Launch, você deve atribuí-la a um ambiente. As extensões, regras e elementos de dados da build são compilados e colocados no ambiente atribuído. Cada ambiente fornece um código integrado exclusivo que permite integrar a build atribuída ao site.

Podem existir diferentes artefatos do Adobe Experience Platform Launch em cada ambiente. Esses artefatos permitem testar diferentes bibliotecas em ambientes diferentes, conforme você as envia por meio do fluxo de trabalho.

Este documento fornece etapas sobre como instalar, configurar e criar ambientes diferentes na interface do usuário do Launch.

Tipos de ambientes

O Platform Launch aceita três tipos de ambientes diferentes, cada um correspondente a um estado diferente no fluxo de trabalho de publicação:

Tipo de ambiente Descrição
Desenvolvimento Esse ambiente corresponde à coluna Desenvolvimento no fluxo de trabalho de publicação.
Armazenamento temporário Esse ambiente corresponde às colunas Enviado e Aprovado no fluxo de trabalho de publicação.
Produção Esse ambiente corresponde à coluna Publicado no fluxo de trabalho de publicação.

Diferentes artefatos do Platform Launch podem existir em cada ambiente. Dessa forma, você pode testar diferentes bibliotecas em ambientes diferentes, conforme você as envia por meio do fluxo de trabalho.

OBSERVAÇÃO

Cada ambiente só pode receber uma build de biblioteca por vez. No entanto, espera-se que um único ambiente contenha muitas builds diferentes ao longo do tempo, conforme você as move pelo fluxo de trabalho de publicação, reatribuindo as builds entre ambientes, conforme necessário.

Instalação

Cada ambiente tem um conjunto de instruções usadas para conectá-lo ao seu aplicativo. Para propriedades da Web, essas instruções fornecem códigos integrados. Para propriedades móveis, essas instruções fornecem o código necessário para instanciar as bibliotecas que você está usando e recuperar a configuração no tempo de execução.

IMPORTANTE

Cada tipo de ambiente tem suas próprias instruções de instalação correspondentes. Dependendo do ambiente que estiver usando, você deve garantir que esteja utilizando os códigos integrados e/ou dependências correspondentes corretos.

Por exemplo, o código de integração de produção para uma propriedade da Web oferece suporte ao armazenamento em cache do navegador, enquanto os códigos integrados de desenvolvimento e armazenamento temporário não. Dessa forma, você não deve usar códigos integrados de desenvolvimento ou armazenamento temporário em contextos de alto tráfego ou produção.

Para acessar as instruções de instalação de um ambiente, navegue até a guia Environments referente à sua propriedade e selecione o ícone Install desse ambiente.

Se estiver usando uma propriedade da Web, você receberá um código integrado para ser usado na tag <head> do seu documento. Você também tem a opção de implantar arquivos de biblioteca de forma síncrona ou assíncrona no tempo de execução. Dependendo da configuração escolhida, as instruções de instalação exibidas serão diferentes. Os códigos integrados são explicados com mais detalhes posteriormente neste documento.

Se estiver usando uma propriedade móvel, você receberá instruções separadas para instalar dependências para Android (via Gradle) e iOS (via CocoaPods).

Configuração móvel

Para propriedades móveis, você pode visualizar as opções de configuração de um ambiente selecionando-o na lista. Aqui, você pode mudar o nome do ambiente. Atualmente, os ambientes móveis só podem usar hosts gerenciados pela Adobe.

Consulte a visão geral dos hosts para obter mais informações.

Configuração da Web

Para propriedades da Web, o Platform Launch também usa as configurações do ambiente atribuído para determinar o seguinte:

  • Host: o local do servidor em que você deseja que a build seja implantada.
  • Configuração de arquivamento: se o sistema deve produzir um conjunto implantável de arquivos ou compactá-los em um formato de arquivo.
  • Código integrado: o código do <script> que será incorporado no HTML das páginas do site, usado para implantar a build da biblioteca no tempo de execução.

Na guia Environments, selecione um ambiente listado para exibir seus controles de configuração.

Host

Selecione Host para escolher um host pré-configurado para o ambiente no menu suspenso.

Quando uma build é criada, o Platform Launch entrega essa build no local especificado para o host atribuído. Para obter informações sobre como criar e configurar hosts no Platform Launch, consulte a visão geral de hosts.

Configuração de arquivamento

A maioria das builds consiste em vários arquivos. As builds de vários arquivos contêm um arquivo da biblioteca principal (vinculado ao código integrado) que contém referências internas aos outros arquivos que são chamados quando necessário.

O botão Create archive permite alternar a configuração de arquivamento do ambiente. Por padrão, a opção de arquivamento é desligada e a build é entregue em um formato que é executado como está (JavaScript para propriedades da Web e JSON para propriedades móveis).

Se você optar por ativar a configuração de arquivamento, configurações adicionais aparecerão na interface do usuário, permitindo que você criptografe opcionalmente o arquivo de arquivamento e defina um caminho para a biblioteca se estiver usando a hospedagem própria.

O caminho pode ser um URL completo ou um caminho relativo que pode ser usado em vários domínios. Isso é importante porque a maioria das builds tem vários arquivos que contêm referências internas umas às outras.

Se você usar a opção de arquivamento, todos os arquivos de build serão entregues como um arquivo ZIP. Isso pode ser útil se:

  1. Você estiver hospedando a biblioteca automaticamente mas não quiser configurar um host SFTP para entrega.
  2. É necessário executar a análise do código na build antes da implantação.
  3. Você só quiser ver o conteúdo da build para ver o que há nela.

Integrar código

Um código integrado é uma tag <script> que deve ser colocada nas seções <head> das páginas do site para carregar e executar o código que você criou no Platform Launch. Cada configuração de ambiente gera automaticamente seu próprio código integrado, de modo que você só precisa copiá-lo e colá-lo em seu site nas páginas em que deseja executar o Platform Launch.

Ao visualizar as instruções de instalação, é possível optar por fazer com que o script carregue os arquivos da biblioteca de forma síncrona ou assíncrona. Essa configuração não é persistente e não reflete como você implementou o Platform Launch no seu site. Em vez disso, apenas mostra a maneira apropriada de instalar o ambiente.

AVISO

Dependendo do conteúdo da sua biblioteca Platform Launch, o comportamento das regras e outros elementos podem mudar entre a implantação síncrona e assíncrona. Portanto, é importante testar detalhadamente qualquer alteração feita.

Implantação assíncrona

A implantação assíncrona permite que o navegador continue carregando o restante da página enquanto a biblioteca está sendo recuperada. Há apenas um código integrado ao usar essa configuração, que deve ser colocado no documento <head>.

Para obter mais informações sobre essa configuração, consulte o guia sobre implantação assíncrona.

Implantação síncrona

Quando o navegador lê um código de integração usando implantação síncrona, ele recupera a biblioteca de Platform Launch e a executa antes de continuar carregando a página. Também é assim que o Dynamic Tag Management (DTM) funciona.

Os códigos integrados síncronos consistem em duas tags <script> que devem ser colocadas dentro do HTML do seu site. Uma tag <script> deve ser colocada no documento <head>, enquanto a outra deve ser colocada antes da tag </body> de fechamento.

Integrar atualizações de código

Como os códigos integrados são gerados com base nas configurações do ambiente, algumas alterações de configuração atualizarão automaticamente o código integrado do ambiente em questão. Essas alterações incluem:

  • Mudar de um host gerenciado pela Adobe para um host SFTP ou vice-versa.
  • Alteração da configuração de arquivamento.
  • Atualizar o campo de caminho se a configuração de arquivamento estiver ativada.
AVISO

Quando um código integrado de um ambiente é alterado no Platform Launch, é necessário atualizar manualmente os códigos integrados no HTML. Para evitar uma manutenção dispendiosa, atualize os códigos integrados quando for absolutamente necessário.

Criar um ambiente

Três ambientes são automaticamente atribuídos a uma propriedade quando ela é criada pela primeira vez: desenvolvimento, armazenamento temporário e produção. Isso é suficiente para executar o fluxo de trabalho de publicação. No entanto, você pode adicionar outros ambientes de desenvolvimento, se desejar, pois isso pode ser útil em equipes maiores onde vários desenvolvedores estão trabalhando em projetos diferentes ao mesmo tempo.

Na guia Environments da propriedade, selecione Add Environment.

Na tela seguinte, selecione a opção Development.

A próxima tela permite nomear o novo ambiente, selecionar um host e escolher uma configuração de arquivamento. Quando terminar, selecione Save para criar o ambiente.

A guia Environments será exibida novamente, com as instruções de instalação do novo ambiente exibidas.

Próximas etapas

Ao ler este documento, você deve ter um entendimento prático para configurar ambientes na interface do usuário e instalá-los em seu site ou aplicativo. Agora você está pronto para começar a publicar as builds de biblioteca.

Conforme você publica iterações da biblioteca, pode ser necessário rastrear e arquivar builds anteriores para fins de solução de problemas e reversão. Consulte o guia sobre republicação de bibliotecas mais antigas para obter mais informações.

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free