Como usar objetos personalizados em modelos

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.

Antes de usar dados de objetos personalizados nos modelos, você precisa criar um objeto.

Acessar dados de objeto pelo menu de personalização

Você pode personalizar blocos 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 aos seus modelos:

1. Adicione um novo bloco de texto ou selecione um bloco de texto existente.
2. Clique duas vezes no bloco de texto e, em seguida, posicione o cursor onde você quer inserir sua propriedade dinâmica.
3. Selecione o botão Personalização no canto superior direito.

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

5. 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.
6. Selecione a propriedade específica do objeto ou o filtro de objeto para incluir no modelo. Você também pode criar aqui um novo filtro de objeto.
7. Defina o texto padrão e todos os estilos do seu texto.

Para especificar as regras de capitalização para dados de objeto, você precisará definir manualmente a regra na tag de personalização. Por exemplo:

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

Estes exemplos usam o seguinte:

• Objeto chamado Pet que é referenciado com a tag object no modelo. 
• Propriedade do objeto chamada Nome

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.

Apresenta um único objeto de um filtro de objetos

Estes exemplos usam o seguinte:

• Um filtro de objeto adicional chamado oldest_dog
• Propriedade do objeto chamada Nome

Retornar um número inteiro de um filtro de objeto

Estes exemplos usam o seguinte:

• Um filtro de objeto adicional chamado count_of_dogs

Recuperar registros de objetos

Para recuperar os registros de objeto mais recentes de um objeto, você precisará percorrer todos os registros de objeto. Este exemplo usa o seguinte:

• Objeto chamado Pets

Dados de objeto nas linhas de assunto

Você pode personalizar suas linhas de assunto com qualquer uma das tags de objeto personalizado:

• {% object_filter %}
• {% object %}
• {% customobject %}

Por exemplo, você pode usar a tag {% object %} na linha de assunto da sua mensagem para exibir diretamente o nome do pet de um cliente.

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 em dados do objeto. Mostrar ou ocultar dinamicamente um bloco com base em dados do objeto usa as mesmas tags que o gerador de modelo. Você pode fazer referência a objetos por ID, propriedades de filtros de objeto ou agregações de filtros de objeto.

Por exemplo, se você tiver um objeto Pet com uma propriedade chamada Breed, você pode escolher mostrar um bloco apenas para donos de pets com uma determinada raça de cachorro usando a condição object.Breed .

Para definir a lógica de exibição/ocultação, clique no bloco para o qual você gostaria de definir as regras e selecione Usar código na aba Exibição.

Insira a condição diretamente no editor de código. Você pode usar filtros de objeto e a tag de modelo de objeto se for uma mensagem de um fluxo acionado por data com base em dados de objeto.

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 permitem que você limite os registros de objeto retornados com base em critérios específicos que você definiu, para que você possa exibir registros de um determinado tipo.

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 no seu modelo.
2. Selecione o botão Personalization .

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

Na modal 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.

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