확장 개발 개요
노트Adobe Experience Platform의 태그 주요 목표 중 하나는 Adobe 외부의 엔지니어가 웹 사이트 및 모바일 애플리케이션에서 추가 기능을 노출할 수 있는 개방형 에코시스템을 만드는 것입니다. 이 작업은 태그 확장을 통해 수행됩니다. 태그 속성에 확장을 설치하면 해당 확장의 기능을 속성의 모든 사용자가 사용할 수 있게 됩니다.
이 문서에서는 확장의 기본 구성 요소에 대해 간략히 설명하고 확장 개발 프로세스를 안내하는 데 도움이 되는 추가 설명서에 대한 링크를 제공합니다.
확장 구조
확장은 파일 디렉터리로 구성됩니다. 특히 확장은 매니페스트 파일, 라이브러리 모듈 및 보기로 구성됩니다.
매니페스트 파일
디렉터리 루트에 매니페스트 파일(extension.json)이 있어야 합니다. 이 파일은 확장의 구성과 특정 파일이 디렉터리 내에 있는 위치를 설명합니다. 매니페스트는 npm 프로젝트의 package.json 파일과 유사하게 작동합니다.
라이브러리 모듈
라이브러리 모듈은 확장에서 제공하는 다양한 구성 요소를 설명하는 파일입니다(즉, 태그 런타임 라이브러리 내에서 내보내는 논리). 각 라이브러리 모듈 파일의 내용은 CommonJS 모듈 표준을 따라야 합니다.
예를 들어 "비콘 보내기"라는 작업 유형을 작성하는 경우, 비콘을 보내는 논리를 포함하는 파일이 있어야 합니다. JavaScript을 사용하는 경우 파일을 sendBeacon.js(으)로 호출할 수 있습니다. 이 파일의 내용은 태그 런타임 라이브러리 내에서 내보내집니다.
extension.json에 라이브러리 모듈 파일이 있는 위치를 설명하면 확장 디렉터리의 원하는 위치에 라이브러리 모듈 파일을 넣을 수 있습니다.
보기 횟수
보기는 특히 Experience Platform UI 및 데이터 수집 UI를 통해 태그 응용 프로그램 내의 iframe 요소에 로드할 수 있는 HTML 파일입니다. 보기에는 확장에서 제공하는 스크립트가 포함되어야 하며, 애플리케이션과 통신하기 위해 작은 API를 따라야 합니다.
확장에 대해 가장 중요한 보기 파일은 해당 구성입니다. 자세한 내용은 확장 구성의 섹션을 참조하십시오.
보기 내에서 사용되는 라이브러리에 대해서는 제한이 없습니다. 즉, jQuery, Underscore, React, Angular, Bootstrap 또는 기타 코드를 사용할 수 있습니다. 그러나 확장이 UI와 유사한 모양과 느낌을 갖도록 하는 것이 좋습니다.
모든 보기 관련 파일(HTML, CSS, JavaScript)을 라이브러리 모듈 파일과 분리된 단일 하위 디렉터리에 배치하는 것이 좋습니다. extension.json에서 이 보기의 하위 디렉터리 위치를 설명할 수 있습니다. 그런 다음 Experience Platform은 웹 서버에서 이 하위 디렉터리(및 이 하위 디렉터리만)를 처리합니다.
라이브러리 구성 요소
각 확장은 기능 세트를 정의합니다. 이러한 기능은 웹 사이트 또는 앱에 배포된 라이브러리에 포함되어 구현됩니다. 라이브러리는 조건, 작업, 데이터 요소 등을 포함한 개별 구성 요소의 컬렉션입니다. 각 라이브러리 구성 요소는 태그 런타임 내에서 내보내는 재사용 가능한 코드 조각(확장에서 제공)입니다.
웹 확장을 개발하는지 또는 Edge 확장을 개발하는지에 따라 사용 가능한 구성 요소 유형과 사용 사례가 달라집니다. 각 확장 유형에 사용할 수 있는 구성 요소에 대한 개요는 아래 하위 섹션을 참조하십시오.
웹 확장용 구성 요소
웹 확장에서 규칙은 이벤트를 통해 트리거되며 지정된 조건 세트가 충족될 경우 특정 작업을 실행할 수 있습니다. 자세한 내용은 웹 확장의 모듈 흐름에 대한 개요를 참조하십시오.
Adobe에서 제공하는 코어 모듈 외에도 웹 확장에서 다음 라이브러리 구성 요소를 정의할 수 있습니다.
노트Edge 확장의 구성 요소
Edge 확장에서 규칙은 조건 검사를 통해 트리거되며 이러한 검사에 통과할 경우 특정 작업을 실행합니다. 자세한 내용은 Edge 확장 흐름에 대한 개요를 참조하십시오.
Edge 확장에서 다음 라이브러리 구성 요소를 정의할 수 있습니다.
노트확장 구성
확장 구성은 사용자로부터 전역 설정을 수집하는 방식을 나타냅니다. 구성은 태그 런타임 라이브러리 내의 설정을 일반 객체로 내보내고 내보내는 보기 구성 요소로 구성됩니다.
예를 들어, 사용자가 "비콘 보내기" 작업을 사용하여 비콘을 전송할 수 있도록 해주는 확장을 생각해보면 비콘에는 항상 계정 ID가 포함되어야 합니다. 비콘 보내기 작업을 구성할 때마다 사용자에게 계정 ID를 묻는 대신 확장은 확장 구성 보기에서 계정 ID를 한 번 요청해야 합니다. 비콘이 전송될 때마다 "비콘 보내기" 작업을 통해 확장 구성에서 계정 ID를 가져와 비콘에 추가할 수 있습니다.
사용자가 UI의 속성에 확장을 설치하면 확장 구성 보기가 표시되며, 설치를 완료하려면 확장을 완료해야 합니다.
자세한 내용은 확장 구성에 대한 안내서를 참조하세요.
확장 제출
확장 빌드를 완료하면 Experience Platform의 확장 카탈로그에 나열되도록 제출할 수 있습니다. 자세한 내용은 확장 제출 프로세스 개요를 참조하십시오.