DocumentaçãoAEM 6.5Guia do usuário

Componentes do Adobe Campaign adobe-campaign-components

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Usuário
  • Administrador
  • Desenvolvedor

Ao integrar com o Adobe Campaign, você tem componentes disponíveis para o ao trabalhar com boletins informativos e formulários. Ambos estão descritos neste documento.

CAUTION
Os componentes de email do AEM foram descontinuados. Devido à natureza do email, que mescla conteúdo e estilo, os componentes de email fornecidos prontos para uso pelo AEM tornam-se de reutilização limitada para os clientes, devido à necessidade de implementar estilos personalizados em quaisquer componentes que sejam necessários para projetos.
Os componentes de email podem ser implementados no nível do projeto, e os componentes de email do AEM obsoletos ilustram como isso pode ser feito. No entanto, não use esses componentes obsoletos em projetos.

Componentes do informativo do Adobe Campaign adobe-campaign-newsletter-components

Todos os componentes do Campaign seguem as práticas recomendadas descritas em Práticas recomendadas para modelos de email e se baseiam na linguagem de marcação Adobe HTL.

Ao abrir um boletim informativo/email configurado para integração com o Adobe Campaign, você deve ver os seguintes componentes na seção Informativo da Adobe Campaign:

  • Cabeçalho (Campanha)
  • Imagem (Campanha)
  • Link (Campanha)
  • Modelo de imagem do Scene7 (Campanha)
  • Referência direcionada (Campaign)
  • Texto e Imagem (Campanha)
  • Texto e personalização (Campanha)

Uma descrição desses componentes está na seção a seguir.

Os componentes aparecem da seguinte maneira:

chlimage_1-43

Cabeçalho (Campanha) heading-campaign

O componente de cabeçalho pode:

  • Exiba o nome da página atual deixando o campo Título em branco.
  • Exibir um texto especificado no campo Título.

Você edita o componente Cabeçalho (Campanha) diretamente. Deixe em branco para utilizar título da página.

chlimage_1-44

Você pode configurar o seguinte:

  • Título
    Se quiser usar um nome diferente do título da página, insira-o aqui.

  • Nível do cabeçalho (1, 2, 3, 4)
    O nível do cabeçalho com base nos tamanhos dos cabeçalhos HTML 1-4.

O exemplo a seguir mostra um componente de Cabeçalho (Campanha) sendo exibido.

chlimage_1-45

Imagem (Campanha) image-campaign

O componente de imagem (campanha) exibe uma imagem e o texto de acompanhamento de acordo com os parâmetros especificados.

É possível carregar uma imagem, editá-la e manipulá-la (por exemplo, cortar, girar, adicionar link/título/texto).

Você pode arrastar e soltar uma imagem do Navegador de Ativos diretamente no componente ou em sua caixa de diálogo de Configuração. Você poderá também enviar uma imagem da janela de Configuração; esta janela também controla todas as definições e manipulações da imagem:

chlimage_1-46

NOTE
Insira informações no campo Alt Text ou a imagem não pode ser salva.

Depois que a imagem for carregada (e não antes) você poderá usar a edição local para recortar/girar a imagem conforme necessário:

Inserir barra de ferramentas de edição

NOTE
O editor local usa o tamanho original e a proporção da imagem ao editar. Também é possível especificar propriedades de altura e largura. Quaisquer restrições de tamanho e taxa de proporção definidas nas propriedades são aplicadas quando você salva as alterações de edição.
Dependendo da sua instância, restrições mínimas e máximas também podem ser impostas pelo design da página; elas são desenvolvidas durante a implementação do projeto.

Várias opções adicionais estão disponíveis no modo de edição de tela cheia; por exemplo, map e zoom:

Modo de edição de tela inteira

Quando uma imagem é carregada, você pode configurar o seguinte:

  • Mapa
    Para mapear uma imagem, selecione Mapear. Você pode especificar como deseja criar o mapa de imagem (retângulo, polígono etc.) e onde a área deve apontar.

  • Cortar
    Selecione Cortar para recortar uma imagem. Use o mouse para cortar a imagem.

  • Girar
    Para girar uma imagem, selecione Girar. Use repetidamente até que a imagem seja girada da maneira desejada.

  • Limpar
    Remover a imagem atual.

  • Barra de zoom (apenas clássica)
    Para ampliar e reduzir a imagem, use a barra deslizante abaixo da imagem (acima dos botões OK e Cancelar)

  • Título
    O título da imagem.

  • Texto Alternativo
    Um texto alternativo a ser usado ao criar conteúdo acessível.

  • Vincular a
    Crie um link para ativos ou outras páginas no seu site.

  • Descrição
    Uma descrição da imagem.

  • Tamanho
    Define a altura e a largura da imagem.

