O Que São Variáveis e Como Usá-las

No Connectif, as variáveis representam dados que podem mudar de valor dependendo do contato que navega e de seu contexto web. Isso permite criar conteúdos e experiências personalizadas, de acordo com o usuário e seu comportamento, que aumentam a fidelização e a conversão. 

 

1. Propriedades

  • Uma variável no Connectif é a representação de dados que mudam dependendo do contato e seu comportamento.
  • Qualquer dado coletado em um workflow pode ser atribuído a uma variável, seja relativo, por exemplo, a informações de produtos ou de contato.
  • Cada variável é identificada por um nome e um identificador único.
 

O identificador da variável não pode conter espaços e só pode incluir letras, números e os símbolos hífen ( - ) e sublinhado ( _ ).

  • As variáveis podem ter um tipo de formato determinado conforme os dados que representam. Esses formatos são Número, Data, Moeda e Percentual. Por padrão, as variáveis são definidas como Sem formato. Esse tipo indefinido é usado para representar texto ou dados que não serão exibidos de maneira especial.
 

Se quiser aprender mais sobre o formato das variáveis em email, conteúdo web, notificação push ou SMS, clique aqui.

  • As variáveis podem ser incluídas em qualquer tipo de conteúdo a partir dos respectivos editores e vinculadas a qualquer dado coletado nos nós anteriores de um workflow.
  • A atribuição de dados às variáveis é feita na configuração dos nós de ação responsáveis por enviar conteúdo ao contato: "Enviar conteúdo web", "Enviar email", "Mostrar push" e "Enviar SMS".
  • Ao criar uma variável é possível definir um valor padrão, que será atribuído automaticamente quando não houver valores para vincular a partir da origem de dados. Caso não esteja vinculada a nenhum dado e não tenha esse valor padrão, será exibido um espaço em branco em seu lugar.

 

2. Como usar no Connectif

2.1. Uso de variáveis predefinidas

Existem algumas variáveis que o Connectif fornece para serem utilizadas nos conteúdos sem a necessidade de fazer uma associação explícita de dados nos nós que enviam ou exibem os conteúdos:

Essas variáveis não permitem a definição de um valor padrão.

  • {{__cn_available_width}}: esta variável está disponível em todos os conteúdos do Connectif, exceto nas Notificações Web Push. Ela é automaticamente substituída pelo valor em pixels da largura da célula onde está localizada.
 

Por exemplo, se criarmos um popup de 600px de largura e adicionarmos um conteúdo dinâmico com esta variável configurada para exibir linhas com 4 células iguais, cada célula do conteúdo dinâmico terá 150px. 

  • {{__cn_email_subject}}: esta variável está disponível apenas no tipo de conteúdo email. Pode ser usada em qualquer parte do email, sendo automaticamente substituída pelo Assunto do email. 
  • {{__cn_email_from}}: esta variável está disponível apenas no tipo de conteúdo email. Pode ser usada em qualquer parte do email, sendo automaticamente substituída pelo Remetente utilizado para enviar o email. 

 

2.2. Criação de variáveis

Conteúdos web

1.  Acesse "Conteúdos > Conteúdo web" e clique em  Criar novo conteúdo web. Se quiser criar variáveis em um design de conteúdo web existente, clique em  Mais para expandir o menu e clique em Editar.

2. Adicione ou selecione no seu design o componente onde deseja criar uma nova variável.

3. Clique em  (Editar elemento).

4. No editor, clique no botão Variáveis.

Atualização variáveis - 1-min.png

5. Digite um nome para distinguir a variável em Identificador da variável.

6. (Opcional) Defina o Valor padrão se necessário.

7. (Opcional) Atribua um Tipo de dado se necessário.

Atualização variáveis - 2-min.png

8. Clique em  Confirmar para salvar as alterações no nó e em  Salvar para salvar as modificações no workflow.

 

Emails

1.  Acesse "Conteúdos > Email" e clique em  Criar novo email. Se quiser criar variáveis em um design de email existente, clique em  Mais para expandir o menu e clique em Editar.

2. Adicione ou selecione no seu design o componente onde deseja criar uma nova variável.

3. Clique em  (Editar elemento).

4. No editor, clique no botão Variáveis.

Atualização variáveis - 3-min.png

