Utvide forhåndsvisning og testing i Marketing Cloud Neste
Forhåndsvis og test er en innebygd funksjon i Marketing Cloud Next for å se gjennom meldingsinnholdet før du sender. Fra forhåndsvisnings- og testvinduet kan du se hvordan e-post-, SMS- eller WhatsApp-meldingen vises til mottakere, tilpasse forhåndsvisningen med bestemte segmentmedlemmer og validere flettefelt. Modalen inneholder tilpassede faner for forhåndsvisning av gjengitt innhold og kjøring av testutsendinger.
Nødvendige utgaver
| Tilgjengelig i Salesforce Enterprise og Unlimited Edition med Marketing Cloud Next Growth eller Advanced Edition, og i Starter og Pro Suite Edition. Versjonen din bestemmer hvilke alternativer du har. |
| Nødvendige brukertillatelser | |
|---|---|
| For å forhåndsvise og teste innhold: | Tillatelsessettet Marketing Cloud Manager OG eventuell bidragsyterrolle i CMS-arbeidsområde |
Du kan utvide Forhåndsvisning og Test ved å legge til tilpassede faner i modalet. Hver tilpassede fane leveres av en Lightning Web Component (LWC) som du bygger og distribuerer til organisasjonen. Fanen mottar direkteforhåndsvisningsdata, inkludert kanaltype, innhold og flettefeltverdier, slik at du kan bygge tilpassede valideringsverktøy, gjengi forhåndsvisninger eller integreringskontroller direkte i forhåndsvisnings- og testopplevelsen.
Utvidelsesmekanismen er basert på en metadatatype UiPreviewMessageTabDef. Når du oppretter og aktiverer en UiPreviewMessageTabDef-post, vises den tilpassede fanen ved siden av standardfanene Forhåndsvisning og Test i modalen.
-
Fullfør oppsettet for Marketing Cloud Growth eller Advanced Edition. Du finner instruksjoner om oppsett i Komme i gang-veiledningen.
-
Konfigurer Salesforce Workbench.
-
Klargjør E-post-kanalen. Uten dette er ikke
UiPreviewMessageTabDeftilgjengelig.
- Forstå previewData-objektet
Din tilpassede LWC mottar et previewData-objekt som inneholder kontekstinformasjon om meldingen som forhåndsvises. Feltene som er tilgjengelig i previewData, varierer etter kanal.
Trinn 1: Opprette og distribuere en Lightning
Opprett en LWC og distribuer den til organisasjonen. Komponenten inneholder innholdet som vises i den tilpassede fanen. Bruk katalogstrukturen og filinnholdet som er angitt i prosedyren.
-
Opprett en katalogstruktur for komponenten:
lwc/ customTab/ customTab.html customTab.js customTab.js-meta.xml package.xml -
Legg til denne koden i 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> -
Legg til denne koden i customTab.js:
import { LightningElement, api } from "lwc"; export default class CustomTab extends LightningElement { @api previewData; } -
Legg til disse metadataene i 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> -
Legg til dette innholdet i 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> - Distribuer komponenten til organisasjonen.
Trinn 2: Opprette en UiPreviewMessageTabDef-oppføring
Når du har distribuert LWC-en, oppretter du en UiPreviewMessageTabDef-post for å registrere den tilpassede fanen.
- Klikk på oppsettikonet i organisasjonen og velg Utviklerkonsoll.
- Klikk på fanen Spørringsredigering i Developer Console.
- Merk av for Bruk Tooling API nederst i spørringsredigeringen.
-
Skriv inn følgende spørring, og klikk deretter på Utfør:
SELECT Id, DeveloperName, TabName, IsActive, SupportedChannel, LightningComponentDefId FROM UiPreviewMessageTabDef - Klikk på Sett inn rad, og oppgi verdier for hvert nødvendige felt. Du finner feltbeskrivelser i UiPreviewMessageTabDef.
-
Kjør følgende spørring i spørringsredigeringen for å hente ID-en til LWC-et du distribuerte:
SELECT Id, DeveloperName, IsExposed, NamespacePrefix FROM LightningComponentBundle WHERE IsExposed = true -
Kopier
Id-verdien fra komponenten og skriv den inn i feltet LightningComponentDefId. - Klikk på Lagre rader.
Når du har lagret UiPreviewMessageTabDef-posten med IsActive satt til true, vises den tilpassede fanen i Forhåndsvisning og Test-vinduet ved siden av standardfanene Forhåndsvisning og Test. previewData-objektet som overføres til komponenten, oppdateres automatisk når forhåndsvisningskonteksten endres, som når en bruker velger et annet segmentmedlem eller bytter mellom tilpassede og ikke-tilpassede visninger.
Trinn 3: Pakk utvidelsen
Hvis du vil distribuere forhåndsvisnings- og testutvidelsen via AppExchange, inkluderer du både LightningComponentBundle- og UiPreviewMessageTabDef-postene i den administrerte pakken.
Brukere som installerer pakken, kan bestemme om den tilpassede fanen skal vises i forhåndsvisnings- og testvinduet ved å endre IsActive-feltet i den installerte UiPreviewMessageTabDef-posten.

