„Shopify Messaging“ kampanijų tinkinimas naudojant „Liquid“

„Liquid“ yra paprasta, lengvai naudojama „Shopify“ programavimo kalba. Tai ta pati programavimo kalba, kuria kuriamos temos iš „Shopify Theme Store“.

Galite naudoti pasirinktinį „Liquid“ kodą, kad patobulintumėte savo „Shopify Messaging“ pranešimus, sukurdami visiškai pagal kodą pritaikytą el. laišką arba pridėdami pasirinktinę „Liquid“ skiltį į šabloną. Šios parinktys leidžia įvesti pasirinktinį „Liquid“ arba HTML kodą.

Galite naudoti pasirinktinį „Liquid“ kodą, norėdami rodyti pasirinktinius išteklius, pavyzdžiui, vienas šalia kito esančius vaizdus, pasirinktinius mygtukus, pasirinktinio dydžio vaizdus ir pasirinktinius skilčių dydžius.

Šiame puslapyje

Svarstytini dalykai

Prieš pradėdami dėti pasirinktinį „Liquid“ kodą į savo „Shopify Messaging“ pranešimus, peržiūrėkite šiuos svarstytinus dalykus:

Kintamieji, kuriuos įtraukiate į savo kodą, turi būti palaikomi pasirinktinio „Liquid“ kodo.
Pasirinktinę „Liquid“ skiltį galite sukurti tik naudodami stalinį įrenginį.
Kintamasis unsubscribe_link arba unsubscribe_url yra privalomas pasirinktinio „Liquid“ kodo el. laiškuose. Jei aktyvavote atidarymo sekimą, kintamasis open_tracking taip pat yra privalomas. Sužinokite daugiau apie privalomų kintamųjų įtraukimą į el. laišką.
Įvestas kodas turi šiuos apribojimus:
- Ne daugiau kaip 50 kilobaitų (KB) pasirinktinėms „Liquid“ skiltims.
- Ne daugiau kaip 500 KB pagal kodą pritaikytiems „Liquid“ el. laiškams.

Pagal kodą pritaikyto el. laiško kūrimas naudojant „Liquid“

Jei norite naudoti pasirinktinį „Liquid“ kodą kurdami el. laišką, galite pridėti pasirinktinę „Liquid“ skiltį arba sukurti el. laišką vien iš pasirinktinio „Liquid“ kodo, pasirinkdami Sukurti savo kodą, kai kuriate „Shopify Messaging“ kampaniją.

„Liquid“ kintamieji, palaikomi pasirinktiniame „Liquid“ kode

Galite naudoti palaikomus kintamuosius, kad pritaikytumėte savo „Shopify Messaging“ el. laiškus su „Liquid“. Galite peržiūrėti palaikomų „Liquid“ kintamųjų sąrašus, skirtus šiems šablonų tipams:

„Liquid“ kintamieji, palaikomi visuose el. laiškų šablonuose

Galite naudoti šiuos kintamuosius, norėdami su „Liquid“ tinkinti bet kurį savo „Shopify Messaging“ el. laišką.

