Referência de condições do segmento – Klaviyo - Help Center - BR

O que você vai aprender

Saiba mais sobre as condições de segmento, incluindo como filtrar suas condições e muito mais. Ao criar segmentos na Klaviyo, as condições são os blocos de construção que você personaliza para incluir ou excluir determinados setores do seu público. Em resumo, os perfis só vão aparecer nos seus segmentos dinâmicos quando atenderem às condições específicas que você definir ao criar o segmento.

Está começando no Klaviyo e precisa de inspiração para segmentação? Confira nosso guia para criar segmentos. Para saber como combinar condições de segmento, confira nosso guia sobre E vs. OU.

Condições do segmento

Um único segmento pode ter no máximo 100 condições.

Ao criar um segmento, você pode incluir ou excluir pessoas com base nas seguintes condições:

O que alguém fez (ou não fez) Você pode escolher entre qualquer atividade rastreada pela Klaviyo — chamamos isso de eventos ou métricas. Para ver uma lista de todas as métricas rastreadas na sua conta, vá até Análises > Métricas na sua conta da Klaviyo.
Propriedades sobre alguém Você pode segmentar com base em atributos associados aos perfis na sua conta — propriedades personalizadas podem ser atribuídas por meio de uma integração ou você pode adicioná-las aos perfis manualmente.
Onde alguém está localizado Ao segmentar clientes nos EUA, UE, Austrália, Nova Zelândia ou Canadá, esta opção permite segmentar com base em um determinado raio de um CEP específico.

Para CEPs do Reino Unido, oferecemos suporte à filtragem por código outward, não por código inward nem por ambos os códigos outward e inward (geralmente separados por um espaço). Por exemplo, se o CEP completo de uma pessoa for "SW1W 0NY", apenas a primeira parte ("SW1W") vai funcionar para esses filtros.
Se alguém está ou não está na UE (GDPR) Essa opção é útil se você quiser excluir pessoas na UE de um determinado segmento se você não tiver coletado consentimento em conformidade com o GDPR. Essa condição de segmento não inclui pessoas localizadas no Reino Unido, então uma regra baseada em localização adicional deve ser adicionada à definição do segmento para estar em conformidade com a legislação GDPR do Reino Unido.
Se alguém está ou não está em uma lista Esta opção é ótima se você quiser combinar 2 ou mais listas ou criar um segmento de uma lista específica, o que é uma prática recomendada ao enviar campanhas.
Se alguém pode ou não receber marketing Escolha se os membros do segmento devem poder receber marketing em um canal específico (ou seja, e-mail, SMS ou push). Para garantir que sejam assinantes desse canal, clique em Adicionar filtro e selecione Porque pessoa > inscrever-se.
Análise preditiva sobre alguém A análise preditiva permite segmentar com base no valor da vida útil do cliente ou no gênero previsto, o que, por sua vez, pode ajudar você a identificar clientes que provavelmente se tornarão compradores recorrentes, que provavelmente não comprarão novamente e muito mais. Observe que você só verá a condição de valor da vida útil do cliente se atender aos critérios descritos neste artigo.

Nas seções a seguir, vamos analisar cada uma dessas opções com mais detalhes.

O que alguém fez ou não fez

Essa condição permite segmentar perfis com base em eventos no Klaviyo, que representam ações que os perfis realizaram. Se você navegar até Análises > Métricas, você verá toda a atividade que o Klaviyo rastreia por meio das suas diferentes integrações. Essas métricas estão disponíveis para segmentação usando a condição O que alguém fez (ou não fez).

Por exemplo, você pode encontrar todos os clientes que fizeram pelo menos 2 compras:

Você pode ajustar e filtrar os seguintes aspectos da métrica selecionada:

