이전 버전과의 호환성 표준

NOTE
Adobe Experience Platform Launch은 Adobe Experience Platform의 데이터 수집 기술군으로 새롭게 브랜딩되었습니다. 그 결과 제품 설명서에 몇 가지 용어 변경 사항이 적용되었습니다. 용어 변경에 대한 통합 참고 자료는 다음 문서를 참조하십시오.

Adobe Experience Platform의 태그 확장 업데이트는 이전 버전의 확장과 호환되어야 합니다. 이것의 의미는 다음과 같습니다.

  • 확장의 기본 구성 요소에 대한 수정한 사항은 이전 버전과 호환되어야 합니다. 이러한 구성 요소에는 확장 구성, 이벤트 유형, 조건 유형, 작업 유형, 데이터 요소 유형 및 공유 모듈이 포함됩니다.
  • 사용자가 이전 확장 버전으로 생성한 구성 요소는 최신 버전에서 제공하는 스키마에 대한 유효성 검사를 제공할 수 있어야 합니다.
  • Adobe Experience Platform 사용자는 업데이트된 버전의 확장을 설치하고 사용자가 수행한 모든 작업이 의도한 대로 계속 작동하도록 해야 합니다.

허용되는 변경 사항

다음과 같은 유형의 확장 변경이 허용됩니다.

  1. 새 구성 요소(예: 이벤트 유형, 조건 유형 등)를 추가할 수 있습니다.
  2. 확장 구성 설정에 새 옵션 필드를 추가할 수 있습니다.
  3. 필수 필드를 옵션 필드로 변경할 수 있습니다.

금지되는 변경 사항

다음 유형의 확장 변경은 허용되지 않습니다.

  1. 구성 요소의 이름을 바꿀 수 없습니다.
  2. 구성 요소를 제거할 수 없습니다.
  3. 구성 요소에서 필드를 제거할 수 없습니다.
  4. 옵션 필드를 필수 필드로 변경할 수 없습니다.
  5. 새 필수 필드를 추가할 수 없습니다.
  6. 기존 공유 모듈의 API를 변경할 수 없습니다.

이러한 변경 작업을 수행하면 속성에 확장을 설치한 사용자의 경우 즉시 다음과 같은 문제가 발생합니다.

  • 규칙 구성 요소 중 하나가 존재하지 않는 구성 요소를 찾으므로 더 이상 규칙이 올바르게 렌더링되지 않습니다.
  • 확장에 더 이상 존재하지 않는 업스트림 리소스가 라이브러리에 포함되어 모든 빌드가 실패합니다.
  • 새 스키마에 대한 유효성 검사가 실패한 설정이 있는 리소스가 라이브러리에 포함되므로 모든 빌드가 실패합니다.

특히 이 두 번째 경우 사용자가 수정할 수 있는 방법이 없어 다시 게시할 수 없습니다.

기능 제거

유효한 비즈니스 사유가 있고 위 목록에 포함된 금지된 변경을 수행해야 하는 경우가 있을 수 있습니다. 그러한 변경은 계속해서 금지되지만, 대신 다음을 수행할 수 있습니다.

  1. 구성 요소를 제거하고 싶습니다 => 새 구성 요소를 만들고 이전 구성 요소를 사용하지 않습니다.
  2. 구성 요소에서 필드를 제거하고 싶습니다 => 해당 필드가 제거된 새 구성 요소를 만들고 이전 구성 요소를 사용하지 않습니다.
  3. 옵션 필드를 필수 필드로 변경하고 싶습니다 => 원하는 필드를 필수로 하는 새 구성 요소를 만들고 이전 구성 요소를 사용하지 않습니다.
  4. 공유 모듈의 API를 변경하고 싶습니다 => 새 공유 모듈을 만들고 이전 모듈을 사용하지 않습니다.

공통 스레드를 선택할 수 있습니다. 좋은 방법입니다. 이전 구성 요소를 사용하지 않는 경우에는 확장이 더 이상 사용되지 않으며 새 구성 요소로 전환해야 함을 사용자에게 알려야 합니다. 사용자에게 이를 알리기 위한 몇 가지 제안 사항:

  • (사용되지 않음)을 포함하도록 이전 구성 요소의 표시 이름을 업데이트합니다.
  • 이전 구성 요소의 보기를 업데이트하여 이 구성 요소가 삭제되었으며 사용자가 새 구성 요소로 전환해야 한다는 빨간색 경고 텍스트를 크게 표시합니다.
  • 콘솔에서 사용 중단 알림을 기록하도록 모듈 코드를 업데이트합니다. 이러한 알림은 최종 사용자에게 표시되므로 깔끔하고 일반적으로 유지해야 합니다.
  • CRM 시스템에서 안내 이메일 메시지를 보낼 수 있습니다.

이전 기능을 사용하지 않지만, 실제로 솔루션에 존재하지 않는 경우 한 가지 추가 단계를 수행할 수 있습니다. 단, 사용자에게 알림을 제공하고 업데이트할 시간을 제공한 후에만 이를 수행해야 합니다.

  • 아무런 작업도 수행되지 않도록 모듈의 내용을 업데이트합니다. 이렇게 하면 사용자에게 배포된 다음 빌드의 라이브러리에서 기능이 제거되지만, 해당 규칙이나 빌드는 중단되지 않습니다.

제거된 기능 복원

이미 기능을 제거한 상태이고 사용자가 이로 인해 사용할 수 없음을 보고하는 경우에는 제거한 구성 요소를 복원하는 새 버전의 확장을 릴리스해야 합니다.

위에서 설명한 대로 더 이상 사용되지 않는 상태로 복원하는 것은 좋은 방법이지만, 반드시 기능이 있어야 합니다.

예를 들어, 사용자가 사용하는 구성 요소 XYZ가 있는 v1.0이 있다고 가정해 보겠습니다. 그런 다음 더 이상 구성 요소 XYZ가 없는 v1.1을 릴리스합니다. 사용자가 확장에서 속성이 손상되어 이를 수정해야 한다고 보고합니다. 구성 요소 XYZ를 복원할 수 있는 v1.2를 릴리스해야 하며(아마 더 이상 사용되지 않는 상태로, 선택 사항) 사용자가 v1.2로 업그레이드하여 작업을 다시 수행할 수 있도록 해야 합니다.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743