Extensão de ajuda do Visual Experience Composer

A variável Adobe Target Visual Experience Composer A extensão de navegador auxiliar (VEC) do Google Chrome permite carregar os 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 do Chrome. Essa extensão não é necessária ao usar o Mozilla Firefox.

IMPORTANTE

O atual Target A extensão do VEC Helper documentada neste artigo foi criada usando o Manifest v2. A Google anunciou recentemente que não permitirá mais novas extensões criadas usando 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 mudem para a mais recente Extensão Auxiliar de edição visual. Você será notificado por meio das notas de versão e do texto deste artigo quando essa extensão deixar de funcionar. No entanto, devido aos aprimoramentos de segurança no Manifest v3, Adobe A recomenda baixar a nova extensão para continuar a criar visualmente seus sites no 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 o 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 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 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 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 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é a Extensão de navegador do 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 alternar para a posição "ativado" se a página da Web ainda não contiver a variável Target Biblioteca JavaScript 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 de navegador de atributo.

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 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 no Target UI in 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.