„Shopify Messaging“ palaikomų „Liquid“ kintamųjų aprašas
Kintamasis	Aprašymas
all_products	Visi produktai Jūsų parduotuvėje.
customer.accepts_marketing	Grąžina `true`, jei klientas sutinka gauti rinkodaros pranešimus, ir `false`, jei ne.
customer.addresses	Grąžina visus su klientu susijusius adresus.
customer.addresses_count	Grąžina su klientu susijusių adresų skaičių.
customer.b2b?	Grąžina `true`, jei klientas yra verslo klientas (B2B), ir `false`, jei ne.
customer.current_location	Grąžina šiuo metu pasirinktą kliento įmonės padalinį.
customer.default_address	Grąžina kliento numatytąjį adresą.
customer.email	Grąžina kliento el. pašto adresą.
customer.first_name	Grąžina kliento vardą.
customer.has_account	Grąžina `true`, jei kliento el. paštas yra susietas su kliento paskyra, ir `false`, jei ne.
customer.has_avatar?	Grąžina `true`, jei klientas turi su savo paskyra susietą avatarą, ir `false`, jei neturi.
customer.id	Grąžina kliento ID.
customer.last_name	Grąžina kliento pavardę.
customer.last_order	Grąžina paskutinį kliento pateiktą užsakymą, neįskaitant bandomųjų užsakymų.
customer.name	Grąžina kliento vardą ir pavardę.
customer.orders	Grąžina visus kliento pateiktus užsakymus.
customer.orders_count	Grąžina bendrą kliento pateiktų užsakymų skaičių.
customer.payment_methods	Grąžina kliento išsaugotus mokėjimo būdus.
customer.phone	Grąžina kliento telefono numerį. Telefono numeris užpildomas tik tuo atveju, jei klientas naudojo telefono numerį atsiskaitydamas, sutiko gauti SMS pranešimus arba jei Jūs rankiniu būdu jį pridėjote prie kliento paskyros.
customer.store_credit_account.balance	Grąžina kliento parduotuvės kredito likutį valiuta, susieta su atitinkamu kontekstu. Pavyzdžiui: `{{customer.store_credit_account.balance \| money_with_currency}}`
customer.tags	Grąžina su klientu susietas žymas.
customer.tax_exempt	Grąžina `true`, jei klientas yra atleistas nuo mokesčių, ir `false`, jei ne.
customer.total_spent	Grąžina bendrą sumą, kurią klientas išleido visiems užsakymams Jūsų parduotuvėje.
email.*	Šis kintamasis suteikia prieigą prie šių el. laiško ypatybių: `subject` rodo el. laiško temos eilutę. `preview_text` rodo el. laiško peržiūros tekstą.
open_tracking	Šis kintamasis suteikia prieigą prie iš anksto suformatuoto atviro sekimo bloko. Šis kintamasis yra būtinas, jei kuriate pasirinktinai koduotą el. laišką ir esate aktyvavę atvirą sekimą.
shop.*	Šis kintamasis suteikia prieigą prie šių parduotuvės ypatybių: `name` rodo parduotuvės pavadinimą. `domain` rodo pagrindinį parduotuvės domeną. `url` rodo parduotuvės URL. `shopify_domain` rodo parduotuvės „Shopify“ domeną. `adresas` rodo parduotuvės adresą, kuris suteikia prieigą prie šių adreso ypatybių: `address1` `address2` `city` `country` `phone` `province` `zip`
unsubscribe_url	Šis kintamasis suteikia prieigą prie neapdoroto prenumeratos atsisakymo URL, kurį galima tinkinti. Jei kuriate pasirinktinai koduotą el. laišką, privalote įtraukti kintamąjį `unsubscribe_url` arba `unsubscribe_link`. Tiek `unsubscribe_url`, tiek `unsubscribe_link` visada nukreips į pagrindinį internetinės parduotuvės domeną ir jų negalima modifikuoti, kad nukreiptų kitur.

„Liquid“ kintamieji, palaikomi nebaigto atsiskaitymo el. laiškuose

Naudodami šiuos kintamuosius su „Liquid“, galite tinkinti savo „Shopify Messaging“ nebaigto atsiskaitymo el. laiškus.

Kintamasis abandoned_checkout užpildomas tik tuo atveju, jei el. laiškas yra nebaigto atsiskaitymo rinkodaros automatizavimo dalis. Kitu atveju kintamasis yra null.