Frequência Depois de selecionar uma atividade, você pode segmentar com base na frequência com que (ou com que não) as pessoas realizaram a atividade. Os operadores permitidos são:
- pelo menos uma vez
- Zero vezes (não realizou esta ação no período selecionado)
- Igual a (é exatamente o número especificado)
- Não é igual a (não é exatamente o número especificado)
- É pelo menos (maior ou igual a)
- É maior que
- É menor que
- É no máximo (menor ou igual a)
Período Depois de escolher uma frequência, você também precisará selecionar um período durante o qual contaremos o número de eventos de cada pessoa. Esses cálculos se baseiam em UTC. As opções aqui são:
durante todo o período
Nos últimos (dentro dos últimos X dias, semanas ou meses)
Entre (entre 2 datas relativas, ou seja, entre 30 e 90 dias atrás)
Antes (antes de uma data específica)
Após (após uma data específica)
Entre datas (entre duas datas específicas) — observe que esse intervalo de datas incluirá as pessoas a partir da primeira data especificada até a data final.

Se você clicar no ícone de filtro, poderá refinar ainda mais os tipos de eventos incluídos. Todas as métricas têm um conjunto exclusivo de propriedades associadas a elas, e você pode aproveitar essas propriedades para ser mais específico sobre quem você captura no seu segmento.

Por exemplo, se você tiver uma métrica de Produto pedido que captura cada vez que alguém compra um produto, talvez você queira filtrar pela propriedade Nome da variante para encontrar pessoas que compraram uma variante específica de um produto.

Observe que a opção de filtro Receita só está disponível em segmentos e não é uma métrica que você pode exportar na sua conta pela guia Métricas no Klaviyo. A receita é baseada no valor do evento Pedido realizado ou de um evento equivalente sincronizado por meio das suas integrações.

O campo de pesquisa de valores nos dados de evento e de perfil pode exibir até 1.000 valores únicos. Se houver mais de 1.000 valores únicos para uma propriedade nos metadados do seu evento, ela talvez não apareça no menu suspenso do campo de texto. Além disso, os valores nos segmentos diferenciam maiúsculas de minúsculas. Por exemplo, um segmento de perfis com endereços de e-mail @Gmail.com teria resultados diferentes de um segmento de perfis com um endereço de e-mail @gmail.com.

No exemplo acima, se houver mais de 1.000 propriedades de Nome da variante (por exemplo, Chocolate, Baunilha, Chocolate com menta), talvez o valor desejado não apareça no campo de pesquisa. Se esse for o caso, basta digitar o valor completo da propriedade (ou seja, Chocolate, com distinção entre maiúsculas e minúsculas) e o segmento vai funcionar conforme o esperado.

Ao definir um filtro para uma condição de evento em um segmento, você também poderá selecionar um operador. As opções disponíveis dependem do tipo de dados, que é definido automaticamente para refletir os valores dos dados do evento. Tenha cuidado ao ajustar o campo Tipo, pois isso pode fazer com que os segmentos sejam avaliados de maneiras não intencionais se o tipo de dados errado for selecionado.

Se o seu segmento estiver retornando 0 perfis quando você acredita que deveria haver perfis incluídos, verifique se você selecionou o tipo de dados correto. Por exemplo, você pode ter o tipo de dados Lista selecionado quando, na verdade, os dados estão no formato Texto.

Para definir o tipo de dados de uma condição, selecione o ícone desejado no campo de operador da condição.
String Representado pelo ícone "T"
Número Representado pelo ícone "#".
Booleano Representado pelo ícone de setas para a esquerda e para a direita.
Lista Representada pelo ícone de lista com marcadores.

Ao configurar um filtro para uma condição de evento em um segmento, você pode selecionar entre os seguintes operadores com base no tipo de dado.

String

String é um tipo de dado que representa texto simples e permite os seguintes operadores.

