Personalizza le campagne Shopify Email utilizzando Liquid

Liquid è il linguaggio di programmazione di Shopify semplice e facile da utilizzare. Si tratta dello stesso linguaggio di programmazione con cui sono costruiti i temi del Theme store di Shopify.

Puoi utilizzare Liquid personalizzato per migliorare i messaggi di Shopify Email creando un'email con il codice completamente personalizzato o aggiungendo una sezione Liquid personalizzata a un modello. Queste opzioni ti consentono di inserire Liquid o HTML personalizzati.

Puoi utilizzare Liquid personalizzato per mostrare risorse personalizzate quali immagini affiancate, pulsanti personalizzati, nonché immagini e sezioni con dimensioni personalizzate.

Considerazioni

Prima di aggiungere Liquid personalizzato ai messaggi di Shopify Email, esamina le seguenti considerazioni:

  • Le variabili incluse nel codice devono essere supportate da Liquid personalizzato.
  • È possibile creare una sezione Liquid personalizzata solo da un dispositivo desktop.
  • La variabile unsubscribe_link ounsubscribe_url è obbligatoria nelle email Liquid personalizzate. Se hai attivato il monitoraggio dell'apertura, è necessaria anche la variabile open_tracking. Scopri di più sull'aggiunta delle variabili obbligatorie alla tua email.
  • Il codice che inserisci ha i seguenti limiti:
    • Massimo 50 kilobyte (KB) per le sezioni Liquid personalizzate.
    • Massimo 500 KB per le email con codice Liquid personalizzato.

Variabili Liquid supportate nel Liquid personalizzato

Puoi utilizzare le seguenti variabili per personalizzare i messaggi di Shopify Email con Liquid.

Variabili Liquid supportate per tutti i modelli di email

Puoi utilizzare le seguenti variabili per personalizzare tutti i messaggi di Shopify Email con Liquid.

Descrizione delle variabili Liquid supportate da Shopify Email
VariabileDescrizione
all_products
Tutti i prodotti nel tuo negozio.
unsubscribe_link
Questa variabile dà accesso a un gruppo di link di annullamento dell'iscrizione pre-formattato. Se crei un'email con codice personalizzato, devi includere la variabile unsubscribe_link o unsubscribe_url.
unsubscribe_url
Questa variabile dà accesso all'URL di annullamento dell'iscrizione non elaborato e può essere personalizzata. Se crei un'email con codice personalizzato, devi includere la variabile unsubscribe_url o unsubscribe_link.
open_tracking
Questa variabile dà accesso al blocco di monitoraggio dell'apertura già formattato. Questa variabile è obbligatoria se crei un'email con codice personalizzato e hai attivato il monitoraggio dell'apertura.
data.customer.*

