Prilagodite svoje kampanje Shopify Messaging pomoću jezika Liquid

Liquid je jednostavan programski jezik platforme Shopify kojim se lako koristi i to je isti programski jezik na kojem su izgrađene teme iz trgovine Shopify Theme Store.

Možete upotrijebiti prilagođeni Liquid kako biste poboljšali poruke aplikacije Shopify Messaging tako što ćete izraditi e-poruku isključivo s prilagođenim kodom ili dodati prilagođeni odjeljak jezika Liquid u predložak. Ove vam opcije omogućuju unos prilagođenog koda Liquid ili HTML-a.

Prilagođeni Liquid možete upotrijebiti za prikaz prilagođenih elemenata kao što su slike jedna pored druge, prilagođeni gumbi, slike prilagođenih veličina i prilagođene veličine odjeljaka.

Na ovoj stranici

Napomene

Prije nego što počnete dodavati prilagođeni Liquid u poruke aplikacije Shopify Messaging, pregledajte sljedeće napomene:

Varijable koje uključite u kod moraju biti podržane u prilagođenom jeziku Liquid.
Za izradu prilagođenog odjeljka jezika Liquid možete upotrijebiti samo stolno računalo.
U e-porukama s prilagođenim kodom Liquid obavezna je varijabla unsubscribe_link ili unsubscribe_url. Ako ste aktivirali praćenje otvaranja, tada je obavezna i varijabla open_tracking. Saznajte više o dodavanju obaveznih varijabli u e-poruku.
Kod koji unosite ima sljedeća ograničenja:
- Najviše 50 kilobajta (KB) za prilagođene odjeljke jezika Liquid.
- Najviše 500 KB za e-poruke s prilagođenim kodom Liquid.

Izrada e-poruke s prilagođenim kodom pomoću jezika Liquid

Ako prilikom izrade e-poruke želite upotrijebiti prilagođeni kod Liquid, možete dodati prilagođeni odjeljak jezika Liquid ili izraditi e-poruku isključivo od prilagođenog koda Liquid tako da odaberete Napišite svoj kod prilikom izrade kampanje Shopify Messaging.

Varijable Liquid koje su podržane u prilagođenom jeziku Liquid

Možete upotrijebiti podržane varijable kako biste prilagodili poruke e-pošte za Shopify Messaging pomoću jezika Liquid. Popise podržanih varijabli Liquid možete pregledati za sljedeće vrste predložaka:

Varijable Liquid koje su podržane za sve predloške e-pošte

Sljedeće varijable možete upotrijebiti kako biste prilagodili bilo koju poruku e-pošte aplikacije Shopify Messaging pomoću jezika Liquid.

Opis podržanih varijabli Liquid za Shopify Messaging
Varijabla	Opis
all_products	Svi proizvodi u vašoj trgovini.
customer.accepts_marketing	Vraća vrijednost `true` ako korisnik prihvaća marketing, a `false` ako ne prihvaća.
customer.addresses	Vraća sve adrese povezane s korisnikom.
customer.addresses_count	Vraća broj adresa povezanih s korisnikom.
customer.b2b?	Vraća vrijednost `true` ako je korisnik B2B korisnik, a `false` ako nije.
customer.current_location	Vraća trenutačno odabranu lokaciju poduzeća za korisnika.
customer.default_address	Vraća zadanu adresu korisnika.
customer.email	Vraća e-adresu korisnika.
customer.first_name	Vraća ime korisnika.
customer.has_account	Vraća vrijednost `true` ako je e-adresa korisnika povezana s računom korisnika, a `false` ako nije.
customer.has_avatar?	Vraća vrijednost `true` ako korisnik ima avatar povezan sa svojim računom, a `false` ako nema.
customer.id	Vraća ID korisnika.
customer.last_name	Vraća prezime korisnika.
customer.last_order	Vraća posljednju narudžbu koju je napravio korisnik, isključujući testne narudžbe.
customer.name	Vraća puno ime i prezime korisnika.
customer.orders	Vraća sve narudžbe koje je korisnik napravio.
customer.orders_count	Vraća ukupan broj narudžbi koje je korisnik napravio.
customer.payment_methods	Vraća spremljene načine plaćanja korisnika.
customer.phone	Vraća telefonski broj korisnika. Telefonski se broj popunjava samo ako je korisnik pri plaćanju upotrijebio telefonski broj, uključio SMS obavijesti ili ako ste ga ručno dodali na njegov račun korisnika.
customer.store_credit_account.balance	Vraća saldo bona za trgovinu korisnika u valuti koja je povezana s relevantnim kontekstom. Na primjer: `{{customer.store_credit_account.balance \| money_with_currency}}`
customer.tags	Vraća oznake povezane s korisnikom.
customer.tax_exempt	Vraća `true` ako je korisnik oslobođen plaćanja poreza, a `false` ako nije.
customer.total_spent	Vraća ukupan iznos koji je korisnik potrošio na sve narudžbe u vašoj trgovini.
email.*	Ova varijabla omogućuje pristup sljedećim svojstvima e-poruke: `subject` prikazuje predmet e-poruke. `preview_text` prikazuje tekst pretpregleda e-poruke.
open_tracking	Ova varijabla omogućuje pristup unaprijed formatiranom bloku za praćenje otvaranja. Ova je varijabla obavezna ako izrađujete e-poruku s prilagođenim kodom i ako ste aktivirali praćenje otvaranja.
shop.*	Ova varijabla omogućuje pristup sljedećim svojstvima trgovine: `name` prikazuje naziv trgovine. `domain` prikazuje primarnu domenu trgovine. `url` prikazuje URL trgovine. `shopify_domain` prikazuje domenu Shopify trgovine. `address` prikazuje adresu trgovine, što omogućuje pristup sljedećim svojstvima adrese: `address1` `address2` `city` `country` `phone` `province` `zip`
unsubscribe_url	Ova varijabla omogućuje pristup neobrađenom URL-u za odjavu i može se prilagoditi. Ako izrađujete e-poruku s prilagođenim kodom, morate uključiti varijablu `unsubscribe_url` ili `unsubscribe_link`. Obje varijable, `unsubscribe_url` i `unsubscribe_link`, uvijek će voditi na primarnu domenu internetske trgovine i ne mogu se izmijeniti da bi vodile negdje drugdje.

