Loading
Marketing Cloud Next
Estender visualização e teste no Marketing Cloud Next

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 UiPreviewMessageTabDef nĆ£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.

  1. Crie uma estrutura de diretório para seu componente:
    
    lwc/
      customTab/
        customTab.html
        customTab.js
        customTab.js-meta.xml
    package.xml
    
  2. 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>
    
  3. Adicione este código ao customTab.js:
    
    import { LightningElement, api } from "lwc";
    export default class CustomTab extends LightningElement {
        @api previewData;
    }
    
  4. 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>
         
  5. 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>
    
  6. 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.

  1. Na sua organização, clique no ícone de configuração e selecione Console do desenvolvedor.
  2. No Developer Console, clique na guia Editor de consulta.
  3. Na parte inferior do Editor de consulta, marque a caixa de seleção Usar API de ferramentas.
  4. Insira a seguinte consulta e clique em Executar:
    SELECT Id, DeveloperName, TabName, IsActive, SupportedChannel, LightningComponentDefId
    FROM UiPreviewMessageTabDef
    
  5. Clique em Inserir linha e forneça valores para cada campo obrigatório. Para descrições de campo, consulte UiPreviewMessageTabDef.
  6. 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
    
  7. Copie o valor de Id do seu componente e insira-o no campo LightningComponentDefId.
  8. 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.

 
Carregando
Salesforce Help | Article