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.

Como os objetos personalizados são diferentes das propriedades do perfil?

As propriedades de perfil são uma ótima maneira de armazenar informações simples. Por exemplo, se você tiver uma propriedade de cor favorita, poderá armazenar a cor favorita de cada cliente.

Mas e se você quiser mais dados ou várias versões dessa propriedade? Um ótimo exemplo é para animais de estimação. Você pode usar as propriedades do perfil para armazenar coisas como nome, idade, raça, mas elas só podem ser usadas uma vez por perfil.

Se alguém tiver vários animais de estimação, você pode usar objetos personalizados. Dessa forma, Fluffy, o Grande Dinamarquês, tem seu próprio cartão de identidade digital para seu nome, idade, peso, etc., e Cheeks, o hamster, tem as mesmas informações, mas com respostas (muito) diferentes. 

Exemplos de casos de uso

Veja abaixo alguns exemplos que demonstram como objetos personalizados são flexíveis nos dados que você pode armazenar na Klaviyo.

Atendimento

Se você for uma empresa onde os clientes podem agendar compromissos, poderá usar um objeto Compromisso para armazenar dados de compromissos para perfis. 

Em cada registro de objeto para o objeto Compromisso, alguns exemplos de dados que você pode querer incluir são:

• ID do Compromisso
• Data do compromisso
• Pessoa agendada (por exemplo, médico específico, instrutor, etc.)
• Localização do compromisso
• Tipo de compromisso

Perfis podem ter vários registros de objeto se tiverem vários compromissos, e você pode usar esses dados de objeto para criar segmentos e enviar mensagens e fluxos personalizados.

Inscrição

Se você for uma empresa onde os clientes podem se inscrever para uma assinatura, poderá usar um objeto Assinatura para armazenar dados de assinatura para perfis. 

Em cada registro de objeto para o objeto Inscrição, alguns exemplos de dados que você pode incluir são:

• ID da assinatura
• Produto de assinatura
• Preço da assinatura
• Status da inscrição
• Próxima data de cobrança

Os perfis podem ter vários registros de objetos se tiverem várias inscrições, e você pode usar esses dados de objeto para criar segmentos e enviar mensagens e fluxos personalizados.

Reserva

Se você for uma empresa onde os clientes podem reservar reservas, poderá usar um objeto Reserva para armazenar dados de reservas de perfis. 

Em cada registro de objeto para o objeto Reserva, alguns exemplos de dados que você pode incluir são:

• ID da reserva
• Data da reserva
• Localização da reserva
• Ocasião da reserva
• Contagem de convidados da reserva

Perfis podem ter vários registros de objeto se tiverem várias reservas, e você pode usar esses dados de objeto para criar segmentos e enviar mensagens e fluxos personalizados.

Pet

Se você é uma empresa que atende proprietários de animais de estimação, você pode usar um objeto Pet para armazenar dados sobre os animais de estimação dos perfis. 

Em cada registro de objeto para o objeto Pet, alguns exemplos de dados que você pode incluir são:

• ID do microchip para animais de estimação
• Nome do animal de estimação
• Tipo de animal de estimação (por exemplo, cão ou gato)
• Raça do animal de estimação
• Aniversário do animal de estimação

Perfis podem ter vários registros de objeto se tiverem vários pets, e você pode usar esses dados de objeto para criar segmentos e enviar mensagens e fluxos personalizados.

Limites da conta

Os objetos personalizados têm 3 conjuntos de limites de conta:

• Limite de objetos
  Número total de objetos que uma conta pode ter.
• Limites de propriedade do objeto
  O número de propriedades que uma conta pode ter por objeto.
• Limites de registros de objetos
  O número de registros de objetos permitidos para uma conta.

O número de objetos e registros de objetos disponíveis é baseado no número total de perfis ativos em todas as suas contas. Os limites de registros são compartilhados em todas as contas, enquanto os limites de objetos se aplicam a cada conta separadamente.

Por exemplo, se você tiver uma família de conta com 5 contas secundárias em que cada conta tiver 100.000 perfis ativos, seu total de perfis ativos será igual a 500.000. Conforme mostrado no gráfico abaixo, as contas com mais de 400.000 perfis têm um multiplicador de registro de objeto de 10. Como resultado, essas contas podem armazenar no máximo 5 milhões de registros (500.000 x 10). Isso significa que você pode ter uma conta com 3 milhões de registros, desde que as 4 contas restantes tenham menos de 2 milhões de registros de objetos combinados. Quanto ao número de objetos por conta, como a contagem combinada de perfis é superior a 400.000, cada conta pode ter até 5 objetos.

Além disso, todas as contas têm os seguintes limites:

• Máximo de 500 registros por perfil e por objeto.
• Cada objeto personalizado não deve ter mais de 8 KB.
• Cada registro de objeto personalizado não deve ter mais de 2 KB.

Criar um objeto