NOTE
Insira informações no campo Alt Text da guia Avançado ou a imagem não pode ser salva e você verá a seguinte mensagem de erro:
Validation failed. Verify the values of the marked fields.

O exemplo a seguir mostra um componente de Imagem (Campanha) sendo exibido.

chlimage_1-47

O componente Link (Campanha) permite adicionar um link ao seu informativo.

Você pode configurar as seguintes opções nas guias Exibir, Informações sobre URL ou Avançado:

  • Legenda do link
    A legenda do link. Esse é o texto que os usuários veem.

  • Vincular ToolTip
    Adiciona mais informações sobre como usar o link.

  • TipoLink
    Na lista suspensa, selecione entre um URL personalizado e um Documento adaptável. Este campo é obrigatório. Se você selecionar URL personalizado, poderá fornecer o URL do link. Se você selecionar Documento adaptável, poderá fornecer o caminho do documento.

  • Parâmetro de URL Adicional
    Adicione quaisquer parâmetros de URL adicionais. Clique em Adicionar item para adicionar vários itens.

NOTE
Digite informações no campo Tipo de link da guia Informações de URL ou o componente não pode ser salvo e você verá a seguinte mensagem de erro:
Validation failed. Verify the values of the marked fields.

O exemplo a seguir mostra um componente Link (Campanha) sendo exibido.

chlimage_1-48

Modelo de imagem do Dynamic Media Classic (Scene7) (Campanha) scene-image-template-campaign

Os Modelos de imagem do Dynamic Media Classic (Scene7) são arquivos de imagem em camadas, nos quais o conteúdo e as propriedades podem ser parametrizados para fins de variabilidade. O componente modelo de imagem permite usar modelos do Scene7 em boletins informativos e alterar os valores dos parâmetros do modelo. Além disso, você pode usar as variáveis de metadados do Adobe Campaign dentro dos parâmetros, para que cada usuário experimente a imagem de forma personalizada.

chlimage_1-49

Clique em Editar para configurar o componente. Você pode definir as configurações descritas nesta seção. Este modelo de Imagem Scene7 é descrito detalhadamente no componente de Modelo de Imagem Scene7.

Além disso, o painel de parâmetros lista todos os parâmetros de modelo que foram definidos para o modelo no Scene7. Para cada um desses parâmetros, você pode adaptar o valor, inserir variáveis ou redefini-las para o valor padrão.

chlimage_1-50

Referência direcionada (Campaign) targeted-reference-campaign

O componente Referência direcionada (Campanha) permite criar uma referência a um parágrafo direcionado.

Neste componente, navegue até o parágrafo de destino para selecioná-lo.

Clique no ícone de pasta para navegar até o parágrafo ao qual deseja fazer referência. Quando terminar, clique na marca de seleção.

Texto e Imagem (Campanha) text-image-campaign

O componente Texto e imagem (Campanha) adiciona um bloco de texto e uma imagem.

Ao clicar para configurar o componente, você seleciona Texto ou Imagem.

chlimage_1-51

Selecionar Texto exibe um editor embutido:

Barra de ferramentas de texto

Selecionar Imagem exibe o editor local para imagens:

Barra de ferramentas da imagem

Consulte o componente de Imagem (Campanha) para obter mais informações sobre como trabalhar com imagens. Consulte o componente de Texto e Personalization (Campanha) para obter mais informações sobre como trabalhar com texto.

Assim como nos componentes Texto e Personalization (Campaign) e Imagem (Campaign), você pode configurar:

  • Texto
    Insira o texto. Use a barra de ferramentas para modificar a formatação, criar listas e adicionar links.

  • Imagem
    Arraste uma imagem do localizador de conteúdo ou clique em para navegar até uma imagem. Recorte ou gire conforme necessário.

  • Propriedades da Imagem (Propriedades Avançadas da Imagem)
    Permite especificar o seguinte:

    • Título
      O título do bloco; é mostrado por mouseover.

    • Texto Alternativo
      Texto alternativo a ser mostrado se a imagem não puder ser exibida.

    • Vincular a
      Crie um link para ativos ou outras páginas no seu site.

    • Descrição
      Uma descrição da imagem.

    • Tamanho
      Define a altura e a largura da imagem.

