Capture datas com um seletor de data na landing page
Colete uma data de calendário em uma landing page da Braze com um seletor de data nativo do navegador, grave-a no perfil de usuário como um atributo personalizado de tempo e mantenha usuários conhecidos em um único perfil com a Liquid tag de landing page.
Sobre este exemplo
A ClaimsJumpr, uma marca fictícia de seguros, pede aos consumidores que informem a data de renovação da apólice em uma landing page da Braze. Campos de data em texto livre geram formatos inconsistentes, difíceis de segmentar. Por isso, a ClaimsJumpr usa um bloco de formulário personalizado com um input de data em HTML, para que o navegador garanta um valor de calendário consistente. Depois, ela grava esse valor como um atributo personalizado de tempo para redirecionamento.
Este cenário combina:
- Um bloco Código personalizado no formulário da landing page
registerFormInput, para que o campo de data seja validado e enviado com o formulário- A ponte JavaScript da landing page, para definir um atributo personalizado de tempo
- A Liquid tag de landing page, para que usuários conhecidos permaneçam em um único perfil
Use este exemplo quando precisar de uma data de calendário no perfil para segmentação baseada em tempo ou para o timing de um Canvas. Prefira um bloco padrão de Texto curto quando uma string de texto livre for suficiente.
Considerações
- Blocos de formulário Texto curto se vinculam apenas a atributos personalizados do tipo string. Para armazenar uma data como atributo de tempo com filtros de data (
before,afterein less than), crie um bloco de formulário personalizado e chamesetCustomUserAttributecom umDatedo JavaScript. - Crie o atributo personalizado com o tipo de dado tempo antes de testar um envio. Passar um
Datepela ponte corresponde a esse tipo de dado. Consulte Tipos de dados de atributos personalizados. - O
<input type="date">do HTML depende do navegador do visitante. O suporte e a interface variam conforme o navegador e o dispositivo (por exemplo, alguns navegadores móveis exibem um seletor nativo; outros podem recorrer a um campo parecido com texto). Teste nos navegadores que seu público usa. - Gravar atributos personalizados consome pontos de dados.
- Insira a Liquid tag
{% landing_page_url %}na mensagem que direciona o tráfego para a página. Sem ela, o envio do formulário pode criar um novo perfil anônimo em vez de atualizar o usuário conhecido. - Landing pages com formulários precisam de uma experiência de confirmação (landing page de confirmação, etapa de confirmação em formulário de várias etapas ou URL pós-envio). Planeje isso antes de publicar.
- Se a página usar um formulário de várias etapas, coloque o bloco Código personalizado que chama
registerFormInputdentro do bloco Layout do formulário, para que o input participe do envio do formulário. - Teste a gravação de atributos e a vinculação de perfis em um espaço de trabalho de desenvolvimento antes de publicar em produção.
Configuração
Etapa 1: Crie um atributo personalizado de tempo
- Acesse Configurações de dados > Atributos personalizados.
- Crie um atributo personalizado, como
policy_renewal_date, com o tipo de dado Tempo. - Use um nome claro e estável. Passe a mesma chave para
setCustomUserAttributeno bloco de formulário personalizado.
Etapa 2: Crie o formulário da landing page
- Acesse Envio de mensagens > Landing pages e crie uma nova landing page.
- Abra o editor de arrastar e soltar e preencha os detalhes do site (URL da página, título e configurações relacionadas). Consulte Criar landing pages.
- Adicione os campos de formulário padrão de que você precisa (por exemplo, um campo Texto curto para o número da placa do veículo, vinculado a um atributo personalizado do tipo string).
- Adicione um bloco Código personalizado para o seletor da data de renovação. Cole o HTML, o script e os estilos da Etapa 3 nesse único bloco.
- Adicione um botão de envio que envie o formulário e configure sua experiência de confirmação.
- Depois de concluir a composição e a confirmação, publique a landing page.
Etapa 3: Registre o seletor de data como input de formulário personalizado
Cole o código a seguir em um único bloco Código personalizado (HTML). O script registra o input de data com registerFormInput, valida se uma data foi selecionada e grava um Date do JavaScript em policy_renewal_date no envio.
<div class="renewal-date-field">
<label for="policy-renewal-date">Policy renewal date</label>
<input id="policy-renewal-date" type="date" autocomplete="off" />
</div>
<script>
document.addEventListener("DOMContentLoaded", () => {
function parseDateInputValue(value) {
const parts = value.split("-").map(Number);
if (parts.length !== 3 || parts.some((n) => Number.isNaN(n))) {
return null;
}
const [year, month, day] = parts;
// Build a local calendar date so YYYY-MM-DD is not shifted by UTC parsing.
return new Date(year, month - 1, day);
}
window.brazeHelpers.forms.registerFormInput({
selector: "#policy-renewal-date",
isRequired: true,
getValue: (element) => element.value || null,
onValidate: (value) => Boolean(parseDateInputValue(value)),
onSubmit: (value) => {
const date = parseDateInputValue(value);
if (!date) {
return;
}
window.brazeBridge.getUser().setCustomUserAttribute("policy_renewal_date", date);
},
});
});
</script>
<style>
.renewal-date-field {
display: flex;
flex-direction: column;
gap: 8px;
max-width: 280px;
margin: 0 auto;
text-align: left;
}
.renewal-date-field label {
font-weight: 600;
}
/* Braze adds this class to the registered element when validation fails. */
#policy-renewal-date.bz-validation-error {
outline: 3px solid #f94144;
outline-offset: 2px;
border-radius: 4px;
}
</style>
O input de data do navegador retorna uma string YYYY-MM-DD. getValue lê essa string, e onValidate confirma que ela pode ser interpretada. onSubmit a converte em um Date local antes de chamar setCustomUserAttribute. A Braze armazena esse Date como um timestamp UTC sem milissegundos. Para visitantes em fusos horários adiantados em relação ao UTC, a meia-noite local pode cair no dia anterior do calendário. O envio do formulário descarrega os dados da ponte para a Braze depois que onSubmit é concluído. Não inclua requestImmediateDataFlush em onSubmit.
Substitua policy_renewal_date pelo nome do seu atributo de tempo da Etapa 1. Adapte o rótulo e os estilos à sua marca.
Etapa 4: Vincule usuários conhecidos a partir de uma mensagem da Braze
No e-mail, SMS ou outra mensagem que leva os consumidores à landing page, insira a Liquid tag de landing page para que a Braze possa atualizar o perfil existente no envio.
<a href="{% landing_page_url claimsjumpr-renewal-date %}" class="button">Share your renewal date</a>
Substitua claimsjumpr-renewal-date pelo identificador da URL da sua landing page. No editor de mensagens, selecione Personalização e defina Tipo de personalização como Landing page.
Etapa 5: Teste a gravação do atributo
- Envie a mensagem com a Liquid tag de landing page para um usuário teste ou abra o link com a tag a partir de uma mensagem da Braze.
- Selecione uma data de renovação, envie o formulário e verifique se a experiência de confirmação aparece.
- Abra o perfil do usuário teste e verifique se
policy_renewal_dateestá definido como um valor de tempo. - Opcional: crie um segmento com um filtro de tempo, como
in less thanouin more than, empolicy_renewal_datepara confirmar que o atributo pode ser usado para redirecionamento.