Prispôsobenie kampaní Shopify Messaging pomocou kódu Liquid
Liquid je jednoduchý a ľahko použiteľný programovací jazyk platformy Shopify. Ide o ten istý programovací jazyk, v ktorom sú vytvorené témy z obchodu Shopify Theme Store.
Vlastný kód Liquid môžete použiť na vylepšenie správ služby Shopify Messaging tak, že vytvoríte e-mail výlučne pomocou vlastného kódu alebo že do šablóny pridáte sekciu vlastného kódu Liquid. Tieto možnosti vám umožňujú zadávať vlastný kód Liquid alebo HTML.
Vlastný kód Liquid môžete použiť na zobrazenie vlastných podkladov, ako sú obrázky vedľa seba, vlastné tlačidlá, obrázky s vlastnými veľkosťami a vlastné veľkosti sekcií.
Na tejto stránke
Dôležité informácie
Pred pridaním vlastného kódu Liquid do správ služby Shopify Messaging si prečítajte nasledujúce dôležité informácie:
- Premenné, ktoré zahrniete do svojho kódu, musia byť podporované vlastným kódom Liquid.
- Sekciu s vlastným kódom Liquid môžete vytvoriť len v počítači.
- V e-mailoch s vlastným kódom Liquid sa vyžaduje premenná
unsubscribe_linkalebounsubscribe_url. Ak ste aktivovali sledovanie otvárania, vyžaduje sa aj premennáopen_tracking. Získajte viac informácií o pridávaní povinných premenných do e-mailu. - Kód, ktorý zadávate, má nasledujúce obmedzenia:
- Maximálne 50 kilobajtov (kB) pre sekcie vlastného kódu Liquid.
- Maximálne 500 kB pre e-maily s vlastným kódom Liquid.
Vytvorenie e-mailu s vlastným kódom Liquid
Ak chcete pri vytváraní e-mailu použiť vlastný kód Liquid, môžete buď pridať sekciu vlastného kódu Liquid, alebo vytvoriť e-mail výlučne z vlastného kódu Liquid tak, že pri vytváraní kampane Shopify Messaging vyberiete možnosť Vlastný kód.
Premenné Liquid podporované vo vlastnom kóde Liquid
Pomocou podporovaných premenných môžete svoje e-mailové správy služby Shopify Messaging prispôsobiť pomocou kódu Liquid. Môžete si pozrieť zoznamy podporovaných premenných Liquid pre nasledujúce typy šablón:
- Všetky šablóny e-mailov
- Šablóny e-mailov o opustenej pokladni
- Šablóny e-mailov o opustenom prehliadaní a opustenom košíku
Premenné Liquid podporované pre všetky šablóny e-mailov
Nasledujúce premenné môžete použiť na prispôsobenie akejkoľvek svojej e-mailovej správy služby Shopify Messaging pomocou kódu Liquid.
| Premenná | Popis |
|---|---|
all_products | Všetky produkty vo vašom obchode. |
customer.accepts_marketing | Vráti hodnotu true, ak zákazník prijíma marketing, a hodnotu false, ak nie. |
customer.addresses | Vráti všetky adresy priradené k zákazníkovi. |
customer.addresses_count | Vráti počet adries priradených k zákazníkovi. |
customer.b2b? | Vráti hodnotu true, ak ide o zákazníka B2B, a hodnotu false, ak nie. |
customer.current_location | Vráti aktuálne vybranú lokalitu spoločnosti pre zákazníka. |
customer.default_address | Vráti predvolenú adresu zákazníka. |
customer.email | Vráti e-mailovú adresu zákazníka. |
customer.first_name | Vráti krstné meno zákazníka. |
customer.has_account | Vráti hodnotu true, ak je e-mail zákazníka prepojený so zákazníckym účtom, a hodnotu false, ak nie. |
customer.has_avatar? | Vráti hodnotu true, ak má zákazník so svojím účtom prepojeného avatara, a hodnotu false, ak nie. |
customer.id | Vráti ID zákazníka. |
customer.last_name | Vráti priezvisko zákazníka. |
customer.last_order | Vráti poslednú objednávku zadanú zákazníkom (nezahŕňa skúšobné objednávky). |
customer.name | Vráti celé meno zákazníka. |
customer.orders | Vráti všetky objednávky zadané zákazníkom. |
customer.orders_count | Vráti celkový počet objednávok, ktoré zákazník zadal. |
customer.payment_methods | Vráti uložené spôsoby platby zákazníka. |
customer.phone | Vráti telefónne číslo zákazníka. Telefónne číslo sa vyplní len vtedy, ak zákazník zadal telefónne číslo v pokladni, prihlásil sa na odber SMS upozornení alebo ak ste mu ho do zákazníckeho účtu pridali manuálne. |
customer.store_credit_account.balance | Vráti zostatok kreditu v obchode zákazníka v mene priradenej k príslušnému kontextu. Napríklad: |
customer.tags | Vráti štítky priradené k zákazníkovi. |
customer.tax_exempt | Vráti hodnotu true, ak je zákazník oslobodený od dane, a hodnotu false, ak nie je. |
customer.total_spent | Vráti celkovú sumu, ktorú zákazník minul na všetky objednávky z vášho obchodu. |
email.* | Táto premenná poskytuje prístup k nasledujúcim vlastnostiam e‑mailu: subject zobrazuje predmet e‑mailu.preview_text zobrazuje text ukážky e‑mailu. |
open_tracking | Táto premenná poskytuje prístup k vopred naformátovanému bloku sledovania otvárania. Táto premenná je povinná, ak vytvoríte e-mail s vlastným kódom a aktivovali ste sledovanie otvárania. |
shop.* | Táto premenná poskytuje prístup k nasledujúcim vlastnostiam obchodu:
name zobrazuje názov obchodu.domain zobrazuje primárnu doménu obchodu.url zobrazuje URL obchodu.shopify_domain zobrazuje doménu Shopify obchodu.
|
unsubscribe_url | Táto premenná poskytuje prístup k nespracovanej URL adrese na zrušenie odberu a dá sa prispôsobiť. Ak vytvoríte e-mail s vlastným kódom, musíte doň zahrnúť premennú unsubscribe_url alebo unsubscribe_link. Premenné unsubscribe_url aj unsubscribe_link budú vždy smerovať na primárnu doménu online obchodu a nedajú sa upraviť tak, aby smerovali inam. |
Podporované premenné Liquid pre e-maily o opustenej pokladni
Nasledujúce premenné môžete použiť na prispôsobenie e‑mailových správ o opustenej pokladni v aplikácii Shopify Messaging pomocou premenných Liquid.
Premenná abandoned_checkout sa vyplní, len ak je e‑mail súčasťou marketingovej automatizácie pre opustenú pokladňu. V opačnom prípade má premenná hodnotu null.
| Premenná | Popis |
|---|---|
abandoned_checkout.* | Táto premenná poskytuje prístup k nasledujúcim vlastnostiam opustenej pokladne:
|
id(checkout ID) | Jedinečné ID pokladne na interné použitie. |
shop | Názov vášho obchodu Shopify. |
name | Názov opustenej pokladne, známy aj ako číslo pokladne. |
total_price | Celková cena objednávky (medzisúčet + náklady na dopravu - zľava na dopravu + daň). |
shipping_price |
Cena za dopravu. Príklad: |
shipping_address | Adresa doručenia. |
billing_address | Fakturačná adresa. |
line_items | Zoznam všetkých samostatných položiek v opustenej pokladni. |
unavailable_line_items | Zoznam všetkých samostatných položiek v opustenej pokladni, ktoré nie sú k dispozícii. |
note | Poznámka, ktorá je pripojená k opustenej pokladni. |
landing_site |
Cesta k vstupnej stránke, ktorú zákazník použil. Je to prvá stránka, na ktorú zákazník pri príchode do obchodu prešiel. Príklad: |
landing_site_ref |
Extrahuje referenčný parameter zo vstupnej stránky. Referenčné parametre môžu byť: Ak je {% if landing_site_ref == 'my-tracking-token' %}
My action...
{% endif %}
|
referring_site |
URL odkazujúceho zdroja, ktorý priviedol zákazníka do vášho obchodu. Príklad: |
created_at | Dátum a čas, kedy zákazník vytvoril pokladňu, ktorú opustil. |
closed_at | Dátum a čas, kedy bola pokladňa zatvorená. |
customer_locale | Dvoj- alebo trojpísmenový kód jazyka pre jazyk a región zákazníka, za ktorým voliteľne nasleduje modifikátor regiónu. Napríklad en, en-CA |
item_count | Súčet množstiev všetkých položiek. |
unique_gateways | Zoznam jedinečných poskytovateľov platieb, ktorí sú v pokladni k dispozícii. |
discount | Zľava uplatnená na košík alebo samostatnú položku v opustenej pokladni. |
discounts | Zoznam zliav uplatnených v pokladni. |
successfully_applied_discounts | Zľavy, ktoré sa úspešne uplatnili v pokladni. |
discounts_amount | Peňažná suma zľavy uplatnená všetkými zľavami. Príklad: +$5.00 |
discounts_savings | Peňažná suma úspor spôsobených všetkými zľavami. Príklad: -$5.00 |
buyer_accepts_marketing | Vráti truealebo falsev závislosti od toho, či zákazník súhlasil s marketingom v opustenej pokladni. |
subtotal_line_items | Samostatné položky, ktoré sa používajú na výpočet medzisúčtu v pokladni, s výnimkou akýchkoľvek samostatných položiek prepitného. |
requires_shipping | Vráti trueak sa v pokladni nachádza aspoň jedna položka, ktorá vyžaduje dopravu. |
subtotal_price | Medzisúčet cien samostatných položiek v pokladni. |
| E-mailová adresa spojená s opustenou pokladňou. | |
shop_name | Názov vášho obchodu. |
tax_lines |
Dane rozdelené podľa typu dane: {% for tax_line in tax_lines %}
{{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }}
{% endfor %}
|
tax_price | Celkové dane za všetky položky v pokladni. |
attributes |
Akékoľvek atribúty, ktoré boli pripojené k opustenej pokladni. Príklad: |
shipping_method | Informácie o prvom spôsobe dopravy, ktorý je k dispozícii v pokladni. |
shipping_methods | Spôsoby dopravy, ktoré sú k dispozícii v pokladni. |
free | Vráti true if the total price of the checkout is zero. |
free_shipping | Vráti trueak pokladňa nevyžaduje dopravu alebo ak je cena za dopravu nula. |
different_billing_address | Vráti truealebo falsena základe toho, či je dodacia adresa rovnaká ako fakturačná adresa. |
customer | Objekt zákazníka obsahujúci atribúty výstupu tagu customer. |
gift_cards | Darčekové karty uplatnené v pokladni. |
gift_cards_amount | Časť ceny v pokladni, ktorá by sa uhradila darčekovými kartami. |
transactions | Transakcie v pokladni. |
shareable_url | Adresa URL prvého produktu v samostatných položkách. |
shareable_title | Názov produktu prvej samostatnej položky. |
total_tip | Celkové prepitné, ktoré zákazník pridal v pokladni. |
discount_applications | Opisuje dôvod a spôsob zľavnenia položky v pokladni. |
cart_level_discount_applications | Aplikácie zliav špecifické pre konkrétny košík. |
currency | Mena opustenej pokladne. |
line_items_subtotal_price | Súčet cien všetkých samostatných položiek v pokladni po uplatnení akýchkoľvek zliav na samostatné položky. |
Premenné Liquid pre e-maily o opustenom prehliadaní a opustenom košíku
Premenná abandoned_visit.* sa vyplní, len ak je e-mail súčasťou automatizácie marketingu pre opustený košík alebo prehliadanie opustených produktov. Pozrite si nasledujúce vlastnosti, ku ktorým táto premenná poskytuje prístup.
| Premenná | Popis |
|---|---|
abandoned_visit.* | Táto premenná poskytuje prístup k nasledujúcim vlastnostiam opusteného košíka alebo prehliadania:
|
Používanie povinných premenných
Keď vytvárate e-mail s vlastným kódom Liquid, vyžaduje sa premenná unsubscribe_link alebo unsubscribe_url. Ak ste aktivovali sledovanie otvárania, vyžaduje sa aj premenná open_tracking.
Hoci je možné tieto premenné vložiť kdekoľvek v kóde e-mailu, najčastejšie sa pridávajú do sekcie päty e-mailu, ako v nasledujúcom príklade:
<div id="footer">{{ unsubscribe_link }} {{ open_tracking_block }}</div>Príklad vlastného kódu Liquid
Vlastný kód Liquid alebo HTML môžete pridať v editore kódu. Nasledujúci kód je príkladom, ako môžete pridať kód Liquid na zobrazenie názvu obchodu, vlastného tlačidla a obrázka vlastnej veľkosti v e-mailovej správe.
<!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>