NOTE
O campo Texto alternativo da guia Avançado é obrigatório ou o componente não pode ser salvo e você verá a seguinte mensagem de erro:
Validation failed. Verify the values of the marked fields.

O exemplo a seguir mostra um componente de Texto e imagem (Campanha) sendo exibido.

chlimage_1-52

Texto e personalização (Campanha) text-personalization-campaign

O componente Text & Personalization (Campaign) permite inserir um bloco de texto usando um editor WYSIWYG, com a funcionalidade fornecida pelo editor de Rich Text. Além disso, esse componente permite usar campos de contexto e blocos de personalização disponíveis no Adobe Campaign. Consulte também Inserção do Personalization.

A seleção de ícones permite formatar o texto, incluindo características de fonte, alinhamento, links, listas e recuo. A funcionalidade é basicamente a mesma em ambas as interfaces, embora a aparência seja diferente:

chlimage_1-53

No editor local, é possível adicionar texto, alterar a justificativa, adicionar e remover links, adicionar campos de contexto ou blocos de personalização e entrar no modo de tela cheia. Quando terminar de adicionar texto/personalização, marque a marca de seleção para salvar suas alterações (ou x para cancelar). Consulte Edição no local para obter mais informações.

NOTE
  • Os campos de personalização disponíveis dependem do modelo do Adobe Campaign ao qual o informativo está vinculado.
  • Depois de selecionar uma persona no ContextHub, os campos de personalização são substituídos automaticamente pelos dados do perfil selecionado.
Consulte Inserir Personalization.

chlimage_1-54

NOTE
Somente os campos definidos no esquema nms:seedMember ou em uma de suas extensões são considerados. Os atributos das tabelas vinculadas a nms:seedMember não estão disponíveis.

Componentes de formulário do Adobe Campaign adobe-campaign-form-components

Use os componentes do Adobe Campaign para criar um formulário que os usuários preenchem para assinar um boletim informativo, cancelar a assinatura de um boletim informativo ou atualizar seus perfis de usuário. Consulte Criando o Adobe Campaign Forms para obter mais informações.

Cada campo de componente pode ser vinculado a um campo de banco de dados do Adobe Campaign. Os campos disponíveis diferem de acordo com o tipo de dados que contêm, conforme descrito na seção Componentes e Tipo de Dados. Se você estender o esquema de recipient no Adobe Campaign, os novos campos estarão disponíveis nos componentes cujos tipos de dados correspondem.

Ao abrir um formulário configurado para integração com o Adobe Campaign, você verá os seguintes componentes na seção Adobe Campaign:

  • Caixa de seleção (Campanha)
  • Campo de data (Campanha) e Campo de data/HTML5 (Campanha)
  • Chave primária criptografada (Campanha)
  • Exibição de erro (Campaign)
  • Chave de reconciliação oculta (Campanha)
  • Campo numérico (Campanha)
  • Campo de opções (Campanha)
  • Lista de verificação de assinaturas (Campanha)
  • Campo de texto (Campanha)

Os componentes aparecem da seguinte maneira:

chlimage_1-55

Esta seção descreve cada componente em detalhes.

Componentes e tipo de dados components-and-data-type

A tabela a seguir descreve os componentes que estão disponíveis para exibir e modificar dados de perfil do Adobe Campaign. Cada componente pode ser mapeado para um campo de perfil do Adobe Campaign para exibir seu valor e atualizar o campo quando o formulário for enviado. Os diferentes componentes só podem ser correspondidos a campos de um tipo de dados apropriado.

Componente
Tipo de dados do campo do Adobe Campaign
Exemplo de campo
Caixa de seleção (Campanha)
booleano
Não entrar mais em contato (por qualquer canal)

Campo de dados (Campanha)

Campo de data/HTML 5 (Campanha)

data
Data de nascimento
Campo numérico (Campanha)
numérico (byte, curto, longo, duplo)
Idade
Campo de opções (Campanha)
byte com valores associados
Sexo
Campo de texto (Campanha)
string
Email

Configurações comuns à maioria dos componentes settings-common-to-most-components

