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.

This content requires Functional cookies to be enabled.

Update Cookie Settings

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

Comece com perfis na sua conta Klaviyo. Integre sua loja e-commerce se você quiser sincronizar as informações dos clientes dela. 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 Klaviyo.js e sua plataforma de e-commerce.

Diferenças das 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. Isso significa que, se você estiver criando um relatório de métricas com um filtro, por exemplo, de local e essa pessoa tiver se mudado desde entã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. Acesse Público > Perfis. A página mostra 50 perfis por página por padrão, com os perfis mais recentes primeiro.

Para ver as propriedades de um perfil:

1. Clique no perfil ou busque diretamente na barra de pesquisa, na parte superior da página.
2. Abra a guia Detalhes para ver as seções Propriedades personalizadas e Informações.

Há dois tipos de propriedades de perfil: propriedades personalizadas e propriedades da Klaviyo.

Propriedades personalizadas

As propriedades personalizadas ficam na seção Propriedades personalizadas da aba Detalhes de um perfil. As propriedades personalizadas são propriedades totalmente personalizáveis que você mesmo cria e que são específicas para seu conteúdo, sua marca e seu 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.

Propriedades da Klaviyo

As propriedades da Klaviyo são propriedades padrão e podem ser encontradas em várias partes de um perfil.

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
• Fonte
• 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

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.

Usar a propriedade $id para identificar perfis geralmente não é a melhor prática. No entanto, se você optar por fazer isso, consulte nossa documentação da API para saber como usá-la para envios de modelos, mensagens pessoais e exportações segmentadas.

O que fazer e o que não fazer com as propriedades

Adicione propriedades personalizadas a um perfil

This content requires Functional cookies to be enabled.

Update Cookie Settings

Há três formas de adicionar propriedades personalizadas a perfis em sua conta:

1. Manualmente (de uma lista ou individualmente).
2. Solicitá-las aos clientes.
3. Sincronizá-las por meio de sua integração.

Adicione-as manualmente

Faça o upload de propriedades personalizadas com um CSV

Ao fazer upload de um CSV, mapeie cada coluna para as informações de perfil que ela contém. A ordem das colunas não determina o mapeamento. Por exemplo, é possível ter uma coluna "Gênero" para o gênero de cada contato.

1. Inclua uma coluna de "E-mail". Se você não tiver o e-mail, use "Telefone".
2. Inclua as colunas "Nome" e "Sobrenome" se você quiser adicionar ou atualizar esses valores.
3. Adicione colunas de propriedades personalizadas (por exemplo, "Gênero").
4. Adicione o valor da propriedade de cada pessoa.

Antes de importar, verifique se a lista de destino aciona um fluxo. Adicionar novos membros à lista pode acionar esse fluxo. Se você estiver apenas atualizando propriedades, use uma lista sem um fluxo conectado ou defina as mensagens do fluxo afetadas como Manual antes de importar.

1. Acesse Público > Listas e segmentos na Klaviyo.
2. Abra uma lista existente. Para criar uma, selecione Criar > Lista, digite um nome e clique em Criar lista.
3. Na lista, selecione Gerenciar lista > Importar contatos.
4. Clique em Fazer upload, selecione seu arquivo CSV e, em seguida, clique em Próximo.
5. Associe cada coluna do seu CSV à propriedade adequada na Klaviyo e confira o tipo de dados dela. Desmarque todas as colunas que você não quer importar. Para uma atualização somente de propriedades, deixe as colunas de status de consentimento e de carimbo de data/hora do consentimento sem mapeamento.
6. Se uma propriedade ainda não existir, abra Selecionar ou criar novo e escolha Criar novo campo. Insira um nome de propriedade do perfil, use Escolher tipo de dados para selecionar o tipo e clique em Criar.
7. Clique em Avançar.
8. Para atualizar propriedades sem alterar o consentimento, confirme se você deixou as colunas de status de consentimento e carimbo de data/hora do consentimento sem mapeamento e, em seguida, escolha Importar apenas o consentimento no meu arquivo. Essa opção ainda importa informações de consentimento se elas estiverem incluídas nas colunas mapeadas.
9. Clique em Importar.

Se algum contato da sua lista ainda não tiver um perfil na Klaviyo, um novo perfil será criado para ele. Caso contrário, novas propriedades serão adicionadas ao perfil existente. Os valores importados substituem os valores existentes para a mesma propriedade. As células em branco são ignoradas, e as propriedades omitidas na importação permanecem inalteradas. Depois que a importação for concluída, abra um perfil para verificar os valores atualizados.

Individualmente

Também é possível adicionar manualmente propriedades personalizadas individuais a um perfil, em vez da lista de perfis.

1. Navegue até o perfil ao qual deseja adicionar uma propriedade e abra a aba Detalhes.
2. Selecione Adicionar propriedade personalizada ao lado de Propriedades personalizadas.

3. Insira um nome da propriedade e um valor no formulário.
   • Propriedade personalizada: Cor favorita
   • Valor: Azul
4. Selecione Adicionar Propriedades do perfil 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:

1. Usar um formulário de registro
2. Criar uma página de inscrição ou de gerenciamento de preferências.
3. Solicitar informações em e-mails.

Formulário de inscrição

1. Abra o formulário de registro que você quer editar no editor de formulários.
2. Arraste e solte um campo de dados no formulário.
3. Selecione o bloco.
4. Configure os detalhes do bloco, como texto e estilo, na barra lateral esquerda.
5. Selecione uma propriedade do perfil existente ou crie uma nova
6. Para um campo de menu suspenso, botão de opção ou de várias caixas de seleção, adicione os rótulos que os clientes veem e os valores que você quer armazenar em Opções da propriedade.
7. Quando você estiver pronto para publicar as alterações, clique em Publicar ou agendar e, em seguida, em Publicar agora.

