Come utilizzare la funzione di ripetizione dei contenuti

Imparerai

Scopra come utilizzare la funzione di ripetizione dei blocchi per una sezione o un blocco in un modello e-mail di Klaviyo. Questa funzione le consente di ripetere il contenuto di un blocco o di una sezione per ogni voce di un array (cioè un elenco) di dati provenienti dall'evento o dai dati del profilo di un destinatario, oppure da un feed di dati.

Prima di iniziare

Se non ha familiarità con l'utilizzo di dati di eventi, profili o cataloghi nelle e-mail, come primo passo consulti la nostra guida alla personalizzazione dei messaggi. 

Sarà utile anche comprendere i tipi di dati in Klaviyo, in particolare gli elenchi (cioè gli array). Un array memorizza più dati strutturati allo stesso modo. Ad esempio, gli articoli acquistati da un cliente sono memorizzati come un array all'interno di un evento Ordine effettuato. L'array items contiene 1 voce per ogni articolo ordinato e ogni voce contiene i dettagli di 1 articolo (ad esempio, nome dell'articolo, URL dell'immagine, quantità, taglia, colore, ecc.) 

Casi d'uso della funzione di ripetizione dei contenuti

Per utilizzare la funzione di ripetizione dei contenuti, avrà bisogno di un array o di un elenco di dati. La tabella seguente elenca alcuni esempi di array di dati che possono esistere nel suo account Klaviyo, insieme a casi d'uso esemplificativi. 

Può utilizzare la funzione di ripetizione dei contenuti con qualsiasi array, sia esso memorizzato nel profilo di un abbonato o nei dati di un evento, oppure in uno dei suoi feed web. Gli esempi sopra riportati sono solo un piccolo esempio di come questa funzione può essere utilizzata.

Come utilizzare la funzione di ripetizione dei contenuti

Per attivare la funzione di ripetizione dei contenuti, si rechi nella sezione o nel blocco che desidera ripetere, quindi faccia clic su Opzioni di visualizzazione. Nella sezione Ripetizione di contenuti, faccia clic su Crea ripetizione di contenuti. 

Vedrà apparire due campi: Ripetere per e Alias articolo. Per compilare questi campi e impostare i suoi contenuti ripetuti, segua la seguente procedura: 

1. Identificare la sua "ripetizione per"
2. Scelga il suo "alias articolo". 
3. Costruisca i suoi contenuti ripetuti
4. Anteprima della sua e-mail

Identificare la sua "ripetizione per" 

Aggiunga il nome dell'array che intende iterare al campo Ripeti per.

Per trovare il nome del suo array, visualizzi i dati della sua fonte di dati (ad esempio, i dati del profilo, i dati degli eventi o un feed di dati). In questo esempio, vedremo come trovare l'array dai dati dell'evento: 

1. Nel suo modello di e-mail, faccia clic su Anteprima e prova.
2. Clicchi su Evento.
3. Selezioni l'evento che attiverà questo flusso e-mail (ad esempio, Checkout avviato).
4. Scorra i dati di anteprima del suo evento fino a trovare un array che contiene le informazioni di cui ha bisogno. Può utilizzare le icone a forma di freccia sulla sinistra dei dati per eliminare le sezioni non necessarie e facilitare la navigazione.
   

   In questo esempio, ci sono due array che memorizzano le informazioni sugli articoli: 

   • Articoli
     Un array di primo livello che contiene un semplice elenco del nome di ogni articolo, ma nessun'altra informazione.
   • Voci_di_linea
     Annidato all'interno dell'array extra, contiene maggiori dettagli, tra cui il titolo, il prezzo, la SKU e l'URL dell'immagine di ogni articolo.
     

   In questo caso, vorrebbe utilizzare l'array più dettagliato, line_items, poiché contiene le informazioni dettagliate necessarie per la visualizzazione nel blocco di ripetizione. Per trovare la variabile appropriata da impostare nel campo Ripeti per, trovi due variabili all'interno della prima sezione dell'array e le copi. In questo esempio, copieremo le variabili prezzo_variante e titolo. Ecco i due tag che abbiamo copiato: 

   {{ event.extra.line_items.0.variant_price }}

   {{ event.extra.line_items.0.title }}

