Come aggiungere un feed web personalizzato in un'email

Imparerai

Scopra come aggiungere e utilizzare un feed web personalizzato all'interno di un'e-mail. Un feed web personalizzato le permette di popolare dinamicamente un feed di dati da un URL esterno all'interno di un'e-mail di Klaviyo. Prima di inviare un'e-mail, Klaviyo effettua una richiesta HTTP all'URL e recupera i dati. Il contenuto del feed web è quindi disponibile per essere utilizzato nella sua e-mail.

Il potere dei feed web consiste nel fatto che le consentono di utilizzare un unico modello e di inserire contenuti in modo dinamico; deve solo mantenere il feed aggiornato e Klaviyo farà in modo che i contenuti freschi del suo feed vengano inseriti in ogni invio.

Questo articolo illustra l'aggiunta e l'utilizzo di un feed web personalizzato nelle campagne e nei flussi.

Prima di iniziare

Il primo passo per aggiungere contenuti esterni dinamici a qualsiasi e-mail in Klaviyo è la creazione della fonte del feed web. Il suo mangime deve: 

• Deve essere ospitato in un URL accessibile, in formato JSON o XML.
• Essere di 3,3 MB o più piccolo
• Non utilizzare un URL di reindirizzamento 

Klaviyo effettuerà una richiesta HTTP all'URL specificato e recupererà i dati del suo feed. Dato che le e-mail di flusso vengono inviate continuamente, Klaviyo manterrà il contenuto del suo feed aggiornato interrogando periodicamente il suo URL di feed per ottenere contenuti aggiornati secondo uno dei seguenti orari: 

• Aggiornamento di 15 minuti
  Klaviyo cercherà di aggiornare il suo feed ogni 15 minuti. Per raggiungere questo obiettivo, il suo feed deve caricarsi entro cinque secondi e restituire una risposta di successo.

• Aggiornamento notturno
  Se il suo feed impiega più di cinque secondi per tornare, dopo tre ore di tentativi, inizieremo a cercare di aggiornare il suo feed di notte. Per i continui aggiornamenti notturni, il suo feed deve caricarsi in meno di 30 secondi. 

Se non riusciamo a caricare il suo feed entro 30 secondi per tre notti consecutive, non potrà utilizzare questo feed nelle sue e-mail. Le email di flusso che si basano su questo feed smetteranno di essere inviate e le email di campagna e di flusso non saranno inviate fino a quando il feed non sarà rimosso o il problema in sospeso con il suo feed non sarà risolto.

Quando interroghiamo il suo feed, se riceviamo una risposta di errore, non potremo accedere al contenuto del suo feed. Seguiremo lo stesso schema di cui sopra e riproveremo per un massimo di tre giorni. Nel frattempo, le e-mail non verranno inviate.

Se abbiamo problemi ad accedere al suo feed web, riceverà notifiche in-app e via e-mail che la informeranno. Un passo facile per la risoluzione dei problemi è quello di controllare due volte i requisiti di alimentazione e assicurarsi che corrispondano ai parametri sopra descritti. 

Se dovesse apportare delle modifiche a un feed - ad esempio, ridurre le dimensioni per velocizzare il tempo di caricamento o risolvere un problema che causa una risposta di errore - e desidera che Klaviyo tenti un nuovo aggiornamento, navighi sul feed nella scheda Feed di dati e clicchi su Aggiorna feed di dati. Verificheremo e riconvalideremo il suo feed. Se il suo feed è valido e restituisce una risposta tempestiva, riprenderemo a cercare di mantenere i suoi contenuti aggiornati. Questo è un buon passo di risoluzione dei problemi da provare se ha problemi ad accedere al suo feed web, anche se non ha apportato modifiche.

Filtri Django

Supportiamo l'uso di filtri Django per le variabili che inserisce. Qui di seguito sono elencati alcuni filtri comunemente utilizzati, e può saperne di più nella nostra guida sull'uso dei filtri per personalizzare le variabili e nel Glossario dei filtri per le variabili.

Limita il riassunto del post a un numero X di parole

Se desidera includere un breve riassunto di un post del blog sotto il titolo del post (e il suo feed fornisce questo testo riassuntivo), può utilizzare il filtro Truncate.

Per limitare il riassunto di un articolo a 250 caratteri, ad esempio, può utilizzare:

{{ item.summary|truncatechars:250 }}

Aggiungere un feed web personalizzato

Configuri il suo feed

1. Clicchi sul nome della sua azienda nell'angolo in basso a sinistra di Klaviyo.
2. Clicchi su Impostazioni.
3. Clicchi su Altro.
   
