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

데이터 요소 유형 라이브러리 모듈에는 "데이터 검색"이라는 하나의 목표가 있습니다. 이 데이터를 검색하는 방법은 사용자에 따라 다릅니다. 예를 들어, 데이터 요소 유형을 사용하여 Adobe Experience Platform Launch 사용자가 로컬 저장소, 쿠키 또는 DOM 요소에서 데이터를 검색할 수 있도록 할 수 있습니다.

중요

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

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

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

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

Platform Launch 사용자가 로컬 저장소 항목 이름을 구성할 수 있도록 하기 위해, 사용자가 이름을 입력한 다음 해당 이름을 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 객체에는 다음 속성이 포함되어야 합니다.

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

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

이 페이지에서는