비고
Dynamics 365 Marketing and Dynamics 365 Customer Insights는 이제 Customer Insights - Journeys and Customer Insights - Data입니다. 자세한 내용은 Dynamics 365 Customer Insights FAQ를 참조하세요
새로운 Customer Insights - Journeys 고객은 실시간 경험 기능만 받습니다. 자세한 내용은 기본 실시간 여정 설치를 참조하세요.
비고
Azure Active Directory는 이제 Microsoft Entra ID입니다. 자세히 알아보기
중요합니다
이 문서는 Customer Insights - Journeys에서 점진적으로 제거되는 아웃바운드 마케팅에만 적용됩니다. 중단을 방지하려면 아웃바운드 마케팅 사용을 중지하고 실시간 경험으로 전환합니다. 자세한 정보: 전환 개요.
이벤트 관리 기능을 사용하면 이벤트를 구성, 관리 및 처리할 수 있습니다. 이벤트 관리 솔루션을 설치하면 사용자에게 이벤트 세부 정보에 대해 자세히 알 수 있는 웹 애플리케이션을 제공하는 이벤트 포털이 제공됩니다. 추가 정보: 이벤트 포털.
이벤트 포털은 다음 두 부분으로 구성됩니다.
- 프런트 엔드
- REST API 백엔드
사용 가능한 프레임워크를 사용하여 프런트 엔드를 구현할 수 있습니다. 프런트 엔드는 단일 페이지 애플리케이션이며 완전히 사용자 지정할 수 있습니다. 백 엔드 및 백 엔드의 사용자 지정은 호스팅 유형에 따라 달라집니다.
다음 두 가지 방법으로 사용자 지정 이벤트 웹 사이트를 호스트할 수 있습니다.
경고
샘플 Angular 웹 사이트에 대한 사용자 지정은 사용자 고유의 위험에서 수행됩니다. Microsoft Dynamics 365 기술 지원은 샘플 웹 사이트 사용자 지정과 관련된 문제 또는 질문에 도움이 되지 않습니다.
필수 조건
프런트 엔드를 빌드하거나 제공된 데모 이벤트 웹 사이트를 사용자 지정할 수 있습니다.
팁 (조언)
Power Pages 스튜디오를 사용하여 아웃바운드 마케팅 이벤트 웹 사이트를 사용자 지정할 수 없습니다.
비고
제공된 데모 이벤트 웹 사이트는 Angular 프레임워크 기반 웹 사이트입니다. 그러나 백 엔드는 프런트 엔드에 종속되지 않으므로 원하는 프레임워크를 사용할 수 있습니다.
데모 이벤트 웹 사이트 사용자 지정을 시작하려면 다음 단계를 수행해야 합니다.
샘플 이벤트 웹 사이트에 대한 소스 코드를 다운로드합니다.
버전 10.x와 버전 16.x 사이에 Node.js 설치합니다. 배포는 최신 버전에서 작동하지 않습니다.
명령 프롬프트 또는 Windows PowerShell을 열고 명령을 실행하여 설치가 성공했는지 확인합니다.
node -v비고
터미널 또는 셸이 이미 열려 있는 경우 명령을 입력하기 전에 다시 시작합니다.
명령을 실행하여 Angular 애플리케이션을 빌드하고 실행하는 데 필요한 Angular CLI(명령줄 인터페이스)를 설치합니다. 추가 정보: Angular CLI.
npm install -g @angular/cli소스 코드를 다운로드한 디렉터리로 이동하고 명령을 실행하여 웹 사이트를 실행하는 데 필요한 모든 패키지를 가져옵니다.
npm install비고
package.json파일이 있는 동일한 디렉터리에서 명령을 실행해야 합니다.백 엔드 서비스와 상호 작용하려면 공용 API 설명서를 참조하십시오.
또한 이벤트 관리 및 포털 솔루션이 설치된 Dynamics 365 Customer Insights - Journeys 인스턴스가 있어야 합니다. 설치하려면 무료 Dynamics 365 Customer Insights - Journeys 평가판 등록을 참조하십시오.
샘플 이벤트 웹 사이트 다운로드
비고
새로운 기능 및 버그 수정이 릴리스되면 샘플 이벤트 웹 사이트의 최신 버전을 사용할 수 있습니다.
아래 표에서 다운로드하려는 버전을 선택합니다.
| 이름 | 릴리스 | Changes | 업로드됨 |
|---|---|---|---|
| 샘플 이벤트 웹 사이트 | 1.60.0(5월 출시) | - 이벤트 포털 웹 사이트의 성능이 향상되었습니다. - 사소한 수정 및 버그 수정. |
Download |
| 샘플 이벤트 웹 사이트 | 1.56.0(12월 릴리스) | - 대기 목록 문제를 해결했습니다. - 사소한 수정 및 버그 수정. |
Download |
| 샘플 이벤트 웹 사이트 | 1.46.0(9월 릴리스) | - 접근성 문제를 해결합니다. - 사소한 수정 및 버그 수정. |
Download |
| 샘플 이벤트 웹 사이트 | 1.34.0(4월 릴리스) | - 사소한 수정 및 버그 수정. | Download |
| 샘플 이벤트 웹 사이트 | 1.30.0(12월 릴리스) | - 사소한 수정 및 버그 수정. | Download |
| 샘플 이벤트 웹 사이트 | 1.28.0(10월 릴리스) | - 로컬 날짜 변환을 옵트인할 수 있는 가능성이 추가되었습니다. - 추가 웹 사이트 언어 구성이 추가되었습니다. |
Download |
| 샘플 이벤트 웹 사이트 | 1.27.0(9월 릴리스) | - 날짜 표시를 구성할 가능성이 추가되었습니다. - 사소한 수정 및 버그 수정. |
Download |
| 샘플 이벤트 웹 사이트 | 1.24.0(6월 릴리스) | - 포털에 단일 파일 배포를 허용하도록 배포 스크립트가 업데이트되었습니다. - 사소한 수정 및 버그 수정. |
Download |
| 샘플 이벤트 웹 사이트 | 1.23.0(5월 릴리스) | - 접근성 문제를 해결합니다. - 사소한 수정 및 버그 수정. |
Download |
| 샘플 이벤트 웹 사이트 | 1.22.0(4월 릴리스) | - 접근성 문제를 해결합니다. - 사소한 수정 및 버그 수정. |
Download |
| 샘플 이벤트 웹 사이트 | 1.21.0(3월 릴리스) | - 이벤트에 대한 중지 등록이 추가되었습니다. - 사소한 수정 및 버그 수정. |
Download |
| 샘플 이벤트 웹 사이트 | 1.20.0(2월 릴리스) | - 이벤트 등록을 위한 마케팅 양식을 통합합니다. - 사소한 수정 및 버그 수정. |
Download |
| 샘플 이벤트 웹 사이트 | 1.19.0(12월 릴리스) | - 접근성 문제를 해결합니다. - 웹 사이트 언어를 업데이트합니다. - 화자 페이지를 개선합니다. - 사소한 수정 및 버그 수정. |
Download |
| 샘플 이벤트 웹 사이트 | 1.18.0(10월 릴리스) | - 사소한 수정 및 버그 수정. | Download |
| 샘플 이벤트 웹 사이트 | 1.17.0(9월 릴리스) | - 유료 이벤트에 대한 워크플로를 개선합니다. - IE11의 호환성 문제를 해결합니다. - 이벤트 세부 정보 페이지를 개선합니다. - 사소한 수정 및 버그 수정. |
Download |
| 샘플 이벤트 웹 사이트 | 1.16.0(8월 릴리스) | - 이벤트 페이지의 로드 동작을 개선합니다. - 부울 형식의 사용자 지정 등록 필드의 UI/UX를 개선합니다. - 사소한 수정 및 버그 수정. |
Download |
| 샘플 이벤트 웹 사이트 | 1.15.0(7월 릴리스) | - 세션이 가득 차면 세션 목록 보기에 정보를 추가합니다. - 사용자 지정 등록 필드에 유효성 검사를 추가합니다. - 번역을 개선합니다. - 포털에 배포한 후 누락된 글꼴 아이콘 수정 - 사소한 수정 및 버그 수정. |
Download |
| 샘플 이벤트 웹 사이트 | 1.14.0(6월 릴리스) | Angular 7로 업그레이드, 체크 아웃 페이지의 UI 및 UX 개선, 번역 업데이트 및 개선, DeployToD365Instance.ps1 스크립트 개선, 사용자 지정 등록 필드 유효성 검사 개선, 기타 버그 수정 | Download |
| 샘플 이벤트 웹 사이트 | 1.13.0(4월 릴리스) | 세션 수준의 대기 목록 기능, UI 연마, 버그 수정 | Download |
| 샘플 이벤트 웹 사이트 | 1.12.2(3월 릴리스) | UI & UX 개선, 버그 수정 | Download |
환경 구성 매개 변수
src\environments 폴더에는 다양한 환경(자체 호스팅, 포털 호스팅, 개발)에 대한 샘플 구성 파일이 포함되어 있습니다. 사용자 지정 이벤트 웹 사이트에 대해 설정된 구성은 \src\environments 폴더 내에서 environment.ts 파일을 만들어 수행됩니다.
자체 호스팅에 대한 환경 구성 및 호스트된 포털에 대한 환경 구성 관련 문서에서 구성을 변경하는 방법에 대한 지침을 찾을 수 있습니다.
사용자 지정 이벤트 웹 사이트 구성을 시작하기 전에 이해해야 하는 몇 가지 매개 변수는 다음과 같습니다.
| 매개 변수 | Description |
|---|---|
| 프로덕션 | Angular 애플리케이션의 프로덕션 모드를 활성화하거나 비활성화합니다. 추가 정보: Angular 설명서 |
| buildVersion | 이 필드는 기본적으로 package.json 파일에 지정된 버전에 연결됩니다. 이 속성을 변경할 필요가 없습니다. 그러나 애플리케이션 버전을 노출하지 않으려면 애플리케이션을 null로 설정할 수 있습니다. |
| apiEndpoint | 이벤트 관리 API 엔드포인트(이벤트의 정보를 검색하고 등록하는 데 사용됨)를 가리키는 URL입니다. |
| localizationEndpoint | 지역화 파일이 저장되는 URL을 가리킵니다(기본적으로 루트 디렉터리에 저장됨). |
| imagesEndpoint | 이미지가 제공되는 기준 URL을 지정합니다. 이 구성을 사용하면 콘텐츠 배달 네트워크 또는 이미지 처리 서비스를 사용하려는 경우 필요할 수 있는 다른 위치에서 이미지를 제공할 수 있습니다. |
| useRestStack | 이 설정은 사용되는 API를 지정합니다. true로 설정하면 새 이벤트 관리 공용 API가 사용됩니다. false로 설정하면 사용되지 않는 이벤트 관리 포털 API가 사용됩니다. 이 API는 포털에서 사용자 지정 이벤트 웹 사이트를 호스트하는 경우에만 사용할 수 있습니다. 새 이벤트 관리 공용 API를 사용하려면 웹 애플리케이션을 등록해야 합니다. |
| emApplicationtoken | 이 토큰은 이벤트 관리 공용 API에 대해 웹 애플리케이션을 인증합니다. Customer Insights - Journeys 인스턴스에 새 웹 애플리케이션을 등록하여 애플리케이션 토큰을 검색할 수 있습니다. 사용되지 않는 이벤트 관리 포털 API를 사용하는 경우에는 이 토큰이 필요하지 않습니다. |
| isAuthenticationEnabled | 이 플래그는 사용자 인증이 지원되는지 여부를 지정합니다(즉, 사용자가 등록하거나 로그인할 수 있음). false로 설정하면 애플리케이션에서 로그인 또는 등록 방법을 표시하지 않습니다. |
| useAadB2C | 인증에 Microsoft Entra ID 아이디 관리를 사용할지 여부를 지정합니다.
Power Apps 포털 ID 관리를 사용하려면 이 플래그를 false로 설정해야 합니다. Microsoft Entra ID를 사용하는 경우 aadB2CConfig 변수를 구성해야 합니다. |
| aadB2CConfig | Microsoft Entra ID 아이디 관리를 사용할 때 이벤트 관리 애플리케이션에서 사용하는 구성 개체입니다. |
| useMockData | 이 설정은 실제 API 호출을 만드는 대신 모의 개체를 반환하는 데 사용할 수 있습니다. |
| dateSettings | 이 설정을 사용하여 웹 사이트에서 날짜의 서식을 지정하는 방법을 구성할 수 있습니다.
convertToLocalDate 플래그가 true로 설정되면 모든 날짜가 자동으로 최종 사용자의 현지 시간으로 변환됩니다. |
| languageSettings | 이 설정을 사용하여 웹 사이트에서 언어를 로드하는 방법을 구성할 수 있습니다.
forceSingleLanguage 플래그가 true로 설정되면 웹 사이트가 websiteLanguageLcid에 지정된 언어로 로드됩니다.
showLanguageDropdown 플래그를 사용하면 언어 드롭다운을 표시하거나 숨길 수 있습니다. 기본적으로 언어 드롭다운이 표시되고 웹 사이트에서 최종 사용자의 브라우저 언어를 사용합니다. |
백 엔드 사용자 지정
이벤트 관리 애플리케이션의 백 엔드를 사용자 지정하려는 상황이 발생할 수 있습니다. 시스템 사용자 지정자가 기존 이벤트 관리 엔터티에 새 필드를 추가하려고 하고 이벤트 웹 사이트에서 해당 필드를 보고 싶다고 가정해 보겠습니다. 예를 들어 custom_new_field 필드가 evtmgmt_pass 엔터티에 추가되는 경우입니다. 이벤트에 대한 패스는 API 엔드포인트 api/v2.0/events/{readableEventId}/passes를 사용하여 검색할 수 있지만 결과에 새로 추가된 필드가 포함되지 않습니다.
API에 표시할 새 필드를 노출하려면 다음 단계를 수행합니다.
- Customer Insights - Journeys 인스턴스를 엽니다.
- 상세하게 찾기를 엽니다.
- 드롭다운에서 웹 사이트 테이블 구성 엔터티를 선택하고 결과를 선택합니다.
- 새 웹 사이트 테이블 구성을 선택하여 새 레코드를 만듭니다.
- 이름 필드에 원하는 이름을 입력합니다.
- 선택한 엔터티 필드에 추가 필드를 표시할 엔터티를 선택합니다.
- 선택한 필드의 API를 통해 표시되어야 하는 새 사용자 지정 필드가 포함된 JSON 배열을 작성합니다. 이렇게 하면 API를 통해 새 사용자 지정 필드가 노출되고 프런트 엔드에서 활용할 수 있습니다.