Extensão de ajuda do Visual Experience Composer

O Adobe Target Visual Experience Composer (VEC) A extensão do navegador de ajuda para o Google Chrome permite carregar os sites de maneira confiável no VEC a fim de criar e controlar a qualidade das experiências da Web com rapidez.

O navegador VEC Helper é uma extensão do Chrome. Essa extensão não é necessária ao usar o Mozilla Firefox.

IMPORTANTE

O atual Target A extensão VEC Helper documentada neste artigo foi criada usando o Manifest v2. A Google anunciou recentemente que não permitirá mais novas extensões criadas com o Manifest v2.

A extensão existente ainda funciona no Google Chrome. No futuro, Adobe descontinuará a extensão auxiliar documentada neste tópico e exigirá que os clientes se movam para o mais novo Extensão do Visual Editing Helper. Você será notificado por meio de notas de versão e texto neste artigo quando esta extensão parar de funcionar. No entanto, devido aos aprimoramentos de segurança no Manifest v3, Adobe O recomenda baixar a nova extensão para continuar a criar visualmente seus sites em Target.

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 Trabalhadores do Serviço (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 veiculada a partir de um cache por um SW, pois a página da Web não será carregada dentro do VEC devido às 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 SameSite. Para obter mais informações, consulte Como as políticas de imposição de cookies do Google Chrome SameSite 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 extensões de terceiros, como Requestly.

Benefícios do uso da extensão do 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 Requestly complicadas.
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, usando o Enhanced Experience Composer (EEC), a extensão não injeta 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 permitidos 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é o Extensão de navegador Adobe Target VEC Helper na Chrome Web Store.
Clique em Adicionar ao Chrome > Adicionar extensão.
Abra o VEC no Target.
Para usar a extensão, clique no ícone de extensão do navegador do VEC Helper () na barra de ferramentas do navegador Chrome no VEC ou no Modo de QA.
(Condicional) Deslize o Inserir bibliotecas do Target alterne para a posição "ativada" se a página da Web ainda não contiver a variável Target Biblioteca de JavaScript da at.js.

A ilustração a seguir mostra o VEC Helper com a configuração Inserir bibliotecas do Target 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 Cookies alterne para a posição "ativada" para adicionar automaticamente a variável SameSite=None correção do navegador de atributos.

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 Inserir bibliotecas do Target 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 antecipa que a maioria dos clientes já tenha o at.js implementado em suas páginas e use a configuração padrão de "desativado".
A extensão carrega a versão mais recente do at.js disponível no Target UI em Administração > Implementação.
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.