Shopify Messaging -kampanjoiden mukauttaminen Liquidin avulla

Liquid on Shopifyn yksinkertainen ja helppokäyttöinen ohjelmointikieli. Se on sama ohjelmointikieli, jolla Shopify Theme Storen teemat on rakennettu.

Voit parantaa Shopify Messaging -viestejäsi mukautetulla Liquidilla joko luomalla kokonaan mukautetun koodatun sähköpostin tai lisäämällä malliin mukautetun Liquid-osion. Näiden vaihtoehtojen avulla voit syöttää mukautettua Liquid- tai HTML-koodia.

Mukautetun Liquidin avulla voit näyttää mukautettuja elementtejä, kuten rinnakkain aseteltuja kuvia, mukautettuja painikkeita, mukautetun kokoisia kuvia ja mukautettuja osioiden kokoja.

Huomioitavaa

Tutustu seuraaviin seikkoihin, ennen kuin alat lisätä mukautettua Liquid-koodia Shopify Messaging -viesteihisi:

  • Koodiin sisällyttämiesi muuttujien on oltava mukautetun Liquidin tukemia.
  • Voit luoda mukautetun Liquid-osion vain tietokoneella.
  • Muuttuja unsubscribe_link tai unsubscribe_url on pakollinen mukautetuissa Liquid-sähköposteissa. Jos olet aktivoinut avaamisen seurannan, myös muuttuja open_tracking on pakollinen. Lue lisää pakollisten muuttujien lisäämisestä sähköpostiisi.
  • Syöttämälläsi koodilla on seuraavat rajoitukset:
    • Enintään 50 kilotavua (kt) mukautetuille Liquid-osioille.
    • Enintään 500 kt mukautetuille koodatuille Liquid-sähköposteille.

Mukautetun koodatun sähköpostin luominen Liquidilla

Jos haluat käyttää mukautettua Liquid-koodia luodessasi sähköpostia, voit joko lisätä mukautetun Liquid-osion tai luoda sähköpostin kokonaan mukautetusta Liquid-koodista valitsemalla Koodaa omasi, kun luot Shopify Messaging -kampanjan.

Mukautetussa Liquidissa tuetut Liquid-muuttujat

Voit käyttää tuettuja muuttujia Shopify Messaging -sähköpostiviestiesi mukauttamiseen Liquidilla. Voit tarkastella tuettujen Liquid-muuttujien luetteloita seuraavan tyyppisille malleille:

Kaikissa sähköpostimalleissa tuetut Liquid-muuttujat

Seuraavien muuttujien avulla voit mukauttaa mitä tahansa Shopify Messaging -sähköpostiviestejäsi Liquidilla.

Shopify Messagingin tukemien Liquid-muuttujien kuvaus
MuuttujaKuvaus
all_products
Kaikki tuotteet kaupassasi.
customer.accepts_marketing
Palauttaa arvon true, jos asiakas hyväksyy markkinoinnin, ja muussa tapauksessa arvon false.
customer.addresses
Palauttaa kaikki asiakkaaseen liitetyt osoitteet.
customer.addresses_count
Palauttaa asiakkaaseen liitettyjen osoitteiden määrän.
customer.b2b?
Palauttaa arvon true, jos asiakas on B2B-asiakas, ja muussa tapauksessa arvon false.
customer.current_location
Palauttaa asiakkaan tällä hetkellä valitun yrityksen sijainnin.
customer.default_address
Palauttaa asiakkaan oletusosoitteen.
customer.email
Palauttaa asiakkaan sähköpostiosoitteen.
customer.first_name
Palauttaa asiakkaan etunimen.
customer.has_account
Palauttaa arvon true, jos asiakkaan sähköpostiosoite on liitetty asiakastiliin, ja muussa tapauksessa arvon false.
customer.has_avatar?
Palauttaa arvon true, jos asiakastiliin on liitetty avatar, ja arvon false, jos ei ole.
customer.id
Palauttaa asiakkaan tunnuksen.
customer.last_name
Palauttaa asiakkaan sukunimen.
customer.last_order
Palauttaa asiakkaan viimeisimmän tilauksen, testitilauksia lukuun ottamatta.
customer.name
Palauttaa asiakkaan koko nimen.
customer.orders
Palauttaa kaikki asiakkaan tekemät tilaukset.
customer.orders_count
Palauttaa asiakkaan tekemien tilausten kokonaismäärän.
customer.payment_methods
Palauttaa asiakkaan tallennetut maksutavat.
customer.phone
Palauttaa asiakkaan puhelinnumeron. Puhelinnumero lisätään vain, jos asiakas on käyttänyt puhelinnumeroa kassalla, tilannut tekstiviesti-ilmoitukset tai olet lisännyt sen manuaalisesti hänen asiakastililleen.
customer.store_credit_account.balance

