Персонализиране на Вашите Shopify Messaging кампании с помощта на Liquid

Liquid е прост, лесен за използване език за програмиране на Shopify и е същият език за програмиране, с който са създадени темите от Shopify Theme Store.

Можете да използвате персонализиран Liquid код, за да подобрите съобщенията си в Shopify Messaging, като създадете изцяло персонализиран кодиран имейл или като добавите персонализиран Liquid раздел към шаблон. Тези опции Ви позволяват да въвеждате персонализиран Liquid или HTML код.

Можете да използвате персонализиран Liquid код, за да показвате персонализирани активи, като например съпоставени изображения, персонализирани бутони, изображения с персонализиран размер и персонализирани размери на секции.

На тази страница

Съображения

Прегледайте следните съображения, преди да започнете да добавяте персонализиран Liquid код към Вашите Shopify Messaging съобщения:

Променливите, които включвате в кода си, трябва да се поддържат от персонализиран Liquid код.
Можете да използвате само настолно устройство, за да създадете персонализиран Liquid раздел.
Променливата unsubscribe_link или unsubscribe_url е задължителна в персонализирани Liquid имейли. Ако сте активирали проследяване на отваряне на имейли, тогава променливата open_tracking също е задължителна. Научете повече за добавянето на задължителни променливи към Вашия имейл.
Кодът, който въвеждате, има следните ограничения:
- Максимум 50 килобайта (КВ) за персонализирани Liquid раздели.
- Максимум 500 КВ за персонализирани кодирани Liquid имейли.

Създаване на персонализиран кодиран имейл с Liquid

Ако искате да използвате персонализиран Liquid код, когато създавате имейл, можете или да добавите персонализиран Liquid раздел, или да създадете имейл изцяло от персонализиран Liquid код, като изберете „Кодирайте свой собствен“, когато създавате Shopify Messaging кампания.

Поддържани променливи на Liquid в персонализиран Liquid код

Можете да използвате поддържани променливи, за да персонализирате Вашите имейл съобщения в Shopify Messaging с Liquid. Можете да прегледате списъците с поддържани променливи на Liquid за следните типове шаблони:

Поддържани променливи на Liquid за всички имейл шаблони

Можете да използвате следните променливи, за да персонализирате всяко от Вашите имейл съобщения в Shopify Messaging с Liquid.

Описание на поддържаните променливи на Liquid в Shopify Messaging
Променлива	Описание
all_products	Всички продукти във Вашия магазин.
customer.accepts_marketing	Връща `true`, ако клиентът приема маркетинг, и `false`, ако не.
customer.addresses	Връща всички адреси, свързани с клиента.
customer.addresses_count	Връща броя на адресите, свързани с клиента.
customer.b2b?	Връща `true`, ако клиентът е B2B клиент, и `false`, ако не.
customer.current_location	Връща текущо избраната локация на компанията за клиента.
customer.default_address	Връща основния адрес на клиента.
customer.email	Връща имейл адреса на клиента.
customer.first_name	Връща собственото име на клиента.
customer.has_account	Връща `true`, ако имейлът на клиента е свързан с клиентски акаунт, и `false`, ако не.
customer.has_avatar?	Връща `true`, ако клиентът има аватар, свързан с акаунта си, и `false`, ако няма.
customer.id	Връща идентификатора на клиента.
customer.last_name	Връща фамилията на клиента.
customer.last_order	Връща последната поръчка, направена от клиента, без да се включват тестовите поръчки.
customer.name	Връща пълното име на клиента.
customer.orders	Връща всички поръчки, които клиентът е направил.
customer.orders_count	Връща общия брой поръчки, които клиентът е направил.
customer.payment_methods	Връща запазените начини на плащане на клиента.
customer.phone	Връща телефонния номер на клиента. Телефонният номер се попълва само ако клиентът е използвал телефонен номер при плащане, абонирал се е за SMS известия или ако сте го добавили ръчно към клиентския му акаунт.
customer.store_credit_account.balance	Връща салдото по кредита в магазина на клиента във валутата, свързана със съответния контекст. Например: `{{customer.store_credit_account.balance \| money_with_currency}}`
customer.tags	Връща таговете, свързани с клиента.
customer.tax_exempt	Връща `true`, ако клиентът е освободен от данъци, и `false`, ако не е.
customer.total_spent	Връща общата сума, която клиентът е похарчил за всички поръчки от Вашия магазин.
email.*	Тази променлива дава достъп до следните свойства на имейла: `subject` показва темата на имейла. `preview_text` показва текста за предварителен преглед на имейла.
open_tracking	Тази променлива дава достъп до предварително форматирания блок за проследяване на отваряне на имейли. Променливата е задължителна, ако създавате имейл с персонализиран код и сте активирали проследяването на отваряне на имейли.
shop.*	Тази променлива дава достъп до следните свойства на магазина: `name` показва името на магазина. `domain` показва основния домейн на магазина. `url` показва URL на магазина. `shopify_domain` показва Shopify домейна на магазина. `address` показва адреса на магазина, който дава достъп до следните свойства на адреса: `address1` `address2` `city` `country` `phone` `province` `zip`
unsubscribe_url	Тази променлива дава достъп до необработения URL адрес за отписване и може да бъде персонализирана. Ако създавате имейл с персонализиран код, тогава трябва да включите променливата `unsubscribe_url` или `unsubscribe_link`. И `unsubscribe_url`, и `unsubscribe_link` винаги сочат към основния домейн на онлайн магазина и не могат да бъдат променяни, за да пренасочват другаде.