5. Digite um nome para distinguir a variável em Identificador da variável.

6. (Opcional) Defina o Valor padrão se necessário.

Atualização variáveis - 4-min.png

8. Clique em  Confirmar para salvar as alterações no nó e em  Salvar para salvar as modificações no workflow.

 

Notificações web push

1.  Acesse "Conteúdos > Notificações Push" e clique em  Criar nova notificação push. Se quiser criar variáveis em um design existente, clique em  Mais para expandir o menu e clique em Editar.

2. Nas abas Conteúdo ou Versão compacta, clique no botão {} (Definir uma variável dinâmica)

3. Digite um nome para distinguir a variável em Identificador da variável.

4. (Opcional) Defina o Valor padrão se necessário.

Atualização variáveis - 5-min.png

5. Clique em  Confirmar.

6. Clique em  Confirmar para salvar as alterações no nó e em  Salvar para salvar as modificações no workflow.

 

SMS

1.  Acesse "Conteúdos > SMS" e clique em  Criar novo SMS. Se quiser criar variáveis em um design existente, clique em  Mais para expandir o menu e clique em Editar.

2. Na aba Conteúdo, clique no botão {} (Definir uma variável dinâmica).

3. Digite um nome para distinguir a variável em Identificador da variável.

4. (Opcional) Defina o Valor padrão se necessário.

Atualização variáveis - 6-min.png

5. Clique em  Confirmar.

6. Clique em  Confirmar para salvar as alterações no nó e em  Salvar para salvar as modificações no workflow.

 

2.3. Modificação do tipo de dados de uma variável

  

Só é possível modificar os tipos de dados de uma variável em conteúdo do tipo web e email.

1. No editor, clique em   Propriedades gerais.

2. Selecione a aba Variáveis.

3. Clique em   (Editar).

4. Modifique o tipo de dados.

Atualização variáveis - 7-min.png

5. Clique em  Confirmar para salvar as alterações na variável e em  Salvar para salvar as modificações no design.

 

2.4. Atribuição de variáveis

Nó "Enviar conteúdo web"

1.  Acesse "Workflows" e clique em  Criar novo workflow. Se quiser atribuir variáveis em uma estratégia existente, clique em  Mais para expandir o menu e clique em Editar.

  

Para seguir os passos desta seção, será necessário um conteúdo web com variáveis, e um workflow que contenha pelo menos um nó "Enviar conteúdo web".
Lembre-se de que você pode usar um modelo já existente no Connectif, por exemplo, Recomendador na home.

2. No nó "Enviar conteúdo web", clique em  (Editar configuração do nó).

3. Selecione o conteúdo web com variáveis.

4. Clique em Próximo  .

5. Na segunda etapa, defina a configuração do envio de acordo com o tipo de conteúdo web.

  

Para saber mais sobre o nó "Enviar conteúdo web", clique aqui.

6. Na terceira etapa da configuração, defina a relação entre os dados obtidos nos nós anteriores e as variáveis criadas no design do conteúdo web.

Atualização variáveis - 8-min.png

7. Clique em Finalizar  .

8. No workflow, clique em  Salvar para salvar as alterações e em  Iniciar para ativá-lo.

 

Nó "Enviar email"

1. Acesse "Workflows" e clique em  Criar novo workflow. Se quiser atribuir variáveis em uma estratégia existente, clique em  Mais para expandir o menu e clique em Editar.

  

Para seguir os passos desta seção, será necessário um design de email com variáveis  e um workflow que contenha pelo menos um nó "Enviar email". 
Lembre-se de que você pode usar um modelo já existente no Connectif, por exemplo, Campanha de email em massa.

2. No nó "Enviar email", clique em  (Editar configuração do nó).

3. Selecione o design de email com variáveis.

4. Clique em Próximo  .

5. Na segunda etapa, defina a configuração e os parâmetros de envio.

6. Na terceira etapa da configuração, defina a relação entre os dados obtidos nos nós anteriores e as variáveis criadas no design do conteúdo web.

Atualização variáveis - 9-min.png

7. Clique em Finalizar  .

8. No workflow, clique em  Salvar para salvar as alterações e em  Iniciar para ativá-lo.

 

Nó "Mostrar push"

