엔드 투 엔드 테스트 업로드 및 구현
Adobe Experience Platform에서 태그 확장을 테스트하려면 태그 API 및/또는 명령줄 도구를 사용하여 확장 패키지를 업로드합니다. 그런 다음 Platform UI 또는 데이터 수집 UI를 사용하여 확장 패키지를 속성에 설치하고 태그 라이브러리 및 빌드 내에서 해당 기능을 수행합니다.
이 문서에서는 확장에 대한 엔드 투 엔드 테스트를 구현하는 방법을 다룹니다.
확장 유효성 검사 validate
확장의 성능 및 Sandbox 도구에서 볼 수 있는 결과에 팀이 만족하면 확장 패키지를 태그에 업로드할 수 있습니다.
업로드하기 전에 필수 필드 또는 설정이 있는지 확인하십시오. 예를 들어, 확장 매니페스트, 확장 구성, 보기, 라이브러리 모듈(최소)을 검토하는 것이 좋습니다.
구체적인 예는 로고 파일로, extension.json
파일에 "iconPath": "example.svg",
줄을 추가하고 해당 로고 이미지 파일을 프로젝트에 포함합니다. 확장에 대해 표시될 아이콘의 상대 경로입니다. 슬래시로 시작하지 않아야 합니다. 확장자가 .svg
인 SVG 파일을 참조해야 합니다. SVG은 정사각형으로 렌더링될 때 정상적으로 표시되어야 하며 사용자 인터페이스에 의해 크기가 조정될 수 있습니다. 자세한 내용은 SVG 크기 조정 방법을 참조하세요.
extension.json
에 항목을 포함하십시오. 확장 매니페스트에는 다음과 같은 항목이 포함되어야 하며, "exchangeUrl":"https://www.adobeexchange.com/experiencecloud.details.12345.html"
은(는) Exchange 목록의 URL을 가리킵니다.Adobe I/O 통합 만들기 integration
API 또는 명령줄 도구를 사용하려면 Adobe I/O에 기술 계정이 있어야 합니다. I/O 콘솔에서 기술 계정을 만든 다음 Uploader 툴을 사용하여 확장 패키지를 업로드해야 합니다.
Adobe Experience Platform의 태그에 사용할 기술 계정을 만드는 방법에 대한 자세한 내용은 Reactor API 시작 안내서를 참조하십시오.
통합을 만들 수 없는 경우 올바른 권한이 없을 수 있습니다. 이 경우 조직 관리자가 단계를 완료하거나 개발자로 할당해야 합니다.
확장 패키지 업로드 upload
자격 증명이 있으므로 확장 패키지를 처음부터 끝까지 테스트할 준비가 되었습니다.
처음 확장 패키지를 업로드하면 development
상태가 됩니다. 즉, 자체 조직에만 표시되고 확장 개발용으로 표시된 속성만 표시됩니다.
명령줄을 사용하여 .zip 패키지가 들어 있는 디렉토리 내에서 다음 명령을 실행합니다.
npx @adobe/reactor-uploader
npx
을(를) 사용하면 npm 패키지를 컴퓨터에 실제로 설치하지 않고도 다운로드하여 실행할 수 있습니다. 이는 Uploader를 실행하는 가장 간단한 방법입니다.
Uploader에서 몇 가지 정보를 입력해야 합니다. 기술 계정 ID, API 키 및 기타 정보 비트는 Adobe I/O 콘솔에서 검색할 수 있습니다. I/O 콘솔에서 통합 페이지(으)로 이동합니다. 드롭다운에서 올바른 조직을 선택하고 올바른 통합을 찾은 다음 보기 를 선택합니다.
- 개인 키의 경로가 무엇입니까? /path/to/private.key입니다. 이는 위 2단계에서 개인 키를 저장한 위치입니다.
- 조직 ID란 무엇입니까? 이전에 열어 둔 I/O 콘솔 개요 페이지에서 이 내용을 복사하여 붙여넣습니다.
- 기술 계정 ID란 무엇입니까? I/O 콘솔에서 이 파일을 복사하여 붙여넣습니다.
- API 키란 무엇입니까? I/O 콘솔에서 이 파일을 복사하여 붙여넣습니다.
- 클라이언트 암호란 무엇입니까? I/O 콘솔에서 이 파일을 복사하여 붙여넣습니다.
- 업로드할 extension_package의 경로는 무엇입니까? /path/to/extension_package.zip입니다. .zip 패키지가 들어 있는 디렉토리 내에서 업로더를 호출하는 경우 경로를 입력하는 대신 목록에서 선택하기만 하면 됩니다.
그러면 확장 패키지가 업로드되고 업로더에서 extension_package의 ID를 제공합니다.
extension_package
ID를 폴링할 수 있습니다. 보류 중으로 표시된 카탈로그에 확장 카드가 표시됩니다.개발 속성 만들기 property
UI에 로그인하고 왼쪽 탐색에서 태그 을(를) 선택하면 속성 화면이 표시됩니다. 속성은 배포하려는 태그의 컨테이너이며 하나 이상의 사이트에서 사용할 수 있습니다.
처음 로그인하면 화면에 속성이 표시되지 않습니다. 새 속성 을 선택하여 속성 하나를 만듭니다. 이름 및 URL을 입력합니다. 확장을 테스트할 테스트 사이트 또는 페이지의 URL을 사용합니다. 이 도메인 필드는 일부 확장 또는 코어 확장을 사용하는 조건으로 사용할 수 있습니다.
localhost
이(가) URL 값으로 작동하지 않습니다. 대신 localhost
URL을 사용하는 경우 테스트에 모의 값을 사용하십시오. 예: example.com.확장 개발 테스트에 이 속성을 사용하려면 고급 OPTIONS 을 확장하고 확장 개발에 대한 구성 을 선택해야 합니다.
맨 아래에 있는 저장 을 선택하여 새 속성을 저장합니다.
Properties 화면이 나타납니다. 방금 생성한 속성의 이름을 선택합니다. 속성 개요 화면이 나타납니다. 왼쪽 열에 전역 탐색 링크가 있는 시스템의 각 영역에 대한 링크를 제공합니다.
확장 설치 install-extension
이 속성에 확장을 설치하려면 왼쪽 열의 기본 탐색 링크에서 확장 링크를 선택합니다. Core 확장이 설치됨 화면에 표시됩니다. Core 확장에는 데이터 수집 내의 모든 태그 관리 기능이 포함되어 있습니다.
확장을 추가하려면 카탈로그 탭을 선택합니다.
카탈로그에는 사용 가능한 각 확장에 대한 카드 아이콘이 표시됩니다. 확장이 카탈로그에 표시되지 않는 경우 Adobe 관리 콘솔 설정 및 확장 패키지 생성 섹션에서 위의 단계를 완료했는지 확인하십시오. Platform이 초기 처리를 완료하지 않은 경우 확장 패키지가 보류 중으로 표시될 수도 있습니다.
이전 단계를 수행했지만 카탈로그에 보류 중 또는 실패한 확장 패키지가 표시되지 않는 경우 API를 사용하여 확장 패키지의 상태를 직접 확인해야 합니다. 적절한 API 호출 방법에 대한 자세한 내용은 API 설명서에서 Fetch an ExtensionPackage를 참조하십시오.
확장 패키지 처리가 완료되면 카드 하단에서 설치 를 선택합니다.
구성 화면이 열립니다(확장에 이 화면이 표시됨). 확장을 구성하는 데 필요한 정보를 추가하고 맨 아래의 저장 을 선택합니다. 여기에 표시된 구성 화면 예제는 Pixel ID가 필요한 Facebook 확장을 사용합니다.
이제 Core 확장의 설치됨 확장 화면이 표시됩니다.
확장을 테스트할 리소스 생성 resources
확장은 Adobe Experience Platform 사용자에게 새로운 기능을 제공합니다. 일반적으로 데이터 요소 또는 규칙 빌더에 표시됩니다.
데이터 요소
태그 데이터 요소의 목적은 사용자가 값을 유지할 수 있도록 돕는 것입니다. 각 데이터 요소는 소스 데이터에 대한 매핑 또는 포인터입니다. 단일 데이터 요소는 쿼리 문자열, URL, 쿠키 값, JavaScript 변수 등에 매핑될 수 있는 변수입니다. 왼쪽 탐색 모음에서 데이터 요소 를 선택하고 새 데이터 요소 만들기 를 선택합니다.
확장에서는 확장을 운영하기 위해 필요한 경우 또는 간단히 사용자에게 편리한 방식으로 데이터 요소 유형을 정의할 수 있습니다. 확장에서 데이터 요소 유형을 제공하면 데이터 요소 만들기 화면의 드롭다운 목록에 표시됩니다.
사용자가 확장 드롭다운에서 확장을 선택하면 데이터 요소 유형 드롭다운이 확장에서 제공한 데이터 요소 유형으로 채워집니다. 그런 다음 사용자는 각 데이터 요소를 소스 값에 매핑할 수 있습니다. 그런 다음 데이터 요소 변경 이벤트 또는 사용자 지정 코드 이벤트에서 규칙을 작성하여 실행할 규칙을 트리거할 때 데이터 요소를 사용할 수 있습니다. 데이터 요소는 데이터 요소 조건이나 규칙의 다른 조건, 예외 또는 작업에서 사용할 수도 있습니다.
데이터 요소가 생성되면(매핑 설정됨) 사용자는 데이터 요소를 참조하여 소스 데이터를 참조할 수 있습니다. 값의 소스가 변경된 경우(사이트 재설계 등) 사용자는 UI에서 매핑을 한 번만 업데이트하면 모든 데이터 요소가 자동으로 새 소스 값을 받게 됩니다.
규칙
왼쪽 탐색에서 규칙 링크를 선택한 다음 새 규칙 만들기 를 선택합니다.
먼저 규칙에 대한 수사적 이름을 입력합니다. 규칙 만들기 화면이 if-then
문처럼 설정되었습니다.
이벤트가 발생하고 조건이 전달되며 예외가 발생하지 않으면 작업이 트리거됩니다. 이벤트, 조건, 예외, 데이터 요소 또는 작업을 만들거나 활용할 수 있는 확장에서도 워크플로가 동일합니다.
facebook 확장 예를 사용하여 페이지가 테스트 사이트에 로드될 때마다 이벤트를 추가합니다.
Window Loaded
이벤트 유형 을(를) 사용하면 테스트 사이트에서 페이지가 로드될 때마다 이 규칙이 트리거됩니다. 변경 내용 유지 를 선택합니다. 이 예제에서는 테스트 사이트의 모든 페이지에 대해 규칙이 트리거되어야 하므로 Conditions 을(를) 무시합니다.
작업 에서 추가 를 선택합니다. 작업 구성 화면이 나타납니다. 그런 다음 규칙을 적용할 확장을 선택하고 규칙이 트리거될 때 수행할 작업을 선택해야 합니다. 확장 드롭다운 목록에서 Facebook Pixel 을 선택하고 작업 유형 드롭다운 목록에서 페이지 보기 보내기 를 선택합니다. 변경 내용 유지 를 선택한 다음 규칙 편집 화면에서 저장 을 선택합니다.
확장을 테스트할 때 관련 이벤트, 조건 등을 선택합니다. 선택할 수 있습니다.
변경 사항 Publish publish
기본 탐색에서 게시 를 선택한 다음 새 라이브러리 추가 링크를 선택합니다.
라이브러리는 확장, 데이터 요소 및 규칙이 서로 및 웹 사이트와 상호 작용하는 방법에 대한 지침 집합입니다. 라이브러리는 빌드에 컴파일됩니다. 라이브러리에는 사용자가 편리하게 한 번에 생성 및 테스트할 수 있도록 여러 변경 사항이 포함될 수 있습니다.
라이브러리 만들기 화면에서 이름 텍스트 필드에 이름을 추가합니다. 태그는 개발(이)라는 기본 개발 환경을 제공합니다. 환경 드롭다운 목록에서 개발 을(를) 선택하십시오. 단순성을 위해 사용 가능한 모든 리소스를 추가합니다. 변경된 모든 리소스 추가 를 선택한 다음 저장 을 선택합니다.
이제 모든 변경 내용이 새로 만든 라이브러리(제공된 예제의 dev)에 포함되었으므로 개발에 저장 및 빌드 를 선택합니다.
빌드 프로세스가 완료되면 라이브러리 이름 옆에 녹색 성공 표시기가 표시됩니다.
이제 태그 라이브러리가 게시되어 사용할 수 있습니다. 테스트 페이지는 브라우저에서 최종 사용자에 대한 페이지 동작을 테스트하려면 새로 만든 라이브러리를 사용해야 합니다.
테스트 사이트에 태그 설치 install-data-collection-tags
설치 지침은 환경 탭에서 확인할 수 있습니다. 이 페이지에는 사용 가능한 모든 환경이 표시되며, 추가 환경을 만들 수도 있습니다. 라이브러리가 개발 환경에 게시되면 개발 행의 INSTALL 열에서 상자 아이콘을 선택합니다.
개발 환경에 대한 웹 설치 지침 대화 상자가 나타납니다. 전체 <script>
태그를 복사하려면 복사 아이콘을 선택하십시오.
문서 또는 사이트 템플릿의 <head>
섹션 내에 이 단일 <script>
태그를 배치하여 설치를 완료합니다. 그런 다음 테스트 사이트를 방문하여 게시된 태그 라이브러리의 동작을 검사합니다.
테스트 test
다음은 테스트 페이지 또는 사이트에서 확장을 확인하는 데 유용한 콘솔 명령 목록입니다.
_satellite.setDebug(true);
이(가) 디버그 모드를 활성화하고 유용한 로깅 문을 콘솔에 출력합니다._satellite._container
개체에는 포함된 빌드, 데이터 요소, 규칙 및 확장에 대한 세부 정보를 포함하여 배포된 라이브러리에 대한 유용한 정보가 포함되어 있습니다.
이 테스트의 목적은 배포된 라이브러리의 기능을 확인하고 확장 패키지가 라이브러리에 컴파일된 후 예상대로 작동하는지 확인하는 것입니다.
확장 패키지를 변경해야 하는 경우 반복되는 프로세스는 개발 프로세스와 유사합니다.
-
프로젝트의 코드를 변경합니다.
-
Sandbox 도구를 사용하여 변경 사항의 유효성을 검사합니다.
-
Packager 툴을 사용한 새 .zip 패키지 만들기
-
Uploader 툴을 사용하여 새 .zip 패키지를 업로드합니다. 이 프로세스는 초기 업로드에 대해 이전과 동일한 지침을 따릅니다. 그러나 개발 모드에 해당 이름의 확장 패키지가 이미 있으므로 이 새 패키지는 새 버전을 만드는 대신 이전 버전을 덮어쓰게 됩니다.
note note NOTE 명령줄에서 인수를 전달하여 자격 증명을 반복적으로 입력하지 않도록 하여 시간을 절약할 수 있습니다. 자세한 내용은 reactor-uploader 설명서를 참조하세요. 1. 기존 패키지를 업데이트할 때 설치 단계를 건너뛸 수 있습니다.
-
리소스 수정 - 확장 구성 요소에 대한 구성이 변경된 경우 UI에서 해당 리소스를 업데이트해야 합니다.
-
라이브러리에 최신 변경 사항을 추가하고 다시 빌드합니다.
-
다른 테스트를 완료하십시오.