Marketing Cloud Next에서 미리 보기 및 테스트 확장
미리 보기 및 테스트는 보내기 전에 메시지 내용을 검토하는 Marketing Cloud Next의 내장 기능입니다. 미리 보기 및 테스트 모달에서 이메일, SMS 또는 WhatsApp 메시지가 수신자에게 표시되는 방식을 확인하고 특정 세그먼트 구성원으로 미리 보기를 개인 설정하거나 병합 필드를 확인할 수 있습니다. 모달에는 렌더링된 콘텐츠를 미리 보고 테스트 전송을 실행할 수 있는 전용 탭이 포함되어 있습니다.
필수 Edition
| 지원 제품: Marketing Cloud Next Growth 또는 Advanced Edition이 포함된 Salesforce Enterprise 및 Unlimited Edition, Starter 및 Pro Suite Edition과 함께 제공됩니다. 사용하는 버전에 따라 사용 가능한 옵션이 결정됩니다. |
| 필요한 사용자 권한 | |
|---|---|
| 콘텐츠 미리 보기 및 테스트: | Marketing Cloud 관리자 권한 집합 및 모든 CMS 작업 영역 공동작업자 역할 |
모달에 사용자 정의 탭을 추가하여 미리 보기 및 테스트를 확장할 수 있습니다. 각 사용자 정의 탭은 조직에 구축하고 배포하는 Lightning 웹 구성 요소(LWC)에 의해 제공됩니다. 탭에 채널 유형, 콘텐츠, 병합 필드 값 등 실시간 미리 보기 데이터가 수신되므로 미리 보기 및 테스트 환경에서 직접 사용자 정의 확인 도구를 구축하고 미리 보기를 렌더링하거나 통합 검사를 수행할 수 있습니다.
확장 메커니즘은 메타데이터 유형 UiPreviewMessageTabDef을 기반으로 합니다. UiPreviewMessageTabDef 레코드를 만들고 활성화하면 모달의 표준 미리 보기 및 테스트 탭과 함께 사용자 정의 탭이 나타납니다.
-
Marketing Cloud Growth 또는 Advanced Edition에 대한 설정을 완료합니다. 설정 지침은 시작하기 가이드를 참조하십시오.
-
Salesforce 워크벤치를 설정합니다.
-
이메일 채널을 프로비저닝합니다. 이 없이는
UiPreviewMessageTabDef에 액세스할 수 없습니다.
- previewData 개체 이해
사용자 정의 LWC는 미리 보려는 메시지에 대한 컨텍스트 정보를 포함하는 previewData 개체를 수신합니다. previewData에서 사용할 수 있는 필드는 채널에 따라 다릅니다.
1단계: Lightning 웹 구성 요소 만들기 및 배포
LWC를 만들고 조직에 배포합니다. 구성 요소는 사용자 정의 탭에 표시되는 콘텐츠를 제공합니다. 절차에 지정된 디렉터리 구조 및 파일 콘텐츠를 사용합니다.
-
구성 요소에 대한 디렉터리 구조를 만듭니다.
lwc/ customTab/ customTab.html customTab.js customTab.js-meta.xml package.xmlLightning 웹 구성 요소 만들기를 참조하십시오. -
customTab.html에 이 마크업을 추가합니다.
<template> <div style="padding: 20px;"> <div>This content appears in the custom tab.</div> <div>previewData.channelType: {previewData.channelType}</div> <div>previewData.content: {previewData.content}</div> <div>previewData.contentKey: {previewData.contentKey}</div> <div>previewData.emailSubject: {previewData.emailSubject}</div> <div>previewData.emailPreheader: {previewData.emailPreheader}</div> </div> </template> -
customTab.js에 이 코드를 추가합니다.
import { LightningElement, api } from "lwc"; export default class CustomTab extends LightningElement { @api previewData; } -
다음 메타데이터를 customTab.js-meta.xml에 추가합니다.
<?xml version="1.0" encoding="UTF-8"?> <LightningComponentBundle xmlns="http://soap.sforce.com/2006/04/metadata"> <apiVersion>64.0</apiVersion> <isExposed>true</isExposed> <capabilities> <capability>lightning__dynamicComponent</capability> </capabilities> </LightningComponentBundle> -
다음 내용을 package.xml에 추가합니다.
<?xml version="1.0" encoding="UTF-8"?> <Package xmlns="http://soap.sforce.com/2006/04/metadata"> <types> <members>*</members> <name>LightningComponentBundle</name> </types> <version>64.0</version> </Package> -
조직에 구성 요소를 배포합니다.
자체 도구를 사용하여 배포를 참조하십시오.
2단계: UiPreviewMessageTabDef 항목 만들기
LWC를 배포한 후 UiPreviewMessageTabDef 레코드를 만들어 사용자 정의 탭을 등록합니다.
- 조직에서 설정 아이콘을 클릭하고 개발자 콘솔을 선택합니다.
- Developer Console에서 쿼리 편집기 탭을 클릭합니다.
- 쿼리 편집기 하단에서 도구 사용 API 확인란을 선택합니다.
-
다음 쿼리를 입력한 다음, 실행을 클릭합니다.
SELECT Id, DeveloperName, TabName, IsActive, SupportedChannel, LightningComponentDefId FROM UiPreviewMessageTabDef - 행 삽입을 클릭하고 각 필수 필드에 대한 값을 입력합니다. 필드 설명은 UiPreviewMessageTabDef를 참조하십시오.
-
배포한 LWC의 ID를 가져오려면 쿼리 편집기에서 다음 쿼리를 실행합니다.
SELECT Id, DeveloperName, IsExposed, NamespacePrefix FROM LightningComponentBundle WHERE IsExposed = true -
구성 요소에서
Id값을 복사하고 LightningComponentDefId 필드에 입력합니다. - 행 저장을 클릭합니다.
IsActive가 true로 설정된 UiPreviewMessageTabDef 레코드를 저장하면 사용자 정의 탭이 표준 미리 보기 및 테스트 탭 옆의 미리 보기 및 테스트 모달에 나타납니다. 사용자가 다른 세그먼트 구성원을 선택하거나 개인화된 보기와 개인화되지 않은 보기 간에 전환하는 등 미리 보기 컨텍스트가 변경되면 구성 요소에 전달되는 previewData 개체가 자동으로 업데이트됩니다.