Questa variabile consente di accedere alle seguenti proprietà dei dati dei clienti:

  • first_name
  • last_name
  • email
  • city
  • state
  • country
  • Queste proprietà non possono essere utilizzate all'interno dei filtri Liquid o delle condizioni Liquid.

    email.*

    Questa variabile consente di accedere alle seguenti proprietà dell'email:

  • subject mostra l'oggetto dell'email.
  • preview_text mostra l'anteprima del testo dell'email.
  • shop.*
    Questa variabile consente di accedere alle seguenti proprietà del negozio:
  • name mostra il nome del negozio.
  • domain mostra il dominio primario del negozio.
  • url visualizza l'URL del negozio.
  • shopify_domain mostra il dominio del negozio Shopify.
    • address mostra l'indirizzo del negozio, che dà accesso alle seguenti proprietà dell'indirizzo:
      • address1
      • address2
      • city
      • country
      • phone
      • province
      • zip
      • branding mostra il branding del negozio, che dà accesso alle seguenti proprietà:
        • accent_section_color
        • background_primary_color
        • background_border_color
        • body_text_color
        • button_background_and_link_color
        • button_label_color
        • footer_link_color
        • footer_text_color
        • footer_background_color
        • social_link_facebook
        • social_link_twitter
        • social_link_instagram
        • social_link_pinterest
        • shop_name
        • logo, visualizzato direttamente come tag img.

    Variabili Liquid supportate per le email per check-out abbandonato

    Puoi utilizzare le seguenti variabili per personalizzare i messaggi Shopify Email dei check-out abbandonati con Liquid.

    La variabile abandoned_checkout viene compilata solo se l'email fa parte di un'automazione di marketing per check-out abbandonati. In caso contrario, la variabile è null.

    Descrizione delle variabili Liquid supportate da Shopify Email per ricerca, carrello e check-out abbandonati
    VariabileDescrizione
    abandoned_checkout.*

    Questa variabile consente di accedere alle seguenti proprietà di un check-out abbandonato:

    • url mostra l'URL del check-out abbandonato.
    • line_items mostra le prime cinque voci del check-out abbandonato. Inoltre, ogni oggetto line_items contiene le seguenti proprietà per ciascun prodotto:
      • image_url
      • product_title
      • variant_title
      • quantity
    • remaining_products_count mostra il numero di voci rimanenti, se il check-out abbandonato contiene più di cinque voci.
    id
    (checkout ID)
    Un ID univoco del check-out per uso interno.
    shop
    Il nome del tuo negozio Shopify.
    name
    Il nome del check-out abbandonato, noto anche come numero di check-out.
    total_price
    Il prezzo totale dell'ordine (subtotale + costo di spedizione - sconto di spedizione + imposte).
    shipping_price

    Il prezzo di spedizione.

    Esempio: {{ shipping_price | money }}

    shipping_address
    L'indirizzo di spedizione.
    billing_address
    L'indirizzo di fatturazione.
    line_items
    Un elenco di tutte le voci nel check-out abbandonato.
    unavailable_line_items
    Un elenco di tutte le voci nel check-out abbandonato che non sono disponibili.
    note
    La nota allegata al check-out abbandonato.
    landing_site

    Il percorso del landing site utilizzato dal cliente. Si tratta della prima pagina a cui il cliente ha effettuato l'accesso una volta arrivato sul tuo negozio.

    Esempio: /products/great-product?ref=my-tracking-token

    landing_site_ref

    Estrae un parametro di riferimento dal landing site. I parametri di riferimento possono essere: ref, source, r.

    Se il landing_site fosse /products/great-product?ref=my-tracking-token, allora il landing_site_ref sarebbe my-tracking-token. È possibile compiere una determinata azione se il tuo parametro di riferimento è uguale a un certo valore:

    {% if landing_site_ref == 'my-tracking-token' %} La mia azione... {% endif %}
    referring_site

    L'URL del referrer che ha portato il cliente al tuo negozio.

    Esempio: https://www.google.com/?s=great+products

    created_at

    La data e l'ora in cui il cliente ha creato il check-out che ha abbandonato.

    closed_at

    La data e l'ora in cui il check-out è stato chiuso.

    customer_locale
    Il codice della lingua composto da due o tre lettere per le impostazioni locali del cliente, seguito eventualmente da un modificatore di area geografica. Per esempio
    it
    ,
    en-CA
    item_count
    Una somma di tutte le quantità degli articoli.
    unique_gateways
    Un elenco dei gestori dei pagamenti univoci disponibili al momento del check-out.
    discount
    Lo sconto applicato al carrello o a una voce nel check-out abbandonato.
    discounts
    Un elenco di sconti applicati al check-out.
    successfully_applied_discounts
    Gli sconti che sono stati correttamente applicati al check-out.
    discounts_amount

    L'importo dello sconto applicato da tutti gli sconti.

    Esempio: + 5,00 $

    discounts_savings

    L'importo dei risparmi derivanti da tutti gli sconti.

    Esempio: -5,00 $

    buyer_accepts_marketing
    RESI
    true
    o
    false
    a seconda che il cliente accetti il marketing durante il check-out abbandonato.
    subtotal_line_items
    Le voci utilizzate per calcolare il prezzo subtotale al momento del check-out, escluse le voci di mancia.
    requires_shipping
    RESI
    true
    se al momento del check-out è presente almeno un articolo che richiede la spedizione.
    subtotal_price
    Il prezzo subtotale delle voci al momento del check-out.
    email
    L'email associata al check-out abbandonato.
    shop_name
    Il nome del tuo negozio.
    tax_lines

    Le imposte suddivise per tipo di imposta:

    {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
    tax_price
    Le imposte complessive di tutti gli articoli al momento del check-out.
    attributes

    Qualsiasi attributo allegato al check-out abbandonato.

    Esempio: {{ attributes.gift-note }}

    shipping_method
    Informazioni sulla prima modalità di spedizione disponibile al momento del check-out.
    shipping_methods
    Le modalità di spedizione disponibili al momento del check-out.
    free
    RESI
    true se il prezzo totale del check-out è zero.
    free_shipping
    RESI
    true
    se il check-out non richiede la spedizione o se il prezzo per la spedizione è zero.
    different_billing_address
    RESI
    true
    o
    false
    a seconda che l'indirizzo di spedizione sia uguale all'indirizzo di fatturazione.
    customer
    L'oggetto cliente contenente gli attributi dell'output del cliente.
    gift_cards
    I buoni regalo applicati al momento del check-out.
    gift_cards_amount
    L'importo del prezzo del check-out che verrebbe pagato con i buoni regalo.
    transactions
    Le transazioni del check-out.
    shareable_url
    L'URL del primo prodotto nelle voci.
    shareable_title
    Il titolo del prodotto della prima voce.
    total_tip
    La mancia totale che il cliente ha aggiunto al momento del check-out.
    discount_applications
    Descrive il motivo per cui un articolo è stato scontato al momento del check-out e con quali modalità.
    cart_level_discount_applications
    Le applicazioni di sconto specifiche del carrello per il carrello.
    currency
    La valuta del check-out abbandonato.
    line_items_subtotal_price
    La somma dei prezzi di tutte le voci del check-out, dopo l'applicazione di eventuali sconti per le voci.

    Variabili Liquid per la ricerca abbandonata e le email per i carrelli abbandonati

    La variabile abandoned_visit.* viene compilata solo se un'email fa parte di un'automazione di marketing per il carrello abbandonato o per la ricerca di prodotto abbandonata. Controlla le seguenti proprietà a cui questa variabile dà accesso.

    Descrizione delle variabili Liquid supportate da Shopify Email
    VariabileDescrizione
    abandoned_visit.*

    Questa variabile consente di accedere alle seguenti proprietà di un browser o un check-out abbandonati:

    • url mostra l'URL del carrello o della ricerca abbandonati.
    • products_added_to_cart mostra le prime cinque voci di prodotto aggiunte al carrello della visita abbandonata. Inoltre, ogni oggetto products_added_to_cart contiene le seguenti proprietà per ciascun prodotto:
      • title
      • image_url
      • variant_title
      • quantity
    • products_viewed mostra i primi cinque prodotti visualizzati durante la visita abbandonata. Inoltre, ogni oggetto products_viewed contiene le seguenti proprietà per ciascun prodotto:
      • title
      • description
      • image_url
      • URL
      • image_alt_text
    • remaining_cart_products_count mostra il numero di voci rimanenti, se il check-out abbandonato contiene più di cinque voci.

    Utilizzo delle variabili

    Quando crei un'email Liquid personalizzata, la variabile unsubscribe_link o unsubscribe_url è obbligatoria. Se hai attivato il monitoraggio dell'apertura, è necessaria anche la variabile open_tracking.

    Anche se queste variabili possono essere inserite in qualsiasi punto del codice del tuo indirizzo email, quello più comune si trova nella sezione footer di un'email, come nell'esempio seguente:

    <div id="footer">{{ unsubscribe_link }} {{ open_tracking_block }}</div>

    Esempio di codice Liquid personalizzato

    Puoi aggiungere HTML e Liquid personalizzati nell'editor di codice. Il seguente codice mostra un esempio di come aggiungere il codice Liquid per visualizzare il nome del negozio, un pulsante personalizzato e un'immagine di dimensioni personalizzate in un messaggio email.

    <style>
      body {
        text-align: center;
      }
    
      p#welcome {
        margin: 0;
        padding: 3rem;
        color: white;
        font-weight: 700;
        font-size: 26px;
        font-family: 'Futura';
      }
    
      div#image_wrapper img {
        max-width: 70%;
        border-radius: 60px;
        box-shadow: -2px 6px 0px rgba(227, 111, 59, 0.7);
      }
    
      div#button_wrapper {
        padding: 1rem;
      }
    
      div#button_wrapper a {
        padding: 1rem 2rem;
        border-radius: 24px;
        display: inline-block;
        background: linear-gradient(120deg, #F6A179, #865CFF);
        box-shadow: -2px 4px 0px rgba(96, 54, 173, 0.9);
        font-weight: 700;
        font-size: 16px;
        font-family: 'Futura';
        color: white;
      }
    
      div#footer {
        font-weight: 700;
        font-size: 16px;
        font-family: 'Futura';
        padding: 2rem;
      }
    
      div#button_wrapper:hover a {
        box-shadow: -4px 6px 0px rgba(96, 54, 173, 0.8);
      }
    
      div#custom_section {
        background: linear-gradient(120deg, #FF9F73, #FFC7AD);
        padding:0 0 2rem 0;
        border-radius: 4rem;
      }
    </style>
    <div id="custom_section">
      <p id="welcome">
        Hello from {{shop.name}}<strong></strong>!
      </p>
      <div id="image_wrapper">
        <img src="https://burst.shopifycdn.com/photos/a-trio-of-natural-soaps.jpg" alt="" />
      </div>
      <div id="button_wrapper">
        <a href="">Shop now</a>
      </div>
      <div id="footer">{{ unsubscribe_link }} {{ open_tracking_block }}</div>
    </div>
    Non trovi le risposte che stai cercando? Siamo qui per aiutarti.