4. Clicchi sui feed web.
5. Clicchi su Aggiungi feed web.
   
6. Compili i campi del feed web come segue:
   • Nome del feed
     In seguito utilizzerà questo identificatore nel suo modello per accedere al contenuto del feed. Assegni al suo feed un nome breve e descrittivo. Si consiglia di nominare i feed in maiuscolo (ad esempio, "MyDataFeed") o in maiuscolo con gli spazi sostituiti da trattini bassi (ad esempio, "MY_DATA_FEED"). Gli spazi non sono consentiti nei nomi dei feed. 
   • URL del feed
     L'endpoint che Klaviyo utilizza per recuperare il contenuto del feed (cioè l'URL del feed JSON o XML configurato in precedenza). Se il suo feed contiene informazioni private, consigliamo vivamente di utilizzare un URL HTTPS e di includere un parametro di query nonce per proteggere il suo feed.
   • Metodo di richiesta
     Specifichi il metodo HTTP che verrà utilizzato per richiedere il suo feed. Se non è sicuro di quale scegliere, selezioni GET. 
   • Tipo di contenuto
     Il formato del feed (JSON o XML). Raccomandiamo di utilizzare JSON, se possibile. Per i feed XML, il feed sarà convertito in JSON.
7. Una volta compilati tutti i campi, faccia clic su Aggiungi feed web. Cercheremo di interrogare l'URL del feed e di verificare che il suo feed funzioni correttamente. Se riscontriamo un errore, vedrà un messaggio di errore e non potrà salvare questo nuovo feed finché il problema non sarà risolto.
   • Vuole provarlo ma non ha un suo URL di feed web? Utilizzi il nostro. Copi il seguente URL per il Centro Assistenza Klaviyo nella casella URL Feed e lo provi nel suo account Klaviyo:

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

8. Klaviyo convalida il suo feed e mostra eventuali errori. Una volta convalidato, vedrà il suo feed in Klaviyo ed è pronto per essere utilizzato nelle e-mail.
   

Anteprima del suo feed

È utile visualizzare l'anteprima di un feed web prima di aggiungerlo a un'e-mail. Per visualizzare l'anteprima di un feed:

1. Nella pagina dei feed web, trovi il suo feed. 
2. Clicchi sui tre puntini, quindi selezioni Modifica. 
   
3. Dalla pagina dei dettagli del mangime, faccia clic su Anteprima. 

Durante l'anteprima del suo feed, vedrà il contenuto del feed o un messaggio di errore se non riusciamo a caricarlo. 

Se il suo feed è un array JSON, analizzeremo automaticamente e mostreremo ogni riga individualmente. Se si tratta di qualcos'altro, probabilmente un dizionario JSON, mostreremo l'intero dizionario.

Se sta sviluppando attivamente il suo feed, utilizzi il pulsante Aggiorna per prelevare l'ultima versione del suo feed. La pagina di anteprima di un feed mostra l'intero feed. Se il suo feed è di grandi dimensioni, potrebbero essere necessari diversi secondi per visualizzare i contenuti. Tenga presente che se il suo feed richiede più di 30 secondi per essere interrogato, questo avrà un impatto sulle prestazioni di qualsiasi e-mail che si basa su questo feed.

Ora che ha aggiunto un feed web e ne ha visualizzato in anteprima il contenuto, può utilizzarlo in un'e-mail.

Utilizzi un feed web in un'e-mail

Per le campagne, Klaviyo recupererà ogni feed una volta per ogni invio e memorizzerà il contenuto restituito. Anche se sta inviando a migliaia di destinatari, Klaviyo non farà migliaia di richieste ai suoi server.

Popola il contenuto del mangime in un modello

Nel nostro esempio di feed web della sezione precedente, abbiamo un array di articoli in cui ogni voce include un nome, un URL, un ID articolo e altro ancora. Dopo che un feed è stato aggiunto a un'e-mail, è disponibile attraverso la variabile feed:

{{ feeds }}

Ad esempio, per il feed JSON di cui sopra, possiamo ora fare riferimento o produrre i contenuti del feed di articoli includendo questa sintassi nel nostro modello:

{{ feeds.Klaviyo_Help_Center }}

Facciamo un esempio in cui iteriamo su tutte le voci dell'array, visualizzando alcune variabili. Utilizzeremo il feed del blog di Klaviyo come esempio, e itereremo sulle immagini.