„Shopify Messaging“ palaikomų „Liquid“ kintamųjų, skirtų nutrauktam naršymo seansui, krepšeliui ir nebaigtam atsiskaitymui, aprašas
Kintamasis	Aprašymas
abandoned_checkout.*	Šis kintamasis suteikia prieigą prie šių nebaigto atsiskaitymo ypatybių: `url` rodo nebaigto atsiskaitymo URL. `prekių pozicijos` rodo pirmas penkias nebaigto atsiskaitymo prekių pozicijas. Be to, kiekviename `prekių pozicijos` objekte yra šios kiekvieno produkto ypatybės: `components` `image_url` `product_title` `variant_title` `quantity` `line_items.components` rodo nebaigto atsiskaitymo komponentus. Be to, kiekviename `components` objekte yra šios kiekvieno komponento ypatybės: `image_url` `quantity` `product_title` `variant_title` `remaining_products_count` rodo likusių prekių pozicijų skaičių, jei nebaigtame atsiskaityme yra daugiau nei penkios prekių pozicijos.
id (checkout ID)	Unikalus atsiskaitymo ID, skirtas vidiniam naudojimui.
shop	Jūsų „Shopify“ parduotuvės pavadinimas.
name	Nebaigto atsiskaitymo pavadinimas, dar vadinamas atsiskaitymo numeriu.
total_price	Bendra užsakymo kaina (tarpinė suma + siuntimo kaina – siuntimo nuolaida + mokesčiai).
shipping_price	Pristatymo kaina. Pavyzdys: `{{ shipping_price \| money }}`
shipping_address	Pristatymo adresas.
billing_address	Atsiskaitymo adresas.
line_items	Visų nebaigtame atsiskaityme esančių prekių pozicijų sąrašas.
unavailable_line_items	Visų nebaigtame atsiskaityme esančių, bet neprieinamų prekių pozicijų sąrašas.
note	Prie nebaigto atsiskaitymo pridėta pastaba.
landing_site	Nukreipimo svetainės, kurią naudojo klientas, kelias. Tai pirmasis puslapis, į kurį klientas pateko atėjęs į parduotuvę. Pavyzdys: `/products/great-product?ref=my-tracking-token`
landing_site_ref	Iš nukreipimo svetainės ištraukia nuorodos parametrą. Nuorodos parametrai gali būti: `ref`, `source`, `r`. Jei `landing_site` yra `/products/great-product?ref=my-tracking-token`, tuomet `landing_site_ref` yra `my-tracking-token`. Galite atlikti tam tikrą veiksmą, jei jūsų nuorodos parametras yra lygus tam tikrai vertei: {% if landing_site_ref == 'my-tracking-token' %} My action... {% endif %}
referring_site	Nukreipėjo, kuris atvedė klientą į Jūsų parduotuvę, URL. Pavyzdys: `https://www.google.com/?s=great+products`
created_at	Data ir laikas, kada klientas sukūrė atsiskaitymą, kurį vėliau nutraukė.
closed_at	Data ir laikas, kada atsiskaitymas buvo uždarytas.
customer_locale	Dviejų arba trijų raidžių kliento lokalės kalbos kodas, po kurio pasirinktinai gali eiti regiono modifikatorius. Pavyzdžiui, en , en-CA
item_count	Visų daiktų kiekių suma.
unique_gateways	Unikalių mokėjimo paslaugų teikėjų, pasiekiamų atsiskaitymo metu, sąrašas.
discount	Nuolaida, pritaikyta krepšeliui arba prekių pozicijai nebaigto atsiskaitymo metu.
discounts	Nuolaidų, pritaikytų atsiskaitymo metu, sąrašas.
successfully_applied_discounts	Nuolaidos, kurios buvo sėkmingai pritaikytos atsiskaitymo metu.
discounts_amount	Visų pritaikytų nuolaidų suma doleriais. Pavyzdys: +5,00 $
discounts_savings	Visų nuolaidų suteiktų sutaupymų suma doleriais. Pavyzdys: -5,00 $
buyer_accepts_marketing	Grąžina true arba false priklausomai nuo to, ar klientas sutiko gauti rinkodaros pranešimus nebaigto atsiskaitymo metu.
subtotal_line_items	Prekių pozicijos, kurios naudojamos tarpinei sumai apskaičiuoti atsiskaitymo metu, neįskaitant arbatpinigių prekių pozicijų.
requires_shipping	Grąžina true , jei atsiskaitymo metu yra bent vienas daiktas, kurį reikia pristatyti.
subtotal_price	Prekių pozicijų tarpinė suma atsiskaitymo metu.
email	El. paštas, susietas su nebaigtu atsiskaitymu.
shop_name	Jūsų parduotuvės pavadinimas.
tax_lines	Mokesčiai, suskirstyti pagal mokesčių tipą: {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}
tax_price	Bendra visų atsiskaitymo metu esančių daiktų mokesčių suma.
attributes	Visi atributai, kurie buvo pridėti prie nebaigto atsiskaitymo. Pavyzdys: `{{ attributes.gift-note }}`
shipping_method	Informacija apie pirmąjį siuntimo būdą, pasiekiamą atsiskaitymo metu.
shipping_methods	Siuntimo būdai, pasiekiami atsiskaitymo metu.
free	Grąžina true if the total price of the checkout is zero.
free_shipping	Grąžina true , jei atsiskaitymui nereikalingas pristatymas arba jei pristatymo kaina yra nulis.
different_billing_address	Grąžina true arba false atsižvelgiant į tai, ar pristatymo adresas sutampa su sąskaitos pateikimo adresu.
customer	Kliento objektas, kuriame yra kliento išvesties atributai.
gift_cards	Dovanų kortelės, pritaikytos atsiskaitymo metu.
gift_cards_amount	Atsiskaitymo kainos dalis, kuri būtų apmokėta dovanų kortelėmis.
transactions	Atsiskaitymo operacijos.
shareable_url	Pirmojo produkto URL prekių pozicijose.
shareable_title	Pirmosios prekių pozicijos produkto pavadinimas.
total_tip	Bendra arbatpinigių suma, kurią klientas pridėjo atsiskaitymo metu.
discount_applications	Aprašoma, kodėl ir kaip daiktui buvo pritaikyta nuolaida atsiskaitymo metu.
cart_level_discount_applications	Krepšeliui skirti nuolaidų pritaikymai.
currency	Nebaigto atsiskaitymo valiuta.
line_items_subtotal_price	Visų atsiskaitymo prekių pozicijų kainų suma, pritaikius visas prekių pozicijų nuolaidas.

