Salesforce 상거래 클라우드 카트리지를 업그레이드하는 방법
학습 내용
클라비요 세일즈포스 커머스 클라우드 카트리지를 업그레이드하는 방법을 알아보세요.
23.7.0보다 오래된 카트리지 버전을 사용하고 계신가요? 즉시 버전 23.7.0 또는 그 이상으로 업그레이드하시기를 권장합니다. 이전 버전의 카트리지는 Klaviyo의 v1 및 v2 API를 사용하며, 이 API는 더 이상 지원되지 않으며 예상대로 작동하지 않습니다. 우리는 항상 최신 버전(현재 25.7.0)으로 업그레이드하시기를 권장합니다.
시작하기 전 안내 사항시작하기 전 안내 사항
버전 23.7.0에는 여러 가지 의미 있는 개선 사항이 포함되어 있으며, 그 중 일부는 이벤트 트리거 방식과 관련된 아키텍처 변경 사항입니다. 23.70 미만 버전에서 그 이상의 버전으로 업그레이드할 때 특별히 고려해야 할 사항은 아래에 자세히 설명되어 있습니다.
현재 통합 상태 이해하기현재 통합 상태 이해하기
현재 SFCC 통합과 웹사이트에 특별히 어떤 변경 또는 사용자 지정이 이루어졌는지 파악하는 것이 중요합니다. 가장 중요한 것은 클라비요에 전송하는 특정 이벤트 데이터가 변경되거나 보강되었는지 여부와 사용자 지정 이벤트를 추가했는지 여부를 고려해야 한다는 것입니다.
이벤트 데이터를 수집하는 코드를 클라비요의 깃허브에서 제공되는 이전 버전의 클라비요 카트리지와 비교하는 것을 권장합니다. 통합을 크게 사용자 정의하지 않았다고 가정하면, 현재 데이터 어셈블리 함수는 int_klaviyo_core/cartridge/scripts/utils/klaviyo/klaviyoUtils.js에서
, 주문 확인은 int_klaviyo_core/cartridge/scripts/utils/klaviyo/emailUtils.js에서
찾을 수 있습니다.
새 카트리지를 설치한 후 다시 적용할 수 있도록 사용자 지정 사항을 기록해 두세요.
SFCC 샌드박스를 클라비요 테스트 계정에 연결하기SFCC 샌드박스를 클라비요 테스트 계정에 연결하기
SFCC 프로덕션 환경에 연결된 계정과 별도로 테스트용 보조 클라비요 계정을 아직 만들지 않았다면 지금 바로 만들어야 합니다. 그런 다음 SFCC 샌드박스 환경을 새 계정에 연결합니다. 새 클라비요 카트리지로 코드베이스를 업그레이드하기 전에 이벤트가 보조 클라비요 계정에서 성공적으로 송수신되는지 확인할 수 있도록 이전 클라비요 카트리지 버전을 사용하여 이 단계를 완료하는 것이 좋습니다.
이전 클라비요 카트리지 코드 제거이전 클라비요 카트리지 코드 제거
통합을 크게 사용자 정의하지 않은 경우, 코드베이스에서 int_klaviyo_core와 int_klaviyo(Site Genesis용) 또는 int_klaviyo_sfra(SFRA용) 두 개의 Klaviyo 카트리지 폴더를 삭제하기만 하면 이전 Klaviyo 통합의 대부분을 제거할 수 있습니다. 그러나 템플릿 파일에 추가되었을 수 있는 클라비요 관련 코드와 자바스크립트 파일도 제거해야 합니다.
사이트 제네시스의 경우사이트 제네시스의 경우
Site Genesis의 표준 통합에는 footer_UI.isml에 다음 코드가 추가됩니다:
<isinclude template="components/footer/klaviyoFooter"/>
또한 미니카트.isml에 다음 블록이 추가됩니다, cart.isml 및 기타 모든 "장바구니" isml 파일을 삭제합니다:
<isif condition="${pdict.CurrentHttpParameterMap.cartAction == 'add' || pdict.CurrentHttpParameterMap.cartAction
== 'update'}">
<isinclude url="${URLUtils.url('Klaviyo-RenderKlaviyoAddToCart')}"/>
</isif>
SFRA의 경우SFRA의 경우
SFCC의 표준 통합에는 pageFooter.isml에 다음 코드가 추가됩니다:
<isinclude template="klaviyo/klaviyoFooter"/>
또한 Cart.js 컨트롤러의 AddProduct 경로에 다음 코드가 추가됩니다:
if(dw.system.Site.getCurrent().getCustomPreferenceValue('klaviyo_enabled')){
var KlaviyoUtils = require('*/cartridge/scripts/utils/klaviyo/klaviyoUtils');
KlaviyoUtils.trackAddToCart();
}
Site Genesis와 SFRA 모두 카트리지 폴더와 위에서 언급한 코드 스니펫을 제거한 후 코드베이스에서 "클라비요"라는 단어를 검색하는 것이 좋습니다. 코드베이스에 남아 있는 클라비요 관련 코드는 새 카트리지를 설치한 후 다시 제자리에 넣어야 할 사용자 지정 블록일 수 있으므로 제거하기 전에 어떤 기능을 하는지 잘 알고 있어야 합니다.
서비스 제거서비스 제거
이전 통합은 관리 > 운영 > 서비스에서 KlaviyoTrack서비스, KlaviyoTrack프로필 및 KlaviyoTrack크레딧을 생성했을 것입니다. 새로운 클라비요 카트리지를 통합하는 과정에서 다른 이름의 새 서비스가 생성되므로 세 가지 모두 안전하게 제거할 수 있습니다.
이전 서비스를 반드시 제거해야 하는 것은 아니지만 향후 혼란을 방지하기 위해 정리하는 것이 좋습니다.
사이트 기본 설정 검토사이트 기본 설정 검토
새 클라비요 카트리지를 통합하는 과정에서 이전 클라비요 사이트 환경설정 중 일부는 유지되며, 새로운 환경설정도 추가됩니다. 판매자 도구 > 사이트 기본 설정 > 사용자 지정 기본 설정 > klaviyo의 클라 비요 기본 설정 그룹에서 사이트 기본 설정을 살펴보고 웹사이트에 특별히 추가된 사용자 지정 기본 설정이 있는지 확인합니다. 카트리지를 사용자 지정하여 고유한 설정을 추가한 경우 해당 설정을 보존하고 싶을 것입니다. 참고로, 이전 클라비요 통합에 내장된 네 가지 사이트 환경 설정은 다음과 같습니다:
-
클라비요 사용(ID: klaviyo_enabled)
클라비요가 켜져 있는지 또는 꺼져 있는지 플래그를 지정합니다.