Como funcionam a Contagem de Segmentos, os Públicos Estimados e a API de Segmentos

O que o segmento e a contagem de listas representam

As contagens de segmentos e listas na Klaviyo representam o número de perfis que atualmente atendem às condições desse segmento ou que estão presentes nessa lista no momento em que a contagem é calculada. Os segmentos dinâmicos são recalculados automaticamente à medida que as pessoas atendem ou não atendem mais às condições, enquanto as listas são coleções estáticas de perfis que você adiciona por meio de formulários, integrações ou importações.

Por que o gerador de campanha mostra um público estimado

Quando você seleciona uma lista ou segmento na configuração da campanha, a Klaviyo mostra Destinatários estimados em vez do tamanho bruto da lista ou do segmento. Essa estimativa aplica regras adicionais além da participação na lista ou no segmento, como:

• Status de supressão (por exemplo, perfis com inscrição cancelada ou devolvidos)
• Se um perfil pode receber marketing no canal selecionado
• Listas e segmentos que você exclui da campanha

Por causa desses filtros, o público estimado geralmente é menor do que o tamanho da lista ou do segmento que você vê na visualização Listas e segmentos. Suas configurações de agendamento determinam quando a Klaviyo seleciona os destinatários: logo após o agendamento ou uma vez antes do início do envio. Ignorações posteriores podem reduzir o número de mensagens realmente enviadas. Saiba como alterar quando os destinatários são determinados.

Com que frequência a contagem de segmentos é atualizada

As contagens de segmentos dinâmicos são atualizadas conforme as alterações de dados subjacentes, incluindo:

• Novos eventos (por exemplo, aberturas, cliques, pedidos) que fazem com que as pessoas se qualifiquem ou desqualifiquem
• Alterações na propriedade do perfil
• Atualizações e supressões de status de inscrição

A maioria dos segmentos com atividade é atualizada quase em tempo real, mas as alterações podem levar algum tempo para serem processadas. A contagem que você vê em Listas e segmentos pode ser diferente de:

• Público estimado no gerador de campanha, que responde pelas regras de elegibilidade de envio
• O número de mensagens realmente enviadas, depois que os destinatários são selecionados e as verificações de horário de envio são aplicadas

Saiba mais sobre como os segmentos são atualizados.

Como a supressão, o consentimento e o Smart Sending afetam as contagens

Mesmo que um perfil pertença à lista ou ao segmento escolhido, a Klaviyo não o enviará se:

• Eles são suprimidos para o canal, como um perfil de e-mail suprimido após um cancelar inscrição ou uma devolução.
• Eles não podem receber marketing nesse canal. SMS exige consentimento para SMS. Para e-mail, um perfil marcado como Nunca se inscreveu não é automaticamente excluído em toda conta; a elegibilidade depende das configurações de consentimento da sua conta e do status de supressão do perfil.
• Eles são excluídos pelo Smart Sending, quando ativado, porque outra mensagem de marketing foi enviada para eles no mesmo canal dentro da janela aplicável do Smart Sending.

A estimativa considera a elegibilidade do canal e as exclusões de público. O Smart Sending é verificado quando as mensagens são enviadas e pode reduzir ainda mais a contagem real de envios.

Obtendo contagens de segmentos com a API Segments

Você pode recuperar informações no nível do segmento, incluindo contagens, usando a API de Segmentos. Solicite uma contagem para um segmento individual; o ponto de extremidade que lista todos os segmentos não retorna contagens de perfil.

Use uma chave de API privada ou um token OAuth com permissão segments:read. Para recuperar uma contagem de segmento:

1. Se você precisar do ID do segmento, solicite GET /api/segments/ e encontre o segmento na resposta. Siga links.next se a resposta tiver mais páginas.
2. Solicitação GET /api/segments/{id}/?additional-fields[segment]=profile_count, substituindo {id} pelo ID do segmento.

Na resposta do segmento individual, procure por:

• data.id: o identificador do segmento, que você pode usar em outras chamadas de API. data.attributes.created fornece a data em que o segmento foi criado.
• data.attributes.profile_count: o número de perfis no segmento quando a contagem é lida. Esta é uma contagem de membros, não uma estimativa de destinatários da campanha.

Como a participação no segmento é dinâmica, as contagens retornadas pela API são um instantâneo de um ponto no tempo e podem mudar entre chamadas. Se data.attributes.is_processing for true, aguarde o processamento terminar antes de comparar as contagens.

Práticas recomendadas para sincronizar contagens com ferramentas externas

Se você sincronizar a contagem de segmentos em uma ferramenta de BI ou painel externo:

• Extraia contagens em uma programação consistente (por exemplo, diária ao mesmo tempo) para facilitar as comparações de tendências.
• Alinhe o fuso horário dos relatórios entre a Klaviyo e o sistema externo.
• Documente todos os filtros adicionais que você aplicar (por exemplo, remover perfis suprimidos) para que os usuários downstream saibam por que os números podem ser diferentes do que veem no aplicativo.

Ao reconciliar diferenças entre tamanhos de segmentos, públicos estimados e contagens de envio, compare sempre:

• A definição do público (condições de lista/segmento),
• As regras de elegibilidade de envio (supressão, consentimento, Smart Sending),
• O horário em que cada contagem foi feita.