Perguntas frequentes sobre objetos personalizados

O que você vai aprender

Saiba mais sobre as perguntas frequentes relacionadas a objetos personalizados no Klaviyo. Se você não encontrar sua pergunta no recurso abaixo, acesse nosso fórum da comunidade.

Perguntas gerais sobre objetos

Preciso de um desenvolvedor para criar um objeto?

Sim, esse recurso depende do uso da API para enviar fontes de dados e, por fim, criar objetos.

Posso criar objetos personalizados usando formulários do Klaviyo ou uploads de CSV?

Atualmente, a Klaviyo exige que as contas criem novos objetos personalizados, enviando-nos dados via API. 

Quando devo usar um objeto personalizado em vez de um Propriedades do perfil ou evento?

Você deve usar objetos personalizados quando tiver uma relação de muitos para um entre a categoria que o objeto personalizado representa e o seu perfil. Por exemplo, se você quiser manter informações sobre os animais de estimação de seus clientes, e eles podem ter mais de um animal de estimação, representá-los como um objeto personalizado é muito melhor do que Propriedades do perfil ou eventos.

Ao rastrear itens como status de associação, em que um perfil só pode ter um status por vez, o Propriedades do perfil é mais adequado. No entanto, se você quiser armazenar outros detalhes sobre a associação de um perfil, um objeto pode funcionar melhor. 

Ao rastrear algo amplo, como quantas vezes um Destinatário abriu um e-mail, recomendamos que você use eventos.

Posso atualizar meu objeto personalizado após a criação?

Sim, você sempre pode adicionar propriedades adicionais e não obrigatórias ao seu objeto personalizado. Para saber mais, leia sobre a atualização de um objeto personalizado. 

Quando devo emitir um evento versus atualizar as propriedades do objeto personalizado?

Os eventos destinam-se a acionar o fluxo rapidamente, permitindo que você envie mensagens oportunas e relevantes. Quando o status de um objeto for alterado e você quiser acionar uma mensagem como resultado disso, deverá atualizar o objeto com as novas informações e nos enviar um evento para acionar o fluxo.

Você pode personalizar o modelo com as informações do objeto no fluxo acionado por evento. Há duas maneiras de conseguir isso: 

1. Use a tag {{ event }} para adicionar propriedades relevantes nos metadados do evento para uso em seu modelo. Isso funciona bem quando a pontualidade é importante.
2. Inclua o ID do objeto nos metadados do evento, o que permite que você obtenha o objeto no modelo com o comando {% customobject id={{ event.pet_id }} as pet %}. No entanto, pode levar algum tempo para que o objeto seja atualizado com as propriedades mais recentes, portanto, é possível que o fluxo tenha acionado uma mensagem a ser enviada antes que o objeto fosse atualizado.

Perguntas sobre o envio de dados de objeto 

Como faço para começar a enviar meus dados para objetos personalizados?

1. Crie uma nova fonte de dados usando nossa API.
2. Defina sua estrutura de dados (veja o exemplo de JSON).
3. Envie os registros da sua fonte de dados para o Klaviyo via API.
4. Crie seu objeto personalizado.
5. Crie o relacionamento entre o objeto personalizado e o perfil.

Como as fontes de dados são criadas e usadas?

Depois de criar uma nova fonte de dados, o Klaviyo retornará um identificador exclusivo como parte da resposta à sua solicitação de API. Isso permite que o Klaviyo identifique as fontes de dados, especialmente nos casos em que uma conta tem várias fontes de dados (por exemplo, uma para cada integração personalizada, data warehouse, ou integrações personalizadas de terceiros das quais a marca depende para seus negócios).

Com esse identificador exclusivo, seu desenvolvedor pode criar registros de fontes de dados por meio da API da Klaviyo.

Como devo formatar meus dados?

Seu desenvolvedor precisará enviar dados formatados em JSON para a Klaviyo. Recomendamos que você envie seus dados como texto com uma lista separada por vírgulas. Você poderá usar o operador "contains" da segmentação e do filtro de fluxo para filtrar os valores nessa string separada por vírgulas. Consulte a referência de condições do segmento para obter mais informações sobre o filtro.  

Tipos de dados suportados em objetos personalizados:

• Texto
• Inteiro
• Decimal
• Data - Todos os períodos de data são convertidos para UTC em nosso sistema. Por exemplo, se você carregar "2025-04-03", ele será convertido em "2025-04-03 00:00:00". Para clientes com fusos horários três horas à frente, o datetime seria "2025-04-02 21:00:00".
• Booleano

O tipo de dados de lista não é suportado no momento. Para obter um exemplo de carga útil para o registro de origem de dados API, consulte Bulk Create dados Source Records.

Quais são os limites de dados para objetos personalizados?

Você pode carregar um máximo de 2 KB por propriedade e 8 KB por registro total.

Posso mapear com dados aninhados?

Recomendamos definir seu objeto JSON sem aninhar as propriedades que você deseja usar para seu objeto personalizado. Se os dados de origem estiverem profundamente aninhados ou usarem uma lista, você precisará inserir manualmente o caminho JSON no gerenciador de objetos. Para lista, você só pode mapear uma propriedade para uma posição dentro dessa lista (por exemplo, o primeiro ou o segundo valor).

Posso associar vários identificadores a um perfil?

Sim, se você quiser usar dois ou mais identificadores de perfil (por exemplo, e-mail e número de telefone) para associar seus registros de objeto personalizado a um perfil, certifique-se de incluir essas duas propriedades em cada sincronização, mesmo que o valor de uma delas seja nulo.  

Perguntas sobre o uso de objetos com o fluxo 

Posso usar o trigger divisão ou trigger filtro para o fluxo acionado por data?

No momento, a criação de divisão de acionamento e filtro de acionamento para fluxo acionado por data não está disponível.

Se meu objeto não acionou um fluxo e eu não tenho um objeto id de um evento, ainda posso personalizar minhas mensagens?

Sim, você pode usar o filtro de objetos para encontrar o objeto certo ao personalizar suas mensagens. 

Posso visualizar mensagens de fluxo quando um objeto aciona um fluxo? 

No momento, não é possível usar a função de visualização no aplicativo para ver uma mensagem quando você usa a tag {{ object }} tag.

Para testar uma mensagem de fluxo:

1. Crie um fluxo acionado por data e defina-o como ativo.
2. Crie um perfil com um objeto que tenha uma data que será acionada em pelo menos 24 horas.

Posso atualizar meus objetos usando ações de fluxo como webhook e código Klaviyo?

Nesse momento, recomendamos que você atualize sua fonte de dados original primeiro e, em seguida, envie o objeto revisado para Klaviyo no formato permitido. Se esses dois sistemas ficarem fora de sincronia, você corre o risco de enviar um registro desatualizado para Klaviyo do seu sistema, revertendo-o para o valor original.