Prilagajanje oglaševalskih akcij Shopify Messaging s kodo Liquid

Liquid je preprost in enostaven programski jezik platforme Shopify. To je isti programski jezik, s katerim so zgrajene teme v trgovini Shopify Theme Store.

Za izboljšanje sporočil v aplikaciji Shopify Messaging lahko uporabite kodo Liquid po meri, in sicer tako da ustvarite e-pošto s kodo po meri ali pa da predlogi dodate odsek s kodo Liquid po meri. Ti možnosti omogočata vnos kode Liquid ali HTML po meri.

Kodo Liquid po meri lahko uporabite za prikaz sredstev po meri, kot so slike druga ob drugi, gumbi po meri, slike po meri ter odseki z velikostmi po meri.

Na tej strani

Kaj je treba upoštevati

Preden začnete dodajati kodo Liquid po meri v sporočila aplikacije Shopify Messaging, upoštevajte naslednje:

Spremenljivke, ki jih vključite v svojo kodo, morajo biti podprte v kodi Liquid po meri.
Odsek s kodo Liquid po meri lahko ustvarite le na namiznem računalniku.
Spremenljivka unsubscribe_link ali unsubscribe_url je obvezna v e-poštnih sporočilih s kodo Liquid po meri. Če ste aktivirali odprto sledenje, je obvezna tudi spremenljivka open_tracking. Več informacij o dodajanju obveznih spremenljivk v e-pošto.
Koda, ki jo vnesete, ima naslednje omejitve:
- Največ 50 kilobajtov (KB) za odseke s kodo Liquid po meri.
- Največ 500 KB za e-poštna sporočila, kodirana s kodo Liquid po meri.

Ustvarjanje e-pošte s kodo po meri z jezikom Liquid

Če želite ob ustvarjanju e-pošte uporabiti kodo Liquid po meri, lahko predlogi dodate odsek s kodo Liquid po meri ali pa v celoti ustvarite e-poštno sporočilo s kodo Liquid po meri tako, da ob ustvarjanju oglaševalske akcije Shopify Messaging izberete možnost Kodirajte sami.

Spremenljivke Liquid, podprte v kodi Liquid po meri

Svoja e-poštna sporočila Shopify Messaging lahko s kodo Liquid prilagodite z uporabo podprtih spremenljivk. Pregledate lahko sezname podprtih spremenljivk Liquid za naslednje vrste predlog:

Podprte spremenljivke Liquid za vse predloge e-pošte

Naslednje spremenljivke lahko uporabite za prilagajanje katerega koli e-poštnega sporočila Shopify Messaging s kodo Liquid.

Opis spremenljivk Liquid, ki jih podpira Shopify Messaging
Spremenljivka	Opis
all_products	Vsi izdelki v vaši trgovini.
customer.accepts_marketing	Vrne `true`, če stranka sprejema trženje, v nasprotnem primeru pa vrne `false`.
customer.addresses	Vrne vse naslove, povezane s stranko.
customer.addresses_count	Vrne število naslovov, povezanih s stranko.
customer.b2b?	Vrne `true`, če gre za stranko B2B, v nasprotnem primeru pa vrne `false`.
customer.current_location	Vrne trenutno izbrano lokacijo podjetja za stranko.
customer.default_address	Vrne privzeti naslov stranke.
customer.email	Vrne e-poštni naslov stranke.
customer.first_name	Vrne ime stranke.
customer.has_account	Vrne `true`, če je e-poštni naslov stranke povezan z računom stranke, v nasprotnem primeru pa vrne `false`.
customer.has_avatar?	Vrne `true`, če ima stranka z računom povezan avatar, v nasprotnem primeru pa vrne `false`.
customer.id	Vrne ID stranke.
customer.last_name	Vrne priimek stranke.
customer.last_order	Vrne zadnje naročilo, ki ga je oddala stranka, razen testnih naročil.
customer.name	Vrne celotno ime stranke.
customer.orders	Vrne vsa naročila, ki jih je oddala stranka.
customer.orders_count	Vrne skupno število naročil, ki jih je oddala stranka.
customer.payment_methods	Vrne shranjene načine plačila stranke.
customer.phone	Vrne telefonsko številko stranke. Telefonska številka se izpolni le, če je stranka telefonsko številko uporabila na blagajni, se je prijavila na obvestila SMS ali če ste jo ročno dodali v njen račun stranke.
customer.store_credit_account.balance	Vrne stanje dobroimetja za nakup stranke v valuti, povezani z ustreznim kontekstom. Na primer: `{{customer.store_credit_account.balance \| money_with_currency}}`
customer.tags	Vrne oznake, povezane s stranko.
customer.tax_exempt	Vrne `true`, če je stranka oproščena plačila davkov, v nasprotnem primeru pa vrne `false`.
customer.total_spent	Vrne skupni znesek, ki ga je stranka porabila za vsa naročila v vaši trgovini.
email.*	Ta spremenljivka omogoča dostop do naslednjih lastnosti e-pošte: `subject` prikaže zadevo e-poštnega sporočila. `preview_text` prikaže predogledno besedilo e-poštnega sporočila.
open_tracking	Ta spremenljivka omogoča dostop do predhodno oblikovanega bloka za odprto sledenje. Ta spremenljivka je obvezna, če ustvarite e-poštno sporočilo s kodo po meri in ste aktivirali odprto sledenje.
shop.*	Ta spremenljivka omogoča dostop do naslednjih lastnosti trgovine: `name` prikaže ime trgovine. `domain` prikaže primarno domeno trgovine. `url` prikaže URL-naslov trgovine. `shopify_domain` prikaže domeno Shopify za trgovino. `address` prikaže naslov trgovine, kar omogoča dostop do naslednjih lastnosti naslova: `address1` `address2` `city` `country` `phone` `province` `zip`
unsubscribe_url	Ta spremenljivka omogoča dostop do neobdelanega URL-naslova za odjavo in jo je mogoče prilagoditi. Če ustvarite e-poštno sporočilo s kodo po meri, morate vključiti spremenljivko `unsubscribe_url` ali `unsubscribe_link`. Obe spremenljivki, `unsubscribe_url` in `unsubscribe_link`, bosta vedno kazali na primarno domeno spletne trgovine in ju ni mogoče spremeniti tako, da bi usmerjali drugam.