Varijable Liquid podržane za poruke e-pošte o nezavršenom plaćanju

Možete upotrijebiti sljedeće varijable da biste pomoću varijabli Liquid prilagodili svoje poruke e-pošte o nezavršenom plaćanju u aplikaciji Shopify Messaging.

Varijabla abandoned_checkout popunjava se samo ako je e-poruka dio automatizacije marketinga za nezavršeno plaćanje. Inače je varijabla null.

Opis varijabli Liquid podržanih u aplikaciji Shopify Messaging za napušteno pregledavanje, košaricu i nezavršeno plaćanje
Varijabla	Opis
abandoned_checkout.*	Ova varijabla omogućuje pristup sljedećim svojstvima nezavršenog plaćanja: `url` prikazuje URL nezavršenog plaćanja. `line_items` prikazuje prvih pet linija artikala nezavršenog plaćanja. Uz to, svaki objekt `line_items` sadrži sljedeća svojstva za svaki proizvod: `components` `image_url` `product_title` `variant_title` `quantity` `line_items.components` prikazuje komponente nezavršenog plaćanja. Uz to, svaki objekt `components` sadrži sljedeća svojstva za svaku komponentu: `image_url` `quantity` `product_title` `variant_title` `remaining_products_count` prikazuje broj preostalih linija artikala ako u nezavršenom plaćanju postoji više od pet linija artikala.
id (checkout ID)	Jedinstveni ID plaćanja za internu upotrebu.
shop	Naziv vaše trgovine Shopify.
name	Naziv nezavršenog plaćanja, poznat i kao broj plaćanja.
total_price	Ukupna cijena narudžbe (međuzbroj + trošak dostave - popust na dostavu + porez).
shipping_price	Cijena dostave. Primjer: `{{ shipping_price \| money }}`
shipping_address	Adresa za dostavu.
billing_address	Adresa za naplatu.
line_items	Popis svih linija artikala u nezavršenom plaćanju.
unavailable_line_items	Popis svih linija artikala u nezavršenom plaćanju koje nisu dostupne.
note	Napomena priložena nezavršenom plaćanju.
landing_site	Putanja odredišnog mjesta koje je korisnik upotrijebio. Ovo je prva stranica kojoj je korisnik pristupio po dolasku u trgovinu. Primjer: `/products/great-product?ref=my-tracking-token`
landing_site_ref	Izdvaja referentni parametar s odredišnog mjesta. Referentni parametri mogu biti: `ref`, `source`, `r`. Ako je `landing_site` jednak `/products/great-product?ref=my-tracking-token`, tada je `landing_site_ref` `my-tracking-token`. Možete izvršiti određenu radnju ako je vaš referentni parametar jednak određenoj vrijednosti: {% if landing_site_ref == 'my-tracking-token' %} My action... {% endif %}
referring_site	URL načina upućivanja putem kojeg je korisnik došao u vašu trgovinu. Primjer: `https://www.google.com/?s=great+products`
created_at	Datum i vrijeme kada je korisnik izradio plaćanje koje nije završio.
closed_at	Datum i vrijeme zatvaranja plaćanja.
customer_locale	Dvoslovni ili troslovni jezični kôd za korisnikove regionalne parametre, po izboru popraćen modifikatorom regije. Na primjer, en , en-CA
item_count	Zbroj svih količina stavki.
unique_gateways	Popis jedinstvenih pružatelja usluga plaćanja dostupnih pri plaćanju.
discount	Popust primijenjen na košaricu ili na liniju artikla u nezavršenom plaćanju.
discounts	Popis popusta primijenjenih na plaćanje.
successfully_applied_discounts	Popusti koji su uspješno primijenjeni na plaćanje.
discounts_amount	Ukupan iznos popusta u dolarima ostvaren svim popustima. Primjer: +5,00 $
discounts_savings	Iznos uštede u dolarima ostvarene svim popustima. Primjer: -5,00 $
buyer_accepts_marketing	Vraća true ili false ovisno o tome je li korisnik prihvatio marketing tijekom nezavršenog plaćanja.
subtotal_line_items	Linije artikla koje se upotrebljavaju za izračun međuzbroja na plaćanju, isključujući sve linije artikla napojnice.
requires_shipping	Vraća true ako postoji barem jedna stavka na plaćanju koja zahtijeva dostavu.
subtotal_price	Međuzbroj za linije artikla na plaćanju.
email	E-adresa povezana s nezavršenim plaćanjem.
shop_name	Naziv vaše trgovine.
tax_lines	Porezi razvrstani po vrsti poreza: {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}
tax_price	Kombinirani porezi svih stavaka na plaćanju.
attributes	Svi atributi dodani nezavršenom plaćanju. Primjer: `{{ attributes.gift-note }}`
shipping_method	Informacije o prvoj metodi dostave dostupnoj na plaćanju.
shipping_methods	Metode dostave dostupne na plaćanju.
free	Vraća true if the total price of the checkout is zero.
free_shipping	Vraća true ako plaćanje ne zahtijeva dostavu ili ako je cijena dostave nula.
different_billing_address	Vraća true ili false na temelju toga je li adresa za dostavu ista kao adresa za naplatu.
customer	Objekt korisnika koji sadrži atribute izlaza customer.
gift_cards	Poklon kartice primijenjene na plaćanje.
gift_cards_amount	Iznos za plaćanje koji bi se pokrio poklon karticama.
transactions	Transakcije plaćanja.
shareable_url	URL prvog proizvoda u linijama artikla.
shareable_title	Naziv proizvoda prve linije artikla.
total_tip	Ukupan iznos napojnice koju je korisnik dodao na plaćanju.
discount_applications	Opisuje zašto i kako je stavka snižena na plaćanju.
cart_level_discount_applications	Primjene popusta koji se odnose na košaricu.
currency	Valuta nezavršenog plaćanja.
line_items_subtotal_price	Zbroj cijena svih linija artikla na plaćanju nakon primjene eventualnih popusta na linije artikla.

