Componentes do Adobe Campaign adobe-campaign-components

CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

Ao fazer a integração com o Adobe Campaign, você tem componentes disponíveis para trabalhar com informativos e formulários. Ambos estão descritos neste documento.

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 são baseados na linguagem de marcação Adobe HTL.

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

  • Cabeçalho (Campanha)
  • Imagem (Campanha)
  • Link (Campanha)
  • Modelo de imagem do Dynamic Media (Campaign)
  • 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 são exibidos da seguinte maneira:

chlimage_1-105

Cabeçalho (Campanha) heading-campaign

O componente de cabeçalho pode:

  • Exibir o nome da página atual, deixando a variável Título campo em branco.
  • Exibir um texto especificado na variável Título campo.

Você edita a variável Cabeçalho (Campaign) componente diretamente. Deixe em branco para utilizar título da página.

chlimage_1-106

Você pode configurar o seguinte:

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

  • Nível de cabeçalho (1, 2, 3, 4)
    O nível de cabeçalho com base nos tamanhos de cabeçalho de HTML de 1 a 4.

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

chlimage_1-107

Imagem (Campanha) image-campaign

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

Você pode fazer upload de uma imagem, em seguida, editá-la e manipulá-la (por exemplo, recortar, girar, adicionar link/título/texto).

Você pode arrastar e soltar uma imagem do Navegador de ativos diretamente no componente ou em seu Caixa de diálogo Configurar. Também é possível fazer upload de uma imagem na caixa de diálogo Configurar ; essa caixa de diálogo também controla todas as definições e manipulações da imagem:

chlimage_1-108

NOTE
Você deve inserir informações no Texto alternativo ou a imagem não pode ser salva.

Após a imagem ser carregada (e não antes), você pode usar edição no local para cortar/girar a imagem conforme necessário:

NOTE
O editor local usa o tamanho e a proporção original da imagem durante a edição. Também é possível especificar as propriedades de altura e largura. Qualquer restrição de tamanho e aspecto definida nas propriedades será aplicada ao salvar as alterações de edição.
Dependendo do seu caso, restrições mínimas e máximas também podem ser impostas pelo design da página; são desenvolvidos 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, mapa e zoom:

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

  • Mapa

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

  • Cortar

    Selecione Recortar para recortar uma imagem. Use o mouse para recortar a imagem.

  • Girar

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

  • Limpar

    Remova a imagem atual.

  • Barra de zoom (somente clássica)

    Para ampliar e reduzir a imagem, use a barra de rolagem abaixo da imagem (acima dos botões OK e Cancelar)

  • Título

    O título da imagem.

  • Alternar texto

    Um texto alternativo para usar na criação de conteúdo acessível.

  • Vincular ao

    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
Você deve inserir informações no Texto alternativo no campo Avançado ou a imagem não poderá 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 (Campaign) sendo exibido.

chlimage_1-109

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

Você pode configurar o seguinte no Exibir, Informações do URL ou Avançado guias:

  • Legenda do link

    A legenda do link. Este é o texto que os usuários veem.

  • Dica da ferramenta Link

    Adiciona informações adicionais sobre como usar o link.

  • LinkType

    Na lista suspensa, selecione entre um URL personalizado e um Documento adaptável. Este campo é obrigatório. Se você selecionar URL personalizado, é possível 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
Você deve inserir informações no Tipo de link no campo Informações do URL ou o componente não poderá ser salvo, e a seguinte mensagem de erro será exibida:
Validation failed. Verify the values of the marked fields.

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

chlimage_1-110

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

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

chlimage_1-111

Clique em Editar para configurar o componente. Você pode definir as configurações descritas nesta seção. Este modelo de imagem do Dynamic Media Classic (antigo Scene7) é descrito detalhadamente em Componente de modelo de imagem do Scene7.

Além disso, o painel de parâmetros lista todos os parâmetros do modelo que foram definidos para o modelo no Dynamic Media Classic (antigo Scene7). Para cada um desses parâmetros, é possível adaptar o valor, inserir variáveis ou redefini-las com o valor padrão.

chlimage_1-112

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

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

Nesse componente, você navega até o parágrafo direcionado para selecioná-lo.

Clique no ícone de pasta para navegar até o parágrafo que deseja referenciar. Quando terminar, clique na marca de seleção.

Texto e Imagem (Campanha) text-image-campaign

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

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

chlimage_1-113

Selecionar Texto exibe um editor em linha:

Selecionar Imagem exibe o editor local de imagens:

Consulte Componente de imagem (Campaign) para obter mais informações sobre como trabalhar com imagens. Consulte Componente Texto e personalização (Campaign) para obter mais informações sobre como trabalhar com texto.

Assim como nos componentes Texto e personalização (Campaign) e Imagem (Campaign) , é possível 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 para navegar até uma imagem. Recorte ou gire, conforme necessário.

  • Propriedades da imagem (Propriedades avançadas de imagem)

    Permite que você especifique o seguinte:

    • Título

      O título do bloco; será exibido ao passar o mouse.

    • Alternar texto

      Texto alternativo a ser exibido se a imagem não puder ser exibida.

    • Vincular para

      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 Texto alternativo no campo Avançado é necessária ou o componente não pode ser salvo, e a seguinte mensagem de erro é exibida:
Validation failed. Verify the values of the marked fields.

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

chlimage_1-114

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

O componente Texto e personalização (Campaign) permite que você insira 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 Inserir personalização.

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

chlimage_1-115