Spremenljivke Liquid, podprte za e-pošto o zapuščeni blagajni

Za prilagajanje e-poštnih sporočil o zapuščeni blagajni storitve Shopify Messaging s pomočjo jezika Liquid lahko uporabite naslednje spremenljivke.

Spremenljivka abandoned_checkout se izpolni le, če je e-poštno sporočilo del avtomatizacije trženja za zapuščeno blagajno. V nasprotnem primeru je vrednost spremenljivke null.

Opis spremenljivk Liquid, ki jih podpira Shopify Messaging, za opuščeno brskanje, košarico in zapuščeno blagajno
Spremenljivka	Opis
abandoned_checkout.*	Ta spremenljivka omogoča dostop do naslednjih lastnosti zapuščene blagajne: `url` prikaže URL-naslov zapuščene blagajne. `line_items` prikaže prvih pet postavk zapuščene blagajne. Poleg tega vsak objekt `line_items` vsebuje naslednje lastnosti posameznega izdelka: `components` `image_url` `product_title` `variant_title` `quantity` `line_items.components` prikaže komponente zapuščene blagajne. Poleg tega vsak objekt `components` vsebuje naslednje lastnosti o vsaki komponenti: `image_url` `quantity` `product_title` `variant_title` `remaining_products_count` prikaže število preostalih postavk, če je v zapuščeni blagajni več kot pet postavk.
id (checkout ID)	Enoličen ID blagajne za notranjo uporabo.
shop	Ime vaše trgovine Shopify.
name	Ime zapuščene blagajne, znano tudi kot številka blagajne.
total_price	Skupna cena naročila (vmesni seštevek + stroški pošiljanja – popust na pošiljanje + davek).
shipping_price	Cena pošiljanja. Primer: `{{ shipping_price \| money }}`
shipping_address	The naslov za dostavo.
billing_address	The naslov za izstavitev računa.
line_items	Seznam vseh postavk v zapuščeni blagajni.
unavailable_line_items	Seznam vseh postavk v zapuščeni blagajni, ki niso na voljo.
note	Opomba, priložena zapuščeni blagajni.
landing_site	Pot ciljnega mesta, ki jo je stranka uporabila. To je prva stran, do katere je stranka dostopala, ko je prispela v trgovino. Primer: `/products/great-product?ref=my-tracking-token`
landing_site_ref	Izvleče referenčni parameter s ciljnega mesta. Referenčni parametri so lahko: `ref`, `source`, `r`. Če je `landing_site` `/products/great-product?ref=my-tracking-token`, potem je `landing_site_ref` `my-tracking-token`. Izvedete lahko določeno dejanje, če je referenčni parameter enak določeni vrednosti: {% if landing_site_ref == 'my-tracking-token' %} My action... {% endif %}
referring_site	URL-naslov napotitvenega vira, ki je stranko pripeljal v vašo trgovino. Primer: `https://www.google.com/?s=great+products`
created_at	Datum in ura, ko je stranka ustvarila blagajno, ki jo je nato zapustila.
closed_at	Datum in ura, ko je bila blagajna zaprta.
customer_locale	Koda jezika iz dveh ali treh črk za območne nastavitve stranke, ki ji lahko sledi modifikator regije. Na primer: en , en-CA
item_count	Vsota količin vseh kosov.
unique_gateways	Seznam edinstvenih ponudnikov plačilnih storitev, ki so na voljo na blagajni.
discount	Popust, uporabljen za košarico ali postavko v zapuščeni blagajni.
discounts	Seznam popustov, uporabljenih na blagajni.
successfully_applied_discounts	Popusti, ki so bili uspešno uporabljeni na blagajni.
discounts_amount	Znesek v dolarjih za popust, ki se uporabi v primeru vseh popustov. Primer: +$5.00
discounts_savings	Znesek v dolarjih za prihranke vseh popustov. Primer: -$5.00
buyer_accepts_marketing	Vrne true ali false glede na to, ali je stranka med zapuščeno blagajno sprejela trženje.
subtotal_line_items	Postavke, ki se uporabljajo za izračun cene z vmesnim seštevkom na blagajni, brez postavk za napitnino.
requires_shipping	Vrne true , če je na blagajni vsaj en kos, ki zahteva dostavo.
subtotal_price	Cena z vmesnim seštevkom za postavke na blagajni.
email	E-pošta, povezana z zapuščeno blagajno.
shop_name	Ime vaše trgovine.
tax_lines	Davki, razdeljeni po vrsti davka: {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}
tax_price	Skupni davki za vse kose na blagajni.
attributes	Vse lastnosti, ki so bile priložene zapuščeni blagajni. Primer: `{{ attributes.gift-note }}`
shipping_method	Podatki o prvem načinu pošiljanja, ki je na voljo na blagajni.
shipping_methods	Načini pošiljanja, ki so na voljo na blagajni.
free	Vrne true if the total price of the checkout is zero.
free_shipping	Vrne true , če za blagajno ni potrebna dostava ali če je cena dostave enaka nič.
different_billing_address	Vrne true ali false glede na to, ali je naslov za dostavo enak naslovu za izdajo računa.
customer	Predmet stranke, ki vsebuje lastnosti rezultata stranke.
gift_cards	Darilne kartice, unovčene na blagajni.
gift_cards_amount	Znesek cene na blagajni, ki bi se plačal z darilnimi karticami.
transactions	Transakcije na blagajni.
shareable_url	URL-naslov prvega izdelka v postavkah.
shareable_title	Ime izdelka za prvo postavko.
total_tip	Skupna napitnina, ki jo je stranka dodala na blagajni.
discount_applications	Opisuje, zakaj in kako je bil kos znižan na blagajni.
cart_level_discount_applications	Uporabe popustov, specifičnih za košarico, za to košarico.
currency	Valuta zapuščene blagajne.
line_items_subtotal_price	Vsota cen vseh postavk na blagajni po upoštevanju morebitnih popustov na postavke.