1.  Acesse "Workflows" e clique em  Criar novo workflow. Se quiser atribuir variáveis em uma estratégia existente, clique em  Mais para expandir o menu e clique em Editar.

  

Para seguir os passos desta seção, será necessário um design de notificação web push com variáveis, e um workflow que contenha pelo menos um nó "Mostrar push".
Lembre-se de que você pode usar um modelo já existente no Connectif, por exemplo, Solicitar assinatura de notificações web push.

2. No nó "Mostrar push", clique em  (Editar configuração do nó).

3. Selecione o design da notificação web push com variáveis.

4. Clique em Próximo  .

5. Na segunda etapa da configuração, defina a relação entre os dados obtidos nos nós anteriores e as variáveis criadas no design do conteúdo web.

Atualização variáveis - 10-min.png

6. Clique em Finalizar  .

7. No workflow, clique em  Salvar para salvar as alterações e em  Iniciar para ativá-lo.

 

Nó "Enviar SMS"

1.  Acesse "Workflows" e clique em  Criar novo workflow. Se quiser atribuir variáveis em uma estratégia existente, clique em  Mais para expandir o menu e clique em Editar.

  

Para seguir os passos desta seção, será necessário um design de SMS com variáveis, e um workflow que contenha pelo menos um nó "Enviar SMS".
Lembre-se de que você pode usar um modelo já existente no Connectif, por exemplo, Enviar um SMS após a compra.

2. No nó "Enviar SMS", clique em  (Editar configuração do nó).

3. Selecione o design de SMS com variáveis.

4. Clique em Próximo  .

5. Na segunda etapa, defina a configuração e os parâmetros de envio.

6. Na terceira etapa da configuração, defina a relação entre os dados obtidos nos nós anteriores e as variáveis criadas no design do SMS.

Atualização variáveis - 11-min.png

7. Clique em Finalizar  .

8. No workflow, clique em  Salvar para salvar as alterações e em  Iniciar para ativá-lo.

 

2.5. Identificação de variáveis

  

Na coluna à esquerda é exibida uma lista com os dados obtidos pelos nós anteriores do workflow.
Na coluna à direita são listadas as variáveis criadas no conteúdo dinâmico.
A coluna central, em branco, serve para relacionar os dados com as variáveis.

1. Atribua os dados obtidos no workflow à variável correspondente.

  

Arraste os dados da lista (coluna esquerda) que desejar para a coluna central para estabelecer a relação com a variável (coluna direita).

Atualização variáveis - 12-min (2).png

 

No nosso exemplo, as variáveis foram atribuídas primeiro com dados de origem Contato provenientes do nó "Início".

Atualização variáveis - 13 (1)-min.png

 

No nosso exemplo, em segundo lugar foram atribuídos os dados com origem no nó "Obter produtos", que contêm informações dos produtos, às variáveis do conteúdo dinâmico.

  

Algumas das associações de variáveis mais comuns são:
"Name": Nome do contato.
"Title": Nome do produto.
"Description": Descrição do item.
"ButtonUrl": URL de detalhes do produto, para a ficha do produto no eCommerce.
"ImageUrl": Imagem do produto.
"Price": Preço atual do produto.

 

Se quiser saber mais sobre os diferentes dados incluídos nas informações de produto, clique aqui.

2. (Opcional). Atribua valores literais às variáveis que assim o exigirem.

  

Um valor literal é um dado definido, estático, que será comum para todos os contatos, ao contrário dos dados dinâmicos que mudam de acordo com o contato e seu comportamento.

Atualização variáveis - 14-min (1).png

 

No nosso exemplo, os links dos botões (buttonURL) sempre levam à página do carrinho, por isso é usado um valor literal.

O resultado teria sido o mesmo se esse comportamento tivesse sido implementado na configuração dos botões no editor de conteúdo.

3. Clique em  Finalizar.

4. No workflow, clique em  Salvar para salvar as alterações e em  Iniciar para ativá-lo.

 

  

 Parabéns!
Você chegou ao final da lição.

  

 Ficou com alguma dúvida?
Lembre-se que você conta com nossos especialistas da Connectif. Para entrar em contato, basta abrir um ticket para o Suporte clicando no botão azul de “Ajuda” no seu painel.

 


Continue aprendendo!

Para aproveitar todo o potencial da sua conta Connectif, recomendamos seguir com os seguintes artigos: