Visão geral
As variáveis dinâmicas permitem que você personalize emails para contatos individuais aproveitando os dados da Apollo e, no caso de variáveis dinâmicas personalizadas, sua própria pesquisa de dados. As variáveis dinâmicas avançadas são um pouco diferentes das variáveis dinâmicas básicas porque permitem lógica condicional limitada.
Isso significa que as variáveis dinâmicas avançadas podem fornecer uma alternativa caso não haja dados para um campo específico de um contato. Você pode usar lógica condicional em prompts de pesquisa com IA ou em emails com variáveis para ajudar a garantir o envio.
Confira as seções a seguir para saber mais sobre variáveis dinâmicas avançadas.
Tipos de variáveis dinâmicas avançadas
As variáveis dinâmicas avançadas existem em vários tipos diferentes:
- Fallback vazio
- Fallback dinâmico
- Operadores de maiúsculas/minúsculas e pluralização
- Operadores de data/hora atual
- Operadores de data personalizada
Cada um desses tipos de variáveis dinâmicas avançadas permite personalizar ainda mais os modelos de email para seus clientes.
Fallback vazio
Use a variável dinâmica avançada de fallback vazio para enviar emails sem receio de que eles não sejam enviados porque uma variável dinâmica básica não tem dados. Com um fallback vazio, seu email é enviado com um espaço em branco no lugar da variável se a Apollo não tiver dados de um contato.
Imagine que você queira enviar um email que cumprimente cada destinatário pelo primeiro nome. Você pode usar a variável dinâmica{{first_name}} básica para dizer:
Greetings {{first_name}},
No entanto, se a Apollo não tiver o primeiro nome de um contato na sua sequência, a variável dinâmica falha e a Apollo move seu email para a pasta Não enviados.
Para evitar essa situação, use a variável dinâmica avançada {{#if first_name}}{{#endif}} para criar um fallback genérico:
Greetings {{#if first_name}}{{#endif}},
Se a Apollo tiver os dados de um destinatário de email, a variável dinâmica será exibida no email:
Greetings John,
Se a Apollo não tiver os dados, o email ainda será enviado com um espaço em branco no lugar da variável dinâmica:
Greetings ,
Fallback dinâmico
As variáveis dinâmicas avançadas com fallback dinâmico vão um passo além da variedade de fallback vazio. Essas variáveis dinâmicas inserem o texto que você definir caso não haja dados relevantes para um contato.
Imagine que você queira usar um texto genérico se o primeiro nome de um destinatário não estiver disponível. Para isso, use a seguinte variável dinâmica avançada para criar um fallback dinâmico:
Hi {{#if first_name}}{{first_name}}{{#else}}there{{#endif}},
Se a Apollo tiver os dados de um destinatário de email, o primeiro nome será exibido no email:
Hi John,
Se a Apollo não tiver os dados necessários, o email será exibido com there no lugar da variável:
Hi there,
É importante entender o que cada parte da variável dinâmica faz. A primeira parte, {{#if firstname}}{{firstname}}, é o início da lógica condicional. Ela informa ao Apollo "Se houver um valor para o primeiro nome, renderize esse primeirovalor do nome no Email aberto". Isso é semelhante à variável dinâmica básica {{firstname}}, com a inclusão de uma instrução {{#if}}.
A próxima parte, {{#else}}there, informa ao Apollo "Se não houver um valor de primeiro nome disponível para este contato, use o texto there no lugar".
A parte final, {{#endif}}, informa ao Apollo que este é o fim da lógica condicional para esta variável dinâmica.
Operadores de caixa de texto e pluralização
Variáveis dinâmicas avançadas com operadores de caixa de texto e pluralização usam o valor de um campo e alteram a capitalização ou a pluralização.
Esses tipos avançados de variáveis dinâmicas funcionam apenas em tipos de campo string. Eles não funcionam para outros tipos de campo.
Os exemplos a seguir mostram como operadores de caixa de texto e pluralização podem ser usados:
| Variáveis dinâmicas | Descrição | Exemplo |
|---|---|---|
{{title->lowercase}} |
Usa o valor do cargo de um contato e converte todas as letras para minúsculas. |
Engineering Manager se torna engineering manager
|
{{title->capitalize_each_word}} |
Usa o valor do cargo de um contato e converte a primeira letra de cada palavra para maiúscula. |
engineering manager se torna Engineering Manager
|
{{title->plural}} |
Usa o valor do cargo de um contato e o converte para a forma plural. |
Engineering Manager se torna Engineering Managers
|
Adicione um -> dentro da variável para combinar vários operadores de caixa de texto e pluralização. Por exemplo, para converter o cargo de um contato para maiúsculas e para a forma plural, combine os operadores dentro da mesma variável:
{{title->capitalize_each_word->plural}}
Esta variável dinâmica renderiza o cargo engineering manager como Engineering Managers.
Operadores de data/hora atual
Variáveis dinâmicas avançadas com operadores {{nowmonth}}, {{nowday}}, e {{now_time}} usam a data atual e a manipulam de várias formas.
Esses tipos avançados de variáveis dinâmicas funcionam apenas em tipos de campo date. Eles não funcionam para outros tipos de campo.
Os exemplos a seguir mostram como os operadores de data e hora atuais podem ser usados:
| Variáveis dinâmicas | Descrição | Exemplo |
|---|---|---|
{{now_day->plus_X}} |
Pega o dia atual e o avança pelo número especificado de dias úteis. Se o número de dias úteis exceder o número de dias do mês atual, o Apollo considera a transição e continua a contagem no primeiro dia do próximo mês. Você pode usar qualquer número inteiro (integer) aqui. |
Se hoje for o dia 15 do mês e uma quarta-feira, a variável dinâmica {{now_day->plus_5}} é exibida como 22 no Email aberto. |
{{now_day->minus_X}} |
Pega o dia atual e o retrocede pelo número especificado de dias úteis. Se o número de dias úteis exceder o número de dias do mês atual, o Apollo considera a transição e continua a contagem no último dia do mês anterior. Você pode usar qualquer número inteiro (integer) aqui. |
Se hoje for o dia 15 do mês e uma quarta-feira, a variável dinâmica {{now_day->minus_5}} é exibida como 8 no Email aberto. |
{{now_month->plus_X}} |
Pega o mês atual e o avança pelo número especificado de meses. Você pode usar qualquer número inteiro (integer) entre 1 e 11. |
Se o mês atual for abril, a variável dinâmica {{now_month->plus_1}} é exibida como May no Email aberto. |
{{now_month->minus_X}} |
Pega o mês atual e o retrocede pelo número especificado de meses. Você pode usar qualquer número inteiro (integer) entre 1 e 11. |
Se o mês atual for abril, a variável dinâmica {{now_month->minus_2}} é exibida como February no Email aberto. |
{{now_year->plus_X}} |
Pega o ano atual e o avança pelo número especificado de anos. Você pode usar qualquer número inteiro (integer) aqui. |
Se o ano atual for 2024, a variável dinâmica {{now_year->plus_2}} será exibida como 2026 no Email aberto. |
{{now_year->minus_X}} |
Pega o ano atual e o retrocede pelo número especificado de anos. Você pode usar qualquer número inteiro (integer) aqui. |
Se o ano atual for 2024, a variável dinâmica {{now_year->minus_1}} será exibida como 2023 no Email aberto. |
{{now_time_of_day}} |
Exibe o período atual do dia (morning, afternoon, evening). |
Se o horário atual for 9h00, a variável dinâmica Good {{now_time_of_day}}, é exibida como Good morning, no email aberto. |
Operadores de data personalizados
Campos personalizados e variáveis dinâmicas que utilizam operadores de data personalizados estão disponíveis apenas para clientes em determinados planos da Apollo. Se você não tiver acesso e quiser fazer upgrade do seu plano, entre em contato com a equipe de vendas da Apollo.
Variáveis dinâmicas avançadas com operadores de data personalizados usam campos personalizados configurados para datas e os manipulam de várias formas.
Esses tipos avançados de variáveis dinâmicas funcionam apenas em campos do tipo date-type. Eles não funcionam com outros tipos de campo.
Imagine que você crie um campo personalizado chamado product_announcement para a data do anúncio anual do seu produto, que acontece em 15 de outubro de 2024. Esse campo personalizado inclui mês, dia e ano, então você pode usar operadores de data personalizados em uma variável dinâmica para extrair partes específicas.
A variável dinâmica {{productannouncement->day}} é exibida como 15, a variável dinâmica {{productannouncement->month}} é exibida como October, e a variável dinâmica {{product_announcement->year}} é exibida como 2024 no email aberto.
Além disso, você pode usar a variável dinâmica {{product_announcement->weekday}} para extrair o dia da semana da sua data personalizada. Nesse caso, ela é exibida como Tuesday no email aberto, porque 15 de outubro de 2024 cai em uma terça-feira.
Exemplo de caso de uso para variáveis dinâmicas avançadas
Neste exemplo, o texto está formatado para destacar as variáveis dinâmicas do texto simples, e quebras de linha são inseridas entre cada instrução de lógica condicional para facilitar a leitura. No Apollo, você deve escrever as variáveis dinâmicas em uma única linha contínua.
Para mais contexto, veja um exemplo real de como usar variáveis dinâmicas avançadas no seu modelo de email. Em uma Task automática de email, criamos um modelo de email com um corpo de texto que usa vários tipos diferentes de variáveis dinâmicas avançadas.
Olá
{{#if first_name}}{{first_name}}{{#else}}there{{#endif}},Sabemos que muitas empresas como
{{#if industry == Marketing}}Company 1 {{#else}}{{#if industry == Big Data}}Company 2 {{#else}}Company 3{{#endif}}{{#endif}}estão buscando novas ferramentas para implementar em
{{now_year->plus_1}}, e gostaríamos de apresentar nossa plataforma para que você tenha uma boa compreensão de todos os nossos recursos. Será que{{now_weekday->plus_2}}ou{{now_weekday->plus_3}}{{now_time_of_day}}funciona para você?
Explicação do caso de uso: variáveis dinâmicas aninhadas apontando para valores de campos específicos
A {{#if firstname}}{{firstname}}{{#else}}there{{#endif}} variável dinâmica define um fallback para o primeiro nome ser exibido como there se não houver dados de primeiro nome disponíveis para o destinatário do Email.
A {{#if industry == Marketing}}Company 1 parte da variável dinâmica informa ao Apollo para exibir o texto como Company 1 se o campo Setor do destinatário do Email for Marketing.Marketing. Se o setor não for
A {{#else}}{{#if industry == Big Data}}Company 2 parte informa ao Apollo para exibir o texto como Company 2 se o campo Setor do destinatário do Email for Big Data. Se o campo Setor não for Marketing ou Big Data, o Apollo passa para a parte de fallback da lógica condicional.
A variável dinâmica {{#else}}Company 3 é o fallback se o campo Setor do destinatário do Email não corresponder a Marketing ou Big Data. Nesse caso, o texto é exibido como Company 3 no Email aberto.
A parte final da variável dinâmica, {{#endif}}{{#endif}}, fecha a lógica condicional. Duas instruções {{endif}} são necessárias porque há instruções {{#if}} aninhadas.
{{endif}} eu preciso?Como regra geral, para cada instrução {{#if}} na sua variável dinâmica, você precisa de uma instrução correspondente {{#endif}} para fechar a variável dinâmica.
Explicação do caso de uso: variáveis dinâmicas em tempo real
A variável dinâmica {{now_year->plus_1}} informa ao Apollo para usar o ano atual 2024 e somar 1 ano a ele. Quando o destinatário abrir este Email, essa variável será exibida como 2025.
A variável dinâmica {{now_weekday->plus_2}} informa ao Apollo para usar o dia atual da semana e avançá-lo em 2 dias. Se o Apollo enviar o Email em uma segunda-feira, o texto no Email será exibido como Wednesday. Se o Apollo enviar este Email em uma quinta-feira, o texto exibirá a variável dinâmica como Monday porque esse é o próximo dia útil disponível.
A variável dinâmica {{now_weekday->plus_3}} informa ao Apollo para usar o dia atual da semana e avançá-lo em 3 dias. Se o Apollo enviar o Email em uma terça-feira, o texto no Email será exibido como Friday. Se o Apollo enviar o Email em uma quarta-feira, o texto será exibido como Monday. O Apollo exibe a variável dinâmica como o próximo dia útil disponível se o dia da semana especificado pela variável dinâmica cair em um fim de semana.
Por fim, a {{now_time_of_day}} variável dinâmica informa ao Apollo para exibir o período atual do dia para o destinatário com base no horário local e no fuso horário local dele (quando disponível) e exibe morning, afternoon, ou evening.