A Shopify Messaging-kampányok testreszabása Liquid használatával

A Liquid a Shopify egyszerű, könnyen használható programozási nyelve, és ugyanaz a programozási nyelv, amellyel a Shopify Theme Store áruházból származó témák is készülnek.

Egyéni Liquid használatával bővítheti Shopify Messaging-üzeneteit egy teljesen egyéni kóddal ellátott e-mail létrehozásával vagy egy egyéni Liquid-szakasz sablonhoz való hozzáadásával. Ezek a lehetőségek lehetővé teszik egyéni Liquid vagy HTML bevitelét.

Egyéni Liquid használatával egyéni eszközöket jeleníthet meg, például egymás melletti képeket, egyéni gombokat, egyéni méretű képeket és egyéni szakaszméreteket.

Ezen az oldalon

Megfontolandók

Tekintse át a következő megfontolandókat, mielőtt egyéni Liquid-kódot adna hozzá a Shopify Messaging-üzeneteihez:

A kódba foglalt változóknak az egyéni Liquid által támogatottnak kell lenniük.
Egyéni Liquid-szakasz létrehozásához csak asztali eszközt használhat.
Az egyéni Liquid-alapú e-mailekben kötelező megadni az unsubscribe_link vagy unsubscribe_url változót. Ha aktiválta a nyitott követést, akkor az open_tracking változó is kötelező. Tudjon meg többet a kötelező változók e-mailhez való hozzáadásáról.
A megadott kódra a következő korlátozások vonatkoznak:
- Legfeljebb 50 kilobájt (KB) az egyéni Liquid-szakaszok esetében.
- Legfeljebb 500 KB az egyéni kódolású Liquid e-mailek esetében.

Egyéni kóddal ellátott e-mail létrehozása Liquiddel

Ha egyéni Liquid-kódot szeretne használni egy e-mail létrehozásakor, akkor vagy hozzáadhat egy egyéni Liquid-szakaszt, vagy létrehozhat egy teljes egészében egyéni Liquid-kódból álló e-mailt a Saját kódolás lehetőség kiválasztásával, amikor létrehoz egy Shopify Messaging-kampányt.

Az egyéni Liquidben támogatott Liquid-változók

Támogatott változók használatával testreszabhatja a Shopify Messaging e-mail-üzeneteit Liquid segítségével. A következő sablontípusokhoz tartozó támogatott Liquid-változók listáit tekintheti át:

Minden e-mail-sablonhoz támogatott Liquid-változók

A következő változók használatával testreszabhatja bármelyik Shopify Messaging e-mail-üzenetét a Liquid segítségével.

A Shopify Messaging által támogatott Liquid-változók leírása
Változó	Leírás
all_products	Az üzlet összes terméke.
customer.accepts_marketing	`true` értéket ad vissza, ha a vásárló elfogadja a marketinganyagokat, ellenkező esetben `false` értéket.
customer.addresses	Visszaadja a vásárlóhoz társított összes címet.
customer.addresses_count	Visszaadja a vásárlóhoz társított címek számát.
customer.b2b?	`true` értéket ad vissza, ha a vásárló B2B-ügyfél, ellenkező esetben `false` értéket.
customer.current_location	Visszaadja a vásárló számára jelenleg kiválasztott vállalkozás telephelyét.
customer.default_address	Visszaadja a vásárló alapértelmezett címét.
customer.email	Visszaadja a vásárló e-mail-címét.
customer.first_name	Visszaadja a vásárló keresztnevét.
customer.has_account	`true` értéket ad vissza, ha a vásárló e-mail-címe vásárlói fiókhoz van társítva, ellenkező esetben `false` értéket.
customer.has_avatar?	A(z) `igaz` értéket adja vissza, ha a vásárlói fiókhoz avatar van társítva, és `hamis` értéket, ha nem.
customer.id	A vásárló azonosítóját adja vissza.
customer.last_name	A vásárló vezetéknevét adja vissza.
customer.last_order	A vásárló által leadott utolsó rendelést adja vissza, a próbarendelések kivételével.
customer.name	A vásárló teljes nevét adja vissza.
customer.orders	A vásárló által leadott összes rendelést adja vissza.
customer.orders_count	A vásárló által leadott rendelések teljes számát adja vissza.
customer.payment_methods	A vásárló mentett fizetési módjait adja vissza.
customer.phone	A vásárló telefonszámát adja vissza. A telefonszám csak akkor jelenik meg, ha a vásárló telefonszámot használt a pénztárnál, feliratkozott az SMS-értesítésekre, vagy ha Ön manuálisan hozzáadta a vásárlói fiókjához.
customer.store_credit_account.balance	A vásárló üzleti jóváírási egyenlegét adja vissza a releváns kontextushoz tartozó pénznemben. Például: `{{customer.store_credit_account.balance \| money_with_currency}}`
customer.tags	A vásárlóhoz társított címkéket adja vissza.
customer.tax_exempt	A(z) `igaz` értéket adja vissza, ha a vásárló adómentes, és a(z) `hamis` értéket, ha nem.
customer.total_spent	Visszaadja a teljes összeget, amelyet a vásárló az Ön üzletében az összes rendelésére költött.
email.*	Ez a változó hozzáférést biztosít a következő e-mail-tulajdonságokhoz: A(z) `subject` megjeleníti az e-mail tárgyát. A(z) `preview_text` megjeleníti az e-mail előnézeti szövegét.
open_tracking	Ez a változó hozzáférést biztosít az előre formázott nyitott követés blokkhoz. Erre a változóra akkor van szükség, ha egyéni kódolású e-mailt hoz létre, és aktiválta a nyitott követést.
shop.*	Ez a változó hozzáférést biztosít a következő üzlettulajdonságokhoz: A(z) `name` megjeleníti az üzlet nevét. A(z) `domain` megjeleníti az üzlet elsődleges tartományát. A(z) `url` megjeleníti az üzlet URL-címét. A(z) `shopify_domain` megjeleníti az üzlet Shopify-doménjét. `cím` megjeleníti az üzlet címét, amely hozzáférést biztosít a következő címtulajdonságokhoz: `address1` `address2` `city` `country` `phone` `province` `zip`
unsubscribe_url	Ez a változó hozzáférést biztosít a nyers leiratkozási URL-hez, és testreszabható. Ha egyéni kódolású e-mailt hoz létre, akkor kötelezően meg kell adnia a(z) `unsubscribe_url` vagy a(z) `unsubscribe_link` változót. Mind a(z) `unsubscribe_url`, mind a(z) `unsubscribe_link` mindig az elsődleges online áruház doménjére mutat, és nem módosítható úgy, hogy máshová irányítson.

