Como adicionar um feed da Web personalizado em um e-mail

O que você vai aprender

Saiba como adicionar e usar um feed da Web personalizado em um e-mail. Um feed da Web personalizado permite que o senhor preencha dinamicamente um feed de dados de um URL externo em um e-mail do Klaviyo. Antes de enviar um e-mail, o Klaviyo faz uma solicitação HTTP para o URL e obtém os dados. O conteúdo do feed da Web fica então disponível para uso em seu e-mail.

O poder dos feeds da Web é que eles permitem que o usuário use um único modelo e extraia o conteúdo dinamicamente, sendo necessário apenas manter o feed atualizado e a Klaviyo garantirá que o conteúdo novo do seu feed seja preenchido em cada envio.

Este artigo abordará a adição e o uso de um feed da Web personalizado em campanhas e fluxos.

Antes de começar

A primeira etapa para adicionar conteúdo externo dinâmico a qualquer e-mail no Klaviyo é criar sua fonte de feed da Web. Seu feed deve: 

• Estar hospedado em um URL acessível no formato JSON ou XML
• Ter 3,3 MB ou menos
• Não usar um URL de redirecionamento 

O Klaviyo fará uma solicitação HTTP para o URL especificado e buscará os dados do feed. Como os e-mails de fluxo são enviados continuamente, a Klaviyo manterá o conteúdo do seu feed atualizado consultando periodicamente o URL do feed para obter conteúdo atualizado em uma das seguintes programações: 

• Atualização de 15 minutos
  O Klaviyo tentará atualizar seu feed a cada 15 minutos. Para isso, seu feed deve ser carregado em cinco segundos e retornar com uma resposta bem-sucedida.

• Atualização noturna
  Se o seu feed demorar mais de cinco segundos para retornar, após três horas de tentativas, começaremos a tentar atualizar seu feed à noite. Para atualizações noturnas contínuas, seu feed deve ser carregado em menos de 30 segundos. 

Se não conseguirmos carregar seu feed em 30 segundos por três noites seguidas, o senhor não poderá usar esse feed em seus e-mails. Os e-mails de fluxo que dependem desse feed deixarão de ser enviados, e os e-mails de campanha e de fluxo não serão enviados até que o feed seja removido ou o problema pendente com o feed seja resolvido.

Quando consultarmos seu feed, se obtivermos uma resposta de erro, não poderemos acessar o conteúdo do feed. Seguiremos o mesmo padrão acima e tentaremos novamente por até três dias. Nesse meio tempo, os e-mails não serão enviados.

Se estivermos com problemas para acessar seu feed da Web, o senhor receberá notificações no aplicativo e por e-mail. Uma etapa fácil de solução de problemas é verificar novamente os requisitos de alimentação e certificar-se de que eles se encaixam nos parâmetros descritos acima. 

Se o senhor fizer alterações em um feed - por exemplo, reduzir o tamanho para acelerar o tempo de upload ou corrigir um problema que esteja causando uma resposta de erro - e quiser que o Klaviyo tente fazer uma nova atualização, navegue até o feed na guia Data Feeds e clique em Update Data Feed. Testaremos e revalidaremos seu feed. Se o seu feed for válido e retornar uma resposta em tempo hábil, voltaremos a tentar manter seu conteúdo atualizado. Essa é uma boa etapa de solução de problemas a ser tentada se o senhor estiver tendo problemas para acessar o feed da Web, mesmo que não tenha feito alterações.

Filtros do Django

Apoiamos o uso de filtros Django para as variáveis que o senhor insere. Abaixo estão alguns filtros comumente usados, e o senhor pode saber mais em nosso guia sobre o uso de filtros para personalizar variáveis e o Glossário de filtros de variáveis.

Limitar o resumo da postagem a um número X de palavras

Se quiser incluir um breve resumo de uma postagem de blog sob o título da postagem (e seu feed fornecer esse texto de resumo), o senhor pode usar o filtro Truncate.

Para limitar o resumo de um artigo a 250 caracteres, por exemplo, o senhor pode usar:

{{ item.summary|truncatechars:250 }}

Adicionar um feed da Web personalizado

Configure seu feed

1. Clique no nome de sua empresa no canto inferior esquerdo do Klaviyo.
2. Clique em Settings.
3. Clique em Outro.
   