É igual a (corresponde exatamente ao valor)
Não é igual (não corresponde exatamente ao valor) — observe que isso não vai incluir quem não tiver um valor definido. Por exemplo, se você criar um segmento de pessoas cujo país não é igual a Estados Unidos, isso só vai incluir quem tiver um valor de país definido como algo diferente de Estados Unidos, e não quem estiver sem o valor de país definido.
Contém (o valor contém a string especificada, se a propriedade for composta por texto. Se a propriedade for composta por uma lista, usar o operador Inclui qualquer um de vai pesquisar por itens da lista que correspondam exatamente ao valor da dimensão que você definiu)
Não contém (a propriedade não contém a string especificada) — observe que isso não incluirá aqueles que não têm um valor definido. Por exemplo, se você criar um segmento de pessoas cujo país não contém Estados Unidos, isso só vai incluir aquelas com um valor de país definido como algo diferente de Estados Unidos, não aquelas cujo valor de país não está definido.
Está em (está em um conjunto de valores)
Não está em (não está em um conjunto de valores)
Começa com (o valor começa com a string especificada)
Não começa com (o valor não começa com a string especificada)
Termina com (o valor termina com a string especificada)
Não termina com (o valor não termina com a string especificada)
Está definido (existe um valor para o evento)
Não está definido (o valor não existe para o evento)

Número

Número é um tipo de dados que representa um valor inteiro e permite os seguintes operadores.

É igual a
Não é igual a
É pelo menos (o valor é maior ou igual a)
É no máximo (o valor é menor ou igual a)
É maior que
É menor que

Data

Date é um tipo de dado que representa um valor de data ou hora e permite os seguintes operadores.

Está nos últimos (o valor está nas últimas X horas/dias/semanas, incluindo a data selecionada)
É pelo menos (o valor é pelo menos X horas/dias/semanas atrás, sem incluir a data selecionada)
Está entre (o valor está entre X e Y horas/dias/semanas atrás, incluindo a data de início, mas não a data de término)
Está nos próximos (o valor está nas próximas X horas/dias/semanas)
É anterior (o valor é anterior à data X, sem incluir a data selecionada)
É depois de (o valor é depois da data X, sem incluir a data selecionada)
Está entre datas (o valor está entre as datas X e Y, incluindo a data de início e a data de término)
O dia é hoje (o valor é a data de hoje)
O dia está nos próximos (o valor está nos próximos X dias)
O dia está nos últimos (o valor está nos últimos X dias)
O dia está neste mês (o valor está no mês atual)
O dia está no mês de (o valor está no mês X)

Saiba mais sobre segmentação com datas.

Booleano

Boolean é um tipo de dado que representa valores definidos como true ou false e permite os seguintes operadores.

É verdadeiro (o valor booleano está definido como verdadeiro)
É falso (o valor booleano está definido como false)

Lista

Lista é um tipo de dado que representa uma matriz de valores (por exemplo, ["Offer1", "Offer2"]). Observe que apenas listas simples podem ser segmentadas; listas complexas (ou seja, uma lista dentro de uma lista) não são compatíveis com filtros de segmento.

Inclui qualquer um de (a lista inclui qualquer um dos valores especificados). Por exemplo, Propriedades sobre alguém > CEP pode usar o operador "inclui qualquer um de" para que você selecione vários CEPs de uma vez eadicione em massa até 500 CEPs de uma vez.
Inclui todos os itens de (a lista inclui todos os valores especificados)
Contém o texto (todos os valores em uma lista que contêm este texto específico são incluídos. Por exemplo, se você usar o texto "jaqueta", ele vai pesquisar todos os valores que contêm essa palavra)
Não inclui nenhum(a) dos(as) (a lista não contém nenhum dos valores específicos)
Não inclui todos os (a lista não contém todos os valores especificados)
Não contém o texto (a lista não captura nenhum valor que contenha este texto específico)
Está vazio (a lista não tem nenhum valor)
Tem pelo menos um item (a lista tem pelo menos um valor definido)
Tem pelo menos (a lista tem pelo menos X valores definidos)
Tem no máximo (a lista tem no máximo X valores definidos)
Tem mais de (a lista tem mais de X valores definidos)
Tem menos de (a lista tem menos de X valores definidos)

No momento, apenas segmentos que usam os operadores Equals e Includes any of podem ser clonados entre contas.

Até outubro de 2024, a Klaviyo só oferecia suporte a Contém para tipos de lista. Esse operador agora se chama Inclui qualquer um de, para diferenciá-lo do novo operador Contém o texto.

Limitações

