在 Marketing Cloud 下一步中擴充預覽和測試
「預覽與測試」是 Marketing Cloud Next 中內建的功能,可在傳送前檢閱您的訊息內容。從「預覽和測試」強制回應中,您可以查看電子郵件、SMS 或 WhatsApp 訊息向收件者顯示的方式、將特定區段成員的預覽個人化,以及驗證合併欄位。強制回應包含預覽轉譯內容和執行測試傳送的專用索引標籤。
必要版本
| 所需的使用者權限 | |
|---|---|
| 預覽和測試內容: | 「Marketing Cloud 管理員」權限集和任何 CMS 工作區參與者角色 |
您可以透過將自訂索引標籤新增至強制回應來擴充「預覽」與「測試」。每個自訂索引標籤皆由您建立並部署至組織的 Lightning Web 元件 (LWC) 提供技術支援。此索引標籤會接收即時預覽資料,包括管道類型、內容和合併欄位值,因此您可以直接在「預覽」和「測試」體驗中建立自訂驗證工具、呈現預覽或整合檢查。
擴充機制以中繼資料類型 UiPreviewMessageTabDef 為基礎。當您建立並啟用 UiPreviewMessageTabDef 記錄時,您的自訂索引標籤會顯示在強制回應中的標準「預覽」和「測試」索引標籤旁。
-
完成 Marketing Cloud Growth 或 Advanced Edition 的設定。如需設定指示,請參閱 開始使用指南。
-
設定 Salesforce 工作台。
-
佈建「電子郵件」管道。若沒有此功能,則無法存取
UiPreviewMessageTabDef。
- 瞭解預覽資料物件
您的自訂 LWC 會收到一個 previewData 物件,其中包含預覽之訊息的相關內容資訊。previewData 中可用的欄位會因管道而有所不同。
步驟 1:建立與部署 Lightning Web 元件
建立 LWC 並將其部署至您的組織。元件會提供顯示在您自訂索引標籤中的內容。使用程序中指定的目錄結構和檔案內容。
-
為您的元件建立目錄結構:
lwc/ customTab/ customTab.html customTab.js customTab.js-meta.xml package.xml請參閱 建立 Lightning Web 元件。 -
將此標記新增至 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 記錄來註冊您的自訂索引標籤。
- 在您的組織中,按一下設定圖示,然後選取「開發人員主控台」。
- 在「開發人員主控台」中,按一下「查詢編輯器」 索引標籤。
- 在查詢編輯器底端,選取「使用 Tooling API」核取方塊。
-
輸入下列查詢,然後按一下「執行」:
SELECT Id, DeveloperName, TabName, IsActive, SupportedChannel, LightningComponentDefId FROM UiPreviewMessageTabDef - 按一下「插入列」,並提供每個必要欄位的值。如需欄位描述,請參閱 UiPreviewMessageTabDef。
-
若要取得您所部署 LWC 的識別碼,請在查詢編輯器中執行下列查詢:
SELECT Id, DeveloperName, IsExposed, NamespacePrefix FROM LightningComponentBundle WHERE IsExposed = true -
從元件複製
Id值,然後在 LightningComponentDefId 欄位中輸入。 - 按一下「儲存列」。
在您將 IsActive 設為 true 的 UiPreviewMessageTabDef 記錄儲存後,您的自訂索引標籤會顯示在標準「預覽」和「測試」索引標籤旁的「預覽」和「測試」強制回應中。當預覽內容變更時,傳送至元件的 previewData 物件會自動更新,例如當使用者選取不同的區段成員或在個人化和非個人化檢視之間切換時。
