단일 페이지 애플리케이션(SPA)으로 VEC(시각적 경험 작성기) 문제 디버깅

이 문서에서는 Adobe Target의 SPA(단일 페이지 애플리케이션) 관련 VEC(시각적 경험 작성기) 문제를 디버깅하는 모범 사례를 제공합니다.

설명 description

환경

Adobe Target

문제/증상

SPA용 Adobe Target VEC는 보기(SPA 경험을 함께 구성하는 시각적 요소의 논리 그룹)라는 새로운 개념을 이용합니다.

SPA이 페이지 로드 시 오퍼를 검색하는 데 의존하지 않는다는 사실에 따라 몇 가지 제한 사항과 사전 요구 사항이 있습니다.

  • SPA VEC는 자동 타겟, 자동화된 개인화 또는 추천 활동을 지원하지 않습니다.

  • SPA VEC를 사용하려면 먼저 앱에서 at.js 2.0+adobe.target.triggerView() 함수를 구현해야 합니다.

  • 초기 페이지 로드 작업 순서는 다음과 같습니다.

    VisitorAPI JS" 로드 at.js 2.x" 실행 Target 요청(미리 가져오기 호출)" 호출 triggerView().

해결 방법 resolution

SPA과 관련된 VEC 문제를 디버깅하는 동안 다음을 확인하십시오.

  1. view ​에 대해 adobe.target.triggerView() 함수가 실행되었는지 확인하십시오.

  2. 페이지에서 매개 변수를 트리밍하거나 제거하지 않도록 하십시오. mboxEdit=1mboxDisable=1

    Target은 시각적 경험 작성기에서 웹 사이트를 열 때 두 개의 매개 변수(mboxEdit=1mboxDisable=1)를 추가합니다.

    한 페이지에서 다른 페이지로 이동할 때(페이지 다시 로드 없이) 웹 사이트(특히 단일 페이지 앱)가 매개 변수를 자르거나 매개 변수를 제거하면 Target 기능이 중단되고 Target 라이브러리가 로드되지 않습니다.

  3. 콘솔 로그에 표시될 수 있는 오류 메시지를 찾습니다. 예를 들어 i-frame으로 인해 보기 로드가 차단되는 문제가 발생할 수 있습니다. 일반적인 오류 메시지는 다음과 같습니다.

    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. 네트워크 로그에서 Target 보기 알림 호출(204 상태의 Target 알림 호출)을 확인하십시오. 통화가 차단되면 상태를 확인합니다.

  5. 수정 사항이 VEC에 더 이상 표시되지 않지만 수정 패널에 표시되는 문제의 경우 패널에서 수정 사항을 삭제할 수 없으면 view 이름에 후행 공백이 없는지 확인하십시오.

  6. 보기 ​이름을 설정하는 동안 확인할 기타 세부 정보는 다음과 같습니다.

    • 후행 공백이 없습니다.
    • 비워 둘 수 없습니다.
    • 보기 이름은 모든 페이지에 대해 고유해야 합니다.
    • 보기 이름은 /로 시작하거나 끝날 수 없습니다. 일반적으로 URL 경로에서 보기 이름을 추출하기 때문입니다. home ​과(와) /home ​이(가) 다릅니다.
    • {page: true} 옵션을 사용하여 동일한 보기를 여러 번 연속적으로 트리거할 수 없습니다.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f