Solução de problemas relacionados ao Visual Experience Composer
Problemas de exibição às vezes ocorrem no Adobe Target Visual Experience Composer (VEC) sob determinadas condições.
Quando abro meu site no Visual Experience Composer, as bibliotecas do Target não são carregadas. (Somente VEC) section_8A7D3F4AD2CC4C3B823EE9432B97E06F
Target adiciona dois parâmetros (mboxEdit=1
e mboxDisable=1
) ao abrir o site no Visual Experience Composer.
Se o site (principalmente, Aplicativos de Página Única) corta parâmetros ou os remove ao navegar de uma página a outra (sem um recarregamento de página), a funcionalidade do Target é interrompida e as bibliotecas do Target não são carregadas.
Para evitar esse problema, assegure-se de não cortar ou remover esses dois parâmetros.
Minha página não abre no EEC ou carrega lentamente. As atividades ou experiências são carregadas de forma lenta no VEC. (Somente VEC) section_71E7601BE9894E3DA3A7FBBB72B6B0C1
Vários problemas podem afetar o desempenho da página nos Experience Composers Target. Alguns erros comuns incluem:
- Você não tem uma mbox na página.
- Seu site usa o bloqueio de proxy, que não permite que a página seja aberta em nenhum compositor de experiência.
- Seu site não pode ser aberto em um iFrame.
Se ocorrerem problemas no Enhanced Experience Composer, tente desativar o Enhanced Experience Composer e use o Visual Experience Composer.
Para desabilitar o Enhanced Experience Composer, vá para Administration > Visual Experience Composer e desative a opção Enable Enhanced Experience Composer.
Alguns usuários veem a seguinte mensagem de erro no console:
Se nem o Visual Experience Composer nem o Enhanced Experience Composer funcionarem, use uma extensão de navegador como o Requestly (Chrome ou Firefox) ou o Modify Response Headers (Firefox) que possa substituir as opções do cabeçalho X-Frames para o site e permitir que elas sejam carregadas em iFrames, habilitando o VEC. Se você não conseguir usar extensões de navegador, use o Experience Composer baseado em formulário.
-
Adicione regras de URL ao URL que você deseja abrir no VEC, para que os cabeçalhos sejam removidos apenas para esses URLs.
-
Habilite a regra quando estiver editando no VEC e desabilite a regra quando não estiver usando o VEC.
- Habilite a regra quando estiver editando no VEC e desabilite a regra quando não estiver usando o VEC.
Para usar a extensão Requestly em Chrome ou Firefox:
-
Desligue o Enhanced Experienced Composer.
-
Instale a extensão de navegador Requestly em Chrome ou Firefox.
-
Abra a extensão e configure-a usando o seguinte:
-
Selecione Modify headers.
-
Digite o seguinte:
-
Nome da regra
-
Regras de modificação
-
Alternar Add para Remove.
-
Alternar Request para Response.
-
Digite "X-Frame-Options" como o nome do cabeçalho.
-
Repita as etapas anteriores e digite "x-frame-options" como nome do cabeçalho.
note note NOTE Os cabeçalhos manipulados via Requestly diferenciam maiúsculas de minúsculas. -
Altere Equals para Contains como a condição para a URL de origem e insira a URL da atividade que você está tentando carregar no VEC.
-
-
-
Clique em Save.
Agora é possível carregar a página rapidamente com o Visual Experience Composer.
Para usar a extensão Modify Response Headers em Firefox:
- Instale o Modify Response Headers em Firefox e reinicie o navegador.
- Em suas extensões do Firefox, selecione a extensão Modificar Cabeçalhos de Resposta.
- Clique em Preferences.
- Selecione Filter no menu suspenso Action.
- No campo Header Name, digite: X-Frame-Options.
- Repita as etapas 4 e 5 para adicionar um filtro com x-frame-options.
- Clique em Add.
- Clique em Start.
Após configurar uma extensão, abra o Target. Suas páginas agora devem ser carregadas no Visual Experience Composer, mesmo que o Enhanced Experience Composer esteja desativado.
Minha página não é exibida no VEC (somente VEC) does-not-load
-
A melhor compatibilidade com o VEC é garantida pela versão mais recente da extensão: Adobe Experience Cloud Visual Editing Helper extension.
Para verificar se você está usando a versão mais recente, vá para Extensions > Manage Extensions e clique em Details.
-
O Visual Experience Composer requer a criação de bibliotecas para realizar modificações na página da Web. Essas bibliotecas são incorporadas à biblioteca at.js e são baixadas pela extensão dos servidores do Adobe sempre que o VEC é usado.
A extensão baixa a biblioteca at.js independentemente de a at.js ou o Adobe Experience Platform Web SDK já estarem incluídos na página.
Verifique se não há alterações inválidas adicionadas aos cabeçalhos do at.js configurados na seção Administration > Implementation.
-
Certifique-se de que a página da Web não esteja bloqueando solicitações obrigatórias para carregamento quando incorporada a um iFrame. Isso inclui o uso de diretivas CSP frame-ancestors ou o código JS personalizado incorporado no site do cliente, tags meta HTML ou o cabeçalho x-frame-options.
-
Certifique-se de que o JavaScript da página da Web não interfira nas bibliotecas de criação. Não use ou inclua arquivos usando os seguintes nomes reservados:
-
target-vec-helper.js
-
target-vec.js
-
target.js
-
admin.css
-
sizzle.js
-
mixContentCheck.html
Além disso, a substituição acidental de variáveis ou eventos definidos nesses arquivos pode levar a problemas com o VEC.
-
-
O navegador está bloqueando uma página não segura em um site seguro.
Clique no ícone à esquerda da URL na barra de endereços do navegador e clique em Disable protection on this page
-
Você inseriu um URL inválido.
-
Se o site não carregar no VEC ou se comportar inesperadamente, uma possível correção é aceitar cookies no site no navegador antes de tentar carregá-lo no Target.
O VEC aparece interrompido quando uso o modo de navegação. (Somente VEC) section_FA2A18E8FD6A4274B2E395DBAA2FB407
Ao usar o modo de navegação, se você acessar uma URL que não tem bibliotecas do Target implementadas (at.js ou Adobe Experience Platform Web SDK) ou que contém um cabeçalho frame-buster, o VEC parece interrompido. Devido a preocupações de segurança do navegador, o Target não pode acessar corretamente a URL para a qual você navegou ou a URL do VEC não é atualizada de forma consistente se a página for carregada.
Esse problema ocorre porque o VEC carrega a página da Web em um <iframe>
. Os mecanismos de segurança atuais dos navegadores impedem que a interface do usuário Target acesse os elementos do quadro fornecido devido à política de mesma origem. Os navegadores bloqueiam scripts que tentam acessar um quadro com uma origem diferente e que inclui informações como location.href
.
Você deve usar a nova extensão do Auxiliar de Edição Visual (recomendável) ou a extensão antiga para inserir a biblioteca Target nas páginas para navegá-las de forma ideal.
Problemas causados por conflitos CSS no Visual Experience Composer
Verifique se há algum arquivo CSS que possa afetar a visibilidade ao carregar a página da Web no editor. Por exemplo, usar a propriedade overflow: hidden
no corpo da página pode levar a problemas de rolagem ou acionar eventos de clique que podem interferir no menu de criação.