엔드 투 엔드 테스트 업로드 및 구현

Adobe Experience Platform에서 태그 확장을 테스트하려면 태그 API 및/또는 명령줄 도구를 사용하여 확장 패키지를 업로드합니다. 그런 다음 Platform UI 또는 데이터 수집 UI를 사용하여 확장 패키지를 속성에 설치하고 태그 라이브러리 및 빌드 내에서 해당 기능을 수행합니다.

이 문서에서는 확장에 대한 엔드 투 엔드 테스트를 구현하는 방법을 다룹니다.

확장 유효성 검사 validate

확장의 성능에 팀이 만족하면 및에서 볼 수 있는 결과를 샌드박스 도구에서 확장 패키지를 태그에 업로드할 수 있습니다.

업로드하기 전에 필수 필드 또는 설정이 있는지 확인하십시오. 예를 들어 확장 매니페스트, 사용자 확장 구성, 사용자 조회수및 라이브러리 모듈 (최소한) 모범 사례입니다.

구체적인 예는 로고 파일로, extension.json 파일에 "iconPath": "example.svg", 줄을 추가하고 해당 로고 이미지 파일을 프로젝트에 포함합니다. 확장에 대해 표시될 아이콘의 상대 경로입니다. 슬래시로 시작하지 않아야 합니다. 확장자가 .svg인 SVG 파일을 참조해야 합니다. SVG은 정사각형으로 렌더링될 때 정상적으로 표시되어야 하며 사용자 인터페이스에 의해 크기가 조정될 수 있습니다. 다음을 참조하십시오. SVG 문서 크기 조절 방법 을 참조하십시오.

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 콘솔의 통합 페이지로 이동합니다. 드롭다운에서 올바른 조직을 선택하고 올바른 통합을 찾은 다음 을 선택합니다. 보기.

그러면 확장 패키지가 업로드되고 업로더에서 extension_package의 ID를 제공합니다.

개발 속성 생성 property

UI에 로그인하고 을(를) 선택한 후 태그 왼쪽 탐색에서 속성 화면이 표시됩니다. 속성은 배포하려는 태그의 컨테이너이며 하나 이상의 사이트에서 사용할 수 있습니다.

처음 로그인하면 화면에 속성이 표시되지 않습니다. 새 속성 ​을 선택하여 속성 하나를 만듭니다. 이름 및 URL을 입력합니다. 확장을 테스트할 테스트 사이트 또는 페이지의 URL을 사용합니다. 이 도메인 필드는 일부 확장 또는 코어 확장을 사용하는 조건으로 사용할 수 있습니다.

확장 개발 테스트에 이 속성을 사용하려면 를 확장해야 합니다 고급 OPTIONS 및 다음 확인란을 선택해야 합니다. 확장 개발에 대한 구성.

맨 아래에 있는 저장 ​을 선택하여 새 속성을 저장합니다.

Properties 화면이 나타납니다. 방금 생성한 속성의 이름을 선택합니다. 속성 개요 화면이 나타납니다. 왼쪽 열에 전역 탐색 링크가 있는 시스템의 각 영역에 대한 링크를 제공합니다.

확장 설치 install-extension

이 속성에 확장을 설치하려면 확장 링크: 기본 탐색 링크: 왼쪽 열. 다음 코어 확장은에 표시됩니다. 설치됨 화면. Core 확장에는 데이터 수집 내의 모든 태그 관리 기능이 포함되어 있습니다.

확장을 추가하려면 카탈로그 탭.

카탈로그에는 사용 가능한 각 확장에 대한 카드 아이콘이 표시됩니다. 확장이 카탈로그에 표시되지 않는 경우 Adobe 관리 콘솔 설정 및 확장 패키지 생성 섹션에서 위의 단계를 완료했는지 확인하십시오. Platform이 초기 처리를 완료하지 않은 경우 확장 패키지가 보류 중으로 표시될 수도 있습니다.

이전 단계를 수행했지만 카탈로그에 보류 중 또는 실패한 확장 패키지가 표시되지 않는 경우 API를 사용하여 확장 패키지의 상태를 직접 확인해야 합니다. 적절한 API 호출 방법에 대한 자세한 내용은 다음을 참조하십시오. ExtensionPackage 가져오기 API 설명서에서 참조할 수 있습니다.

확장 패키지 처리가 완료되면 다음을 선택합니다. 설치 카드 하단에서.

구성 화면이 열립니다(확장에 이 화면이 표시됨). 확장을 구성하는 데 필요한 정보를 추가하고 맨 아래의 저장 ​을 선택합니다. 여기에 표시된 구성 화면 예제는 Pixel ID가 필요한 Facebook 확장을 사용합니다.

이제 Core 확장의 설치됨 확장 화면이 표시됩니다.

확장을 테스트할 리소스 생성 resources

확장은 Adobe Experience Platform 사용자에게 새로운 기능을 제공합니다. 일반적으로 데이터 요소 또는 규칙 빌더에 표시됩니다.

데이터 요소

태그 데이터 요소의 목적은 사용자가 값을 유지할 수 있도록 돕는 것입니다. 각 데이터 요소는 소스 데이터에 대한 매핑 또는 포인터입니다. 단일 데이터 요소는 쿼리 문자열, URL, 쿠키 값, JavaScript 변수 등으로 매핑될 수 있는 변수입니다. 선택 데이터 요소 왼쪽 탐색 모음에서 및 새 데이터 요소 만들기.

