Como usar objetos personalizados no modelo

Estimado 5 minuto de leitura
|
Atualizado 7 de abr. de 2025, 18:55 EST
O que você vai aprender

O que você vai aprender

Saiba como usar objetos personalizados no modelo, para que o senhor possa usar dados de objetos em fluxos e envios de campanhas.

O senhor deve criar um objeto antes de poder usar dados de objetos personalizados no modelo.

Acesso aos dados do objeto por meio do menu de personalização 

Acesso aos dados do objeto por meio do menu de personalização 

É possível personalizar o bloco de texto no editor de modelos usando propriedades de um objeto personalizado ou a contagem de registros de um objeto.

Saiba como usar o editor de modelos do Klaviyo

Para começar a adicionar dados de objetos ao seu modelo:

  1. Adicione um novo bloco de texto ou edite o texto em um bloco de texto existente em seu modelo. 
  2. Selecione o botão Personalization (Personalização ) no canto superior direito. 

  1. No modal de personalização, selecione Objects (Objetos ) no menu suspenso All types (Todos os tipos ).

  1. Em Objects (Objetos), o senhor verá todos os objetos da sua conta que podem ser usados para extrair dados para o modelo. Selecione o objeto que contém os dados que o senhor gostaria de usar no modelo. 
  2. Selecione a propriedade específica do objeto ou o filtro de objeto a ser incluído no modelo. O senhor também pode criar um novo filtro de objeto aqui.
  3. Defina o texto padrão e quaisquer estilos para seu texto.

Para especificar as regras de capitalização para dados de objetos, o senhor precisará definir manualmente a regra no site tag do modelo. Por exemplo: 

  • {{ object.full_name|title|default:'value' }}
    John Doe 
  • {{ object.full_name|upper|default:'value' }}
    JOHN DOE
  • {{ object.full_name|lower|default:'value' }}
    desconhecido 

Saiba mais sobre como modificar valores com o filtro do Django. 

Acesso a dados de objetos com a tag do modelo

Acesso a dados de objetos com a tag do modelo

O senhor pode usar a tag do modelo no e-mail (incluindo a linha de assunto do e-mail), nas mensagens SMS/MMS, na notificação push e no Klaviyo Customer Hub para exibir dados de objetos.

Saiba como usar a tag do modelo em Klaviyo

Objeto tag do modelo de referência

O senhor pode usar a seguinte tag do modelo com objetos.

Usando o objeto que acionou um fluxo

Esses exemplos usam o seguinte:

  • Objeto chamado Pet , que é referência com a tag de objeto no modelo.  
  • Propriedade do objeto chamada Name
EstruturaExemplo
{{ object.object_property }}{{ object.Name }}
{{ object | lookup:'object_property' }}{{ object | lookup:'Name' }}

Obtendo um objeto por ID

Esses exemplos usam o seguinte:

  • Objeto chamado Pet
  • Propriedade do objeto chamada Name
  • Evento que acionou o fluxo com uma propriedade de objeto chamada pet_id. Esse campo é o mesmo que o ID do objeto Pet.
Estrutura Exemplo

{% get_object id={{ event.object_id }} as alias %}
{{ alias.object_property }}
{% endget_object %}

{% get_object id={{ event.pet_id }} as pet %}
{{ pet.Name }}
{% endget_object %}

{% get_object id={{ event.object_id }} as alias %}
{{ alias | lookup:'object_property' }}
{% endget_object %}

{% get_object id={{ event.pet_id }} as pet %}
{{ pet | lookup:'Name' }}
{% endget_object %}

Retorna um único objeto de um filtro de objetos 

Esses exemplos usam o seguinte:

  • Um filtro de objeto adicional chamado oldest_dog
  • Propriedade do objeto chamada Name
EstruturaExemplo

{{ object_filter.object_filter_name.object_property}}

