웹 확장을 위한 조건 유형

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

노트

이 문서에서는 웹 확장에 대한 조건 유형을 다룹니다. Edge 확장을 개발하는 경우 Edge 확장에 대한 조건 유형에 대한 안내서를 대신 참조하십시오.

이 문서에서는 또한 사용자가 라이브러리 모듈 및 Platform Launch 확장에 이러한 모듈을 통합하는 방법을 잘 알고 있다고 가정합니다. 소개 내용이 필요한 경우 이 안내서로 돌아가기 전에 라이브러리 모듈 형식 지정에 대한 개요를 참조하십시오.

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

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

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

{
  "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 객체에는 다음 속성이 포함되어야 합니다.

속성 설명
$type 마침표를 사용하여 연결된 확장 이름 및 이벤트 이름을 설명하는 문자열입니다. 예: youtube.play.
$rule 현재 실행 중인 규칙에 대한 정보가 포함된 객체입니다. 객체에는 다음과 같은 하위 속성이 포함되어야 합니다.
  • id: 현재 실행 중인 규칙의 ID입니다.
  • name: 현재 실행 중인 규칙의 이름입니다.

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

이 페이지에서는