Az elhagyott pénztárra vonatkozó e-mailekben támogatott Liquid-változók

A következő változókkal szabhatja testre a Liquid segítségével az elhagyott pénztárral kapcsolatos Shopify Messaging e-mail-üzeneteit.

A(z) abandoned_checkout változó csak akkor töltődik fel, ha az e-mail egy elhagyott pénztár marketingautomatizálás része. Ellenkező esetben a változó értéke null.

A Shopify Messaging által támogatott Liquid-változók leírása félbehagyott böngészés, elhagyott kosár és elhagyott pénztár esetén
Változó	Leírás
abandoned_checkout.*	Ez a változó egy elhagyott pénztár következő tulajdonságaihoz biztosít hozzáférést: A(z) `url` megjeleníti az elhagyott pénztár URL-címét. `line_items` megjeleníti az elhagyott pénztár első öt sorelemét. Ezenkívül minden egyes `line_items` objektum a következő tulajdonságokat tartalmazza az egyes termékekről: `components` `image_url` `product_title` `variant_title` `quantity` `line_items.components` megjeleníti az elhagyott pénztár komponenseit. Ezenkívül minden egyes `components` objektum az alábbi tulajdonságokat tartalmazza az egyes komponensekről: `image_url` `quantity` `product_title` `variant_title` A(z) `remaining_products_count` megjeleníti a fennmaradó sorelemek számát, ha az elhagyott pénztárban több mint öt sorelem van.
id (checkout ID)	A pénztár belső használatra szolgáló egyedi azonosítója.
shop	Az Ön Shopify-üzletének neve.
name	Az elhagyott pénztár neve, más néven a pénztár száma.
total_price	A rendelés teljes ára (részösszeg + szállítási költség - szállítási kedvezmény + adó).
shipping_price	A szállítási díj. Példa: `{{ shipping_price \| money }}`
shipping_address	A szállítási cím.
billing_address	A számlázási cím.
line_items	Az elhagyott pénztárban lévő összes sorelem listája.
unavailable_line_items	Az elhagyott pénztárban lévő, nem elérhető sorelemek listája.
note	Az elhagyott pénztárhoz csatolt megjegyzés.
landing_site	Annak a céloldalnak az útvonala, amelyet a vásárló használt. Ez az első oldal, amelyet a vásárló elért, amikor megérkezett az üzletbe. Példa: `/products/great-product?ref=my-tracking-token`
landing_site_ref	Kinyer egy hivatkozási paramétert a céloldalról. A hivatkozási paraméterek a következők lehetnek: `ref`, `source`, `r`. Ha a `landing_site` értéke `/products/great-product?ref=my-tracking-token`, akkor a `landing_site_ref` értéke `my-tracking-token`. Végrehajthat egy bizonyos műveletet, ha a hivatkozási paraméter egy adott értékkel egyenlő: {% if landing_site_ref == 'my-tracking-token' %} My action... {% endif %}
referring_site	Annak a hivatkozónak az URL-címe, amely a vásárlót az Ön üzletébe irányította. Példa: `https://www.google.com/?s=great+products`
created_at	Annak a pénztárnak a létrehozási dátuma és időpontja, amelyet a vásárló később elhagyott.
closed_at	A pénztár lezárásának dátuma és időpontja.
customer_locale	A vásárló területi beállításának két- vagy hárombetűs nyelvi kódja, amelyet opcionálisan egy régiómódosító követ. Például en , en-CA
item_count	Az összes tétel mennyiségének összege.
unique_gateways	A pénztárnál elérhető egyedi fizetési szolgáltatók listája.
discount	Az elhagyott pénztárban a kosárra vagy egy sorelemre alkalmazott kedvezmény.
discounts	A pénztárnál alkalmazott kedvezmények listája.
successfully_applied_discounts	A pénztárnál sikeresen alkalmazott kedvezmények.
discounts_amount	Az összes kedvezmény által biztosított kedvezmény összege dollárban. Példa: +5,00 $
discounts_savings	Az összes kedvezménynek köszönhető megtakarítás összege dollárban. Példa: -5,00 $
buyer_accepts_marketing	Visszaadja a(z) true vagy false attól függően, hogy a vásárló elfogadta-e a marketingcélú megkeresést az elhagyott pénztár folyamán.
subtotal_line_items	A pénztárnál a részösszeg kiszámításához használt sorelemek, a borravaló sorelemeinek kivételével.
requires_shipping	Visszaadja a(z) true ha a pénztárnál legalább egy tétel található, amely szállítást igényel.
subtotal_price	A pénztárnál lévő sorelemek részösszege.
email	Az elhagyott pénztárhoz társított e-mail-cím.
shop_name	Az üzlet neve.
tax_lines	Az adók adótípusok szerinti bontásban: {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}
tax_price	A pénztárban lévő összes tétel együttes adója.
attributes	Az elhagyott pénztárhoz csatolt bármely jellemző. Példa: `{{ attributes.gift-note }}`
shipping_method	Információk a pénztárnál elérhető első szállítási módról.
shipping_methods	A pénztárnál elérhető szállítási módok.
free	Visszaadja a(z) true if the total price of the checkout is zero.
free_shipping	Visszaadja a(z) true ha a pénztárnál nincs szükség szállításra, vagy ha a szállítási díj nulla.
different_billing_address	Visszaadja a(z) true vagy false attól függően, hogy a szállítási cím megegyezik-e a számlázási címmel.
customer	A vásárló kimenetének jellemzőit tartalmazó vásárlói objektum.
gift_cards	A pénztárnál felhasznált ajándékkártyák.
gift_cards_amount	A pénztárnál fizetendő összeg ajándékkártyákkal fizetendő része.
transactions	A pénztári tranzakciók.
shareable_url	A sorelemekben szereplő első termék URL-je.
shareable_title	Az első sorelem termékneve.
total_tip	A vásárló által a pénztárnál adott borravaló teljes összege.
discount_applications	Leírja, hogy egy tétel miért és hogyan kapott kedvezményt a pénztárban.
cart_level_discount_applications	A kosárra vonatkozó kedvezményalkalmazások.
currency	Az elhagyott pénztár valutája.
line_items_subtotal_price	A pénztár összes soreleme árának összege, a sorelemekre vonatkozó kedvezmények alkalmazása után.