Varijable Liquid za poruke e-pošte o napuštenom pregledavanju i napuštenoj košarici

Varijabla abandoned_visit.* ispunjava se samo ako je poruka e-pošte dio automatizacije marketinških komunikacija u vezi s napuštenom košaricom ili pregledavanjem proizvoda bez kupnje. Pregledajte sljedeća svojstva kojima ova varijabla daje pristup.

Opis podržanih varijabli Liquid za Shopify Messaging
Varijabla	Opis
abandoned_visit.*	Ova varijabla daje pristup sljedećim svojstvima napuštene košarice ili pregledavanja: `url` prikazuje URL napuštene košarice ili pregledavanja. `products_added_to_cart` prikazuje prvih pet linija artikla proizvoda dodanih u košaricu napuštenog posjeta. Uz to, svaki objekt `products_added_to_cart` sadrži sljedeća svojstva o svakom proizvodu: `title` `image_url` `variant_title` `quantity` `products_viewed` prikazuje prvih pet proizvoda pregledanih tijekom napuštenog posjeta. Uz to, svaki objekt `products_viewed` sadrži sljedeća svojstva o svakom proizvodu: `title` `description` `image_url` `url` `image_alt_text` `remaining_cart_products_count` prikazuje broj preostalih linija artikla ako na nezavršenom plaćanju postoji više od pet linija artikla.

Upotreba obaveznih varijabli

Kada izrađujete prilagođenu Liquid poruku e-pošte, varijabla unsubscribe_link ili unsubscribe_url je obavezna. Ako ste aktivirali praćenje otvaranja, tada je obavezna i varijabla open_tracking.

Iako se ove varijable mogu umetnuti bilo gdje u kod vaše poruke e-pošte, obično se dodaju u podnožje e-poruke, kao u sljedećem primjeru:

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

Primjer prilagođenog Liquid koda

U uređivač koda možete dodati prilagođeni Liquid ili HTML kod. Sljedeći kod je primjer kako dodati Liquid kod da bi se u poruci e-pošte prikazao naziv vaše trgovine, prilagođeni gumb i slika prilagođene veličine.

<!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>