Envie para Klaviyo os produtos
que valem a pena mostrar.

A Klaviyo é uma plataforma de automação de marketing por e-mail e SMS criada para marcas de e-commerce. Ela funciona sobre os dados de clientes e de produtos do lojista para alimentar fluxos personalizados, como séries de boas-vindas, lembretes de carrinho abandonado, alertas de produto de volta ao estoque e notificações de queda de preço. As integrações nativas da própria Klaviyo cobrem plataformas como Shopify, WooCommerce, BigCommerce, Magento, PrestaShop, Salesforce Commerce Cloud, Spree, Square, Wix, Mi9 e Shift4Shop. Para qualquer outra plataforma, ou para lojistas que querem um controle mais rigoroso sobre quais dados chegam à Klaviyo, a plataforma recebe um catálogo de produtos por meio de um feed de catálogo personalizado ou da Catalogs API, e é aqui que entra a Feedance.

Os mecanismos de recomendação e automação da Klaviyo só funcionam se tiverem uma visão atualizada do seu catálogo. Depois que um catálogo é sincronizado, a Klaviyo combina seus dados de produtos com o comportamento no site e nos e-mails (produtos visualizados, eventos de adição ao carrinho, eventos de início de checkout e histórico de compras) para criar blocos de recomendação personalizados, disparar notificações de volta ao estoque quando o estoque é reposto e preencher e-mails de carrinho abandonado e de navegação abandonada com os produtos exatos que o comprador viu. A Klaviyo observa que produtos sem dados essenciais, como uma imagem, são excluídos automaticamente das recomendações, e que itens já comprados ou esgotados são filtrados dos blocos de sugestões; portanto, a completude e a precisão do feed determinam diretamente o desempenho desses fluxos.

Depois que um catálogo personalizado é sincronizado, a Klaviyo permite que os profissionais de marketing arrastem um bloco de produtos para um e-mail de fluxo ou de campanha e o preencham dinamicamente, sem escrever HTML, já que a própria documentação da Klaviyo observa que "os blocos de produtos não suportam nenhum HTML personalizado". Esses blocos podem trazer produtos visualizados recentemente (com base na métrica Viewed Product), itens semelhantes aos que o cliente visualizou ou pediu, produtos adicionados ao carrinho (a partir dos eventos Added to Cart ou Checkout Started) ou as clássicas listas de mais vendidos e listas estáticas. Para casos de uso mais avançados, como um mecanismo de recomendação proprietário, a Klaviyo também suporta tags de consulta ao catálogo (catalog lookup tags) que referenciam itens específicos pelo ID exclusivo dentro dos templates. Tudo isso depende de o feed de catálogo trazer registros de itens limpos e completos, com os identificadores corretos.

A Klaviyo oferece dois caminhos para sincronizar um catálogo externo: um feed de catálogo personalizado hospedado ou a integração direta pela Catalogs API.

Para um feed hospedado, a Klaviyo aceita JSON ou XML - CSV não é suportado. O feed precisa estar acessível publicamente via HTTPS, e a Klaviyo o busca em uma programação fixa, e não sob demanda. O guia da Klaviyo é explícito: os dados do feed devem ter "apenas um nível de profundidade, sem JSON ou XML aninhado" (os feeds do Google Merchant são a única exceção documentada), o primeiro item do feed deve conter todos os campos que você pretende mapear para que a Klaviyo detecte o esquema, e nenhum campo obrigatório deve ficar em branco - a Klaviyo recomenda usar "0" para números indisponíveis e "n/a" para textos indisponíveis, em vez de omitir o campo. Os arquivos de feed podem ter até 100MB, embora a Klaviyo recomende ficar abaixo de 50MB para um processamento confiável, e catálogos maiores podem ser divididos em vários arquivos que alimentam um único catálogo.

Como alternativa, sistemas que precisam de atualizações em tempo real ou orientadas por eventos podem enviar itens diretamente pela Catalogs API da Klaviyo, que usa um formato de ID de recurso {integration_type}:::{catalog_type}:::{external_id} - por exemplo, $custom:::$default:::3829918373-TShirt-1. Atualmente, a Klaviyo só suporta o tipo de integração $custom combinado com o tipo de catálogo $default.

A Feedance gera o feed de catálogo hospedado em JSON ou XML que a Klaviyo espera, mapeado campo a campo para o esquema da Klaviyo, para que você não precise montar manualmente um feed plano de um único nível nem manter uma integração de API personalizada.

