Platform Web SDK 구현의 유효성 검사
Target 구현을 at.js에서 Platform Web SDK로 마이그레이션한 후 프로덕션 사이트에 변경 사항을 게시하기 전에 모든 것이 제대로 작동하는지 확인하는 것이 중요합니다. Adobe은 이 페이지에서 자세히 다루는 다음 사항을 권장합니다.
- 기술 유효성 검사를 수행하여 기본 구현 및 Platform Web SDK 요청 및 응답이 올바른지 확인합니다
- Target 활동이 제대로 전달되고 렌더링되는지 확인합니다.
- 보고가 올바르게 작동하는지 확인
- 대상자 및 프로필 스크립트를 다시 방문하여 Platform Web SDK와 호환되는지 확인하십시오
- Adobe 또는 서드파티 애플리케이션과의 통합이 올바르게 작동하는지 확인
모든 Target 구현은 사이트 아키텍처 및 사용되는 기능에 따라 다릅니다. 아래 표를 시작점으로 사용하여 구현에 고유한 항목을 추가할 수 있습니다. 이 자습서의 디버깅 페이지에는 이 유효성 검사에 도움이 되는 데 사용할 수 있는 도구가 표시됩니다.
기술 유효성 검사
유효성 검사 항목
참고
at.js 코드 조각 사전 숨김이 페이지에 더 이상 없습니다
Platform Web SDK는 ID가
at-body-style인 스타일을 자동으로 제거하지 않습니다. 페이지에 이 이전 코드 조각을 남겨두면 코드 조각 시간 제한에 도달할 때까지 숨겨진 컨텐츠가 발생합니다.at.js 라이브러리가 더 이상 페이지에 없습니다
브라우저의 개발자 도구 콘솔에 "adobe.target" 개체가 없는지 확인합니다. Platform Web SDK와 at.js를 모두 포함하면 의도하지 않은 렌더링 동작이 발생합니다
필요한 매개 변수가
sendEvent 요청의 XDM 및 데이터 개체에 있습니다.페이지 요청을 사용하여 카탈로그를 채우는 경우 Recommendations 카탈로그가 예상대로 업데이트됩니다
프로필 매개 변수가 Target에 정상적으로 전달되었습니다.
디버거에서 Edge 추적 보기
데이터 스트림 매퍼에서 XDM에 매핑된 매개 변수는 Target에 올바르게 전달됩니다
디버거 및/또는 보증의 Edge 추적 기능을 사용하여 유효성 검사
Target 콘텐츠가 적용 가능한
sendEvent개 응답에서 반환됩니다.renderDecisions 옵션이 true(으)로 설정되어 있거나 범위가 요청되고 사용자가 특정 Target 활동에 대한 자격이 있는 경우 필요합니다.VEC 기반 활동이 렌더링된 후
decisioning.propositionDisplay 이벤트가 실행됩니다.자동으로 렌더링되고 온디맨드로 렌더링되는 활동에는 별도의 이벤트 호출이 필요합니다
양식 기반 활동 렌더링 후
decisioning.propositionDisplay 이벤트가 실행됩니다.특정 구현에만 적용할 수 있습니다. 이 호출을 실행하려면 사용자 지정 코드가 필요합니다.
SPA 보기 변경 시 오퍼가 적용되면
decisioning.propositionDisplay 이벤트가 실행됩니다SPA 구현에만 적용 가능
지정된 보기에 대해 SPA 구성 요소가 다시 렌더링될 때
decisioning.propositionDisplay 이벤트가 실행되지 않습니다.SPA 구현에만 적용 가능
활동 전환 후
decisioning.propsitionInteract 이벤트가 실행됨at.js
trackEvent 또는 sendNotifications에서 마이그레이션된 "요소를 클릭함" 및 사용자 지정 전환에는 별도의 이벤트 호출이 있어야 합니다응답 토큰이
sendEvent 응답에서 반환되고 예상 값이 있습니다.응답 토큰은 웹 SDK에서 정상적으로 작동해야 함
ECID는 Web SDK 및 at.js를 사용하는 페이지 간에 일관됩니다
페이지별 마이그레이션에 적용됩니다. 리디렉션 오퍼는 이러한 유형의 마이그레이션에서는 작동하지 않습니다
활동 전달 및 렌더링
유효성 검사 항목
참고
VEC 기반 활동은 페이지 로드 시 올바르게 렌더링됩니다
요소를 다시 정렬하거나 텍스트를 바꾸는 것과 같은 사용자 지정 코드 수정 사항과 기본 수정 사항을 모두 확인하는 것이 가장 좋습니다
SPA 보기 변경 시 VEC 기반 활동이 올바르게 렌더링됩니다.
SPA 구현에만 적용 가능
양식 기반 활동이 올바르게 렌더링됨
특정 구현에만 적용할 수 있습니다. 양식 기반 활동을 렌더링하려면 at.js와 유사한 사용자 지정 코드가 필요합니다.
리디렉션을 사용하는 활동이 제대로 작동합니다
소스 페이지와 대상 페이지가 모두 Platform Web SDK를 사용하는 경우 리디렉션이 지원됩니다. at.js 페이지에서 Platform Web SDK 페이지로의 Target 리디렉션 또는 그 반대 방법은 지원되지 않습니다.
원격 오퍼를 사용하는 활동이 제대로 작동함
일반적이지 않습니다. 원격 오퍼에 대한 Target 오퍼 인벤토리를 확인하십시오.
깜박임이 적절하게 완화됩니다.
플리커 처리는 선택 사항이지만, 현재 사용하고 있는 모든 완화 전략이 최적의 페이지 성능과 사용자 경험을 위해 예상대로 작동하는지 확인하십시오
QA 링크가 예상대로 작동합니다
작동하지 않는 경우 web.webPageDetails.URL이 브라우저의 URL과 정확히 일치하는지 확인합니다
일반적으로 사용되는 모든 오퍼 유형은 예상대로 렌더링됩니다
보고
유효성 검사 항목
참고
방문자는 VEC 기반 활동으로 인한 것입니다
보고가 페이지 로드 수정 및 SPA 보기 수정 모두에 대해 예상대로 작동하는지 확인하는 것이 가장 좋습니다
방문자는 양식 기반 활동으로 인한 것입니다
사용된 렌더링 방식에 따라 구현에는
decisioning.propositionDisplay 이벤트를 실행하기 위해 사용자 지정 코드가 필요할 수 있습니다표준 전환 목표가 올바르게 캡처됩니다.
보고 소스로 Target 또는 Analytics에 적용됩니다.
주문 전환 및 세부 사항이 올바르게 캡처됩니다.
감사 보고서 확인
클릭 추적 전환이 제대로 캡처됩니다.
사용자 정의 전환 목표가 올바르게 캡처됨
예를 들어 전환 목표가 at.js
trackEvent 또는 sendNotifications에서 마이그레이션되었으며, 이는 "mbox 확인함" 목표와 함께 일반적으로 사용됩니다대상자 및 프로필 스크립트
유효성 검사 항목
참고
라이브 활동에 사용된 대상은 Platform Web SDK와 호환됩니다
"사용자 지정" (mbox 매개 변수) 구성 요소를 사용하는 대상은 XDM 속성을 포함하도록 업데이트해야 합니다
모든 프로필 스크립트는 Platform Web SDK와 호환됩니다
mbox 매개 변수를 사용하는 모든 프로필 스크립트는 XDM 속성을 포함하도록 업데이트해야 합니다
Target 대상에 대한 활동이 반환됩니다.
Platform Web SDK와 호환되도록 수정하는 대상에 대해 전체적인 유효성 검사를 수행하는 것이 가장 좋습니다
프로필 스크립트가 예상대로 평가됨
디버거에서 Edge 추적 보기
Adobe 애플리케이션과 통합
유효성 검사 항목
참고
Experience Cloud 대상에 대한 활동이 반환됩니다.
예: Adobe Analytics에서 게시된 세그먼트
Experience Platform 대상에 대한 활동이 반환됩니다.
RTCDP와 같은 Experience Platform 기반 애플리케이션에 대한 라이센스가 있는 경우에만 적용됩니다.
Audience Manager 대상에 대한 활동이 반환됩니다.
예를 들어 특정 페이지 방문을 기반으로 한 세그먼트
Target 활동 데이터가 Analysis Workspace에 표시됨
Adobe Analytics을 보고 소스로 사용하는 활동에 적용
타사 애플리케이션과 통합
유효성 검사 항목
참고
응답 토큰 데이터가 타사 애플리케이션에 올바르게 전달됨
통합 접근 방식은 다양할 수 있지만 일반적인 방법은 Target 응답 토큰을 사용하여 활동 및 경험 정보를 Google Analytics과 같은 다른 분석 도구에 전달하는 것입니다
서드파티의 정보는 XDM 또는 프로필 데이터로 전달됩니다
타사의 모든 관련 정보는 Target에
sendEvent 호출 시 전달되어야 합니다.위의 유효성 검사 단계를 수행한 후에는 Platform Web SDK 구현이 프로덕션으로 이동할 준비가 된 것으로 확신할 수 있습니다.
다음으로 Platform Web SDK를 사용하여 Target 구현 문제를 해결하는 방법을 알아봅니다.
NOTE
at.js에서 Web SDK로 Target을 성공적으로 마이그레이션할 수 있도록 지원하기 위해 최선을 다하고 있습니다. 마이그레이션에 문제가 발생하거나 이 안내서에 중요한 정보가 누락된 것 같은 느낌이 드는 경우 이 커뮤니티 토론에 게시하여 알려 주십시오.
recommendation-more-help
a69e1b51-9545-4d8a-822d-319242c29110