Поддържани променливи на Liquid за имейли за незавършен процес на поръчка

Можете да използвате следните променливи, за да персонализирате с Liquid имейл съобщенията си в Shopify Messaging за незавършен процес на поръчка.

Променливата abandoned_checkout се попълва само ако имейлът е част от маркетингова автоматизация за незавършен процес на поръчка. В противен случай променливата е null.

Описание на поддържаните от Shopify Messaging променливи на Liquid за изоставено разглеждане, изоставена количка и незавършен процес на поръчка
Променлива	Описание
abandoned_checkout.*	Тази променлива дава достъп до следните свойства на незавършен процес на поръчка: `url` показва URL адреса на незавършения процес на поръчка. `line_items` показва първите пет реда от незавършения процес на поръчка. Освен това всеки `line_items` обект съдържа следните свойства за всеки продукт: `components` `image_url` `product_title` `variant_title` `quantity` `line_items.components` показва компонентите на незавършения процес на поръчка. Освен това всеки `components` обект съдържа следните свойства за всеки компонент: `image_url` `quantity` `product_title` `variant_title` `remaining_products_count` показва броя на оставащите редове, ако в незавършения процес на поръчка има повече от пет реда.
id (checkout ID)	Уникален идентификатор на плащането за вътрешна употреба.
shop	Името на Вашия магазин в Shopify.
name	Името на незавършения процес на поръчка, известно още като номер на плащането.
total_price	Общата цена на поръчката (междинна сума + разходи за доставка - отстъпка за доставка + данък).
shipping_price	Цената на доставката. Пример: `{{ shipping_price \| money }}`
shipping_address	Показва адреса за доставка.
billing_address	Показва адреса за фактуриране.
line_items	Списък на всички редове в незавършения процес на поръчка.
unavailable_line_items	Списък на всички редове в незавършения процес на поръчка, които не са налични.
note	Бележката, прикачена към незавършения процес на поръчка.
landing_site	Пътят до целевия сайт, който клиентът е използвал. Това е първата страница, до която клиентът е осъществил достъп при влизане в магазина. Пример: `/products/great-product?ref=my-tracking-token`
landing_site_ref	Извлича референтен параметър от целевия сайт. Референтните параметри могат да бъдат: `ref`, `source`, `r`. Ако `landing_site` е `/products/great-product?ref=my-tracking-token`, тогава `landing_site_ref` е `my-tracking-token`. Можете да извършите определено действие, ако Вашият референтен параметър е равен на определена стойност: {% if landing_site_ref == 'my-tracking-token' %} My action... {% endif %}
referring_site	Препращащият URL адрес, който е довел клиента до Вашия магазин. Пример: `https://www.google.com/?s=great+products`
created_at	Датата и часът, когато клиентът е създал плащането, което е изоставил.
closed_at	Датата и часът на затваряне на плащането.
customer_locale	Дву- или трибуквеният езиков код за езика и региона на клиента, по избор последван от модификатор за регион. Например en , en-CA
item_count	Сбор от количествата на всички артикули.
unique_gateways	Списък с уникалните доставчици на плащания, налични при плащането.
discount	Отстъпката, приложена към количката или към ред при незавършения процес на поръчка.
discounts	Списък с отстъпките, приложени при плащането.
successfully_applied_discounts	Отстъпките, които са били успешно приложени при плащането.
discounts_amount	Общата стойност в долари на приложените отстъпки. Пример: +5,00 USD
discounts_savings	Спестената сума в долари благодарение на всички отстъпки. Пример: -5,00 USD
buyer_accepts_marketing	Връща true или false в зависимост от това дали клиентът е приел маркетинг по време на незавършения процес на поръчка.
subtotal_line_items	Редовете, които се използват за изчисляване на междинната сума при плащането, с изключение на редовете за бакшиш.
requires_shipping	Връща true ако при плащането има поне един артикул, който изисква доставка.
subtotal_price	Междинната сума на редовете при плащането.
email	Имейлът, свързан с незавършения процес на поръчка.
shop_name	Името на Вашия магазин.
tax_lines	Данъците, разбити по вид данък: {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}
tax_price	Общата сума на данъците за всички артикули при плащането.
attributes	Всички атрибути, които са били прикачени към незавършения процес на поръчка. Пример: `{{ attributes.gift-note }}`
shipping_method	Информация за първия наличен начин на доставка при плащането.
shipping_methods	Начините на доставка, налични при плащането.
free	Връща true if the total price of the checkout is zero.
free_shipping	Връща true ако плащането не изисква доставка или ако цената за доставка е нула.
different_billing_address	Връща true или false в зависимост от това дали адресът за доставка е същият като адреса за фактуриране.
customer	Обектът на клиента, съдържащ атрибутите на изходните данни за клиента.
gift_cards	Подаръчните карти, приложени при плащането.
gift_cards_amount	Сумата от цената при плащане, която ще бъде платена с подаръчни карти.
transactions	Транзакциите при плащането.
shareable_url	URL на първия продукт в редовете.
shareable_title	Наименованието на продукта на първия ред.
total_tip	Общият бакшиш, който клиентът е добавил при плащането.
discount_applications	Описва защо и как е приложена отстъпка за артикул при плащането.
cart_level_discount_applications	Приложенията за отстъпки, специфични за количката.
currency	Валутата на незавършения процес на поръчка.
line_items_subtotal_price	Сборът от цените на всички редове при плащането, след прилагане на отстъпки за отделните редове.

