Documentação

Depuração de problemas do Visual Experience Composer (VEC) com aplicativos de página única (SPA)

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Este artigo fornece práticas recomendadas para depurar problemas do Visual Experience Composer (VEC) com aplicativos de página única (SPA) no Adobe Target.

Descrição description

Ambiente

Adobe Target

Problema/Sintomas

O VEC do Adobe Target para SPA aproveita um novo conceito chamado Exibições(um grupo lógico de elementos visuais que juntos constituem uma experiência com o SPA).

Com base no fato de que o SPA não depende da recuperação de ofertas no carregamento da página, há algumas limitações e pré-requisitos:

  • O VEC do SPA não é compatível com direcionamento automático, personalização automatizada ou atividades de recomendação.

  • at.js 2.0+ e a função adobe.target.triggerView() devem ser implementadas no aplicativo antes que você possa usar o VEC do SPA.

  • A ordem de operações do carregamento inicial da página é a seguinte:

    Carregar VisitorAPI JS" Carregar at.js 2.x" Executar Solicitação do Target (chamada de pré-busca)" Chamada triggerView().

Resolução resolution

Ao depurar os problemas do VEC relacionados ao SPA, verifique o seguinte:

  1. Verifique se a função adobe.target.triggerView() foi acionada para cada exibição.

  2. Certifique-se de que a sua página não corte nem remova os parâmetros: mboxEdit=1 e mboxDisable=1

    O 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) cortar nossos parâmetros ou removê-los ao navegar de uma página para outra (sem um recarregamento de página), a funcionalidade do Target será interrompida e as bibliotecas do Target não serão carregadas.

  3. Procure qualquer mensagem de erro que possa ser exibida nos registros do Console. Por exemplo, pode haver um problema com o i-frame bloqueando o carregamento da visualização. Uma mensagem de erro comum é:

    code language-none 
    Uncaught DOMException: Blocked a frame with origin "https://view.customer-website.com" from accessing a cross-origin frame.
at https://www.adobe.com

  4. Verifique a chamada de notificação de exibição do Target nos logs de rede (chamada de notificação do Target com status 204). Se a chamada estiver bloqueada, verifique o status.

  5. Para problemas em que a modificação não é mais exibida no VEC, mas aparece no painel de modificação; e você não pode excluir as modificações do painel, verifique se não há espaços à direita no nome da exibição.

  6. Outros detalhes a serem garantidos durante a configuração do nome da exibição são:

    • Sem espaços à direita.
    • Não pode estar em branco.
    • O nome da Exibição deve ser exclusivo para todas as páginas.
    • O nome da Exibição não deve iniciar ou terminar com /. Isso ocorre porque geralmente se extrai o nome da visualização do caminho do URL. Para nós, casa e /casa são diferentes.
    • A mesma exibição não deve ser acionada consecutivamente várias vezes com a opção {page: true}.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f