Ao criar segmentos usando propriedades do evento, apenas os seguintes tipos de operador são compatíveis:

Texto
Número
Booleano
Lista

Operadores baseados em data não têm suporte para propriedades de evento, mesmo que uma determinada propriedade de evento esteja formatada como uma data e hora válida.

Se você precisar segmentar com base em uma data relacionada a um evento, recomendamos:
Persistir a data como uma propriedade do perfil (por exemplo, via a API de eventos usando profile.data.attributes.properties)
Então, crie seu segmento usando essa propriedade de data do perfil, onde há suporte para operadores baseados em data.

Observação: essa solução alternativa é especialmente relevante para eventos personalizados em que você controla o esquema do evento e pode escolher quais datas manter no perfil.

Propriedades sobre uma pessoa

Essa condição permite que você filtre com base em Propriedades do perfil (ou seja, as informações que você coletou sobre seus contatos no Klaviyo). Quaisquer dados na seção Propriedades personalizadas de um perfil do Klaviyo estão disponíveis para segmentação usando a opção Propriedades sobre alguém.

Por padrão, você terá acesso às seguintes propriedades da Klaviyo e poderá usá-las para criar um segmento:

Cidade
País
E-mail
Ativo pela primeira vez
Nome
Origem inicial
Ativo pela última vez
Sobrenome
Empresa
Estado/Região
ID única
CEP
Número de telefone (permite o uso do filtro Código do país em )

À medida que você coleta informações adicionais sobre seus contatos (ou seja, propriedades personalizadas), você pode usar essas informações para criar segmentos.

Ao escolher CEP, o criador de segmentos usa por padrão o operador "inclui qualquer um de", que permite selecionar vários CEPs. Você pode selecionar até 500 CEPs no menu suspenso e clicar em "Adicionar CEP" para adicionar em massa até 500 CEPs de uma só vez. Veja mais em Como criar um segmento baseado em localização.

Outro exemplo é: se você coleta dados sobre preferências de produtos de assinantes da newsletter, você pode segmentar com base nas respostas deles.

Depois de selecionar uma Propriedades do perfil para segmentação, você também poderá selecionar um operador. As opções disponíveis dependerão de o tipo de dado da propriedade, que é atualizado automaticamente quando você escolhe uma propriedade para refletir os valores que essa propriedade contém. Tenha cuidado ao ajustar o campo Tipo, pois isso pode fazer com que os segmentos sejam avaliados de formas não intencionais se o tipo de dado errado for selecionado.

Abaixo estão os operadores para propriedades de string:
equivale a
não igual a
contém (a propriedade contém a string especificada se a propriedade for um texto; se a propriedade for uma lista, usar o operador "contém" vai procurar itens da lista que correspondam exatamente ao valor de dimensão que você definiu)
não contém (a propriedade não contém a string especificada) — observe que isso não incluirá quem tem um valor não definido. Por exemplo, se você criar um segmento de pessoas cujo país não contém Estados Unidos, isso só vai incluir aquelas com um valor de país definido como algo diferente de Estados Unidos, e não aquelas cujo valor de país não está definido.
está em (a propriedade está em um conjunto de valores)
não está em (a propriedade não está em um conjunto de valores)
começa com (a propriedade começa com a string especificada)
não começa com (a propriedade não começa com a string especificada)
termina com (a propriedade termina com a string especificada)
não termina com (a propriedade não termina com a string especificada)
está definido (a propriedade existe para o perfil)
não está definido (a propriedade não existe para o perfil)

Depois de escolher uma propriedade e um operador, a última parte é o valor da dimensão. Quando você clicar, esse campo de valor será preenchido com um menu suspenso que inclui todos os valores disponíveis com base na propriedade, no operador e no tipo de dados selecionados.

Se a propriedade que você selecionar contiver valores numéricos ou datas, ajuste o tipo de dados conforme apropriado. Ao fazer isso, você verá operadores específicos do tipo, e isso vai afetar os valores disponíveis para segmentação.