확장에서는 확장을 운영하기 위해 필요한 경우 또는 간단히 사용자에게 편리한 방식으로 데이터 요소 유형을 정의할 수 있습니다. 확장에서 데이터 요소 유형을 제공하면 의 사용자에 대한 드롭다운 목록에 표시됩니다. 데이터 요소 만들기 화면:

사용자가 다음에서 확장을 선택할 때 확장 드롭다운, 데이터 요소 유형 드롭다운이 확장에서 제공한 모든 데이터 요소 유형으로 채워집니다. 그런 다음 사용자는 각 데이터 요소를 소스 값에 매핑할 수 있습니다. 그런 다음 데이터 요소 변경 이벤트 또는 사용자 지정 코드 이벤트에서 규칙을 작성하여 실행할 규칙을 트리거할 때 데이터 요소를 사용할 수 있습니다. 데이터 요소는 데이터 요소 조건이나 규칙의 다른 조건, 예외 또는 작업에서 사용할 수도 있습니다.

데이터 요소가 생성되면(매핑 설정됨) 사용자는 데이터 요소를 참조하여 소스 데이터를 참조할 수 있습니다. 값의 소스가 변경된 경우(사이트 재설계 등) 사용자는 UI에서 매핑을 한 번만 업데이트하면 모든 데이터 요소가 자동으로 새 소스 값을 받게 됩니다.

규칙

다음 항목 선택 규칙 왼쪽 탐색 링크를 클릭한 다음 새 규칙 만들기.

먼저 규칙에 대한 수사적 이름을 입력합니다. 다음 규칙 만들기 화면이 다음과 같이 설정됨 if-then 명령문입니다.

이벤트가 발생하고 조건이 전달되며 예외가 발생하지 않으면 작업이 트리거됩니다. 이벤트, 조건, 예외, 데이터 요소 또는 작업을 만들거나 활용할 수 있는 확장에서도 워크플로가 동일합니다.

facebook 확장 예를 사용하여 페이지가 테스트 사이트에 로드될 때마다 이벤트를 추가합니다.

다음 Window Loaded 이벤트 유형 는 페이지가 테스트 사이트에 로드될 때마다 이 규칙이 트리거되도록 합니다. 변경사항 유지 ​를 선택합니다. 이 예에서는 ignore 조건 따라서 테스트 사이트의 페이지에 대해 규칙을 트리거해야 합니다.

아래 작업 선택 추가. 다음 작업 구성 화면이 나타납니다.그런 다음 규칙을 적용할 확장을 선택하고 규칙이 트리거될 때 수행할 작업을 선택해야 합니다. 선택 Facebook 픽셀 다음에서 확장 드롭다운 목록, 페이지 보기 보내기 다음에서 작업 유형 드롭다운 목록입니다. 선택 변경 내용 유지, 및 저장 다음에 규칙 편집 화면.

확장을 테스트할 때 관련 이벤트, 조건 등을 선택합니다. 선택할 수 있습니다.

변경 사항 게시 publish

기본 탐색에서 게시 ​를 선택한 다음 새 라이브러리 추가 링크를 선택합니다.

라이브러리는 확장, 데이터 요소 및 규칙이 서로 및 웹 사이트와 상호 작용하는 방법에 대한 지침 집합입니다. 라이브러리는 빌드에 컴파일됩니다. 라이브러리에는 사용자가 편리하게 한 번에 생성 및 테스트할 수 있도록 여러 변경 사항이 포함될 수 있습니다.

다음에서 라이브러리 만들기 화면에 이름을 추가합니다. 이름 텍스트 필드. 태그는 라는 기본 개발 환경을 제공합니다. 개발. 선택 개발 다음에서 환경 드롭다운 목록입니다. 단순성을 위해 사용 가능한 모든 리소스를 추가합니다. 선택 변경된 모든 리소스 추가 ​을 선택한 다음 을 선택합니다. 저장.

이제 모든 변경 사항이 새로 생성된 라이브러리(라는)에 포함되었습니다. 개발 제공된 예에서 을 선택합니다. 개발에 저장 및 구축.

빌드 프로세스가 완료되면 녹색 성공 라이브러리 이름 옆에 표시기가 표시됩니다.

이제 태그 라이브러리가 게시되어 사용할 수 있습니다. 테스트 페이지는 브라우저에서 최종 사용자에 대한 페이지 동작을 테스트하려면 새로 만든 라이브러리를 사용해야 합니다.

테스트 사이트에 태그 설치 install-data-collection-tags

설치 지침은 환경 탭에서 확인할 수 있습니다. 이 페이지에는 사용 가능한 모든 환경이 표시되며, 추가 환경을 만들 수도 있습니다. 라이브러리가 개발 환경에 게시되었으므로 설치 의 열 개발 행.

다음 웹 설치 지침 개발 환경에 대한 대화 상자가 나타납니다. 복사 아이콘을 선택하여 전체 복사 <script> 태그에 가깝게 배치하십시오.

이 단일 을(를) 배치하여 설치를 완료합니다 <script> 태그 내 <head> 문서 또는 사이트 템플릿의 섹션입니다. 그런 다음 테스트 사이트를 방문하여 게시된 태그 라이브러리의 동작을 검사합니다.

테스트 test

다음은 테스트 페이지 또는 사이트에서 확장을 확인하는 데 유용한 콘솔 명령 목록입니다.

이 테스트의 목적은 배포된 라이브러리의 기능을 확인하고 확장 패키지가 라이브러리에 컴파일된 후 예상대로 작동하는지 확인하는 것입니다.

확장 패키지를 변경해야 하는 경우 반복되는 프로세스는 개발 프로세스와 유사합니다.