Liquid-változók a félbehagyott böngészésre és az elhagyott kosárra vonatkozó e-mailekhez

Az abandoned_visit.* változó csak akkor töltődik ki, ha egy e-mail egy elhagyott kosárra vagy elhagyott termékek böngészésére vonatkozó marketingautomatizálás része. Tekintse át a következő tulajdonságokat, amelyekhez ez a változó hozzáférést biztosít.

A Shopify Messaging által támogatott Liquid-változók leírása
Változó	Leírás
abandoned_visit.*	Ez a változó hozzáférést biztosít az elhagyott kosár vagy böngészés következő tulajdonságaihoz: A `url` az elhagyott kosár vagy böngészés URL-jét jeleníti meg. `products_added_to_cart` megjeleníti az elhagyott látogatás során a kosárba helyezett első öt termék sorelemét. Ezenkívül minden `products_added_to_cart` objektum a következő tulajdonságokat tartalmazza az egyes termékekről: `title` `image_url` `variant_title` `quantity` `products_viewed` megjeleníti az elhagyott látogatás során megtekintett első öt terméket. Ezenkívül minden `products_viewed` objektum a következő tulajdonságokat tartalmazza az egyes termékekről: `title` `description` `image_url` `url` `image_alt_text` A `remaining_cart_products_count` megjeleníti a fennmaradó sorelemek számát, ha ötnél több sorelem van az elhagyott pénztárban.

Kötelező változók használata

Egyéni Liquid e-mail létrehozásakor az unsubscribe_link vagy unsubscribe_url változó megadása kötelező. Ha aktiválta a nyitott követést, akkor az open_tracking változó is kötelező.

Bár ezek a változók az e-mail kódjának bármely pontján elhelyezhetők, leggyakrabban az e-mail lábléc szakaszában szokták hozzáadni őket, ahogy a következő példa is mutatja:

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

Példa egyéni Liquid-kódra

Az egyéni Liquid- vagy HTML-kódot a kódszerkesztőben adhatja hozzá. A következő kód egy példa arra, hogyan adhat hozzá Liquid-kódot az üzletnév, egy egyéni gomb és egy egyéni méretű kép e-mail-üzenetben való megjelenítéséhez.

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