웹 확장에 대한 데이터 요소 유형

데이터 수집 태그에서 데이터 요소는 기본적으로 페이지의 데이터 조각에 대한 별칭입니다. 이 데이터는 쿼리 문자열 매개 변수, 쿠키, DOM 요소 또는 기타 위치에서 찾을 수 있습니다. 데이터 요소는 규칙에서 참조하고 이러한 데이터 조각에 액세스하기 위해 추상적으로 사용할 수 있습니다.

데이터 요소 유형은 확장에서 제공하며 사용자가 특정 방식으로 데이터 조각에 액세스하도록 데이터 요소를 구성할 수 있습니다. 예를 들어, 확장은 사용자가 로컬 저장소 항목 이름을 지정할 수 있는 "로컬 저장소 항목" 데이터 요소 유형을 제공할 수 있습니다. 데이터 요소가 규칙에 의해 참조되면 확장은 데이터 요소를 구성할 때 사용자가 제공한 로컬 저장소 항목 이름을 사용하여 로컬 저장소 항목 값을 조회할 수 있습니다.

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

데이터 요소 유형은 일반적으로 다음과 같이 구성됩니다.

사용자가 이름이 productName인 로컬 저장소 항목에서 데이터를 검색할 수 있도록 허용하려는 상황을 생각해 보겠습니다 . 모듈은 다음과 같습니다.

module.exports = function(settings) {
  return localStorage.getItem('productName');
}

Adobe Experience Platform 사용자가 로컬 저장소 항목 이름을 구성할 수 있도록 하려면 사용자가 이름을 입력한 다음 해당 이름을 settings 개체. 객체는 다음과 같을 수 있습니다.

{
  itemName: "campaignId"
}

사용자 정의 로컬 저장소 항목 이름으로 작동하려면 모듈을 다음과 같이 변경해야 합니다.

module.exports = function(settings) {
  return localStorage.getItem(settings.itemName);
}

기본값 지원

사용자는 모든 데이터 요소에 대해 기본값을 구성할 수 있습니다. 데이터 요소 라이브러리 모듈에서 undefined 또는 null의 값을 반환하면 데이터 요소에 대해 사용자가 구성한 기본값으로 자동으로 대체됩니다.

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

규칙이 트리거된 결과로서 데이터 요소를 검색하는 경우(예: 데이터 요소가 규칙의 조건 및 작업에 사용됨) 규칙을 실행한 이벤트 관련 컨텍스트 정보가 포함된 두 번째 인수가 모듈에 전달됩니다. 이는 특정 경우에 유용할 수 있으며 다음과 같이 액세스할 수 있습니다.

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

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

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