1. Na Feedance, crie um novo feed e selecione a Klaviyo como template de destino.
2. Mapeie seus dados de produtos para os campos obrigatórios da Klaviyo ($id, $title, $description, $link, $image_link) e adicione os campos opcionais que você quer usar, como $price, $inventory_quantity, $inventory_policy e categories.
3. Publique o feed para obter da Feedance uma URL de feed pública e hospedada em HTTPS.
4. Na Klaviyo, acesse Content > Products > Manage Custom Catalog Sources, clique em Add new source e cole a URL do feed da Feedance.
5. Configure o mapeamento de campos na página Custom Sources da Klaviyo para confirmar que cada atributo está alinhado corretamente e, em seguida, entre em contato com o suporte da Klaviyo informando os nomes das métricas relevantes e das propriedades de ID do item, para que a equipe deles finalize o catálogo para produção, como o próprio fluxo de configuração da Klaviyo exige.
6. Depois que a Klaviyo confirmar que o catálogo está ativo, monitore a primeira sincronização na Feedance e na Klaviyo para identificar eventuais problemas de mapeamento antes que os blocos de recomendação ou os fluxos de Back in Stock entrem no ar.

A Klaviyo busca os feeds de catálogo personalizados em um ciclo fixo de 6 horas. Se o seu feed estiver atrás de uma camada de cache, a documentação da Klaviyo alerta que você deve desativar o cache ou atualizá-lo manualmente quando os dados de origem mudarem; caso contrário, a Klaviyo continuará buscando dados antigos em cache mesmo depois da atualização da sua fonte. Além da sincronização do feed em si, os modelos de recomendação da Klaviyo precisam do seu próprio tempo: a plataforma informa que normalmente leva de 2 dias a uma semana para que seus sistemas sejam treinados com um novo catálogo, e que os modelos de recomendação geralmente são retreinados a cada 2 a 7 dias, dependendo do uso. Com a Feedance atualizando seu feed de forma confiável no ciclo de 6 horas da Klaviyo, as alterações de preço, estoque e novos produtos chegam a esse ciclo de treinamento tão rápido quanto a própria arquitetura da Klaviyo permite.

A documentação de sincronização e de solução de problemas da Klaviyo aponta várias causas recorrentes de falhas na sincronização do catálogo:

• Feed inacessível: a Klaviyo não consegue acessar a URL de origem, geralmente porque ela está protegida por senha ou bloqueada por alguma camada de segurança.
• Dados antigos em cache: uma camada de cache na frente da URL do feed entrega à Klaviyo uma versão antiga do arquivo, então as atualizações nunca aparecem até que o cache seja limpo ou atualizado.
• Estruturas de dados aninhadas: o parser da Klaviyo espera dados com "apenas um nível de profundidade", então JSON ou XML aninhados (fora da exceção dos feeds do Google Merchant) não serão mapeados corretamente.
• Primeiro item incompleto: como a Klaviyo usa o primeiro item do feed para detectar o esquema, um item sem campos que aparecem mais adiante no arquivo pode fazer com que esses campos sejam descartados para todo o catálogo.
• Identificadores duplicados ou ausentes: a Klaviyo tem um artigo de solução de problemas dedicado a erros de identificadores duplicados ou ausentes e, do lado da Catalogs API, tentar criar um item com um external_id que já existe retorna um 409 Conflict; as falhas em jobs em massa listam o campo específico e o motivo em um array de erros na resposta da API.
• Imagens ausentes: itens sem URL de imagem são excluídos do mecanismo de recomendação da Klaviyo, mesmo que o restante do registro seja válido.

Mantenha o ID do item estável em todas as sincronizações - a Klaviyo associa os itens por esse valor, então um ID que muda faz com que a Klaviyo trate um produto existente como totalmente novo e zere todo o histórico de recomendações e de estoque acumulado para ele. Preencha todos os campos opcionais que a Klaviyo pode usar na automação, especialmente $price e $inventory_quantity, já que os dados de estoque são necessários para ativar os fluxos de Back in Stock e os dados de preço alimentam as campanhas de queda de preço. Garanta que todo item tenha uma URL de imagem HTTPS válida, já que a Klaviyo remove silenciosamente dos blocos de recomendação os produtos sem imagem, em vez de gerar um erro. Se você gerencia mais de aproximadamente 50MB de dados de catálogo, divida-os em vários arquivos de feed apontados para o mesmo catálogo em vez de enviar um único arquivo grande demais e, se o seu catálogo se aproximar dos limites documentados pela Klaviyo de 250.000 itens, 500.000 variantes ou 2.500 categorias, ou se o seu feed for passar de 1 milhão de itens, planeje entrar em contato com o suporte da Klaviyo antes da configuração, conforme a orientação deles.