Para começar a criar um objeto na Klaviyo, navegue até Conteúdo > Objetos. e clique em Criar objeto.

A partir daí, você pode criar um objeto do zero ou selecionar um modelo de objeto recomendado. Para criar um objeto do zero, selecione o botão Criar seu próprio.

A primeira parte do fluxo de trabalho de criação de objeto requer que você defina as seguintes informações para seu objeto:

• Nome
  Um nome para identificar seu objeto
• Descrição (opcional)
  Uma descrição dos dados que seu objeto representa
• Fonte de dados
  A fonte de dados onde estão os dados do seu objeto.

Para criar uma nova fonte de dados, clique no menu suspenso Selecionar uma fonte de dados e selecione Criar uma nova fonte de dados.

Para criar uma fonte de dados, é necessário definir as seguintes informações:

• Nome
  Um nome exclusivo para identificar a origem de seus dados de objeto.
• Descrição (opcional)
  Uma descrição de sua fonte de dados.

Definir a ID do objeto

Depois de definir um nome para seu objeto e escolher a fonte de dados, a próxima etapa é definir um ID do objeto e mapear as propriedades do objeto desejadas. Durante esta etapa, você poderá visualizar os dados associados à fonte de dados que foi enviada para a Klaviyo por meio da API de objeto personalizado.

A definição da ID do objeto é necessária para distinguir os registros do objeto uns dos outros. É preciso especificar uma propriedade de fonte de dados para a ID de objeto exclusivo.

A ID do objeto deve ser uma propriedade de fonte de dados exclusiva que pode ser usada para identificar instâncias específicas de um registro de objeto. Por exemplo, com um objeto de vale-presente, você pode usar algo como o código de desconto exclusivo como a ID do objeto. Isso é exclusivo para cada instância da fonte de dados e existirá para cada registro de objeto.

Sempre que a Klaviyo receber dados de sua fonte de dados com a mesma ID de objeto, o registro de objeto associado será atualizado. Por esse motivo, é importante que a ID do objeto seja exclusiva para que o registro apropriado seja atualizado.

Enviar dados do objeto

Quando você atualiza um registro de objeto existente, todo o registro é substituído. Portanto, é fundamental enviar todo o registro do objeto, mesmo que você queira atualizar apenas 1 propriedade.

Por exemplo, digamos que você queira atualizar apenas 1 de 5 propriedades em um registro. Se você enviar dados atualizados com a ID e apenas a propriedade 1 que deseja atualizar, as outras 4 propriedades serão definidas como nulas. Se um dos novos campos nulos tiver sido usado no seu relacionamento de perfil (por exemplo, um identificador de perfil, como um endereço de e-mail), o objeto não estará mais relacionado a esse perfil.

Mapear propriedades do objeto

Ao mapear propriedades do objeto, você pode selecionar quais informações da fonte de dados estarão disponíveis em um objeto na Klaviyo.

No entanto, por esse motivo, recomendamos enviar dados de objeto pela API de ingestão de objetos em formatos padronizados de data e carimbo de data/hora. Se o valor de uma propriedade específica não for conhecido, você pode definir um valor nulo para ela.

Para mapear propriedades do objeto:

1. Na coluna Propriedade da fonte de dados, selecione a propriedade da fonte de dados que deseja incluir no seu objeto.
2. Na coluna Propriedade mapeada , insira o nome que deseja que a propriedade da fonte de dados tenha no objeto.
3. Na coluna Tipo de dados, selecione o tipo de dados apropriado da propriedade da sua fonte de dados.
4. Na coluna Obrigatório, marque a caixa de seleção se quiser que essa propriedade seja obrigatória no objeto.
5. Selecione o botão Adicionar mapeamento se precisar mapear propriedades de objeto adicionais.

Dados aninhados no mapeamento

Por padrão, a interface do gerenciador de objetos suporta 1 nível de aninhamento. Para acessar dados mais profundos, você deve inserir manualmente no caminho de sua escolha.

Por exemplo, veja a fonte de dados abaixo.

text Copy

{
  "type": "data-source-record",
  "attributes": {
    "record": {
      "child": {
        "child_id": "d64b8458",
        "name": {
          "first": "Theodore",
          "last": "Customer"
        },
        "birth_date": "2022-04-12",
        "email": "jon.customer@klaviyo.com",
        "phone_numbers": [
              "+11234567899",
              "+13456789123"
        ]
      }
    }      
  }
}

Para acessar dados sobre o nome de uma criança, você pode inserir o seguinte caminho, pois os dados são aninhados muito longe para serem acessados com a interface.

Se você tiver uma matriz em seus dados de origem, poderá encontrar propriedades para mapear por posição. Por exemplo, você pode extrair o primeiro número de telefone dentro da matriz phone_numbers incluindo [0] no final do seu caminho.

Adicionar relacionamento

