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.

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

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.

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

  1. Navegue até a extensão de navegador do Adobe Target VEC Helper na Chrome Web Store.

  2. Clique em Add to Chrome > Add Extension.

  3. Abra o VEC no Target.

  4. Para usar a extensão, clique no ícone de extensão do navegador do VEC Helper ( ícone do VEC Helper ) na barra de ferramentas do navegador Chrome no VEC ou no Modo de QA.

  5. (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:

    VEC Helper 1

    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:

    VEC Helper 2

  6. (Condicional) Deslize o botão Cookies para a posição "ligado" para adicionar automaticamente a correção de navegador do atributo SameSite=None.

    Alternância de cookies na extensão auxiliar do VEC

    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.
recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654