4. Clique em Web feeds.
5. Clique em Add Web Feed.
   
6. Preencha os campos de feed da Web da seguinte forma:
   • Nome do feed
     Posteriormente, o senhor usará esse identificador em seu modelo para acessar o conteúdo do feed. Dê ao seu feed um nome curto e descritivo. Recomendamos nomear os feeds em letras maiúsculas (por exemplo, "MyDataFeed") ou em letras maiúsculas com espaços substituídos por sublinhados (por exemplo, "MY_DATA_FEED"). Não são permitidos espaços nos nomes dos feeds. 
   • URL do feed
     O endpoint que o Klaviyo usa para buscar o conteúdo do feed (ou seja, o URL do feed JSON ou XML configurado anteriormente). Se o seu feed contiver informações privadas, é altamente recomendável usar um URL HTTPS e incluir um parâmetro de consulta nonce para proteger o feed.
   • Método de solicitação
     Especifique o método HTTP que será usado para solicitar seu feed. Se o senhor não tiver certeza de qual escolher, selecione GET. 
   • Tipo de conteúdo
     O formato do feed (JSON ou XML). Recomendamos o uso de JSON, se possível. Para feeds XML, o feed será convertido em JSON.
7. Depois de preencher todos os campos, clique em Add web feed (Adicionar feed da Web). Tentaremos consultar o URL do feed e validar se o feed está funcionando corretamente. Se encontrarmos um erro, o senhor verá uma mensagem de erro e não poderá salvar esse novo feed até que o problema seja resolvido.
   • Quer experimentar, mas não tem seu próprio URL de feed da Web? Use o nosso. Copie o seguinte URL da Central de Ajuda do Klaviyo na caixa Feed URL e experimente-o em sua própria conta do Klaviyo:

     https://help.klaviyo.com/api/v2/help_center/en-us/articles.json

8. O Klaviyo valida seu feed e mostra os possíveis erros. Depois de validado, o senhor verá seu feed em Klaviyo e ele estará pronto para ser usado no e-mail.
   

Visualize seu feed

É útil visualizar um feed da Web antes de adicioná-lo a um e-mail. Para visualizar um feed:

1. Na página de feeds da Web, localize seu feed. 
2. Clique nos três pontos e selecione Edit (Editar). 
   
3. Na página de detalhes do feed, clique em Preview (Visualizar). 

Ao visualizar seu feed, o senhor verá o conteúdo do feed ou uma mensagem de erro se não for possível carregar o feed. 

Se seu feed for uma matriz JSON, analisaremos automaticamente e mostraremos cada linha individualmente. Se for outra coisa, provavelmente um dicionário JSON, mostraremos o dicionário inteiro.

Se estiver desenvolvendo ativamente seu feed, use o botão Refresh (Atualizar ) para obter a versão mais recente do feed. A página de visualização de um feed mostra o feed inteiro. Se seu feed for grande, pode levar vários segundos para exibir o conteúdo. Lembre-se de que se o seu feed demorar mais de 30 segundos para ser consultado, isso afetará o desempenho de todos os e-mails que dependem desse feed.

Agora que o senhor adicionou um feed da Web e visualizou seu conteúdo, pode usá-lo em um e-mail.

Use um feed da Web em um e-mail

Para campanhas, o Klaviyo buscará cada feed uma vez por envio e armazenará o conteúdo retornado. Mesmo que o senhor esteja enviando para milhares de destinatários, o Klaviyo não fará milhares de solicitações aos seus servidores.

Preencher o conteúdo do feed em um modelo

Em nosso exemplo de feed da Web da seção anterior, temos uma matriz de artigos em que cada entrada inclui um nome, URL, ID do artigo e muito mais. Depois que um feed é adicionado a um e-mail, ele fica disponível por meio da variável de feeds:

{{ feeds }}

Por exemplo, para o feed JSON acima, agora podemos fazer referência ou gerar o conteúdo do feed de artigos incluindo essa sintaxe em nosso modelo:

{{ feeds.Klaviyo_Help_Center }}

Vamos executar um exemplo em que iteramos sobre todas as entradas da matriz, exibindo determinadas variáveis. Vamos usar o feed do Klaviyo Blog como exemplo e iterar sobre as imagens.