Os componentes do Adobe Campaign têm configurações comuns em todos os componentes (exceto os componentes Chave primária criptografada e Chave de reconciliação oculta).

Na maioria dos componentes, é possível configurar o seguinte:

Título e texto title-and-text

chlimage_1-56

  • Título
    Se quiser usar um nome diferente do nome do elemento, insira-o aqui.

  • Ocultar título
    Marque essa caixa de seleção se não quiser que o título fique visível.

  • Descrição
    Adicione uma descrição ao campo para fornecer mais informações aos usuários.

  • Mostrar apenas o valor
    Mostra apenas o valor, se houver um

Adobe Campaign adobe-campaign

Você pode configurar o seguinte:

  • Mapeamento
    Selecione um campo de personalização do Adobe Campaign, se apropriado.

  • Chave de reconciliação
    Marque esta caixa de seleção se este campo fizer parte da chave de reconciliação.

chlimage_1-57

Restrições constraints

  • Obrigatório Marque esta caixa de seleção para tornar este componente obrigatório; ou seja, os usuários devem inserir um valor.
  • Mensagem Obrigatória Opcionalmente, adicione uma mensagem informando que o campo é obrigatório.

chlimage_1-58

Estilo styling

  • CSS
    Insira as classes CSS que você deseja usar para este componente.

chlimage_1-59

Caixa de seleção (Campanha) checkbox-campaign

O componente Caixa de seleção (Campanha) permite que o usuário modifique campos de perfil do Adobe Campaign que são do tipo de dados booleano. Por exemplo, você pode ter um componente Caixa de seleção (Campanha) que permite que o recipient especifique que não deseja ser contatado por meio de nenhum canal.

Você pode definir configurações comuns à maioria dos componentes do Adobe Campaign no componente Caixa de seleção (Campanha).

O exemplo a seguir mostra um componente Caixa de seleção (Campanha) sendo exibido.

chlimage_1-60

Campo de data (Campanha) e Campo de data/HTML 5 (Campanha) date-field-campaign-and-date-field-html-campaign

Use o campo de data para permitir que os destinatários definam uma data; por exemplo, você pode desejar que os destinatários especifiquem suas datas de nascimento. O formato de data corresponde ao formato usado na instância do Adobe Campaign.

Além das configurações comuns à maioria dos componentes do Adobe Campaign, você pode definir o seguinte:

  • Restrições - Menu suspenso Restrição
    Você pode selecionar - Nenhum ou Data - para adicionar a restrição de uma data ou nenhuma restrição. Se você selecionar data, os usuários de resposta inseridos no campo deverão estar em um formato de data.

  • Mensagem de restrição Além disso, você pode adicionar uma mensagem de restrição para que os usuários saibam como formatar corretamente suas respostas.

  • Estilo - Largura Ajuste a largura do campo clicando ou tocando nos ícones + e - ou inserindo um número.

O exemplo a seguir mostra um componente Campo de data (Campanha) com a largura ajustada sendo exibida.

chlimage_1-61

Chave primária criptografada (Campanha) encrypted-primary-key-campaign

Este componente define o nome do parâmetro de URL que conterá o identificador de um perfil do Adobe Campaign (Identificador de Recurso Principal ou Chave primária criptografada no Adobe Campaign Standard e 6.1, respectivamente).

Cada formulário exibindo e modificando os dados de perfil do Adobe Campaign deve incluir um componente de Chave Primária Criptografada.

Você pode configurar o seguinte no componente Chave primária criptografada (Campaign):

  • Título e Texto - Nome do Elemento O padrão é encryptedPK. Você só precisa alterar o nome do elemento quando ele estiver em conflito com o nome de outro elemento no formulário. Nenhum campo de formulário pode ter o mesmo nome de elemento.
  • Adobe Campaign - Parâmetro de URL Adicione o parâmetro de URL para o EPK. Por exemplo, você pode usar o valor epk.

O exemplo a seguir mostra um componente de Chave primária criptografada (Campanha) que está sendo exibido.

chlimage_1-62

Exibição de erro (Campaign) error-display-campaign

Esse componente permite exibir erros de backend. A manipulação de erros do formulário precisa ser definida como Encaminhar para que o componente funcione corretamente.

O exemplo a seguir mostra um componente de Exibição de erro (Campanha) sendo exibido.

chlimage_1-63

Chave de reconciliação oculta (Campanha) hidden-reconciliation-key-campaign

