VocĆŖ estĆ” aqui:
Estender visualização e teste no Marketing Cloud Next
Visualizar e testar Ć© um recurso integrado no Marketing Cloud Next para revisar o conteĆŗdo da sua mensagem antes do envio. No modal Visualizar e testar, vocĆŖ pode ver como seu email, SMS ou mensagem do WhatsApp aparece para os destinatĆ”rios, personalizar a visualização com membros especĆficos do segmento e validar campos de mesclagem. O modal inclui guias dedicadas para visualizar conteĆŗdo renderizado e executar envios de teste.
Edições obrigatórias
| DisponĆvel em: EdiƧƵes Enterprise e Unlimited do Salesforce com o Marketing Cloud Next Growth ou Advanced Edition e nas ediƧƵes Starter e Pro Suite. Sua edição determina as opƧƵes que vocĆŖ tem. |
| PermissƵes de usuƔrio necessƔrias | |
|---|---|
| Para visualizar e testar o conteúdo: | Conjunto de permissões de Gerente do Marketing Cloud E qualquer papel de colaborador do espaço de trabalho do CMS |
Você pode estender a visualização e o teste adicionando guias personalizadas ao modal. Cada guia personalizada é alimentada por um Componente da Web Lightning (LWC) que você cria e implanta na sua organização. A guia recebe dados de visualização ativa, incluindo tipos de canal, conteúdo e valores de campo de mesclagem, para que você possa criar ferramentas de validação personalizadas, renderizar visualizações ou verificar a integração diretamente na experiência de visualização e teste.
O mecanismo de extensão é baseado em um tipo de metadados UiPreviewMessageTabDef. Quando você cria e ativa um registro de UiPreviewMessageTabDef, sua guia personalizada aparece junto com as guias padrão Visualizar e Testar no modal.
-
Conclua a configuração para as edições Marketing Cloud Growth ou Advanced. Para instruções de configuração, consulte o guia Introdução.
-
Configure o Salesforce Workbench.
-
Provisione o canal de email. Sem isso, o
UiPreviewMessageTabDefnĆ£o Ć© acessĆvel.
- Entender o objeto previewData
Seu LWC personalizado recebe um objeto previewData que contĆ©m informaƧƵes contextuais sobre a mensagem que estĆ” sendo visualizada. Os campos disponĆveis em previewData variam de acordo com o canal.
Etapa 1: Criar e implementar um componente da Web Lightning
Crie um LWC e implante-o em sua organização. O componente fornece o conteúdo que aparece na sua guia personalizada. Use a estrutura de diretórios e o conteúdo do arquivo especificados no procedimento.
-
Crie uma estrutura de diretório para seu componente:
lwc/ customTab/ customTab.html customTab.js customTab.js-meta.xml package.xmlConsulte Criar componentes da Web Lightning. -
Adicione esta marcação 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> -
Adicione este código ao customTab.js:
import { LightningElement, api } from "lwc"; export default class CustomTab extends LightningElement { @api previewData; } -
Adicione estes metadados ao 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> -
Adicione este conteĆŗdo ao 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> - Implemente o componente na sua organização.
Etapa 2: criar uma entrada UiPreviewMessageTabDef
Depois de implementar seu LWC, crie um registro de UiPreviewMessageTabDef para registrar sua guia personalizada.
- Na sua organização, clique no Ćcone de configuração e selecione Console do desenvolvedor.
- No Developer Console, clique na guia Editor de consulta.
- Na parte inferior do Editor de consulta, marque a caixa de seleção Usar API de ferramentas.
-
Insira a seguinte consulta e clique em Executar:
SELECT Id, DeveloperName, TabName, IsActive, SupportedChannel, LightningComponentDefId FROM UiPreviewMessageTabDef - Clique em Inserir linha e forneça valores para cada campo obrigatório. Para descrições de campo, consulte UiPreviewMessageTabDef.
-
Para obter o ID do LWC implementado, execute a seguinte consulta no Editor de consulta:
SELECT Id, DeveloperName, IsExposed, NamespacePrefix FROM LightningComponentBundle WHERE IsExposed = true -
Copie o valor de
Iddo seu componente e insira-o no campo LightningComponentDefId. - Clique em Salvar linhas.
Depois de salvar o registro de UiPreviewMessageTabDef com IsActive definido como true, sua guia personalizada aparece no modal Visualizar e Testar ao lado das guias padrão Visualizar e Testar. O objeto de previewData passado para o seu componente é atualizado automaticamente quando o contexto da visualização muda, por exemplo, quando um usuÔrio seleciona um membro de segmento diferente ou alterna entre visualizações personalizadas e não personalizadas.
Etapa 3: empacotar sua extensão
Para distribuir sua extensão de Visualização e Teste por meio do AppExchange, inclua os registros de LightningComponentBundle e UiPreviewMessageTabDef no pacote gerenciado.
Os usuƔrios que instalam seu pacote podem controlar se a guia personalizada aparece no modal Visualizar e Testar modificando o campo IsActive no registro de UiPreviewMessageTabDef instalado.