1. Arraste um novo bloco de texto para seu e-mail e coloque-o onde deseja que o feed da Web seja preenchido.
2. Ative o recurso de repetição de bloco/conteúdo: clique na guia Display Options (Opções de exibição ) do bloco de texto e, em seguida, clique em Create Repeat Rules (Criar regras de repetição).
3. No campo Repeat For (Repetir para ), insira feeds.YOUR_FEED_NAME, seguido do nome da(s) variável(eis) que contém o array que o senhor deseja iterar.
   • Em nosso exemplo, como estamos iterando também o valor "articles", repetiremos para: feeds.Klaviyo_Help_Center.articles.
4. Seus dados podem estar aninhados em uma série de variáveis. Por exemplo, seu feed pode ser estruturado da seguinte forma: 

   rss: {
            ..... 
            channel: { 
                    ..... 
                        item: { 
                                .....}}}

   Nesse caso, o senhor usaria feeds.YOUR_FEED_NAME.rss.channel.item como sua repetição para.

5. Se o senhor quiser que esse bloco itere apenas sobre um determinado número de entradas, use o filtro "slice". Para usar esse filtro, ajuste o valor Repeat For adicionando o filtro ao final:  feeds.Klaviyo_Help_Center.articles|slice:':3'
   Neste exemplo, |slice:':3' fará com que apenas as três primeiras entradas sejam exibidas. 
6. No campo Item Alias, insira: item
7. Depois de configurar o recurso Repeat Block/Content Repeat (Repetição de bloco/conteúdo ), o senhor pode inserir variáveis usando o alias "item".
8. Para identificar e adicionar variáveis, abra a visualização do seu feed da Web e faça referência à forma como os dados estão estruturados. Qualquer dado aninhado na matriz usada no campo Repetir para pode ser usado como uma variável.
   Nesse exemplo, todos os dados mostrados na matriz de artigos estão disponíveis para uso em um e-mail:
   
9. Para dados de primeiro nível, basta adicionar item antes do nome da variável mostrada em seus dados. Por exemplo, use {{ item.title }} para exibir o título de um artigo ou {{ item.url }} para exibir o URL de um artigo. 
10. Para acessar os dados aninhados nas variáveis de primeiro nível, use a notação de ponto (por exemplo, {{ item.images.thumbnail_url }}). Para saber mais sobre notações de ponto e variáveis de modelo, consulte nosso guia de tags de modelo e sintaxe de variáveis. 
11. Ao visualizar o modelo, o senhor notará que o recurso Repetir bloco/repetição de conteúdo permitirá que esse bloco de texto simples itere automaticamente em todas as entradas do feed. Somente as variáveis que o senhor especificar no bloco de texto serão exibidas para cada entrada.
12. Se estiver inserindo uma imagem, observe que o senhor precisará editar o campo Código-fonte do bloco de texto e conter a imagem em uma tag <img src>.
    

O senhor adicionou um feed da Web personalizado ao seu e-mail e agora pode preencher dinamicamente um feed de dados do seu URL externo. 

Teste ou valide seu feed

Se o senhor receber um e-mail ou uma notificação no aplicativo informando que estamos com problemas para acessar seu feed da Web:

1. Navegue até seu feed e clique no botão Atualizar feed.
2. Após a conclusão da validação, há dois tipos de mensagens de erro que o senhor poderá ver:
   • Resposta inválida
     Se recebermos uma resposta de erro ao tentar consultar o conteúdo do seu feed, informaremos ao senhor o código de status do erro. O senhor precisará resolver o problema que está causando essa resposta de erro antes que o feed possa ser usado com êxito em qualquer e-mail.
   • Problema de desempenho
     Se não obtivermos uma resposta do seu feed em 30 segundos, isso causará atrasos no envio. Embora o senhor possa ter conseguido salvar o feed historicamente, para reduzir o risco de atrasos no envio, será necessário resolver o problema de desempenho do feed antes de revalidá-lo e salvá-lo com êxito.

Em ambos os casos, se o senhor usar um feed problemático em um envio, isso levará a atrasos no envio ou seu e-mail poderá ser cancelado. Para os fluxos, também é provável que os e-mails não estejam sendo enviados.

Recomendamos que o senhor remova um feed problemático de todos os e-mails enquanto resolve os problemas pendentes para evitar a interrupção do envio.

Recursos adicionais

• Solucionar problemas com o feed da web do Instagram em e-mails
• Como usar feeds e recomendações de produtos