Palauttaa asiakkaan kauppakrediitin saldon kyseiseen kontekstiin liittyvässä valuutassa. Esimerkki:

{{customer.store_credit_account.balance | money_with_currency}}
customer.tags
Palauttaa asiakkaaseen liitetyt tunnisteet.
customer.tax_exempt
Palauttaa arvon true, jos asiakas on vapautettu veroista, ja arvon false, jos ei ole.
customer.total_spent
Palauttaa summan, jonka asiakas on yhteensä käyttänyt kauppasi kaikkiin tilauksiin.
email.*

Tämän muuttujan avulla voit käyttää seuraavia sähköpostin ominaisuuksia:

  • subject näyttää sähköpostin aiherivin.
  • preview_text näyttää sähköpostin esikatselutekstin.
  • open_tracking
    Tämän muuttujan avulla voit käyttää esimuotoiltua avaamisen seurannan lohkoa. Tämä muuttuja on pakollinen, jos luot mukautetusti koodatun sähköpostin ja olet aktivoinut avaamisen seurannan.
    shop.*
    Tämän muuttujan avulla voit käyttää seuraavia kaupan ominaisuuksia:
  • name näyttää kaupan nimen.
  • domain näyttää kaupan ensisijaisen verkkotunnuksen.
  • url näyttää kaupan URL-osoitteen.
  • shopify_domain näyttää kaupan Shopify-verkkotunnuksen.
    • osoite näyttää kaupan osoitteen, jonka avulla voit käyttää seuraavia osoitteen ominaisuuksia:
      • address1
      • address2
      • city
      • country
      • phone
      • province
      • zip
    unsubscribe_url
    Tämä muuttuja antaa pääsyn raakaan tilauksen peruutus-URL-osoitteeseen, ja sitä voidaan mukauttaa. Jos luot mukautetusti koodatun sähköpostin, sinun on sisällytettävä mukaan unsubscribe_url- tai unsubscribe_link-muuttuja. Sekä unsubscribe_url että unsubscribe_link osoittavat aina verkkokaupan ensisijaiseen verkkotunnukseen, eikä niitä voi muokata osoittamaan muualle.

    Tuetut Liquid-muuttujat hylättyjen kassavaiheiden sähköposteille

    Voit käyttää seuraavia muuttujia mukauttaaksesi hylättyjä kassavaiheita koskevia Shopify Messaging -sähköpostiviestejäsi Liquid-kielellä.

    abandoned_checkout-muuttuja lisätään vain, jos sähköposti on osa hylätyn kassavaiheen markkinointiautomaatiota. Muussa tapauksessa muuttujan arvo on null.

    Shopify Messagingissa tuettujen Liquid-muuttujien kuvaus hylättyä selausta, ostoskoria ja kassavaihetta varten
    MuuttujaKuvaus
    abandoned_checkout.*

    Tämän muuttujan avulla voit käyttää seuraavia hylätyn kassavaiheen ominaisuuksia:

    • url näyttää hylätyn kassavaiheen URL-osoitteen.
    • rivikohdat näyttää hylätyn kassavaiheen viisi ensimmäistä rivikohtaa. Lisäksi kukin rivikohdat objekti sisältää seuraavat ominaisuudet kustakin tuotteesta:
      • components
      • image_url
      • product_title
      • variant_title
      • quantity
    • line_items.components näyttää hylätyn kassavaiheen tuoteosat. Lisäksi kukin components objekti sisältää seuraavat ominaisuudet kustakin tuoteosasta:
      • image_url
      • quantity
      • product_title
      • variant_title
    • remaining_products_count näyttää jäljellä olevien rivikohtien määrän, jos hylätyssä kassavaiheessa on enemmän kuin viisi rivikohtaa.
    id
    (checkout ID)
    Kassavaiheen yksilöllinen tunnus sisäiseen käyttöön.
    shop
    Shopify-kauppasi nimi.
    name
    Hylätyn kassavaiheen nimi, joka tunnetaan myös kassavaiheen numerona.
    total_price
    Tilauksen kokonaishinta (välisumma + toimituskulu – toimitusalennus + vero).
    shipping_price

    Toimituksen hinta.

    Esimerkki: {{ shipping_price | money }}

    shipping_address
    Toimitusosoite.
    billing_address
    Laskutusosoite.
    line_items
    Luettelo kaikista hylätyn kassavaiheen rivikohdista.
    unavailable_line_items
    Luettelo kaikista hylätyn kassavaiheen rivikohdista, jotka eivät ole saatavilla.
    note
    Hylättyyn kassavaiheeseen liitetty muistiinpano.
    landing_site

    Asiakkaan käyttämän laskeutumissivuston polku. Tämä on ensimmäinen sivu, jolle asiakas saapui tullessaan kauppaan.

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

    landing_site_ref

    Poimii viiteparametrin laskeutumissivustolta. Viiteparametreja voivat olla: ref, source, r.

    Jos landing_site on /products/great-product?ref=my-tracking-token, niin landing_site_ref on my-tracking-token. Voit suorittaa tietyn toimenpiteen, jos viiteparametrisi on yhtä suuri kuin tietty arvo:

    {% if landing_site_ref == 'my-tracking-token' %}
    My action...
    {% endif %}
    referring_site

    Viittauslähteen URL-osoite, joka toi asiakkaan kauppaasi.

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

    created_at

    Päivämäärä ja kellonaika, jolloin asiakas loi hylkäämänsä kassavaiheen.

    closed_at

    Päivämäärä ja kellonaika, jolloin kassavaihe suljettiin.

    customer_locale
    Kaksi- tai kolmekirjaiminen kielikoodi asiakkaan alueelle, jota voi valinnaisesti seurata aluetunniste. Esimerkiksi
    en
    ,
    en-CA
    item_count
    Kaikkien tuotteiden yhteenlaskettu lukumäärä.
    unique_gateways
    Luettelo kassalla käytettävissä olevista yksilöllisistä maksupalvelujen tarjoajista.
    discount
    Alennus, jota on sovellettu ostoskoriin tai hylätyn kassavaiheen rivikohtaan.
    discounts
    Luettelo kassalla sovelletuista alennuksista.
    successfully_applied_discounts
    Kassavaiheeseen onnistuneesti sovelletut alennukset.
    discounts_amount

    Kaikkien alennusten yhteenlaskettu rahasumma.

    Esimerkki: +5,00 $

    discounts_savings

    Kaikkien alennusten yhteenlaskettu säästö.

    Esimerkki: -5,00 $

    buyer_accepts_marketing
    Palauttaa arvon
    true
    tai
    false
    riippuen siitä, onko asiakas hyväksynyt markkinoinnin hylätyn kassavaiheen aikana.
    subtotal_line_items
    Rivikohdat, joita käytetään kassan välisumman laskemiseen, lukuun ottamatta juomarahoja koskevia rivikohtia.
    requires_shipping
    Palauttaa arvon
    true
    jos kassalla on vähintään yksi tuote, joka vaatii toimituksen.
    subtotal_price
    Kassalla olevien rivikohtien välisumma.
    email
    Hylättyyn kassavaiheeseen liitetty sähköpostiosoite.
    shop_name
    Kauppasi nimi.
    tax_lines

    Verot eriteltyinä verotyypin mukaan:

    {% for tax_line in tax_lines %}
    {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency  }}
    {% endfor %}
    tax_price
    Kaikkien kassalla olevien tuotteiden verot yhteensä.
    attributes

    Kaikki hylättyyn kassavaiheeseen liitetyt attribuutit.

    Esimerkki: {{ attributes.gift-note }}

    shipping_method
    Tiedot kassalla käytettävissä olevasta ensimmäisestä toimitustavasta.
    shipping_methods
    Kassalla käytettävissä olevat toimitustavat.
    free
    Palauttaa arvon
    true if the total price of the checkout is zero.
    free_shipping
    Palauttaa arvon
    true
    jos kassa ei vaadi toimitusta tai jos toimituksen hinta on nolla.
    different_billing_address
    Palauttaa arvon
    true
    tai
    false
    riippuen siitä, onko toimitusosoite sama kuin laskutusosoite.
    customer
    Asiakasobjekti, joka sisältää asiakkaan tulosteen attribuutit.
    gift_cards
    Kassalla käytetyt lahjakortit.
    gift_cards_amount
    Summa kassan loppusummasta, joka maksettaisiin lahjakorteilla.
    transactions
    Kassan maksutapahtumat.
    shareable_url
    Rivikohtien ensimmäisen tuotteen URL-osoite.
    shareable_title
    Ensimmäisen rivikohdan tuotenimike.
    total_tip
    Asiakkaan kassalla lisäämä juomaraha yhteensä.
    discount_applications
    Kuvaa, miksi ja miten tuotteesta annettiin alennus kassalla.
    cart_level_discount_applications
    Ostoskorille sovelletut ostoskorikohtaiset alennukset.
    currency
    Hylätyn kassavaiheen valuutta.
    line_items_subtotal_price
    Kassan kaikkien rivikohtien hintojen summa sen jälkeen, kun mahdolliset rivialennukset on otettu huomioon.

    Liquid-muuttujat hylättyjen selausten ja hylättyjen ostoskorien sähköposteja varten

    Muuttuja abandoned_visit.* täytetään vain, jos sähköposti on osa hylätyn ostoskorin tai hylätyn tuoteselauksen markkinointiautomaatiota. Tarkista seuraavat ominaisuudet, joihin tällä muuttujalla on pääsy.

    Shopify Messagingin tukemien Liquid-muuttujien kuvaus
    MuuttujaKuvaus
    abandoned_visit.*

    Tämä muuttuja antaa pääsyn seuraaviin hylätyn ostoskorin tai selauksen ominaisuuksiin:

    • url näyttää hylätyn ostoskorin tai selauksen URL-osoitteen.
    • products_added_to_cart näyttää viisi ensimmäistä tuoterivikohtaa, jotka on lisätty hylätyn käynnin ostoskoriin. Lisäksi kukin products_added_to_cart -objekti sisältää seuraavat ominaisuudet kustakin tuotteesta:
      • title
      • image_url
      • variant_title
      • quantity
    • products_viewed näyttää viisi ensimmäistä hylätyn käynnin aikana katsottua tuotetta. Lisäksi kukin products_viewed -objekti sisältää seuraavat ominaisuudet kustakin tuotteesta:
      • title
      • description
      • image_url
      • url
      • image_alt_text
    • remaining_cart_products_count näyttää jäljellä olevien rivikohtien määrän, jos hylätyssä kassavaiheessa on enemmän kuin viisi rivikohtaa.

    Pakollisten muuttujien käyttäminen

    Kun luot mukautetun Liquid-sähköpostin, muuttuja unsubscribe_link tai unsubscribe_url on pakollinen. Jos olet aktivoinut avaamisen seurannan, myös open_tracking-muuttuja on pakollinen.

    Vaikka nämä muuttujat voidaan lisätä mihin tahansa sähköpostisi koodissa, yleisin paikka niiden lisäämiselle on sähköpostin alatunnisteosio, kuten seuraavassa esimerkissä:

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

    Esimerkki mukautetusta Liquid-koodista

    Voit lisätä mukautetun Liquid- tai HTML-koodin koodieditoriin. Seuraava koodi on esimerkki siitä, miten voit lisätä Liquid-koodia näyttämään kauppasi nimen, mukautetun painikkeen ja mukautetun kokoisen kuvan sähköpostiviestissä.

    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
        <title>{{ shop.name }} Newsletter</title>
    </head>
    <body style="margin: 0; padding: 0; font-family: Arial, sans-serif; line-height: 1.5; color: #333333; background-color: #f5f5f5;">
        <table cellpadding="0" cellspacing="0" border="0" width="100%" style="background-color: #f5f5f5;">
            <tr>
                <td align="center" style="padding: 20px;">
                    <table cellpadding="0" cellspacing="0" border="0" width="600" style="background-color: #ffffff; border-radius: 4px; box-shadow: 0 2px 4px rgba(0,0,0,0.1);">
                        <!-- Header -->
                        <tr>
                            <td align="center" style="background-color: #4a6de5; padding: 30px 20px; color: #ffffff;">
                                <h1 style="margin: 0; font-size: 28px; font-weight: bold;">{{ shop.name }}</h1>
                                <p style="margin: 10px 0 0; font-size: 16px;">Your Book Journey with Us</p>
                            </td>
                        </tr>
    
                        <!-- Content -->
                        <tr>
                            <td style="padding: 30px 20px;">
                                <!-- Greeting Section -->
                                <table cellpadding="0" cellspacing="0" border="0" width="100%" style="margin-bottom: 30px;">
                                    <tr>
                                        <td>
                                            <h2 style="margin: 0 0 15px; font-size: 22px; color: #222222;">Hello {{ customer.name }}!</h2>
                                            <p style="margin: 0 0 15px; font-size: 15px;">We hope this email finds you well. We noticed you're from {{ customer.default_address.city }}.</p>
                                            {% if customer.email %}
                                                <p style="margin: 0 0 15px; font-size: 15px;">Your registered email is: {{ customer.email }}</p>
                                            {% endif %}
                                        </td>
                                    </tr>
                                </table>
    
                                <!-- Reading Journey Section -->
                                <table cellpadding="0" cellspacing="0" border="0" width="100%" style="margin-bottom: 30px;">
                                    <tr>
                                        <td>
                                            <h2 style="margin: 0 0 15px; font-size: 20px; color: #4a6de5;">Your Reading Journey</h2>
                                            <p style="margin: 0 0 15px; font-size: 15px;">Thank you for being a loyal customer! Here's a snapshot of your journey:</p>
                                            <p style="margin: 0 0 15px; font-size: 15px;">You purchased {{ customer.orders_count }} books with us.</p>
                                            {% if customer.last_order %}
                                                <p style="margin: 0 0 15px; font-size: 15px;"> You last read {{customer.last_order.line_items[0].title}}. Great choice! </p>
                                              {% endif %}
                                        </td>
                                    </tr>
                                </table>
    
                                <!-- Recommended Books Section -->
                                <table cellpadding="0" cellspacing="0" border="0" width="100%" style="margin-bottom: 30px;">
                                    <tr>
                                        <td>
                                            <h2 style="margin: 0 0 15px; font-size: 20px; color: #4a6de5;">Books You Might Love</h2>
                                            <p style="margin: 0 0 15px; font-size: 15px;">Based on your reading preferences, we've handpicked these titles just for you:</p>
    
                                            <table cellpadding="0" cellspacing="0" border="0" width="100%">
                                                <tr>
                                                    <td width="50%" style="padding-right: 10px;">
                                                        <table cellpadding="0" cellspacing="0" border="0" width="100%" style="background-color: #f9f9f9; border-radius: 4px; padding: 15px;">
                                                            <tr>
                                                                <td align="center">
                                                                    <!-- Image with proper email attributes -->
                                                                    <img src="https:{{ all_products['product-1-handle'] | image_url: width: 200 }}"
                                                                         alt="Product 1"
                                                                         width="200"
                                                                         height="200"
                                                                         style="display: block; border: 0; outline: none; text-decoration: none; -ms-interpolation-mode: bicubic;"
                                                                         title="Product 1"
                                                                         border="0">
                                                                    <h3 style="margin: 0 0 10px; font-size: 16px; color: #333333;">{{ all_products['product-1-handle'].title }}</h3>
                                                                    <p style="margin: 0 0 10px; font-size: 15px; color: #4a6de5;">${{ all_products['product-1-handle'].price }}</p>
                                                                    <a href="{{shop.domain}}{{ all_products['product-1-handle'].url }}" style="display: inline-block; background-color: #4a6de5; color: #ffffff; padding: 10px 20px; text-decoration: none; border-radius: 4px; font-size: 14px;">View Book</a>
                                                                </td>
                                                            </tr>
                                                        </table>
                                                    </td>
                                                    <td width="50%" style="padding-left: 10px;">
                                                        <table cellpadding="0" cellspacing="0" border="0" width="100%" style="background-color: #f9f9f9; border-radius: 4px; padding: 15px;">
                                                            <tr>
                                                                <td align="center">
                                                                    <!-- Image with proper email attributes -->
                                                                    <img src="https:{{ all_products['product-2-handle'] | image_url: width: 200 }}"
                                                                         alt="Product 2"
                                                                         width="200"
                                                                         height="200"
                                                                         style="display: block; border: 0; outline: none; text-decoration: none; -ms-interpolation-mode: bicubic;"
                                                                         title="Product 2"
                                                                         border="0">
                                                                    <h3 style="margin: 0 0 10px; font-size: 16px; color: #333333;">{{ all_products['product-2-handle'].title }}</h3>
                                                                    <p style="margin: 0 0 10px; font-size: 15px; color: #4a6de5;">${{ all_products['product-2-handle'].price }}</p>
                                                                    <a href="{{shop.domain}}{{ all_products['product-2-handle'].url }}" style="display: inline-block; background-color: #4a6de5; color: #ffffff; padding: 10px 20px; text-decoration: none; border-radius: 4px; font-size: 14px;">View Book</a>
                                                                </td>
                                                            </tr>
                                                        </table>
                                                    </td>
                                                </tr>
                                            </table>
                                        </td>
                                    </tr>
                                </table>
    
                                <!-- Book Club Section -->
                                <table cellpadding="0" cellspacing="0" border="0" width="100%" style="margin-bottom: 30px;">
                                    <tr>
                                        <td style="background-color: #f5f7ff; border-radius: 4px; padding: 25px; text-align: center;">
                                            <h2 style="margin: 0 0 15px; font-size: 18px; color: #333333;">This Month's Top Picks</h2>
                                            <p style="margin: 0 0 20px; font-size: 15px;">Discover what other readers are loving this month:</p>
                                            <a href="{{ shop.url }}/pages/book-club" style="display: inline-block; background-color: #4a6de5; color: #ffffff; padding: 10px 20px; text-decoration: none; border-radius: 4px; font-size: 14px;">Join Our Book Club</a>
                                        </td>
                                    </tr>
                                </table>
                            </td>
                        </tr>
    
                        <!-- Footer -->
                        <tr>
                            <td style="background-color: #f2f2f2; padding: 30px 20px; text-align: center;">
                                <p style="margin: 0 0 15px; font-size: 15px;">Best regards,<br><strong>{{ shop.name }} Team</strong></p>
                                <p style="margin: 0 0 15px; font-size: 12px; color: #999999;">© {{ 'now' | date: '%Y' }} {{ shop.name }}. All rights reserved.</p>
                                <p style="margin: 0 0 15px; font-size: 12px;">{{ open_tracking_block }}</p>
                                <a href="{{ unsubscribe_url }}" style="color: #999999; font-size: 12px; text-decoration: underline;">{{ unsubscribe_link }}</a>
                            </td>
                        </tr>
                    </table>
                </td>
            </tr>
        </table>
    </body>
    </html>