No editor local, é possível adicionar texto, alterar a justificação, 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, selecione 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 seu boletim informativo está vinculado.
  • Após selecionar uma persona no ContextHub, os campos de personalização são substituídos automaticamente pelos dados do perfil selecionado.
Consulte Inserir personalização.

chlimage_1-116

NOTE
Somente os campos definidos na variável nms:seedMember ou uma de suas extensões é levada em conta. 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 informativo, cancelar a assinatura de um informativo ou atualizar seus perfis de usuário. Consulte Criação do 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 eles contêm, conforme descrito na seção Componentes e tipo de dados. Se você estender o esquema do 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 Adobe Campaign seção:

  • Caixa de seleção (Campanha)
  • Campo de data (Campaign) e Campo de data/HTML5 (Campaign)
  • 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 são exibidos da seguinte maneira:

chlimage_1-117

Esta seção descreve cada componente em detalhes.

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

A tabela a seguir descreve os componentes disponíveis para exibir e modificar os 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 aos campos de um tipo de dados apropriado.

Componente
Tipo de dados do campo 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, você pode configurar o seguinte:

Título e texto title-and-text

chlimage_1-118

  • 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 para os 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.

  • Tecla de reconciliação

    Marque essa caixa de seleção se esse campo fizer parte da chave de reconciliação.

chlimage_1-119

Restrições constraints

  • Obrigatório

    Marque essa caixa de seleção para tornar esse 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-120

Estilo styling

  • CSS
    Insira as classes CSS que deseja usar para esse componente.

chlimage_1-121

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

O componente Caixa de seleção (Campaign) permite que o usuário modifique campos de perfil do Adobe Campaign que sejam do tipo de dados booleano. Por exemplo, você pode ter um componente Caixa de seleção (Campaign) 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 (Campaign) .

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

chlimage_1-122

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

Use o campo de data para permitir que os recipients tenham uma data; por exemplo, talvez você queira que os recipients especifiquem suas datas de nascimento. O formato de data corresponde ao formato usado em sua instância do Adobe Campaign.

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

  • Restrições - Restrição lista suspensa

    Você pode selecionar - Nenhum ou Data- para adicionar a restrição de uma data ou nenhuma restrição. Se você selecionar data, a resposta que os usuários inserirem no campo deverá estar em um formato de data.

  • Mensagem de restrição

    Além disso, é possível adicionar uma mensagem de restrição para que os usuários saibam formatar corretamente suas respostas.

  • Estilo - Largura
    Ajuste a largura do campo clicando ou tocando no botão
    + e - ou inserir um número.

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

chlimage_1-123

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

Esse 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 must inclua um componente 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. Dois campos de formulário não podem ter o mesmo nome de elemento.

  • Adobe Campaign - Parâmetro de URL
    Adicione o parâmetro de URL para a EPK. Por exemplo, você pode usar o valor
    epk.

O exemplo a seguir mostra um componente Chave primária criptografada (Campaign) sendo exibido.

chlimage_1-124

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

Esse componente permite exibir erros de backend. O tratamento de erros do formulário precisa ser definido como Encaminhar para que o componente funcione corretamente.

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

chlimage_1-125

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

O componente Chave de reconciliação oculta (Campaign) 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 (Campaign):

  • Título e texto - Nome do elemento

    O padrão é reconcilKey. Você só precisa alterar o nome do elemento quando ele estiver em conflito com o nome de outro elemento no formulário. Dois campos de formulário não podem ter o mesmo nome de elemento.

  • Adobe Campaign - Mapeamento
    Mapear para um campo de personalização do Adobe Campaign.

O exemplo a seguir mostra um componente Chave de reconciliação oculta (Campaign) sendo exibido.

chlimage_1-126

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 de configurações comuns à maioria dos componentes do Adobe Campaign, você pode configurar o seguinte:

  • Restrições - Restrição lista suspensa

    Você pode selecionar - Nenhum ou Numérico - para adicionar a restrição de um número ou nenhuma restrição. Se você selecionar um número, a resposta que os usuários inserirem no campo deverá ser numérica.

  • Mensagem de restrição

    Além disso, é possível adicionar uma mensagem de restrição para que os usuários saibam formatar corretamente suas respostas.

  • Estilo - Largura
    Ajuste a largura do campo clicando ou tocando no botão
    + e - ou inserir um número.

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

chlimage_1-127

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

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

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

chlimage_1-128

O exemplo a seguir mostra um componente Campo de opção (Campaign) sendo exibido.

chlimage_1-129

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

Use o Lista de verificação de assinaturas (Campaign) 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, esse componente inscreve o usuário ou cancela a assinatura dos serviços selecionados, dependendo do tipo de ação de formulário (Adobe Campaign: Inscrever-se nos Serviços ou Adobe Campaign: Cancelar assinatura dos serviços).

NOTE
O componente não verifica de quais serviços o usuário já está inscrito/cancelado.

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

O exemplo a seguir mostra um componente Lista de verificação de assinaturas (Campaign) sendo exibido.

chlimage_1-130

Campo de texto (Campanha) text-field-campaign

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

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

  • Restrições - Restrição lista suspensa

    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 um email, a resposta que os usuários inserirem no campo deverá ser um endereço de email. Se você selecionar um nome, ele deve ser um nome (trema não são permitidos).

  • Mensagem de restrição

    Além disso, é possível adicionar uma mensagem de restrição para que os usuários saibam formatar corretamente suas respostas.

  • Estilo - Largura

    Ajuste a largura do campo clicando ou tocando no botão + e - ou inserir um número.

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

chlimage_1-131

recommendation-more-help
5f6f1f67-8db1-40cb-84e9-024e65b9fc4c