Ti trovi qui:
Anteprima e test estesi in Marketing Cloud Next
Anteprima e test è una funzione incorporata in Marketing Cloud Next per la revisione del contenuto del messaggio prima dell'invio. Dalla finestra modale Anteprima e Test è possibile vedere come appare il messaggio email, SMS o WhatsApp ai destinatari, personalizzare l'anteprima con membri specifici del segmento e convalidare i campi di unione. La finestra modale include schede dedicate per visualizzare in anteprima il contenuto visualizzato ed eseguire invii di prova.
Versioni (Edition) richieste
| Disponibile nelle versioni: Salesforce Enterprise Edition e Unlimited Edition con Marketing Cloud Next Growth Edition o Advanced Edition e nelle versioni Starter Edition e Pro Suite Edition. La versione utilizzata determina le opzioni disponibili. |
| Autorizzazioni utente necessarie | |
|---|---|
| Per visualizzare in anteprima e testare il contenuto: | Insieme di autorizzazioni Responsabile Marketing Cloud E qualsiasi ruolo Contributor dell'area di lavoro CMS |
È possibile estendere Anteprima e Test aggiungendo schede personalizzate alla finestra modale. Ogni scheda personalizzata è basata su un componente Web Lightning (LWC) creato e distribuito all'organizzazione. La scheda riceve i dati di anteprima live, inclusi il tipo di canale, il contenuto e i valori dei campi di unione, quindi è possibile creare strumenti di convalida personalizzati, visualizzare anteprime o controlli di integrazione direttamente nell'esperienza Anteprima e test.
Il meccanismo di estensione è basato su un tipo di metadati UiPreviewMessageTabDef. Quando si crea e si attiva un record UiPreviewMessageTabDef, la scheda personalizzata viene visualizzata insieme alle schede Anteprima e Test standard nella finestra modale.
-
Completare la configurazione per Marketing Cloud Growth o la versione Advanced Edition. Per istruzioni sull'impostazione, vedere la guida introduttiva.
-
Impostare Salesforce Workbench.
-
Eseguire il provisioning del canale Email. In caso contrario,
UiPreviewMessageTabDefnon è accessibile.
- Informazioni sull'oggetto previewData
Il componente LWC personalizzato riceve un oggetto previewData che contiene informazioni contestuali sul messaggio in anteprima. I campi disponibili in previewData variano a seconda del canale.
Fase 1: Creazione e distribuzione di un componente Web Lightning
Creare un LWC e distribuirlo all'organizzazione. Il componente fornisce il contenuto visualizzato nella scheda personalizzata. Utilizzare la struttura delle directory e i contenuti dei file specificati nella procedura.
-
Creare una struttura di directory per il componente:
lwc/ customTab/ customTab.html customTab.js customTab.js-meta.xml package.xml -
Aggiungere questo markup a 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> -
Aggiungere questo codice a customTab.js:
import { LightningElement, api } from "lwc"; export default class CustomTab extends LightningElement { @api previewData; } -
Aggiungere questi metadati a 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> -
Aggiungere questo contenuto a 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> -
Distribuire il componente nell'organizzazione.
Vedere Distribuzione con strumenti personalizzati.
Fase 2: Creazione di una voce UiPreviewMessageTabDef
Dopo aver distribuito il componente LWC, creare un record UiPreviewMessageTabDef per registrare la scheda personalizzata.
- Nell'organizzazione, fare clic sull'icona di impostazione e selezionare Developer Console.
- Nella Developer Console, fare clic sulla scheda Query Editor.
- Nella parte inferiore del Query Editor, selezionare la casella di controllo Usa Tooling API.
-
Immettere la query seguente e fare clic su Esegui:
SELECT Id, DeveloperName, TabName, IsActive, SupportedChannel, LightningComponentDefId FROM UiPreviewMessageTabDef - Fare clic su Inserisci riga e specificare i valori per ogni campo obbligatorio. Per le descrizioni dei campi, vedere UiPreviewMessageTabDef.
-
Per ottenere l'ID del componente LWC distribuito, eseguire la query seguente nell'editor di query:
SELECT Id, DeveloperName, IsExposed, NamespacePrefix FROM LightningComponentBundle WHERE IsExposed = true -
Copiare il valore
Iddal componente e immetterlo nel campo LightningComponentDefId. - Fare clic su Salva righe.
Dopo aver salvato il record UiPreviewMessageTabDef con IsActive impostato su true, la scheda personalizzata viene visualizzata nella finestra modale Anteprima e Test accanto alle schede Anteprima e Test standard. L'oggetto previewData passato al componente si aggiorna automaticamente quando cambia il contesto di anteprima, ad esempio quando un utente seleziona un altro membro del segmento o passa da una visualizzazione personalizzata a una non personalizzata.
Fase 3: Inserimento in pacchetti dell'estensione
Per distribuire l'estensione Anteprima e Test tramite AppExchange, includere sia i record LightningComponentBundle che UiPreviewMessageTabDef nel pacchetto gestito.
Gli utenti che installano il pacchetto possono controllare se la scheda personalizzata viene visualizzata nella finestra modale Anteprima e Test modificando il campo IsActive nel record UiPreviewMessageTabDef installato.
