Referência sobre propriedades de perfil
O que você vai aprender
Entenda a diferença entre propriedades personalizadas e propriedades da Klaviyo, como usá-las para rastrear informações sobre assinantes, como removê-las, práticas recomendadas e muito mais.
As propriedades de perfil ajudam você a entender seus assinantes em nível pessoal para segmentá-los com base nessas informações. Ao final deste artigo, você saberá como obter insights sobre seus clientes e usar as propriedades de forma mais estratégica e organizada.
Antes de começar
Primeiro, é importante que sua loja de e-commerce esteja integrada com a Klaviyo e os perfis na sua conta. Também é recomendável publicar formulários de registro para que você possa coletar propriedades personalizadas e da Klaviyo sobre seus assinantes.
Os formulários de registro são habilitados por um snippet de código chamado Klaviyo.js. Esse snippet é instalado automaticamente por meio da integração da Klaviyo com a maioria das plataformas de e-commerce. Saiba mais sobre o Klaviyo.js e sua plataforma de e-commerce.
Diferentes propriedades usadas em relatórios de métricas
É importante destacar que os relatórios de métricas registram as propriedades de perfil quando elas são inicialmente inseridas na Klaviyo. Já os segmentos reconhecem as propriedades presentes no perfil. Por exemplo, se estiver criando um relatório de métricas com um filtro para um local específico e a pessoa tiver mudado de endereço, essa atualização pode não ser capturada com precisão.
Propriedades personalizadas x propriedades da Klaviyo
Qualquer perfil da sua conta exibe propriedades. Uma amostra de perfis pode ser encontrada na aba Perfis da sua conta Klaviyo, que exibe os primeiros 50 contatos.
Para ver as propriedades de um perfil:
- Clique no perfil ou busque diretamente na barra de pesquisa, na parte superior da página.
- Visualize as propriedades à direita, na seção Informações.
Há dois tipos de propriedades de perfil: propriedades personalizadas e propriedades da Klaviyo.
Propriedades personalizadas
As propriedades personalizadas podem ser encontradas na aba "Informações" de um perfil. Como o nome diz, elas são totalmente personalizáveis e geradas pelo próprio usuário, e específicas para seu conteúdo, marca e caso de uso.
Algumas propriedades personalizadas que você pode reunir:
- Informações sobre gênero, tamanho, interesses e aniversários.
- Preferências de frequência de e-mails, tipo de conteúdo, entre outras.
- Respostas a questionários.
Se uma propriedade do perfil tiver o mesmo nome de uma propriedade da Klaviyo na sua conta, você não poderá usar essa propriedade personalizada para segmentação. Recomendamos, por esse motivo, que você evite usar o mesmo nome das propriedades da Klaviyo em propriedades de perfil personalizadas.
Propriedades da Klaviyo
As propriedades da Klaviyo são propriedades padrão e podem ser encontradas em várias partes de um perfil.
Quando exportadas em um arquivo, muitas delas são identificadas por um prefixo de cifrão ($). Não é necessário adicionar esse prefixo ao CSV ao fazer upload das mesmas propriedades na Klaviyo, pois você receberá uma mensagem solicitando para associar o upload à propriedade de sua escolha.
As propriedades da Klaviyo incluem:
- E-mail
- ID da Klaviyo
- Nome
- Sobrenome
- Empresa
- Cargo
- Telefone
- Endereço
- Endereço 2
- Cidade
- Estado/região
- País
- CEP
- Latitude
- Longitude
- Origem
- Consentimento
- Data/hora do consentimento para SMS
- Ativo pela primeira vez
- Ativo pela última vez
- Perfil criado em
- Data de inclusão
- Última abertura
- Último clique
- $consent_form_id
- $consent_form_version
- $consent_method
- $timezone
- $id
- $locale
- $locale_language
- $locale_country
O campo locale da Shopify é sincronizado automaticamente com $locale na Klaviyo.
As propriedades Ativo pela primeira vez e Ativo pela última vez são exibidas no fuso horário do seu navegador, mas são avaliadas no fuso horário UTC na segmentação.
As seguintes propriedades da Klaviyo não podem ser editadas em uma importação de CSV:
- ID da Klaviyo
- Ativo pela primeira vez
- Ativo pela última vez
- Perfil criado em
- Data de inclusão
- Última abertura
- Último clique
- $locale_language
- $locale_country
Quando você exporta um perfil, as propriedades "Última abertura", "Último clique", "Ativo pela primeira vez", "Ativo pela última vez" e "Data de inclusão" não aparecem no CSV.
Não é uma prática recomendada usar a propriedade $id para identificar perfis. Consulte a documentação da nossa API para saber como fazer isso para envios de modelos, mensagens pessoais e exportações segmentadas.
Desde abril de 2022, a propriedade de ID externo ($id) tem um limite de 64 caracteres. Todos os caracteres acima do limite ficarão truncados.
O que fazer e o que não fazer com as propriedades
Se uma propriedade de perfil tiver o mesmo nome dos dados do evento em sua conta, não será possível segmentar os dados do evento nem visualizá-los nos menus suspensos. Por isso, evite nomear propriedades de perfil e dados de eventos com o mesmo nome. Se remover, ou renomear uma propriedade personalizada com um nome diferente dos dados de evento, os dados de evento serão exibidos nos menus suspensos.
Adicione propriedades personalizadas a um perfil
Há três formas de adicionar propriedades personalizadas a perfis em sua conta:
- Manualmente (de uma lista ou individualmente).
- Solicitá-las aos clientes.
- Sincronizá-las por meio de sua integração.
Adicione-as manualmente
Faça o upload de propriedades personalizadas com um CSV
Ao carregar uma lista, qualquer coluna após a primeira (e-mail ou telefone) em um arquivo CSV pode ser usada para anexar uma propriedade personalizada a um perfil. Por exemplo, é possível ter uma coluna "Gênero" para o gênero de cada contato.
- O "E-mail" deve ser a primeira coluna. Se não houver e-mail cadastrado, use "Telefone".
- Nas duas colunas seguintes, use "Nome" e "Sobrenome".
- Adicione colunas de propriedades personalizadas (por exemplo, "Gênero").
- Adicione o valor da propriedade de cada pessoa.
Se estiver fazendo upload de listas de valores para cada propriedade personalizada, é preciso formatar o valor como uma matriz (por exemplo, [“value 1”, “value 2”, “value 3”]).
Se estiver fazendo upload de uma propriedade de data, formate-as como AAAA-MM-DD ou MM/DD/AAAA. Para definir uma hora, você pode usar o formato HH:MM:SS (por exemplo, 00:00:00 para a meia-noite).
- Acesse Público > Listas e segmentos na Klaviyo.
- Escolha uma lista existente ou clique em Criar lista/Segmento > Lista.
- Clique em Fazer upload e selecione seu arquivo CSV com assinantes de e-mail.
- Associe cada coluna do seu CSV a uma propriedade adequada na Klaviyo e clique em Próximo.
- Se a propriedade ainda não existir na Klaviyo, digite o nome de uma nova propriedade e clique em Criar novo campo.
- Clique em Próximo.
- No campo com a pergunta Estes assinantes concordaram em receber mensagens de marketing?, selecione Não. Isso não altera o status de inscrição de nenhum dos assinantes atuais.
- Clique em Importar.
O tamanho máximo permitido da propriedade personalizada é de 100 KB.
Para saber como formatar datas para que sejam carregadas com sucesso na Klaviyo, consulte o artigo sobre formatação de datas e data/hora em CSVs.
Se algum contato da sua lista ainda não tiver um perfil na Klaviyo, um novo perfil será criado para ele. Caso contrário, todas as novas propriedades serão adicionadas ao perfil já existente. É possível navegar em um desses perfis para ver como ele aparece na página designada. Qualquer coluna atual do perfil de um contato será substituída pelo upload. Uma coluna que ainda não existe não afetará as propriedades atuais, pois você pode ter quantas propriedades personalizadas quiser na aba "Informações" de um determinado perfil.
Individualmente
Também é possível adicionar manualmente propriedades personalizadas individuais a um perfil, em vez da lista de perfis.
- Navegue até o perfil ao qual deseja adicionar uma propriedade.
- Selecione o botão Adicionar propriedade personalizada ao lado de Propriedades personalizadas.
- Adicione uma Propriedade e um Valor no modal.
- Propriedade personalizada: Cor favorita
- Valor: Azul
- Selecione Adicionar propriedade para adicioná-la ao perfil.
Solicitar propriedades aos clientes
A segunda forma de coletar propriedades personalizadas é solicitar essas informações diretamente aos clientes. Há três maneiras de coletar informações dos clientes:
- Usar um formulário de registro
- Criar uma página de inscrição ou de gerenciamento de preferências.
- Solicitar informações em e-mails.
Formulário de inscrição
- Arraste e solte um bloco no formulário.
- Selecione o bloco.
- Configure os detalhes do bloco, como texto e estilo, na barra lateral esquerda.
- Selecione uma propriedade do perfil existente ou crie uma nova
- Adicione um rótulo e um valor para a propriedade personalizada em Opções de propriedade.
- Salve o bloco.
No exemplo acima, um menu suspenso permite que o cliente selecione sua flor favorita. Se selecionar "Dália", essa informação será associada ao perfil dele na sua conta. Se essa pessoa já tiver um valor nessa propriedade de perfil, o valor atual será substituído pelo novo após o envio do formulário.
Formulário com campos ocultos
Também é possível obter propriedades de perfil por meio de campos ocultos em um formulário da Klaviyo. Os campos ocultos coletam informações discretamente, pois são anexados ao botão de envio do formulário. Em geral, eles coletam propriedades associadas ao conteúdo do formulário ou ao local do seu site. Por padrão, todos os novos cadastros possuem uma propriedade Origem como um campo oculto. Ela identifica de onde veio o perfil no "Relatório de crescimento de listas".
Se você adicionar campos ocultos que correspondam a propriedades existentes no perfil de alguém, eles serão substituídos pelo novo valor quando a pessoa enviar o formulário.
- Vá ao editor de botões.
- Selecione +Adicionar uma propriedade em ENVIAR CAMPOS OCULTOS.
- Escolha uma propriedade de perfil existente ou crie uma nova.
- Insira o valor da propriedade.
- Salve o botão.
Se você tiver vários formulários no seu site, pode ser interessante adicionar campos ocultos para indicar a página em que o perfil estava navegando ao enviá-los. Por exemplo, se você tem uma livraria com páginas dedicadas a diferentes gêneros, pode adicionar um campo oculto ao formulário para coletar informações de URL. Esse campo oculto irá rastreia o gênero literário em que a pessoa está interessada.
Sincronização por meio de integrações
A terceira forma de coletar propriedades personalizadas é sincronizá-las a partir de suas integrações. Isso é feito automaticamente, e os tipos de propriedades dependem das suas integrações. Por exemplo, uma integração com a Shopify sincroniza automaticamente a propriedade personalizada Aceita comunicações de marketing com a Klaviyo.
Para saber mais sobre as propriedades personalizadas sincronizadas por meio de integrações, consulte a documentação de integração em nossa Klaviyo Help Center.
Gerenciamento de propriedades
Nomeie as propriedades
Para garantir uma formatação consistente em todos os perfis, pense no nome da propriedade personalizada antes de criá-la. Alterações nos nomes das propriedades e em seus valores, inclusive ajustes simples na ortografia ou mudanças de letras minúsculas ou maiúsculas, geram uma propriedade totalmente nova na Klaviyo. As propriedades e seus valores devem ser exatamente os mesmos em toda a conta.
Por exemplo, alterar "gênero" com "g" minúsculo para "Gênero" com "G" maiúsculo origina duas propriedades distintas, apesar de o nome ser o mesmo. Mantenha a ortografia e a formatação consistentes em todas as propriedades e em seus valores conforme os adiciona aos perfis. "Gênero: Masculino" e "gênero: masculino" teriam duas propriedades diferentes e dois valores diferentes se ambos fossem inseridos em sua conta.
Considere antecipadamente as convenções de nomenclatura para evitar problemas de organização e a necessidade de revisar e excluir entradas. Lembre-se: consistência é fundamental.
É possível ajustar nomes de propriedades personalizadas para uma pequena quantidade de perfis. No entanto, eles não podem ser ajustados em massa sem a remoção da propriedade original. Se quiser renomear uma propriedade em massa, primeiro crie um segmento de perfis com essa propriedade e exporte esses clientes com sua propriedade e valor. Em seguida, entre em contato com nossa equipe de suporte e solicite a remoção da propriedade original da sua conta e dos perfis. Por fim, faça um novo upload da propriedade e do valor do perfil com o nome desejado em uma lista.
Manutenção de propriedades
Em geral, o objetivo do gerenciamento de propriedades é manter a organização, eliminar propriedades desnecessárias e seguir nossas regras de nomenclatura e edição. Ao nomear e editar propriedades, certifique-se de que o nome e o valor correspondam aos usados em sua conta, pois ela diferencia maiúsculas de minúsculas.
Caso decida editar uma propriedade depois de ela ter sido aplicada aos perfis, uma propriedade totalmente nova será gerada. Depois, é preciso voltar e excluir a anterior. Se não considerar esses fatores, você terá várias propriedades para as mesmas informações, criando desorganização em sua conta.
Exclusão de propriedades
É uma prática recomendada limpar as propriedades que não são mais úteis. No entanto, não é possível excluir as propriedades da Klaviyo, pois elas estão incorporadas à plataforma. Se quiser excluir uma propriedade personalizada que você criou, pode fazer isso no próprio perfil.
Se você tiver muitas propriedades que abrangem vários perfis, pode ser necessário excluí-las em massa. A exclusão em massa só pode ser realizada pela equipe da Klaviyo e só deve ocorrer quando absolutamente necessário. Para isso, entre em contato com nossa equipe de suporte. Nessa situação, solicitaremos que você registre um tíquete de suporte. Nele, você deve apresentar uma lista de propriedades que deseja excluir.
Para excluir uma propriedade de um único perfil:
- Vá até esse perfil.
- Acesse a seção Propriedades personalizadas do perfil.
- Encontre a propriedade personalizada.
- Expanda o menu da propriedade e selecione Excluir.
- Selecione Sim para confirmar que deseja excluir a propriedade.
Observe que a exclusão de uma propriedade de perfil não a excluirá automaticamente de outros perfis. Isso só deve ser feito para remover propriedades de um único perfil ou de uma pequena quantidade de perfis.
Como usar as propriedades de perfil
Você aprendeu o que são propriedades e como carregá-las e gerenciá-las. Agora, a pergunta é: como você usa as propriedades de perfil? Nesta seção, veremos exemplos de como usar a Klaviyo e as propriedades personalizadas na sua conta.
Vamos explicar
- como inserir propriedades dinâmicas nos e-mails da Klaviyo,
- como usar propriedades para segmentação avançada
- e práticas recomendadas de filtragem de fluxos com base em propriedades.
Não é possível segmentar ou filtrar um fluxo com uma propriedade até que ela exista em pelo menos um perfil na Klaviyo. Por isso, pode ser útil ter um perfil de teste com propriedades antes de criar segmentos e fluxos designados.
Insira propriedades dinâmicas nos e-mails da Klaviyo
Para inserir propriedades em e-mails, use a sintaxe variável. Com a sintaxe variável, você pode personalizar o conteúdo para cada usuário, inserindo a variável da pessoa e aplicando o filtro de pesquisa com a propriedade associada. Assim, os e-mails serão preenchidos dinamicamente com o conteúdo específico do cliente.
Veja um exemplo em que "Cor favorita" é a entrada desejada.
Normalmente, é recomendável incluir o filtro padrão para fornecer um valor quando alguém não tem a propriedade personalizada que você está tentando usar. Não recomendamos inserir uma propriedade de data personalizada nas páginas de preferências padrão na Klaviyo, pois é preciso garantir que as pessoas insiram a data em um formato padrão.
Use propriedades para criar segmentos-chave
Um fator crucial para o sucesso das campanhas de e-mail é segmentar seu público. A segmentação permite alcançar destinatários de e-mail com conteúdo específico que os atraia. Além disso, é possível usar segmentos para enviar conteúdo aos clientes por meio de anúncios em mídias sociais, formulários segmentados e SMS.
O exemplo abaixo mostra um segmento de mulheres torcedoras do Patriots. A propriedade personalizada é "marca", e essas pessoas escolheram o Patriots como a marca de sua preferência.
Verifique se todas as instâncias do valor e do nome dessa propriedade foram incluídas, caso não haja consistência entre os perfis. Além disso, as clientes podem adicionar suas preferências esportivas de outras formas, por exemplo: Pats, Patriots, patriots e pats. Isso também ocorre com o país. Alguém dos Estados Unidos pode listar seu país de origem como EUA, eua, Estados Unidos da América etc. Todos os valores que você adicionar precisam ser considerados e divididos por condições "OR".
Em seguida, alcance esse segmento com um formulário que informe sobre novas ofertas de roupas femininas do Patriots. Em vez de apresentar uma área para se inscrever nas comunicações de marketing, disponibilize um link para essa página do seu site. Defina o formulário para alcançar apenas indivíduos do segmento escolhido.
Também é possível definir seu segmento para incluir qualquer pessoa cuja propriedade contenha um determinado valor. Isso significa que sua condição de segmento indicaria: Propriedades sobre uma pessoa > contém ________.
Só é possível aplicar contém a tipos de dados de lista. Os tipos de dados de lista também devem ter o valor completo dentro de sua condição. Eles são formatados como uma matriz na sua conta. Por exemplo, se você tem uma padaria e reúne propriedades personalizadas para os produtos de padaria favoritos de seus clientes, pode dar a eles a opção de selecionar várias propriedades associadas a um perfil (por exemplo, bolo de chocolate, bolo de baunilha, biscoitos de chocolate e biscoitos doces). Eles aparecerão como tipos de dados de lista na sua conta.
No entanto, não é possível segmentar "chocolate" ao criar a condição de segmento informando que a propriedade "contém chocolate". Em vez disso, inclua o nome completo da propriedade, escrito por extenso (como "bolo de chocolate" e "biscoitos de chocolate"), como mostrado abaixo:
Para saber mais e ideias de segmentos que você pode personalizar para aumentar as vendas, consulte nossa Referência sobre segmentação avançada.
Use propriedades para filtrar fluxos
É possível usar as propriedades para filtrar fluxos e alcançar os clientes com informações específicas relevantes para eles, por exemplo, um "fluxo de feliz aniversário". Você pode coletar as datas de aniversário dos clientes quando eles se cadastram na sua newsletter. Em seguida, use essa propriedade ao criar seu fluxo, fazendo com que o disparador seja uma Propriedade de data e enviando aos aniversariantes um cupom ou uma mensagem por e-mail ou SMS. Programe esse fluxo para ocorrer anualmente e ajuste-o de acordo com o fuso horário e as necessidades de conteúdo dos clientes.
Escolha nomes diferentes para suas propriedades de perfil e de evento. Se uma propriedade de evento tiver o mesmo nome de uma propriedade de perfil, somente a propriedade de perfil aparecerá no filtro.
Você aprendeu a criar, gerenciar e usar propriedades personalizadas. Você também viu a diferença entre as propriedades da Klaviyo e as personalizadas, ou seja, criadas por você. Confira uma lista completa do que fazer e não fazer com as propriedades personalizadas no final deste guia. Em seguida, veja como usar as propriedades para criar conteúdo segmentado e exclusivo de sua empresa. É mais uma forma de ter controle absoluto do seu marketing.
Recursos adicionais
- Compreender a seção de informações de um perfil
Saiba mais sobre a seção de informações de um perfil no Klaviyo, que contém detalhes como quando e como o perfil encontrou o usuário e a última vez em que esteve ativo.
- Informações sobre a segmentação avançada
Saiba como usar estratégias de segmentação avançada eficazes para obter insights sobre clientes e criar experiências altamente personalizadas para os assinantes.
- Como funcionam os tipos de dados
Saiba mais sobre as diferentes opções disponíveis para armazenar seus dados na Klaviyo e como usar cada uma delas. A Klaviyo permite que você aproveite os dados coletados de seus clientes para orientar decisões de marketing e impulsionar o crescimento da sua marca. Para isso, é importante entender os dados que são inseridos na sua conta.