Platform Web SDK 호환성을 위한 Target 대상자 및 프로필 스크립트 업데이트

Target을 Platform Web SDK로 마이그레이션하는 기술 업데이트를 완료한 후 원활하게 전환하려면 일부 대상, 프로필 스크립트 및 활동을 업데이트해야 할 수 있습니다.

모든 Target mbox 매개 변수는 Platform 웹 SDK 구현을 사용하여 XDM 형식으로 전달해야 합니다. 프로덕션에 변경 사항을 게시하기 전에 다음을 수행해야 합니다.

대상자 조정

사용자 지정 mbox 매개 변수를 사용하는 모든 대상은 새 XDM 매개 변수 이름을 사용하도록 업데이트해야 합니다. 예를 들어 page_name에 대한 사용자 지정 매개 변수가 web.webpagedetails.pageName에 매핑될 수 있습니다.

at.js 및 Platform Web SDK와의 호환성을 보장하기 위한 한 가지 접근 방식은 아래와 같이 OR 조건이 사용되도록 관련 대상을 업데이트하는 것입니다.

프로필 스크립트 편집

대상과 마찬가지로 새 XDM 매개 변수 이름을 참조하도록 프로필 스크립트를 업데이트해야 합니다. mbox 매개 변수 이름을 변경해도 at.js와 Platform Web SDK 구현 간에 프로필 스크립트가 작동하는 방식에는 차이가 없습니다.

호환성을 확인하는 한 가지 방법은 프로필 스크립트 코드에서 OR 조건을 사용하는 것입니다.

프로필 스크립트 예:

if(mbox.param('pageName') == 'Product Details'){
  return true
}

Platform Web SDK 호환성에 대한 프로필 스크립트가 업데이트되었습니다.

if((mbox.param('pageName') == 'Product Details') || (mbox.param('web.webPageDetails.pageName') =='Product Details')){
  return true
}

자세한 내용과 모범 사례는 프로필 스크립트에 대한 전용 설명서를 참조하세요.

다이내믹 컨텐츠에 대한 매개 변수 토큰 업데이트

다이내믹 콘텐츠 대체를 사용하는 오퍼, 권장 사항 디자인 또는 활동이 있는 경우 새 XDM 매개 변수 이름을 고려하여 그에 따라 업데이트해야 할 수 있습니다.

mbox 매개 변수에 토큰 교체를 사용하는 방법에 따라 기존 설정을 개선하여 이전 매개 변수와 새 매개 변수 이름을 모두 고려할 수 있습니다. 그러나 JSON 오퍼에서와 같이 사용자 정의 JavaScript 코드를 사용할 수 없는 상황에서는 마이그레이션이 완료된 후 프로덕션 사이트에서 라이브를 만들고 사본을 만들어야 합니다.

JSON 오퍼 예:

{
  "pageName" : "${mbox.page_name}",
  "layoutVariation" : "grid"
}

Platform Web SDK 매개 변수 이름을 사용하는 JSON 오퍼 예:

{
  "pageName" : "${mbox.web.webPagedDetails.pageName}",
  "layoutVariation" : "grid"
}

마이그레이션 후 새 XDM mbox 매개 변수 이름을 고려하도록 조정하는 경우, 마이그레이션 이벤트 중에 영향을 받는 활동을 일시 중지하여 방문자에 대한 활동 표시 오류를 방지해야 합니다.

다음으로 Target 구현의 유효성을 검사하는 방법을 알아봅니다.