„Liquid“ kintamieji, skirti nutraukto naršymo seanso ir palikto krepšelio el. laiškams

Kintamasis abandoned_visit.* užpildomas tik tuo atveju, jei el. laiškas yra palikto krepšelio arba apleisto produkto naršymo rinkodaros automatizavimo dalis. Peržiūrėkite tolesnes ypatybes, prie kurių šis kintamasis suteikia prieigą.

„Shopify Messaging“ palaikomų „Liquid“ kintamųjų aprašas
Kintamasis	Aprašymas
abandoned_visit.*	Šis kintamasis suteikia prieigą prie šių palikto krepšelio arba naršymo ypatybių: `url` rodo palikto krepšelio arba naršymo URL. `products_added_to_cart` rodo pirmąsias penkias produktų prekių pozicijas, įdėtas į krepšelį per nutrauktą apsilankymą. Be to, kiekvienas `products_added_to_cart` objektas turi šias kiekvieno produkto ypatybes: `title` `image_url` `variant_title` `quantity` `products_viewed` rodo pirmuosius penkis produktus, peržiūrėtus per nutrauktą apsilankymą. Be to, kiekvienas `products_viewed` objektas turi šias kiekvieno produkto ypatybes: `title` `description` `image_url` `url` `image_alt_text` `remaining_cart_products_count` rodo likusių prekių pozicijų skaičių, jei nebaigto atsiskaitymo metu yra daugiau nei penkios prekių pozicijos.

Būtinųjų kintamųjų naudojimas

Kai kuriate pasirinktinį „Liquid“ el. laišką, kintamasis unsubscribe_link arba unsubscribe_url yra būtinas. Jei aktyvavote atvirą sekimą, kintamasis open_tracking taip pat yra būtinas.

Nors šiuos kintamuosius galima įterpti bet kurioje el. laiško kodo vietoje, dažniausiai jie pridedami el. laiško poraštės skiltyje, kaip nurodyta tolesniame pavyzdyje:

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

Pasirinktinio „Liquid“ kodo pavyzdys

Galite pridėti pasirinktinį „Liquid“ arba HTML kodą kodo rengyklėje. Tolesnis kodas yra pavyzdys, kaip galite pridėti „Liquid“ kodą, kad el. laiške būtų rodomas Jūsų parduotuvės pavadinimas, pasirinktinis mygtukas ir pasirinktinio dydžio vaizdas.

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