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 객체에 다른 유용한 정보를 추가할 수 있습니다.

이 페이지에서는

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now