A seguir estão os tipos de dados disponíveis:
String: valor de string de texto simples.
Número: valor inteiro.
Data: valor de data/hora.
Booleano: valor verdadeiro ou falso.
Lista: matriz de valores (por exemplo, ["Offer1", "Offer2"]). Observe que apenas listas simples podem ser usadas para segmentação; listas complexas (ou seja, uma lista dentro de uma lista) não são aceitas nos filtros de segmento.

O campo de pesquisa de valores de propriedades nos dados de eventos e de perfis pode exibir até 1.000 valores exclusivos. Se houver mais de 1.000 valores exclusivos para uma Propriedades do perfil, talvez ela não apareça no menu suspenso do campo de texto.

No exemplo acima, se houver mais de 1.000 propriedades de Tipo de café (por exemplo, Grão inteiro, Moído fino, Moído grosso etc.), o valor que você quer talvez não apareça no menu suspenso do campo de pesquisa. Se for esse o caso, basta digitar o valor completo da propriedade (ou seja, Whole bean, com diferenciação entre maiúsculas e minúsculas) e seu segmento funcionará como esperado.

A proximidade de alguém a um local

Use códigos postais para filtrar um segmento pela localização listada no perfil de um destinatário. Isso permite que você envie informações específicas por região para pessoas que moram a uma distância definida de um local.

Someones proximity to a locations segment

Se você tem uma loja física ou um evento presencial, isso permite segmentar seus clientes e fãs da marca que talvez tenham interesse em participar.

Mesmo que você não tenha uma loja física, pode usar esse recursos para enviar informações sobre produtos específicos por região (ou seja, luvas em lugares frios durante o inverno) ou enviar promoções para uma determinada área. Além disso, isso permite que você use um formulário de registro para criar um pop-up que será exibido para uma região específica, permitindo que você personalize a experiência do destinatário no seu site.

Se alguém está ou não na UE (GDPR)

Essa condição pode ser usada para identificar pessoas na UE. Isso é útil se você quiser excluir esses contatos de um segmento específico para cumprir o GDPR.

If someone is within the EU

Se alguém está ou não em uma lista

Essa condição pode ser usada para segmentar se alguém é membro (ou não é membro) de uma lista específica.

Use este segmento se você quiser capturar uma seção transversal dessa lista. Por exemplo, o segmento a seguir vai identificar todo mundo da sua lista de newsletter dos Estados Unidos:

If someone is in a list segment

Ao segmentar com base em se alguém está ou não em uma lista, você pode filtrar com base em quando essa pessoa foi adicionada à lista:

nos últimos (dentro dos últimos X dias, semanas ou meses)
entre (duas datas relativas)
antes (de uma data específica)
após (uma data específica)
Entre datas (duas datas específicas) — observe que esse intervalo de datas incluirá pessoas a partir da primeira data especificada, mas não incluirá a data final. Como a última data não é realmente incluída no seu segmento, adicione um dia após a data final ao seu intervalo de tempo para incluir a data final desejada.

Se alguém está ou não suprimido

Em outubro de 2023, a condição Se alguém está ou não está suprimido para e-mail foi substituída pela condição Se alguém não pode ou pode receber marketing. Os segmentos foram atualizados automaticamente para usar as novas condições, e essa mudança não teve impacto na associação aos segmentos. Saiba mais sobre a transição para os novos critérios de segmento.

Se alguém está ou não autorizado a receber SMS

Em outubro de 2023, a condição Se alguém tem ou não consentimento para receber SMS foi substituída pela condição Se alguém não pode ou pode receber marketing. Os segmentos foram atualizados automaticamente para usar as novas condições, e essa mudança não teve impacto na participação no segmento.

Se alguém pode ou não receber marketing

Os segmentos são criados a partir de todos os perfis na sua conta, independentemente de quais canais de marketing eles estão ou não inscrevem-se. Quando você cria um segmento, é provável que ele contenha alguns perfis que estejam suprimidos para um determinado canal (por exemplo, e-mail), o que significa que você não pode entrar em contato com eles por esse canal.

