Como usar objetos personalizados em modelos
Você precisa ter acesso a objetos personalizados para usar essa funcionalidade.
O que você vai aprender
Saiba como usar objetos personalizados em modelos para poder usar dados de objetos em envios de fluxo e de campanha.
Você precisa criar um objeto antes de poder usar dados de objetos personalizados nos modelos. Para o menu de personalização, os filtros de objetos e as listas de registros de destinatários, use um objeto com uma relação com o perfil. Os registros dele precisam estar vinculados ao destinatário para aparecerem na mensagem dele.
Acessar dados de objeto pelo menu de personalização
Você pode personalizar blocos de texto no editor de modelos de arrastar e soltar usando propriedades de um objeto personalizado ou a contagem de registros de um objeto.
Saiba como usar o editor de modelos do Klaviyo.
Se você estiver começando com um modelo HTML, pode criar primeiro uma cópia de arrastar e soltar:
- Acesse Conteúdo > Modelos e abra E-mail: salvo. Abra o menu de três pontos do seu modelo de HTML e selecione Clonar para arrastar e soltar.
- Abra Modelos convertidos para acompanhar o progresso. Quando o status estiver Pronto para usar, clique no nome do modelo convertido para abri-lo.
- Revise o layout do texto e o conteúdo personalizado antes de usá-lo. O modelo HTML original permanece inalterado.
Para começar a adicionar dados de objetos aos seus modelos:
- Adicione um novo bloco de texto ou selecione um bloco de texto existente.
- Clique duas vezes no bloco de texto e, em seguida, posicione o cursor no local em que você quer inserir sua propriedade dinâmica.
- Selecione o botão Personalização na barra de ferramentas de texto.

- No modal de personalização, selecione Objetos no menu suspenso Todos os tipos .

- Em Objetos, você verá todos os objetos na sua conta que pode usar para puxar dados para o modelo. Selecione o objeto que contém os dados que você gostaria de usar no modelo.
- Selecione uma propriedade para exibir ou Número de objetos para exibir uma contagem. Em seguida, selecione um filtro de objeto. Você também pode criar um novo filtro de objeto aqui.
- Clique em Inserir depois de selecionar um filtro existente. Se você criar um novo filtro, a tag dele será inserida quando você terminar de criá-lo.
- Aplique os estilos de texto de que você precisar. Para um valor de propriedade, adicione um texto padrão editando a tag para incluir
|default:'value'. Substituavaluepelo texto que você quer exibir quando a propriedade estiver vazia.
Para definir as regras de capitalização para dados de objeto, você precisará configurar manualmente a regra na tag de personalização. Por exemplo, estas tag usam o objeto que acionou um fluxo acionado por data:
- {{ object.full_name|title|default:'value' }}
John Doe - {{ object.full_name|upper|default:'value' }}
JOHN DOE - {{ object.full_name|lower|default:'value' }}
john doe
Saiba mais sobre como modificar valores com filtros do Django.
Como acessar dados de objetos com tags de personalização
Você pode usar tags de personalização em e-mails (incluindo a linha de assunto do e-mail), mensagens SMS/MMS, notificações push e no Klaviyo Customer Hub para exibir dados do objeto.
Saiba como usar tags de personalização na Klaviyo.
Referência de tags de personalização de objeto
Você pode usar as seguintes tags de personalização com objetos.
Usando o objeto que acionou um fluxo
{{ object }} só está disponível quando um objeto tiver disparado um fluxo. A tag de modelo {{ object }} só está disponível em fluxos disparados por data com base em um objeto. Isso é semelhante à tag de modelo {{ event }} para fluxos disparados por evento.
Estes exemplos usam o seguinte:
- Objeto chamado Pet que é referenciado com a tag object no modelo.
- Propriedade do objeto chamada Nome
Estrutura | Exemplo |
{{ object.object_property }} | {{ object.Name }} |
{{ object | lookup:'object_property' }} | {{ object | lookup:'Name' }} |
Recuperar um objeto por ID
Estes exemplos usam o seguinte:
- Objeto chamado Pet
- Propriedade do objeto chamada Nome
- Evento que disparou o fluxo com uma propriedade de objeto chamada pet_id. Este campo é o mesmo que o ID do objeto para o objeto Pet.
Estrutura | Exemplo |
{% customobject event.object_id object_type_title="Title" as alias %} | {% customobject event.pet_id object_type_title="Pet" as pet %} |
{% customobject event.object_id object_type_title="Title" as alias %} | {% customobject event.pet_id object_type_title="Pet" as pet %} |
Apresenta um único objeto de um filtro de objetos
Estes exemplos usam o seguinte:
- Um filtro de objetos adicional chamado oldestDog
- Propriedade do objeto chamada Nome
Estrutura | Exemplo |
{{ object_filter.object_filter_name.object_property}} | {{ object_filter.oldestDog.Name }} |
{{ object_filter.object_filter_name | lookup:'object_property' }} | {{ object_filter.oldestDog | lookup:'Name' }} |
Retornar um número inteiro de um filtro de objeto
Estes exemplos usam o seguinte:
- Um filtro de objeto adicional chamado countOfDogs
Estrutura | Exemplo |
{{ object_filter.object_filter_name }} | {{ object_filter.countOfDogs }} |
Apresenta vários objetos de um filtro de objetos
Para um filtro chamado dogs configurado com Múltiplo, faça um loop pelos registros correspondentes para exibir a propriedade Name de cada pet:
{% for pet in object_filter.dogs %}
{{ pet.Name }}
{% endfor %}
Recuperar registros de objetos
Use customobjects para recuperar até 5 registros vinculados ao destinatário, ordenados do mais recentemente adicionado ao mais antigo. Percorra esses registros retornados em loop para exibir as propriedades deles. Este exemplo usa o seguinte:
- Objeto chamado Perfil de animal de estimação
- Propriedade do objeto chamada name
Estrutura | Exemplo |
{% customobjects object_type_title="Title" as alias %} | {% customobjects object_type_title="Pet Profile" as pets %} |
Dados de objeto nas linhas de assunto
Use a mesma sintaxe de objeto personalizado nas linhas de assunto e no corpo da mensagem. Estes exemplos mostram a sintaxe de cada fonte de dados:
{{ object_filter.oldestDog.Name }}exibe a propriedade Name do filtro de objeto único oldestDog.{{ object.Name }}exibe a propriedade Name do objeto que acionou um fluxo acionado por data.{% customobject event.pet_id object_type_title="Pet" as pet %}{{ pet.Name }}{% endcustomobject %}procura um registro de pet pelo ID. Use isso em um fluxo acionado por um evento que contém pet_id.
Por exemplo, use {{ object.Name }} em um fluxo acionado por data com base no objeto Pet para exibir o nome do pet de um cliente na linha de assunto.
Visualização de rascunho:

