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, entre em contato no nosso fórum da Community.

Perguntas gerais sobre objetos

Preciso de um desenvolvedor para criar um objeto?

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

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

No momento, a Klaviyo exige que as contas criem novos objetos personalizados enviando dados para nós via API.

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

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

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

Ao fazer o rastreamento de algo mais amplo, como quantas vezes um destinatário abriu um e-mail, recomendamos usar eventos.

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

Sim, você sempre pode adicionar propriedades adicionais não obrigatórias ao seu objeto personalizado. Para saber mais, leia sobre como atualizar um objeto personalizado.

Quando devo emitir um evento em vez de atualizar as propriedades do objeto personalizado?

Os eventos servem para acionar fluxos rapidamente, permitindo que você envie mensagens oportunas e relevantes. Quando o status de um objeto muda e você quer disparar uma mensagem como resultado, você deve atualizar o objeto com as novas informações e nos enviar um evento para disparar o fluxo.

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

1. Use a tag {{ event }} para adicionar propriedades relevantes aos metadados do seu evento para usar no seu modelo. Isso funciona bem quando a pontualidade é importante.
2. Inclua o ID do objeto nos metadados do evento, o que permite obter o objeto no modelo com o {% customobject id={{ event.pet_id }} as pet %}. No entanto, pode levar algum tempo para o objeto ser atualizado com as propriedades mais recentes, então é possível que o fluxo tenha acionado o envio de uma mensagem antes que o objeto fosse atualizado.

Dúvidas sobre o envio de dados de objetos

Como começo 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 a Klaviyo via API.
4. Criar seu objeto personalizado.
5. Crie o relacionamento entre seu objeto personalizado e seus perfis.

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

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

Com esse identificador exclusivo, seu desenvolvedor pode criar registros de fonte de dados pela API da Klaviyo.

Como devo formatar meus dados?

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

Tipos de dados compatíveis em objetos personalizados:

• Texto
• Inteiro
• Decimal
• Data - Todas as datas e horas são convertidas para UTC no nosso sistema. Por exemplo, se você fizer upload de "2025-04-03", ele será convertido em "2025-04-03 00:00:00". Para clientes com fusos horários três horas à frente, a data e hora aparecerá como "2025-04-02 21:00:00".
• Booleano

No momento, o tipo de dados de lista não é compatível. Para ver um exemplo de payload da API de registros de fonte de dados, consulte Criar registros de fonte de dados em massa.

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

Você pode fazer upload de no máximo 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ê quer usar para seu objeto personalizado. Se seus dados de origem estiverem profundamente aninhados ou usarem uma lista, você precisará inserir manualmente o caminho do JSON no gerenciador de objetos. Para listas, você só pode mapear uma propriedade para uma posição dentro dessa lista (por exemplo, o primeiro ou segundo valor).

Posso associar vários identificadores a um perfil?

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

Perguntas sobre o uso de objetos com fluxos

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

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

Posso pré-visualizar mensagens do fluxo quando um objeto dispara um fluxo?

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

Para testar uma mensagem de fluxo:

1. Crie um fluxo disparado por data e coloque-o no ar.
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 webhooks e código da Klaviyo?

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