A Klaviyo aceita feeds em CSV?
Não. A sincronização de feeds de catálogo personalizados da Klaviyo aceita apenas JSON ou XML; CSV não é um formato suportado.

Qual é a diferença entre um feed de catálogo personalizado e a Catalogs API?
Um feed de catálogo personalizado é um arquivo hospedado que a Klaviyo busca em sua própria programação de 6 horas. A Catalogs API permite enviar diretamente criações, atualizações e exclusões de itens, o que é adequado para lojistas que precisam de atualizações mais rápidas ou orientadas por eventos do que um feed consultado periodicamente pode oferecer.

Por que meu catálogo não está sendo atualizado na Klaviyo?
As causas mais comuns documentadas pela Klaviyo são uma camada de cache entregando dados antigos, uma URL de feed que ficou inacessível ou protegida, ou uma estrutura de feed malformada/aninhada que não atende ao requisito de um único nível de profundidade da Klaviyo.

Do que preciso no meu feed para ativar os alertas de Back in Stock?
O guia de Back in Stock da Klaviyo exige o campo $inventory_quantity em todos os itens do seu feed de catálogo personalizado; sem ele, a Klaviyo não tem nenhum sinal de estoque para disparar uma notificação de reposição.

Posso usar HTML personalizado nos blocos de recomendação de produtos da Klaviyo?
Não. A documentação da Klaviyo informa que os blocos de produtos não suportam HTML personalizado; formatações avançadas exigem usar a opção Source em um bloco de texto ou as tags de consulta ao catálogo.

A Klaviyo é uma plataforma de e-mail marketing e automação que ajuda as empresas a segmentar e engajar seus clientes de forma eficaz. Ela foi fundada em 2012, o que a torna uma plataforma relativamente jovem, mas em rápido crescimento no mercado. A Klaviyo tem sede em Boston, Massachusetts, nos Estados Unidos.

A plataforma permite que as empresas criem e gerenciem suas campanhas de e-mail marketing, com foco em comunicação personalizada e segmentação. Ela oferece uma ampla variedade de recursos, como templates de e-mail, criadores de campanhas com arrastar e soltar, rastreamento de e-mails, segmentação avançada, testes A/B, fluxos automatizados e análises.

Um dos principais pontos fortes da Klaviyo é a capacidade de se integrar a diversas plataformas de e-commerce, incluindo Shopify, Magento, BigCommerce, WooCommerce e outras. Essa integração permite que as empresas sincronizem os dados dos clientes de forma integrada e os usem para alimentar campanhas de e-mail segmentadas e personalizadas.

A Klaviyo também oferece recursos robustos de análise e relatórios, permitindo que as empresas acompanhem métricas de engajamento, taxas de conversão, receita gerada e outros indicadores-chave de desempenho. Essa abordagem orientada por dados ajuda as empresas a entender a eficácia dos seus esforços de e-mail marketing e a tomar decisões informadas de otimização.

Além do e-mail marketing, a Klaviyo oferece outros canais de engajamento com o cliente, como marketing por SMS e recursos de rastreamento na web. Essa abordagem multicanal permite que as empresas alcancem seus clientes em vários pontos de contato, melhorando a experiência geral do cliente.

O sucesso da plataforma pode ser atribuído à sua interface fácil de usar, aos seus poderosos recursos de automação e ao foco em estratégias de marketing orientadas por dados. A Klaviyo aproveita os dados de comportamento e o histórico de compras dos clientes para enviar e-mails segmentados, criando experiências personalizadas que impulsionam o engajamento, as conversões e, em última análise, o crescimento do negócio.

De modo geral, a Klaviyo é uma plataforma líder de e-mail marketing que permite às empresas criar campanhas personalizadas, segmentadas e automatizadas. Com sede em Boston, Massachusetts, ela rapidamente ganhou popularidade e se tornou uma solução confiável para empresas que querem otimizar seus esforços de e-mail marketing.