Guia de introdução com objetos personalizados

O que você vai aprender

Saiba mais sobre objetos personalizados, inclusive como configurar um objeto e como usar objetos no Klaviyo.

Antes de começar

O senhor deve ter acesso a objetos personalizados para usar essa funcionalidade. 

O que são objetos personalizados?

Os objetos personalizados são um tipo de estrutura de dados em Klaviyo que permite ao senhor mapear diversos conceitos de dados multi-relacionais em Klaviyo que não podem ser armazenados usando Propriedades do perfil. Por exemplo, digamos que o senhor queira armazenar dados sobre os animais de estimação dos clientes em Klaviyo. Cada animal de estimação tem uma série de atributos (por exemplo, nome, idade, raça). etc.), o que torna difícil armazenar essas informações com Propriedades do perfil quando um perfil tem vários animais de estimação. 

O senhor pode então usar esses dados de objeto em fluxo, modelo e segmento em Klaviyo para personalizar melhor seu marketing. 

Exemplos de casos de uso

Abaixo estão alguns exemplos que demonstram como os objetos personalizados são flexíveis em relação aos dados que o senhor pode armazenar no Klaviyo. 

Nomeação

Se o senhor for uma empresa em que os clientes podem agendar compromissos, poderá usar um objeto Appointment para armazenar dados de compromissos para o perfil.  

Em cada registro de objeto para o objeto Appointment, alguns exemplos de dados que o senhor pode querer incluir são

• ID da nomeação 
• Data da nomeação
• Pessoa indicada (por exemplo, médico específico, instrutor, etc.)
• Local da consulta
• Tipo de nomeação 

O perfil pode ter vários registros de objeto se tiver vários compromissos, e o senhor pode usar esses dados de objeto para criar segmentos e enviar mensagens e fluxos personalizados. 

Assinatura 

Se o senhor for uma empresa em que o cliente pode fazer uma assinatura, poderá usar um objeto Subscription para armazenar dados de assinatura para o perfil.  

Em cada registro de objeto do objeto Subscription, alguns exemplos de dados que o senhor pode querer incluir são

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

O perfil pode ter vários registros de objeto se tiver várias assinaturas, e o senhor pode usar esses dados de objeto para criar segmentos e enviar mensagens e fluxos personalizados. 

Reserva

Se o senhor for uma empresa em que os clientes podem fazer reservas, poderá usar um objeto Reservation para armazenar dados de reserva para o perfil.  

Em cada registro de objeto para o objeto Reserva, alguns exemplos de dados que o senhor pode querer incluir são

• ID da reserva
• Data da reserva
• Local da reserva
• Ocasião de reserva 
• Contagem de hóspedes da reserva 

O perfil pode ter vários registros de objeto se tiver várias reservas, e o senhor pode usar esses dados de objeto para criar segmentos e enviar mensagens e fluxos personalizados. 

Animal de estimação

Se o senhor for uma empresa que atende a donos de animais de estimação, poderá usar um objeto Pet para armazenar dados sobre os animais de estimação do perfil.  

Em cada registro de objeto para o objeto Pet, alguns exemplos de dados que o senhor pode querer incluir são

• Identificação do microchip do animal de estimação
• Nome do animal de estimação 
• Tipo de animal de estimação (por exemplo, cachorro ou gato)
• Raça do animal de estimação
• Aniversário do animal de estimação 

O perfil pode ter vários registros de objetos se tiver vários animais de estimação, e o senhor pode usar esses dados de objetos 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 de 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 registro são compartilhados entre todas as contas, enquanto os limites de objeto se aplicam a cada conta separadamente. 

Por exemplo, se o senhor tiver uma família de contas com 5 contas-filhas em que cada conta tem 100.000 de perfil ativo, seu perfil ativo total 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 um máximo combinado de 5 milhões de registros (500.000 x 10). Isso significa que o senhor 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 pode 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 no Klaviyo, navegue até Content > Objects. 

Siga as etapas para criar e sincronizar uma fonte de dados para seu objeto personalizado. Quando essas etapas forem concluídas, selecione o botão Create custom object (Criar objeto personalizado ) para criar o objeto. 

A partir daí, o senhor pode criar um objeto do zero ou selecionar um modelo de objeto recomendado. Para criar um objeto do zero, selecione o botão Build your own (Criar seu próprio objeto).

A primeira parte do fluxo de trabalho de criação de objetos requer a definição das seguintes informações para o seu objeto:

• Nome do objeto
  Um nome para identificar seu objeto
• Descrição (opcional)
  Uma descrição dos dados que seu objeto representa
• dados source
  A fonte de dados para obter dados de objetos. Pelo menos 1 registro deve ser enviado para a Klaviyo usando a API de objeto personalizado para que ele apareça como uma opção no menu suspenso. 

Definir o ID do objeto

Depois de definir um nome para o objeto e escolher a fonte de dados, a próxima etapa é definir um ID de objeto e mapear as propriedades desejadas do objeto. Durante essa etapa, o senhor poderá visualizar os dados associados à fonte de dados que foram enviados à Klaviyo por meio da API de objeto personalizado.

A definição do ID do objeto é necessária para distinguir os registros de objetos uns dos outros. O senhor precisará especificar uma propriedade da fonte de dados a ser usada para o ID exclusivo do objeto. 

A identificação do objeto deve ser uma propriedade exclusiva da fonte de dados que possa ser utilizada para identificar instâncias específicas de um registro de objeto. Por exemplo, com um objeto cartão-presente, é possível utilizar algo como o código de desconto exclusivo como ID do objeto. Isso é exclusivo para cada instância da fonte de dados e existirá para cada registro de objeto. 

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