1. Trascini un nuovo blocco di testo nella sua e-mail e lo collochi nel punto in cui desidera che il feed web venga popolato.
2. Attivi la funzione di ripetizione del blocco/contenuto: clicchi sulla scheda Opzioni di visualizzazione del blocco di testo, quindi su Crea regole di ripetizione.
3. Per il campo Ripeti per, inserisca feeds.YOUR_FEED_NAME, seguito dal nome della variabile o delle variabili che contengono l'array che desidera iterare.
   • Nel nostro esempio, poiché stiamo iterando anche sul valore "articles", ripeteremo per: feeds.Klaviyo_Help_Center.articles.
4. I suoi dati possono essere annidati in una serie di variabili. Ad esempio, il suo feed potrebbe essere strutturato in questo modo: 

   rss: {
            ..... 
            canale: { 
                    ..... 
                        voce: { 
                                .....}}}

   In questo caso, userebbe feeds.YOUR_FEED_NAME.rss.channel.item come ripetizione.

5. Se vuole che questo blocco iteri solo su un certo numero di voci, utilizzi il filtro "slice". Per utilizzare questo filtro, regoli il valore Ripeti per aggiungendo il filtro alla fine:  feed.Klaviyo_Help_Center.articles|slice:':3'
   In questo esempio, |slice:':3' farà sì che vengano visualizzate solo le prime tre voci. 
6. Per il campo Alias articolo, inserisca: articolo
7. Una volta configurata la funzione Ripeti blocco/ripeti contenuto, può inserire le variabili utilizzando l'alias "item".
8. Per identificare e aggiungere le variabili, apra l'anteprima del suo feed web e faccia riferimento al modo in cui sono strutturati i suoi dati. Qualsiasi dato annidato all'interno dell'array utilizzato nel campo Ripeti per può essere utilizzato come variabile.
   In questo esempio, tutti i dati mostrati all'interno dell'array di articoli sono disponibili per essere utilizzati in un'e-mail:
   
9. Per i dati di primo livello, aggiunga semplicemente item prima del nome della variabile indicata nei suoi dati. Per esempio, utilizzi {{ item.title }} per visualizzare il titolo di un articolo, o {{ item.url }} per visualizzare l'URL di un articolo. 
10. Per accedere ai dati annidati all'interno delle variabili di primo livello, utilizzi la notazione a punti (ad esempio, {{ item.images.thumbnail_url }}). Per saperne di più sulle notazioni a punti e sulle variabili template, consulti la nostra guida ai tag template e alla sintassi delle variabili. 
11. Quando visualizza l'anteprima del suo modello, noterà che la funzione Ripeti blocco/ripeti contenuto consentirà a questo semplice blocco di testo di iterare automaticamente su tutte le voci del suo feed. Per ogni voce verranno visualizzate solo le variabili da lei specificate nel blocco di testo.
12. Se sta inserendo un'immagine, deve modificare il campo Codice sorgente del blocco di testo e contenere l'immagine in un tag <img src>.
    

Ha aggiunto un feed web personalizzato alla sua e-mail e ora può popolare dinamicamente un feed di dati dal suo URL esterno. 

Provi o convalidi il suo mangime

Se riceve un'e-mail o una notifica in-app che segnala un problema di accesso al suo feed web:

1. Si rechi al suo feed e clicchi sul pulsante Aggiorna feed.
2. Una volta completata la convalida, si possono vedere due tipi di messaggi di errore:
   • Risposta non valida
     Se riceviamo una risposta di errore quando tentiamo di interrogare il contenuto del suo feed, le indicheremo il codice di stato dell'errore. Dovrà risolvere il problema che causa questa risposta di errore prima che il feed possa essere utilizzato con successo all'interno di qualsiasi e-mail.
   • Problema di prestazioni
     Se non riceviamo una risposta dal suo feed entro 30 secondi, si verificheranno ritardi nell'invio. Sebbene sia stato in grado di salvare il suo feed storicamente, per mitigare il rischio di ritardi nell'invio, dovrà risolvere il problema di prestazioni del suo feed prima di riconvalidarlo e salvarlo con successo.

In entrambi i casi, se utilizza un feed problematico all'interno di un invio, si verificheranno ritardi nell'invio o la sua e-mail potrebbe essere cancellata del tutto. Per i flussi, è anche probabile che le e-mail non vengano inviate.

Consigliamo di rimuovere un feed problematico da tutte le e-mail mentre risolve qualsiasi problema in sospeso, per evitare interruzioni nell'invio.

Risorse aggiuntive

• Risoluzione dei problemi del suo feed web di Instagram nelle e-mail
• Come utilizzare i feed e le raccomandazioni sui prodotti