5. Ignori le parentesi graffe e osservi le variabili al loro interno. Noti che l'inizio di entrambe le variabili è lo stesso: event.extra.line_items.0. 

   Utilizzi tutto ciò che è fino a (ma escluso) il punto e il numero alla fine di questa parte della variabile come Ripetizione. In questo esempio, l'impostazione appropriata per il campo Ripeti per è event.extra.line_items.

Scelga il suo alias articolo

Il suo alias articolo può essere qualsiasi testo che desidera utilizzare (senza caratteri speciali o spazi). Utilizzerà questo alias all'interno del suo blocco di ripetizione per identificare le variabili che devono essere estratte dall'array selezionato in precedenza. Scelga un alias semplice ma descrittivo, in modo che sia facile da ricordare. 

Per esempio, se il suo blocco si ripete su un elenco di articoli in un carrello abbandonato, item è un buon alias da utilizzare. Se il suo blocco si ripete su un elenco di post del blog, potrebbe utilizzare post come alias.

Può utilizzare qualsiasi alias che desidera; si assicuri solo di utilizzare coerentemente tale alias nelle variabili del suo array (come indicato nei passi successivi). 

Dopo aver compilato i campi Ripeti per e Alias articolo, clicchi su Salva modifiche e inizi a creare il suo contenuto. 

Costruisca il suo blocco/sezione ripetente

Una volta impostate le impostazioni di Ripeti per e Alias articolo, aggiunga i tag di personalizzazione al blocco di contenuti da iterare. Può aggiungere qualsiasi tipo di variabile a questo blocco, compresi i dati del profilo e dell'evento, ma i tag che vengono estratti dal suo array (ad esempio, l'elenco degli articoli ordinati) devono essere leggermente adattati. 

Le variabili del titolo completo e del prezzo della variante utilizzate nell'esempio precedente erano: 

{{ event.extra.line_items.0.variant_price }}

{{ event.extra.line_items.0.title }}

Se aggiunge le variabili di cui sopra al blocco, questo verrà ripetuto una volta per ogni articolo del suo array, ma ogni ripetizione mostrerà il titolo e il prezzo del primo articolo dell'array. 

Per mostrare il titolo e il prezzo di ogni articolo, sostituisca il testo dell'impostazione Ripeti per (event.extra.line_items), più il punto e il numero successivo (.0) con il suo alias Articolo(item). Le variabili risultanti per questo esempio sono: 

{{ item.variant_price }}

{{ item.title }}

Ripeta il processo con qualsiasi altra variabile che desidera includere nell'array. 

Anteprima dell'e-mail e risoluzione dei problemi

Una volta creato il suo blocco di ripetizione, visualizzi l'anteprima dell'e-mail. Se l'e-mail fa riferimento ai dati dell'evento, selezioni lo stesso evento che ha utilizzato per costruire il blocco (cioè l'evento che attiverà questo flusso). Se il suo blocco fa riferimento ai dati del profilo, selezioni un profilo che abbia le variabili corrette. 

Se il blocco di ripetizione nella sua e-mail di anteprima appare vuoto o non contiene tutti i contenuti che si aspettava, torni ai passaggi precedenti. Si assicuri che l'alias Ripeti per, l'alias Articolo e tutte le variabili personalizzate siano configurate correttamente seguendo i passaggi precedenti. Quindi, riveda i dati di anteprima che sta utilizzando: si assicuri di aver selezionato l'evento corretto e che l'evento campione scelto contenga i dati di cui ha bisogno. 

Risorse aggiuntive

• Riferimento alla personalizzazione del messaggio
• Guida all'editor di modelli e-mail