Extensão auxiliar do Visual Experience Composer
A extensão de navegador do Adobe Target Visual Experience Composer (VEC) Helper para Google Chrome permite carregar sites de maneira confiável no VEC para criar e controlar a qualidade das experiências da web com rapidez.
O navegador VEC Helper é uma extensão Chrome. Esta extensão não é necessária ao usar Mozilla Firefox.
-
A extensão auxiliar do VEC Target herdada documentada neste artigo foi criada usando o Manifest V2. Google anunciou que não permitirá mais extensões criadas usando o Manifest V2 a partir de junho de 2024. Para obter mais informações, consulte o anúncio da linha do tempo de suporte do Manifest V2 de Google no site Chrome para Desenvolvedores.
-
A partir de junho de 2024, o Google começará a desabilitar as extensões criadas usando o Manifesto V2, incluindo a extensão documentada neste tópico. A Adobe recomenda que os clientes mudem para a extensão Auxiliar de edição visual mais recente assim que possível.
-
Os clientes que usam os Repositórios da Web Privados da Chrome devem continuar a usar esta versão da extensão até que o suporte para este caso de uso seja implementado na nova Visual Editing Helper extensão até o final de janeiro de 2025.
Motivos pelos quais alguns sites podem não abrir de forma confiável no VEC
- O site tem políticas de segurança estritas.
- O site está em um iframe.
- A biblioteca do at.js ainda não está implementada no site.
- O site de controle de qualidade e/ou preparo do cliente não está disponível para partes externas (o site é interno).
- Existem algumas limitações atuais ao tentar usar o VEC para abrir um site que esteja usando o Service Workers (SW).
Um SW é uma tecnologia da Web que pode ser usada para interceptar solicitações do domínio em que estão instalados por uma página da Web. O SW se mantém na visita da página e se ativa em visitas subsequentes. Ele decide quais solicitações são passadas e quais são interceptadas e fornecidas a partir de um cache.
O SW pode controlar o armazenamento em cache; pode armazenar em cache a própria página da Web, recursos estáticos, como JS, CSS, IMG, solicitações de AJAX e seu conteúdo e cabeçalhos de resposta, incluindo aqueles que a extensão auxiliar do Target VEC tenta remover, como X-Frame-Options: SAMEORIGIN, CSP (Política-Segurança-Conteúdo) ou definir-cookie.
Infelizmente, as APIs de extensão do Chrome que interceptam solicitações da Web não recebem as solicitações que foram interceptadas e tratadas por um SW. Portanto, a extensão não pode corrigir os cabeçalhos e os cookies se a solicitação de página da Web foi fornecida a partir de um cache por um SW, pois a página da Web não será carregada dentro do VEC devido ao X-Frame-Options ou cabeçalhos CSP que também foram armazenados em cache.
Como uma possível solução alternativa, você pode desativar o Service Workers do Chrome Developer Tools > guia do Aplicativo e, em seguida, habilitar a caixa de seleção "Bypass for network" na seção Service Workers.
- Você está usando o Google Chrome 80+ com políticas aprimoradas de imposição de cookies do SameSite. Para obter mais informações, consulte Como as políticas de imposição de cookies SameSite do Google Chrome recentemente anunciadas afetam o VEC e o EEC?
A extensão de navegador VEC Helper para o Chrome resolve problemas de carregamento de site para os quais os clientes agora dependem do Target Enhanced Experience Composer ou de extensões de terceiros, como o Requestly.
Benefícios do uso da extensão VEC Helper
-
Todos os cabeçalhos de interrupção de iframe, como X-Frame-Opções e Conteúdo-Segurança-Política, são removidos implicitamente do site. Não há mais necessidade de criar regras complicadas do Requestly.
-
Se uma página da Web ainda não contiver a biblioteca JavaScript do at.js Target, você poderá usar a extensão e inserir a biblioteca para poder criar experiências no site. Em seguida, você pode criar atividades, além de QA, usando links de visualização.
Observe que ao usar o Enhanced Experience Composer (EEC), a extensão não insere a at.js, mas a funcionalidade de cookie SameSite ainda está presente. Para inserir a at.js na página da Web, desative o EEC.
-
Visores móveis são suportados mesmo sem o Enhanced Experience Composer (EEC).
-
Os clientes novos do Target podem usar a extensão para experimentar com Target mesmo se os desenvolvedores de TI ainda não tiverem implementado o Target em seus sites.
-
Os parceiros que servem vários sites e contas do Target de vários clientes agora têm um mecanismo simples para suportar o carregamento do VEC, em vez de gerenciar várias regras em ferramentas de terceiros.
Obter e instalar a extensão do navegador VEC Helper
-
Navegue até a extensão de navegador do Adobe Target VEC Helper na Chrome Web Store.
-
Clique em Add to Chrome > Add Extension.
-
Abra o VEC no Target.
-
Para usar a extensão, clique no ícone de extensão do navegador do VEC Helper (
-
(Condicional) Deslize o botão Inject Target Libraries para a posição "ligado" se a página da Web ainda não contiver a biblioteca at.js de JavaScript Target.
A ilustração a seguir mostra o VEC Helper com a configuração Inject Target Libraries ativada:
A ilustração a seguir mostra o VEC Helper perguntando se você deseja inserir bibliotecas do Target na página para ativar a criação:
-
(Condicional) Deslize o botão Cookies para a posição "ligado" para adicionar automaticamente a correção de navegador do atributo
SameSite=None.
Para obter mais informações sobre a correção de navegador do atributo
SameSite=None, consulte “Como as políticas de aplicação de cookies SameSite do Google Chrome recentemente anunciadas afetam o VEC e o EEC?” em Solução de problemas relacionados ao Visual Experience Composer e ao Enhanced Experience Composer.
Notas
-
O sinalizador Inject Target libraries na extensão está desativado por padrão. Você pode ativar esse sinalizador se desejar usar o VEC em um site que ainda não foi implementado para Target.
Esse sinalizador é uma configuração global. O sinalizador é ativado ou desativado para todos os sites abertos no VEC. Assim, por exemplo, se você definir esse sinalizador como "ativado" e abrir um site que já esteja implementado com a at.js, você receberá uma mensagem informando que a at.js já está carregada. O Adobe prevê que a maioria dos clientes já tenha o at.js implementado em suas páginas e use a configuração padrão "desativado".
-
A extensão carrega a versão mais recente da at.js disponível do Target UI em Administration > Implementation.
-
Ao usar a extensão para inserir o at.js enquanto estiver no Modo de QA, é necessário abrir outra guia do Chrome. Essa guia do Chrome deve ser autenticada na mesma organização de Adobe Experience Cloud na qual você criou a atividade.
-
As mensagens a seguir ajudam a manter você informado:
- Caso tente carregar um site usando o VEC que não é carregado, uma mensagem será exibida sugerindo que você instale a extensão de navegador VEC Helper.
- Se o at.js ainda não estiver implementado no site, uma mensagem será exibida no VEC sugerindo que você instale a extensão.
- Se a extensão estiver ativada e promovendo o carregamento, as mensagens serão exibidas quando a extensão injetar a biblioteca do at.js (se necessário) ou ajudar a abrir o site de forma confiável no VEC.