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

노트

Adobe Experience Platform Launch은 Adobe Experience Platform에서 데이터 수집 기술 세트로 브랜딩되었습니다. 그 결과 제품 설명서에서 몇 가지 용어 변경 사항이 롤아웃되었습니다. 용어 변경 내용을 통합 참조하려면 다음 document을 참조하십시오.

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

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

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

중요

Edge 확장을 개발 중인 경우 Edge Extensions🔗에 대한 데이터 요소 유형에 대한 안내서를 대신 참조하십시오.

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

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

  1. 사용자가 데이터 요소의 설정을 수정할 수 있는 데이터 수집 UI 내에 표시되는 view
  2. 설정을 해석하고 데이터 조각을 검색하기 위해 태그 런타임 라이브러리 내에 제공되는 라이브러리 모듈입니다.

사용자가 이름이 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 객체에는 다음 속성이 포함되어야 합니다.

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

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

이 페이지에서는