확장 개발 개요

노트

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

Adobe Experience Platform에서 태그의 주요 목표 중 하나는 Adobe 외부의 엔지니어가 웹 사이트 및 모바일 애플리케이션에서 추가 기능을 노출할 수 있는 개방형 에코시스템을 구축하는 것입니다. 이 작업은 태그 확장을 통해 수행됩니다. 확장이 태그 속성에 설치되면 해당 확장의 기능을 해당 속성의 모든 사용자가 사용할 수 있게 됩니다.

이 문서에서는 확장의 기본 구성 요소에 대해 간략하게 설명하고 확장 개발 프로세스를 안내하는 추가 설명서에 대한 링크를 제공합니다.

확장 구조

확장은 파일 디렉터리로 구성됩니다. 특히 확장은 매니페스트 파일, 라이브러리 모듈 및 보기로 구성됩니다.

매니페스트 파일

디렉터리 루트에 매니페스트 파일(extension.json)이 있어야 합니다. 이 파일은 확장의 구성과 특정 파일이 디렉터리 내에 있는 위치에 대해 설명합니다. 매니페스트는 npm 프로젝트의 package.json 파일과 유사하게 작동합니다.

라이브러리 모듈

라이브러리 모듈은 확장이 제공하는 다른 구성 요소를 설명하는 파일입니다(즉, 태그 런타임 라이브러리 내에서 내보내는 논리). 각 라이브러리 모듈 파일의 컨텐츠는 CommonJS 모듈 standard를 따라야 합니다.

예를 들어, "비콘 보내기"라는 작업 유형을 작성하는 경우 비콘을 보내는 로직을 포함하는 파일이 있어야 합니다. JavaScript를 사용하는 경우 파일을 sendBeacon.js이라고 할 수 있습니다. 이 파일의 컨텐츠가 태그 런타임 라이브러리 내에 표시됩니다.

extension.json에 라이브러리 모듈 파일의 위치를 설명하는 경우, 확장 디렉토리 내의 원하는 위치에 라이브러리 모듈 파일을 배치할 수 있습니다.

보기 횟수

보기는 태그 애플리케이션 내의 iframe 요소에, 특히 데이터 수집 UI를 통해 로드할 수 있는 HTML 파일입니다. 보기에는 확장에서 제공하는 스크립트가 포함되어야 하며, 애플리케이션과 통신하기 위해 작은 API를 따라야 합니다.

확장에 대한 가장 중요한 보기 파일은 해당 구성입니다. 자세한 내용은 확장 구성의 섹션을 참조하십시오.

보기 내에서 사용되는 라이브러리에 대해서는 제한이 없습니다. 즉, jQuery, Underscore, React, Angular, Bootstrap 또는 기타 항목을 사용할 수 있습니다. 그러나 확장의 모양과 느낌을 데이터 수집 UI와 유사하게 유지하는 것이 좋습니다.

모든 보기 관련 파일(HTML, CSS, JavaScript)을 라이브러리 모듈 파일과 분리된 단일 하위 디렉터리에 배치하는 것이 좋습니다. extension.json에서 이 보기의 하위 디렉터리가 있는 위치를 설명할 수 있습니다. 그런 다음 Platform은 웹 서버에서 이 하위 디렉터리(및 이 하위 디렉터리만)를 처리합니다.

라이브러리 구성 요소

각 확장은 기능 세트를 정의합니다. 이러한 기능은 웹 사이트 또는 앱에 배포되는 라이브러리에 포함됨으로써 구현됩니다. 라이브러리는 조건, 작업, 데이터 요소 등을 포함한 개별 구성 요소의 컬렉션입니다. 각 라이브러리 구성 요소는 태그 런타임 내에 전달되는 재사용 가능한 코드(확장에서 제공)의 일부입니다.

웹 확장을 개발하는지 또는 Edge 확장을 개발하는지에 따라 사용 가능한 구성 요소 유형과 사용 사례가 다릅니다. 각 확장 유형에 사용할 수 있는 구성 요소에 대한 개요를 알려면 아래 하위 섹션을 참조하십시오.

웹 확장용 구성 요소

웹 확장에서 규칙은 이벤트를 통해 트리거되며 지정된 조건 세트가 충족될 경우 특정 작업을 실행할 수 있습니다. 자세한 내용은 웹 확장의 모듈 흐름에 대한 개요를 참조하십시오.

Adobe이 제공하는 핵심 모듈 외에도 웹 확장에서 다음 라이브러리 구성 요소를 정의할 수 있습니다.

노트

웹 확장에서 라이브러리 구성 요소를 구현하는 데 필요한 형식에 대한 자세한 내용은 모듈 형식 개요를 참조하십시오.

Edge 확장을 위한 구성 요소

Edge 확장에서 규칙은 조건 검사를 통해 트리거되며 이러한 검사에 통과할 경우 특정 작업을 실행합니다. 자세한 내용은 Edge Extension 흐름에 대한 개요를 참조하십시오.

Edge 확장에서 다음 라이브러리 구성 요소를 정의할 수 있습니다.

노트

Edge 확장에서 라이브러리 모듈을 구현하는 데 필요한 형식에 대한 자세한 내용은 모듈 형식 개요를 참조하십시오.

확장 구성

확장 구성은 사용자로부터 전역 설정을 수집하는 방식을 나타냅니다. 구성은 태그 런타임 라이브러리 내에서 일반 객체로 설정을 내보내고 내보내는 보기 구성 요소로 구성됩니다.

예를 들어, 사용자가 "비콘 보내기" 작업을 사용하여 비콘을 전송할 수 있도록 해주는 확장을 생각해보면 비콘에는 항상 계정 ID가 포함되어야 합니다. 사용자가 "비콘 보내기" 작업을 구성할 때마다 계정 ID를 요청하지 않고 확장 구성 보기에서 계정 ID를 한 번 요청해야 합니다. 비콘이 전송될 때마다 "비콘 보내기" 작업은 확장 구성에서 계정 ID를 가져와 비콘에 추가할 수 있습니다.

사용자가 UI에서 속성에 확장을 설치하면 확장 구성 보기가 표시되며 설치를 완료해야 합니다.

자세한 내용은 확장 구성에 대한 안내서를 참조하십시오.

확장 제출

확장 빌드를 마치면 Platform의 확장 카탈로그에 나열되도록 제출할 수 있습니다. 자세한 내용은 확장 제출 프로세스 개요를 참조하십시오.

이 페이지에서는