Depois de definir uma ID de objeto e mapear suas propriedades de objeto, a próxima etapa é adicionar um relacionamento ao seu objeto.

Relacionamentos conectam seu objeto a perfis relevantes. Defina as seguintes informações para definir um relacionamento:

• Nome do relacionamento
  Defina um nome para seu relacionamento. Por exemplo, se você tiver um objeto pet, pode definir o nome do relacionamento como "Pet owner".
• Dados de origem
  Selecione as propriedades da fonte de dados que deseja associar a um perfil.
• Identificador de perfil
  Defina o identificador de perfil (ou seja, e-mail, número de telefone etc.). Isso precisa ser incluído na fonte de dados para que um objeto seja associado a um perfil. Use o botão Vincular outra propriedade para adicionar outros pares de propriedade e identificador.

Confirmar mapeamentos e criar objetos

Depois de mapear as propriedades do objeto e definir o relacionamento, confirme os mapeamentos no modal de confirmação e selecione o botão Criar objeto. Observe que os mapeamentos existentes não podem ser editados depois que o objeto for criado, e os dados começarão a ser sincronizados imediatamente.

Você verá seu objeto listado na página Objetos na Klaviyo, juntamente com as seguintes informações:

• Nome do objeto
• Data de criação
• Data da última atualização
• Status

Estados de status de objeto personalizado

Há três estados de status ao publicar objetos personalizados:

• Rascunho
  O objeto ainda é editável e não foi publicado ou está ativo.
• Publicação
  O objeto está criando registros de objetos personalizados a partir dos dados que você enviou para sua fonte de dados.  Se você enviou alguns milhares de registros de sua fonte de dados, seu objeto será publicado instantaneamente. Se você enviou alguns milhões de registros, pode levar horas para publicá-los. Uma vez concluído, o status será alterado para Ativo.
• Ativo
  O objeto é publicado e está ativo. Todos os registros de objetos personalizados foram criados de acordo com os dados enviados de sua fonte de dados. Todos os novos dados enviados para esse objeto gerarão registros de objetos personalizados adicionais vinculados aos seus perfis.

Objetos em páginas de perfil

Os objetos relevantes também aparecerão em uma página de perfil para que você possa visualizar os registros de objetos que pertencem a um perfil. Para visualizar os registros de objetos, navegue até a aba Objetos em uma página de perfil. Você pode alternar entre objetos usando o menu suspenso acima dos cartões de objeto.

Para visualizar um registro de objeto completo, selecione o menu de 3 pontos e clique em Exibir. Será exibido um painel lateral que contém o registro completo do objeto.

Atualizar um objeto

Se quiser começar a enviar novos dados para um objeto, adicione as propriedades adicionais do objeto à sua fonte de dados e, em seguida, edite o mapeamento do objeto para incluir essa nova propriedade. Todos os objetos criados anteriormente retornarão um nulo para essa propriedade, pois os dados não estão disponíveis, mas, a partir de agora, os objetos serão criados e atualizados com essa propriedade.

Se você enviar novas propriedades de objeto que ainda não foram mapeadas para um objeto, poderá atualizar seu objeto personalizado para incluí-lo. Todos os registros de objetos personalizados são reprocessados para incluir esses dados.

Para atualizar um objeto:

1. Clique em Conteúdo > Objetos na barra lateral da Klaviyo.
2. Selecione o nome do objeto que deseja editar.
3. Clique em Avançar no canto superior direito.
4. Na seção Mapear propriedades do objeto , clique em Adicionar mapeamento.

1. Na coluna Propriedade da fonte de dados, selecione a propriedade da fonte de dados que deseja incluir no seu objeto.
2. Na coluna Propriedade mapeada , insira o nome que deseja que a propriedade da fonte de dados tenha no objeto.
3. Na coluna Tipo de dado, selecione o tipo de dado apropriado da propriedade da sua fonte de dados.

1. Clique em Avançar no canto superior direito.
2. Clique em Avançar no canto superior direito. Você não terá que fazer mudanças em seus relacionamentos.
3. Clique em Publicar alterações.

Depois de concluir esse processo, todos os registros de sua fonte de dados serão reprocessados e os registros de objetos personalizados existentes serão atualizados de acordo.

Excluir um objeto

Para excluir um objeto:

1. Clique em Conteúdo > Objetos na barra lateral da Klaviyo.
2. No menu à direita do objeto, clique em Excluir.
   

3. Clique em Excluir novamente para confirmar a remoção do objeto.
4. O objeto e todos os registros de objetos personalizados associados são excluídos.

Se você criar um novo objeto personalizado usando a fonte de dados de um objeto anterior, novos registros de objeto personalizado serão gerados usando os dados que você já sincronizou. Embora use os mesmos dados, é considerado um novo objeto com novos registros, portanto, todos os segmentos, fluxos, modelos e campanhas devem ser atualizados para usar esse novo objeto.

Recursos adicionais