O componente Chave de reconciliação oculta (Campanha) permite adicionar campos ocultos como parte da chave de reconciliação a um formulário.

Você pode configurar o seguinte no componente Chave de reconciliação oculta (Campanha):

  • Título e Texto - Nome do Elemento O padrão é reconciliarChave. Você só precisa alterar o nome do elemento quando ele estiver em conflito com o nome de outro elemento no formulário. Nenhum campo de formulário pode ter o mesmo nome de elemento.
  • Adobe Campaign - Mapeamento Mapeie para um campo de personalização do Adobe Campaign.

O exemplo a seguir mostra um componente Chave de reconciliação oculta (Campanha) que está sendo exibido.

chlimage_1-64

Campo numérico (Campanha) numeric-field-campaign

Use o campo numérico para permitir que os recipients insiram números, por exemplo, sua idade.

Além das configurações comuns à maioria dos componentes do Adobe Campaign, você pode definir o seguinte:

  • Restrições - Menu suspenso Restrição
    Você pode selecionar - Nenhum ou Numérico - para adicionar a restrição de um número ou nenhuma restrição. Se você selecionar número, os usuários de resposta inseridos no campo deverão ser numéricos.

  • Mensagem de restrição Além disso, você pode adicionar uma mensagem de restrição para que os usuários saibam como formatar corretamente suas respostas.

  • Estilo - Largura Ajuste a largura do campo clicando ou tocando nos ícones + e - ou inserindo um número.

O exemplo a seguir mostra um componente de Campo numérico (Campanha) com a largura configurada sendo exibida.

chlimage_1-65

Campo de opções (Campanha) option-field-campaign

Essa lista suspensa permite selecionar uma opção; por exemplo, o gênero ou o status de um recipient.

Você pode definir configurações comuns à maioria dos componentes do Adobe Campaign no componente Campo de Opções (Campanha). Para preencher a lista suspensa, selecione o campo apropriado nos campos de personalização do Adobe Campaign clicando ou tocando no símbolo da Adobe Campaign e navegando até o campo.

chlimage_1-66

O exemplo a seguir mostra um componente Campo de opções (Campanha) sendo exibido.

chlimage_1-67

Lista de verificação de assinaturas (Campanha) subscriptions-checklist-campaign

Use o componente Lista de Verificação de Assinaturas (Campanha) para modificar as assinaturas associadas a um perfil do Adobe Campaign.

Quando adicionado a um formulário, esse componente exibe todas as assinaturas disponíveis como caixas de seleção e permite que o usuário selecione as assinaturas desejadas. Quando os usuários enviam o formulário, este componente faz a assinatura do usuário ou cancela a assinatura do usuário nos serviços selecionados, dependendo do tipo de ação de formulário (Adobe Campaign: Assinar Serviços ou Adobe Campaign: Cancelar Assinatura de Serviços).

NOTE
O componente não verifica quais serviços o usuário já assinou/cancelou a assinatura.

Você pode definir configurações comuns à maioria dos componentes do Adobe Campaign no componente Lista de verificação de assinaturas (Campanha). (Não há configurações do Adobe Campaign disponíveis para este componente.)

O exemplo a seguir mostra um componente Lista de verificação de assinaturas (Campanha) que está sendo exibido.

chlimage_1-68

Campo de texto (Campanha) text-field-campaign

O componente Campo de texto (Campanha) que permite inserir dados do tipo string, como nome, sobrenome, endereço, endereço de email e assim por diante.

Além das configurações comuns à maioria dos componentes do Adobe Campaign, você pode definir o seguinte:

  • Restrições - Menu suspenso Restrição
    Você pode selecionar - Nenhum, Email ou Nome (sem umlauts) - para adicionar a restrição de um endereço de email, nome ou nenhuma restrição. Se você selecionar email, os usuários de resposta inseridos no campo deverão ser um endereço de email. Se você selecionar name, ele deverá ser um nome (umlauts não são permitidos).

  • Mensagem de restrição Além disso, você pode adicionar uma mensagem de restrição para que os usuários saibam como formatar corretamente suas respostas.

  • Estilo - Largura Ajuste a largura do campo clicando ou tocando nos ícones + e - ou inserindo um número.

O exemplo a seguir mostra um componente Campo de texto (Campanha) sendo exibido.

chlimage_1-69

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2