Visualização de e-mail:
Dados de objeto na lógica de mostrar/ocultar
Você também pode configurar se deseja mostrar ou ocultar um bloco em um modelo com base nos dados do objeto. Use uma propriedade ou contagem de um filtro de objetos ou o objeto que acionou um fluxo acionado por data. Você pode usar dados do objeto em uma única condição de mostrar/ocultar ou na condição para cada variante de lógica de mostrar/ocultar. Para dados recuperados por ID, use a lógica condicional avançada descrita abaixo.
Você precisa criar filtros de objeto antes de poder referenciá-los na lógica de mostrar/ocultar.
Por exemplo, em um fluxo acionado por data com base em um objeto Pet, use object.Breed == 'Labrador' para mostrar um bloco apenas quando a Breed do pet que acionou for Labrador. Use o valor exato da raça a partir dos seus dados.
- Selecione o bloco e abra a guia Exibição. Em Lógica de mostrar/ocultar, selecione Mostrar apenas para um público específico ou selecione Personalizar para vários públicos para criar variantes de lógica. Em seguida, selecione Usar código.
- Insira uma condição como
object_filter.countOfDogs > 0sem{{ }}ou{% %}em volta dela. Os filtros de objeto podem ser usados em campanhas e fluxos. Useobjectapenas em um fluxo acionado por data com base em dados de objeto. - Clique em Salvar para aplicar a condição.

As seções de objetos personalizados oferecem suporte à lógica de mostrar/ocultar para apenas um público. As variantes de lógica não estão disponíveis para elas. Saiba mais sobre variantes da lógica de mostrar/ocultar.
Para ter mais flexibilidade (por exemplo, tornar algumas informações condicionais com base nas informações retornadas por {% customobject %} ou {% customobjects %}), considere usar lógica condicional avançada com a lógica {% if ... %} diretamente em um bloco de texto.
Filtros de objeto
O que é um filtro de objeto?
Os filtros de objeto selecionam registros vinculados a cada destinatário usando critérios que você define. Você pode exibir uma propriedade de 1 registro correspondente, propriedades de até 10 registros correspondentes ou uma contagem de registros correspondentes.
Criar um novo filtro de objeto
Para começar a criar um filtro de objeto:
- Adicione um novo bloco de texto ou edite o texto em um bloco de texto existente no seu modelo.
- Selecione o botão Personalization .

- Na janela modal de personalização, selecione Objetos na lista suspensa Todos os tipos .
- Selecione o objeto que contém os dados para os quais você gostaria de definir um filtro.
- Selecione a propriedade que você quer exibir. Para criar um filtro de contagem, selecione Número de objetos.
- Clique em Criar se ainda não houver filtros. Se houver filtros listados, deixe-os desmarcados e clique em Criar filtro de objeto.
Na modal Criar filtro de objeto, defina as seguintes informações:
- Nome
Insira um nome exclusivo que contenha apenas letras e números, como oldestDog. Não use espaços ou caracteres especiais. - Defina condições de filtro
Defina as regras que um objeto precisa atender para ser incluído no bloco de texto. - Quantos objetos devem ser exibidos?
Para um valor de propriedade, selecione Único para 1 registro ou Múltiplos para até 10 registros. Os filtros de contagem não mostram essa configuração. - Selecione a propriedade e Ordem de classificação
Para um filtro de propriedade-valor, escolha a propriedade usada para selecionar ou classificar registros e, em seguida, escolha a ordem de classificação. Por exemplo, classifique por uma propriedade de aniversário com Mais antigo para selecionar primeiro o animal de estimação mais velho. Esses campos não aparecem para filtros de contagem.

Clique em Criar filtro de objeto para salvar seu filtro e inserir a tag dele no bloco de texto.
Depois que o filtro de objeto é criado, você pode usá-lo na lógica de mostrar/ocultar e em tag de personalização para exibir registros de objetos específicos com base nos critérios que você definir.
Recursos adicionais
- Introdução aos objetos personalizados
Saiba mais sobre objetos personalizados, que permitem armazenar e associar várias propriedades a um único "objeto". Objetos personalizados permitem que você mapeie diversos conceitos de dados multirrelacionais para a Klaviyo, que não podem ser armazenados usando propriedades de perfil. Você pode usar objetos personalizados em suas mensagens, segmentos e muito mais.
- Referência sobre a personalização de mensagens
Saiba como usar as tags do modelo da Klaviyo para personalizar a experiência dos seus clientes.
- Como usar o painel de visualização para personalizar mensagens
Saiba como usar o painel de visualização para entender os dados de personalização disponíveis para suas mensagens e como acessar tags de modelo. Use o modal de visualização como sua fonte de verdade para opções de personalização.