Enviar dados do objeto

Quando o senhor atualiza um registro de objeto existente, o objeto inteiro é substituído. Portanto, é fundamental enviar o objeto inteiro todas as vezes, mesmo que o senhor queira atualizar apenas um registro. 

Por exemplo, digamos que o senhor queira atualizar apenas 1 dos 5 registros de um objeto. Se o senhor enviar dados de atualização com o ID e apenas o 1 registro que deseja atualizar, os outros 4 registros serão definidos como nulos. Se um dos novos campos nulos tiver sido usado em 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.

Propriedades do objeto de mapa 

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

Entretanto, por esse motivo, recomendamos o envio de dados de objetos por meio da API de ingestão de objetos em formatos padronizados. Se o valor de uma propriedade específica não for conhecido, o senhor pode definir um valor nulo para ela.

Para mapear as propriedades do objeto:

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

Dados aninhados no mapeamento

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

Como exemplo, veja a fonte de dados abaixo. 

{
  "tipo": "dados-source-record",
  "atributos": {
    "registro": {
      "filho": {
        "id_filho": "d64b8458",
        "nome": {
          "first": "Theodore",
          "last": "Customer"
        },
        "data_de_nascimento": "2022-04-12",
        "E-mail": "jon.customer@klaviyo.com",
        "números de telefone": [
              "" ,
              "+13456789123"
        ]
      }
    }      
  }
}

Para acessar os dados sobre o primeiro nome de uma criança, o senhor pode inserir o seguinte caminho, já que os dados estão aninhados demais para serem acessados com a interface.

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

Adicionar relacionamento 

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

Os relacionamentos conectam seu objeto ao perfil relevante. Defina as seguintes informações para estabelecer um relacionamento: 

• Nome do relacionamento
  Defina um nome para seu relacionamento. Por exemplo, se o senhor tiver um objeto pet, talvez queira definir o nome do relacionamento como algo como "Pet owner" (Proprietário do pet). 
• Dados deorigem
  Selecione as propriedades de origem de dados que o senhor gostaria de associar a um perfil. 
• identificador de perfil
  Define o identificador do 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 propriedades e identificadores.

Confirmar mapeamentos e criar objetos

Quando terminar 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 é criado, e os dados começarão a ser sincronizados imediatamente. 

O senhor verá seu objeto listado na página Objects (Objetos ) no Klaviyo, juntamente com as seguintes informações: 

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

Estados de status de objetos personalizados

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

• Rascunho
  O objeto ainda é editável e não está publicado ou ativo .
• Publicação
  O objeto está criando registros de objetos personalizados a partir dos dados que o senhor enviou para a fonte de dados. Se o senhor tiver enviado alguns milhares de registros da fonte de dados, o objeto será publicado instantaneamente. Se tiver enviado alguns milhões de registros, a publicação poderá levar horas. Depois de concluído, o status será alterado para Active (Ativo).
• Ativo
  O objeto está publicado e ativo. Todos os registros de objetos personalizados foram criados de acordo com os dados enviados da sua fonte de dados. Quaisquer novos dados enviados para esse objeto gerarão registros de objetos personalizados adicionais vinculados ao seu perfil.

Objetos nas páginas de perfil

Os objetos relevantes também aparecerão em uma página de perfil para que o senhor possa visualizar os registros de objetos relacionados a um perfil. Para visualizar os registros de objetos, navegue até a guia Objects (Objetos ) em uma página de perfil. O senhor pode alternar entre os 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 View. Será exibido um painel lateral que contém o registro completo do objeto. 

atualização um objeto 

Se o senhor 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 valor nulo para essa propriedade, uma vez que esses dados não estão disponíveis, mas, no futuro, os objetos serão criados e atualizados com essa propriedade.

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

Para atualizar um objeto:

1. Clique em Content > Objects (Conteúdo Objetos ) na barra lateral do Klaviyo.
2. Selecione o nome do objeto que o senhor deseja editar. 
3. Clique em Next no canto superior direito.
4. Na seção de propriedades do objeto de mapa , clique em Add mapping (Adicionar mapeamento).

   Essa opção só estará disponível se o objeto tiver propriedades adicionais que possam ser adicionadas.

5. Na coluna dados source property (propriedade de origem de dados), selecione a propriedade de origem de dados que o senhor deseja incluir em seu objeto. 
6. Na coluna Mapped property (Propriedade mapeada ), digite o nome que o senhor deseja que a propriedade da fonte de dados tenha no objeto. 
7. Na coluna tipo de dados, selecione o tipo de dados apropriado de sua propriedade de origem de dados.

   As propriedades mapeadas recentemente não podem ser marcadas como necessárias.

   
8. Clique em Next (Avançar ) no canto superior direito. 
9. Clique em Next (Avançar ) no canto superior direito. O senhor não terá de fazer mudanças em seus relacionamentos.
10. Clique em Publicar alterações.

Depois de concluir esse processo, todos os registros da 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 Content > Objects (Conteúdo Objetos ) na barra lateral do Klaviyo.
2. No menu à direita de seu objeto, clique em Delete (Excluir). 
   
3. Clique em Delete novamente para confirmar a remoção do objeto. 
4. O objeto e todos os registros de objetos personalizados associados são excluídos. 

Se o senhor criar um novo objeto personalizado usando a fonte de dados de um objeto anterior, novos registros de objetos personalizados serão gerados usando os dados que já foram sincronizados. 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 

Como usar objetos personalizados no modelo

Como usar objetos personalizados no segmento

Como usar objetos personalizados no fluxo

Visão geral da API de objetos personalizados