Променливи на Liquid за имейли за изоставено разглеждане и изоставена количка

Променливата abandoned_visit.* се попълва само ако даден имейл е част от маркетингова автоматизация за изоставена количка или изоставено разглеждане на продукт. Прегледайте следните свойства, до които тази променлива дава достъп.

Описание на поддържаните променливи на Liquid в Shopify Messaging
Променлива	Описание
abandoned_visit.*	Тази променлива дава достъп до следните свойства на изоставена количка или разглеждане: `url` показва URL на изоставената количка или разглеждане. `Продукти, добавени в количката` показва първите пет реда с продукти, добавени в количката при изоставеното посещение. Освен това, всеки `Продукти, добавени в количката` обект съдържа следните свойства за всеки продукт: `title` `image_url` `variant_title` `quantity` `Разгледани продукти` показва първите пет продукта, разгледани по време на изоставеното посещение. Освен това, всеки `Разгледани продукти` обект съдържа следните свойства за всеки продукт: `title` `description` `image_url` `url` `image_alt_text` `remaining_cart_products_count` показва броя на оставащите редове, ако в незавършения процес на поръчка има повече от пет реда.

Използване на задължителни променливи

Когато създавате персонализиран имейл с Liquid, променливата unsubscribe_link или unsubscribe_url е задължителна. Ако сте активирали проследяването на отваряне на имейли, тогава променливата open_tracking също е задължителна.

Въпреки че тези променливи могат да бъдат вмъкнати навсякъде в кода на Вашия имейл, най-честото място за добавянето им е в долния колонтитул на имейла, както е показано в следния пример:

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

Пример за персонализиран код на Liquid

Можете да добавите свой персонализиран Liquid или HTML код в редактора на код. Следващият код е пример за това как можете да добавите код на Liquid за показване на името на Вашия магазин, персонализиран бутон и изображение с персонализиран размер в имейл съобщение.

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