No exemplo acima, um menu suspenso permite que o cliente selecione sua flor favorita. Se eles selecionarem “Dahlia”, isso será mapeado para o perfil deles 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".

1. Selecione o botão de envio do formulário para abrir o editor dele.
2. Selecione Adicionar uma propriedade em Enviar campos ocultos.
3. Escolha uma propriedade de perfil existente ou crie uma nova.
4. Insira o valor da propriedade.
5. Quando você estiver pronto para publicar as alterações, clique em Publicar ou agendar e, em seguida, em Publicar agora.

Se você tiver formulários diferentes em páginas diferentes, pode usar um campo oculto para registrar a página associada a cada formulário. Insira o URL dessa página como o valor do campo oculto e direcione o formulário para essa página. Por exemplo, uma livraria pode usar um formulário em uma página de um gênero específico para registrar interesse nesse gênero. O campo oculto envia o valor que você configura; ele não captura automaticamente o URL atual do visitante.

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

This content requires Functional cookies to be enabled.

Update Cookie Settings

Nomeie as propriedades

Para manter a formatação consistente em todos os perfis, escolha um nome de propriedade personalizada antes de criá-la. Os nomes das propriedades diferenciam maiúsculas e minúsculas: mudar a grafia ou a capitalização cria um nome de propriedade diferente. Editar um valor em um nome de propriedade existente atualiza essa propriedade; isso não cria uma nova.

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.

Para renomear uma propriedade personalizada em alguns perfis, adicione uma propriedade com o nome desejado e copie o valor existente. Verifique o novo valor e, em seguida, exclua a propriedade antiga. Para renomear em massa:

1. Crie um segmento de perfis com a propriedade e, em seguida, exporte esses perfis com os identificadores e os valores da propriedade.
2. Renomeie a coluna de propriedade no CSV e importe-o seguindo as etapas acima. Verifique os novos valores da propriedade antes de remover a propriedade antiga.
3. Remova a propriedade antiga desses perfis usando o método de remoção por CSV em Excluir propriedades abaixo. Se você precisar eliminar a propriedade antiga da sua conta, entre em contato com nossa equipe de suporte.

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 em toda a sua conta, pois diferencia maiúsculas de minúsculas.

Para alterar o valor de uma propriedade personalizada em um perfil:

1. Abra a guia Detalhes do perfil e encontre a propriedade em Propriedades personalizadas.
2. Expanda o menu da propriedade e selecione Editar valor.
3. Altere o Valor atual e, em seguida, clique em Atualizar.

Exclusão de propriedades

É uma prática recomendada limpar as propriedades que não são mais úteis. Os campos de propriedade integrados do Klaviyo continuam fazendo parte da plataforma, mesmo quando um perfil não tem valor para um campo. Você pode remover uma propriedade personalizada de um perfil individual ou de vários perfis com uma importação de CSV.

Para remover propriedades personalizadas de vários perfis, importe um CSV com o identificador de cada perfil e uma coluna $unset. Em cada linha, liste os nomes exatos das propriedades a serem removidas como um array, como ["Favorite Color", "Old Preference"]. Mapeie $unset com o tipo de dados List. Siga Como desmarcar Propriedades do perfil para ver o procedimento completo. Para remover uma propriedade da sua conta, entre em contato com nossa equipe de suporte e inclua os nomes das propriedades no seu ticket.

Para excluir uma propriedade de um único perfil:

1. Vá até esse perfil.
2. Abra a aba Detalhes e encontre a seção Propriedades personalizadas.
3. Encontre a propriedade personalizada.
4. Expanda o menu da propriedade e selecione Excluir.

5. Selecione Excluir quando solicitado 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

This content requires Functional cookies to be enabled.

Update Cookie Settings

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

1. como inserir propriedades dinâmicas nos e-mails da Klaviyo,
2. como usar propriedades para segmentação avançada
3. Práticas recomendadas para filtrar fluxos com base em propriedades.

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.

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 ________.

Você pode aplicar contém aos tipos de dados Texto e Lista. Para Texto, ele corresponde a parte de um valor. Para Lista, ele corresponde a um item completo na lista. Tipos de dados de lista são formatados como uma matriz na sua conta. Por exemplo, se você tem uma padaria e coleta os produtos de padaria favoritos dos clientes, pode deixar que eles selecionem vários valores para uma propriedade, como bolo de chocolate, bolo de baunilha, cookie de gotas de chocolate e cookie de açúcar.

Para esta propriedade de Lista, contém chocolate não corresponderá a "bolo de chocolate" nem a "cookies com gotas de chocolate". Use os valores completos de item da lista em condições OU separadas, 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 acionar e filtrar fluxos

Você pode usar Propriedades do perfil em Filtros de perfil para segmentar clientes com informações específicas relevantes para eles. Você também pode usar uma propriedade de data para acionar um fluxo. Por exemplo, colete datas de aniversário quando os clientes se inscreverem na sua newsletter e, em seguida, use essa propriedade para acionar um fluxo de aniversário que envia um cupom ou uma mensagem atenciosa por e-mail ou SMS. Configure o fluxo para se repetir anualmente e escolha o horário que corresponda aos horários locais dos seus clientes e às suas necessidades de conteúdo. Saiba como criar um fluxo acionado por uma propriedade de data.

Use condições de Propriedades do perfil para informações armazenadas no perfil da pessoa. Para um fluxo acionado por um evento, use filtros de acionamento para detalhes desse evento que acionou o fluxo.

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 nossa lista completa do que fazer e não fazer com as propriedades personalizadas no início deste guia como outro recurso para adicionar ao seu kit de ferramentas do Klaviyo. 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