Para ter uma visão precisa de quantos membros do segmento você pode contatar, use um conector AND para adicionar esta condição: Se alguém não pode ou pode receber marketing > pode receber > marketing por e-mail (ou marketing por SMS, ou Push para celular, ou marketing por push para celular).

Se você quiser que seu segmento contenha apenas perfis com consentimento (isto é, com opt-in) para um canal de marketing, adicione a condição acima. Em seguida, clique em Adicionar filtro e selecione porque pessoa > inscrever-se.

Subscribers segment

Para criar um segmento de perfil que se inscreveram por qualquer formulário do Klaviyo, adicione o filtro método de inscrição = formulário do Klaviyo e deixe o campo de ID do formulário em branco.

Análise preditiva sobre uma pessoa

Observe que você só verá todas as opções listadas abaixo se tiver:

Pelo menos 500 clientes fizeram um pedido. Isso não se refere a perfis com atividade, mas sim ao número de pessoas que realmente fizeram uma compra na sua empresa. Se esta seção estiver em um perfil, mas estiver em branco, isso significa que não temos dados suficientes sobre essa pessoa para fazer uma previsão.
Você tem uma integração de e-commerce (por exemplo, Shopify, BigCommerce, Magento) ou usa nossa API para enviar pedidos feitos.
Você tem pelo menos 180 dias de histórico de pedidos e tem pedidos nos últimos 90 dias.
Você tem pelo menos alguns clientes que fizeram 3 ou mais pedidos.

Isso pode ser usado se você quiser segmentar com base no valor da vida útil do cliente (valor da vida útil do cliente) ou no gênero previsto. Ao usar a condição Análise preditiva sobre alguém, você terá as seguintes opções:

Gênero previsto O algoritmo de previsão de gênero da Klaviyo usa o primeiro nome do cliente junto com dados do censo para prever o gênero: provavelmente masculino, provavelmente feminino ou incerto.
Valor da vida útil do cliente histórico Esta é a soma de todas as compras anteriores que uma pessoa fez.
Valor da vida útil do cliente previsto Esta é uma previsão de quantas compras um cliente fará no próximo ano. Não é uma previsão exata, então, em alguns casos, você pode ver um número impossível de pedidos previstos. Por exemplo, você pode ver 1,43 como o número de pedidos previstos para um cliente específico. Isso significa que esperamos que ele faça um ou dois pedidos, mas há uma chance de ele fazer mais ou menos. Essas expectativas começam a fazer sentido quando você agrupa vários clientes, porque você pode prever o número total de pedidos ou o gasto do grupo. Se tivermos cinco clientes com um número previsto de compras de 1,43, 0,25, 3,12, 0,78 e 2,97, podemos esperar aproximadamente 9 compras nesse grupo.
Valor total da vida útil do cliente Esta é a soma do valor da vida útil do cliente histórico e do valor da vida útil do cliente previsto de um cliente.
Número previsto de pedidos Este é o número previsto de pedidos que um cliente fará ao longo do próximo ano.
Tempo médio entre compras Esta é uma média do número de dias que se passaram entre cada uma das compras de um cliente.

Ao criar esses segmentos, você pode restringir o valor desejado a:
é pelo menos
é no máximo
especificado com base no gênero ou incerto

Como filtrar uma condição de segmento

Ao criar condições de segmento, você tem a oportunidade de usar filtros para refinar seu segmento. Você pode fazer isso escolhendo uma condição de segmento e, em seguida, selecionando o ícone de filtro.

filter icon .jpg

Em seguida, você verá um campo de entrada em que poderá selecionar uma propriedade para filtrar. Depois de escolher sua propriedade, selecione um valor para essa propriedade. Um menu suspenso também será preenchido aqui com valores disponíveis. As opções no menu suspenso são apenas aquelas que foram sincronizadas com sua conta da Klaviyo.

Você também pode incluir vários filtros em uma única condição de evento. Por exemplo, você pode incluir perfis que fizeram um pedido com um determinado número de itens, e um desses itens é de uma marca específica. Para incluir vários filtros em uma condição de evento, selecione o ícone de filtro novamente.