{{ object_filter.oldest_dog.Name }}
{{ object_filter.object_filter_name | lookup: 'object_property' }}{{ object_filter.oldest_dog | lookup: 'Name' }}

Retorna uma contagem

Esses exemplos usam o seguinte:

  • Objeto chamado Pet
  • Um filtro de objeto chamado count_of_pets
EstruturaExemplo
{{ object.object_filter }}{{ Pet.count_of_pets }}
{{ object | lookup:'object_filter' }}{{ Pet | lookup:'count_of_pets' }}

Retorna uma contagem de um filtro de objeto 

Esses exemplos usam o seguinte:

  • Um filtro de objeto adicional chamado count_of_dogs
EstruturaExemplo
{{ object_filter.object_filter_name }}{{ object_filter.count_of_dogs }}

 

Dados do objeto na lógica mostrar/ocultar

Dados do objeto na lógica mostrar/ocultar

O senhor também pode configurar se deseja mostrar ou ocultar o bloco em um modelo com base nos dados do objeto. Mostrar ou ocultar dinamicamente um bloco com base nos dados do objeto usa a mesma tag do gerador de modelo. O senhor pode fazer referência a objetos por ID, propriedades do filtro de objetos ou agregados do filtro de objetos.

Por exemplo, se o senhor tiver um objeto Pet com uma propriedade chamada Breed, poderá optar por mostrar um bloco somente aos proprietários de animais de estimação com uma determinada raça de cachorro usando a condição object.Breed

Para definir a lógica de mostrar/ocultar, clique no bloco para o qual deseja definir as regras e selecione Use code (Usar código) na guia Display (Exibir)

Insira a condição diretamente no editor de código. 

Objeto filtro

Objeto filtro

O que é um filtro de objeto?

O que é um filtro de objeto?

O filtro de objetos permite limitar os registros de objetos retornados com base em critérios específicos definidos para que o usuário possa exibir registros de um determinado tipo. 

Criar um novo filtro de objeto

Criar um novo filtro de objeto

Para começar a criar um filtro de objeto:

  1. Adicione um novo bloco de texto ou edite o texto em um bloco de texto existente em seu modelo. 
  2. Selecione o botão Personalization (Personalização ). 

  1. No modelo de personalização, selecione Objetos no menu suspenso Todos os tipos
  2. Selecione o objeto que contém os dados para os quais o senhor gostaria de definir um filtro. 
  3. Selecione a propriedade do objeto para a qual deseja definir um filtro. 
  4. Selecione Criar novo filtro

No modal Create object filter (Criar filtro de objeto ), defina as seguintes informações: 

  • Nome
    Crie um nome para seu filtro de objeto.
  • Condições de filtro
    Defina as regras que um objeto deve atender para ser incluído no bloco de texto. 
  • Comportamento quando vários registros atendem às condições
    Defina o comportamento para casos em que vários registros atendem às condições.

Uma vez criado o filtro de objetos, é possível usá-lo na lógica mostrar/ocultar e na tag do modelo para exibir registros de objetos específicos com base nos critérios definidos. 

Recursos adicionais 

Recursos adicionais 

Guia de introdução com objetos

Referência de personalização de mensagens

Como usar o painel de visualização para personalizar mensagens

Esse artigo foi útil?
Use esse formulário somente para fazer comentários sobre artigos. Saiba como entrar em contato com o suporte.

Saiba mais sobre a Klaviyo

Comunidade
Conecte-se com colegas, parceiros e especialistas da Klaviyo para encontrar inspiração, compartilhar percepções e obter respostas para todas as suas perguntas.
Treinamentos ao vivo
Participe de uma sessão ao vivo com especialistas da Klaviyo para aprender sobre as práticas recomendadas, como configurar os principais recursos e muito mais.
Suporte

Acesse o suporte por meio da sua conta.

Suporte por e-mail (teste gratuito e contas pagas) Disponível 24 horas

Chat/assistência virtual
A disponibilidade varia conforme o local e o tipo de plano