웹 확장을 위한 조건 유형

규칙 컨텍스트에서는 이벤트가 발생한 후 조건이 평가됩니다. 규칙이 계속 처리되려면 모든 조건이 true를 반환해야 합니다. 예외는 사용자가 명시적으로 "예외" 버킷에 조건을 배치하는 경우로, 이 경우 버킷 내의 모든 조건은 처리를 계속하려면 false를 반환해야 합니다.

예를 들어, 확장은 사용자가 CSS 선택기를 지정할 수 있는 "뷰포트 포함" 조건 유형을 제공할 수 있습니다. 조건이 클라이언트의 웹 사이트에서 평가되면, 확장은 CSS 선택기와 일치하는 요소를 찾아 해당 조건이 사용자의 뷰포트 내에 포함되어 있는지 여부를 반환할 수 있습니다.

이 문서에서는 Adobe Experience Platform에서 웹 확장에 대한 조건 유형을 정의하는 방법을 다룹니다.

조건 유형은 일반적으로 다음과 같이 구성됩니다.

조건 유형 라이브러리 모듈에는 "참 또는 거짓 평가"라는 하나의 목표가 있습니다. 평가 대상은 사용자가 결정합니다.

예를 들어, 사용자가 example.com 호스트에 있는지 여부를 평가하려면 모듈이 다음과 같을 수 있습니다.

module.exports = function(settings) {
  return document.location.hostname === 'example.com';
};

이제 Adobe Experience Platform 사용자가 호스트 이름을 구성할 수 있도록 하려는 상황을 생각해 보겠습니다. 사용자가 호스트 이름을 입력한 다음 설정 객체에 호스트 이름을 저장하도록 허용할 수 있습니다. 객체는 다음과 같을 수 있습니다.

{
  "hostname": "example.com"
}

사용자 정의 호스트 이름에서 작동하려면 모듈을 다음과 같이 변경해야 합니다.

module.exports = function(settings) {
  return document.location.hostname === settings.hostname;
};

컨텍스트 기반 이벤트 데이터

규칙을 실행한 이벤트와 관련된 컨텍스트 정보가 포함된 두 번째 인수가 모듈에 전달됩니다. 이는 특정 경우에 유용할 수 있으며 다음과 같이 액세스할 수 있습니다.

module.exports = function(settings, event) {
  // event contains information regarding the event that fired the rule
};

event 객체에는 다음 속성이 포함되어야 합니다.

규칙을 트리거하는 이벤트 유형을 제공하는 확장은 선택적으로 이 event 객체에 다른 유용한 정보를 추가할 수 있습니다.