Operadores avançados (ou seja, operadores além de "igual a" e inclui qualquer um de") e segmentos que incluem condições com vários filtros não podem ser clonados entre contas no momento.

Você pode ter no máximo 10 filtros para cada condição de evento. Quando você atingir o número máximo de filtros, o ícone de filtro não ficará mais disponível para a condição de evento.

O Klaviyo só vai preencher valores automaticamente para produtos que já foram comprados. Se você estiver criando um segmento com base em um valor de propriedade que ainda não existe no Klaviyo — por exemplo, um produto novo na sua loja que ninguém comprou ainda — você pode copiar e colar o valor na caixa de valor. Se o valor de propriedade que você colar for idêntico ao valor que vai ser sincronizado com o Klaviyo no futuro, o segmento vai funcionar como esperado.

Embora o Klaviyo possa sincronizar muitos detalhes sobre uma determinada métrica, nem todas as propriedades sincronizadas ficam disponíveis para segmentação. Para fins de gerenciamento de dados, apenas os detalhes principais de um evento são sincronizados como propriedades de nível superior, e você só pode segmentar essas propriedades de nível superior.

Se você visualizar os dados brutos que a Klaviyo sincroniza para um evento, você verá pontos de dados importantes do evento. Para um evento Placed Order, por exemplo, você pode ver as seguintes propriedades de nível superior:

Valor
Coleções / Categorias
Contagem de itens
Itens
Nome da fonte

Você verá um array rotulado como "Extra" ou "Details." Embora os dados em uma matriz "Extra" ou "Details" estejam disponíveis para inserir em um modelo de e-mail, você não pode segmentar com base em propriedades aninhadas nessa matriz.

Integrações personalizadas e segmentação

Se você estiver criando sua própria integração personalizada e decidindo como estruturar os dados que está enviando para a Klaviyo, garanta que todas as Propriedades do perfil que você quer usar na segmentação sejam enviadas como propriedades de nível superior (e não aninhadas).

Por exemplo, se você criar uma métrica Placed Order em que um evento será rastreado sempre que alguém concluir uma compra no seu site, talvez você queira filtrar eventos com base em qual(is) item(ns) a pessoa comprou.

Para fazer isso, é preciso ter uma matriz "ItemNames" de nível superior que inclua todos os nomes dos produtos comprados — isso seria além de uma matriz aninhada com detalhes de cada item. A seguir, você pode ver a matriz ItemNames no payload deste evento Pedido feito, além da matriz Items, que contém informações detalhadas sobre cada produto:

{
  "token" : "API_KEY",
  "event" : "Placed Order",
  "customer_properties" : {
    "$email" : "john.smith@gmail.com",
    "$first_name" : "John",
    "$last_name" : "Smith"
  },
  "$event_id" : "1234",
  "$value" : 29.98,
  "Categories" : ["Fiction", "Classics", "Children"],
  "ItemNames" : ["Winnie the Pooh", "A Tale of Two Cities"],
  "Brands" : ["Kids Books", "Harcourt Classics"],
  "Items" : [
    {
      "SKU" : "WINNIEPOOH",
      "Name" : "Winnie the Pooh",
      "Quantity" : 1,
      "ItemPrice" : 9.99,
      "RowTotal" : 9.99,
      "ProductURL" : "http://www.example.com/path/to/product",
      "ImageURL" : "http://www.example.com/path/to/product/image.png",
      "Categories" : ["Fiction", "Children"],
      "Brand" : "Kids Books"
      },
    {
      "SKU" : "TALEOFTWO",
      "Name" : "A Tale of Two Cities",
      "Quantity" : 1,
      "ItemPrice" : 19.99,
      "RowTotal" : 19.99,
      "ProductURL" : "http://www.example.com/path/to/product2",
      "ImageURL" : "http://www.example.com/path/to/product/image2.png",
      "Categories" : ["Fiction", "Classics"],
      "Brand" : "Harcourt Classics"
    }
  ],
  "time" : 1387302423
}

Para mais informações sobre integrações personalizadas, confira nosso artigo sobre importar manualmente dados históricos de eventos.