Esikatselun ja testauksen laajentaminen Marketing Cloud Next -sovelluksessa
Esikatselu ja testi on sisäänrakennettu ominaisuus, jota käytetään Marketing Cloud Nextissa viestien sisällön tarkastamiseen ennen viestin lähettämistä. Esikatselu- ja Testaus-ikkunoissa voit nähdä, miten sähköpostisi, SMS-tekstiviestisi tai WhatsApp-viestisi näytetään vastaanottajille, mukauttaa esikatselua tietyille segmentin jäsenille ja vahvistaa yhdistämiskentät. modaali sisältää erillisiä välilehtiä renderöidyn sisällön esikatseluun ja testien lähetysten suorittamiseen.
Vaaditut versiot
| Käytettävissä: Salesforce Enterprise Edition- ja Unlimited Edition -versioissa Marketing Cloud Next Growth- tai Advanced Edition -versioilla sekä Starter Edition- ja Pro Suite -versioissa. Edition-versiosi määrittää käytettävissäsi olevat vaihtoehdot. |
| Tarvittavat käyttöoikeudet | |
|---|---|
| Sisällön esikatseleminen ja testaaminen: | Marketing Cloud Manager -käyttöoikeusjoukko JA mikä tahansa CMS-työtilan sisällöntuottajan rooli |
Voit laajentaa esikatselu- ja testausvaihtoehtoja lisäämällä mukautettuja välilehtiä modaaliin. Jokainen mukautettu välilehti perustuu Lightning (LWC), jonka rakennat ja otat käyttöön organisaatiossasi. Välilehti vastaanottaa live-esikatseludataa, mukaan lukien kanavan tyyppiä, sisältöä ja yhdistämiskenttien arvoja, jotta voit luoda mukautettuja vahvistustyökaluja, renderöidä esikatseluita tai integrointitarkistuksia suoraan esikatselu- ja testauskokemuksesta.
Laajennusmekanismi perustuu metadatatyyppiin UiPreviewMessageTabDef. Kun luot ja aktivoit UiPreviewMessageTabDef-tietueen, mukautettu välilehti näytetään modaalissa vakiomuotoisten Esikatselu- ja Testaa-välilehtien vieressä.
-
Suorita Marketing Cloud Growth Edition- tai Advanced Edition -versioiden määritykset. Katso määritysohjeet kohdasta Aloittaminen.
-
Määritä Salesforce Workbench.
-
Provisioi Sähköposti-kanava. Ilman tätä
UiPreviewMessageTabDefei ole käytettävissä.
- previewData-objektin ymmärtäminen
Mukautettu LWC vastaanottaa previewData-objektin, joka sisältää asiayhteydestä riippuvaisia tietoja esikatseltavasta viestistä. previewData-sovelluksessa käytettävissä olevat kentät vaihtelevat kanavan mukaan.
Vaihe 1: Lightning luominen ja käyttöönotto
Luo LWC ja ota se käyttöön organisaatiossasi. Komponentti tarjoaa mukautetussa välilehdessäsi näytettävän sisällön. Käytä toimenpiteessä määritettyä hakemiston rakennetta ja tiedoston sisältöä.
-
Luo komponentillesi hakemiston rakenne:
lwc/ customTab/ customTab.html customTab.js customTab.js-meta.xml package.xmlLisätietoja on kohdassa Lightning-verkkokomponenttien luominen. -
Lisää tämä koodi kohtaan 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> -
Lisää tämä koodi customTab.js-tiedostoon:
import { LightningElement, api } from "lwc"; export default class CustomTab extends LightningElement { @api previewData; } -
Lisää tämä metadata customTab.js-meta.xml-tiedostoon:
<?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> -
Lisää tämä sisältö package.xml-tiedostoon:
<?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> -
Ota komponentti käyttöön organisaatiossasi.
Lisätietoja on kohdassa Ota käyttöön omilla työkaluillasi.
Vaihe 2: UiPreviewMessageTabDef-merkinnän luominen
Kun olet ottanut LWC:n käyttöön, luo UiPreviewMessageTabDef-tietue rekisteröidäksesi mukautetun välilehtesi.
- Napsauta organisaatiostasi määrityskuvaketta ja valitse Developer Console.
- Napsauta Developer Consolesta kyselyeditorin välilehteä.
- Valitse kyselyeditorin alalaidasta Käytä Tooling API:a -valintaruutu.
-
Syötä seuraava kysely ja napsauta sitten Suorita:
SELECT Id, DeveloperName, TabName, IsActive, SupportedChannel, LightningComponentDefId FROM UiPreviewMessageTabDef - Napsauta Lisää rivi ja anna arvot jokaiselle pakolliselle kentälle. Katso kenttien kuvaukset kohdasta UiPreviewMessageTabDef.
-
Suorita seuraava kysely kyselyeditorissa saadaksesi käyttöönottamasi LWC:n tunnuksen:
SELECT Id, DeveloperName, IsExposed, NamespacePrefix FROM LightningComponentBundle WHERE IsExposed = true -
Kopioi komponenttisi
Id-arvo ja syötä se LightningComponentDefId-kenttään. - Napsauta Tallenna rivit.
Kun tallennat UiPreviewMessageTabDef-tietueen, jonka IsActive on true, mukautettu välilehti näytetään esikatselu- ja testausikkunoissa vakiomuotoisten esikatselu- ja testausvälilehtien vieressä. Komponenttiisi välitetty previewData-objekti päivitetään automaattisesti, kun esikatselun konteksti muuttuu, esimerkiksi kun käyttäjä valitsee toisen segmentin jäsenen tai siirtyy henkilökohtaisten ja ei-henkilökohtaisten näkymien välillä.
Vaihe 3: Laajennuksen pakkaaminen
Jos haluat jakaa esikatselu- ja testauslaajennuksesi AppExchangesta, sisällytä hallittuun pakettiisi sekä LightningComponentBundle- että UiPreviewMessageTabDef-tietueet.
Pakettiasi asentavat käyttäjät voivat hallita, näytetäänkö mukautettu välilehti heidän Esikatselu- ja Testaus-ikkunassaan muokkaamalla asennetun UiPreviewMessageTabDef-tietueen IsActive-kenttää.