Spremenljivke Liquid za e-pošto o opuščenem brskanju in zapuščeni košarici

Spremenljivka abandoned_visit.* se izpolni samo, če je e-pošta del trženjske avtomatizacije za zapuščeno košarico ali opuščeno brskanje po izdelkih. Preglejte spodnje lastnosti, do katerih ta spremenljivka omogoča dostop.

Opis spremenljivk Liquid, ki jih podpira Shopify Messaging
Spremenljivka	Opis
abandoned_visit.*	Ta spremenljivka omogoča dostop do naslednjih lastnosti zapuščene košarice ali opuščenega brskanja: `url` prikaže URL-naslov zapuščene košarice ali opuščenega brskanja. `products_added_to_cart` prikaže prvih pet postavk za izdelke, dodanih v košarico v okviru zapuščenega obiska. Poleg tega vsak `products_added_to_cart` predmet vsebuje naslednje lastnosti posameznega izdelka: `title` `image_url` `variant_title` `quantity` `products_viewed` prikaže prvih pet izdelkov, ogledanih med zapuščenim obiskom. Poleg tega vsak `products_viewed` predmet vsebuje naslednje lastnosti posameznega izdelka: `title` `description` `image_url` `url` `image_alt_text` `remaining_cart_products_count` prikaže preostalo število postavk, če je v zapuščeni blagajni več kot pet postavk.

Uporaba obveznih spremenljivk

Ko ustvarite e-poštno sporočilo Liquid po meri, je obvezna spremenljivka unsubscribe_link ali unsubscribe_url. Če ste aktivirali odprto sledenje, je obvezna tudi spremenljivka open_tracking.

Čeprav je te spremenljivke mogoče vstaviti kamor koli v kodo e-pošte, je najpogostejše mesto za dodajanje teh spremenljivk v nogi e-pošte, kot v naslednjem primeru:

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

Primer kode Liquid po meri

V urejevalniku kode lahko dodate Liquid ali HTML po meri. Naslednja koda je primer, kako lahko dodate kodo Liquid, da se v e-poštnem sporočilu prikažejo ime trgovine, gumb po meri in slika velikosti po meri.

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