Sesuaikan kempen Shopify Messaging anda menggunakan Liquid

Liquid merupakan bahasa pemprograman Shopify yang ringkas dan mudah digunakan, serta merupakan bahasa pemprograman yang sama yang digunakan untuk membina tema daripada Shopify Theme Store.

Anda boleh menggunakan Liquid tersuai untuk mempertingkat mesej Shopify Messaging anda dengan mencipta e-mel berkod tersuai sepenuhnya atau dengan menambah bahagian Liquid tersuai pada templat. Pilihan ini membolehkan anda memasukkan Liquid atau HTML tersuai.

Anda boleh menggunakan Liquid tersuai untuk memaparkan aset tersuai seperti imej bersebelahan, butang tersuai, imej bersaiz tersuai dan saiz bahagian tersuai.

Pada halaman ini

Pertimbangan

Semak pertimbangan yang berikut sebelum anda mula menambahkan Liquid tersuai pada mesej Shopify Messaging anda:

Pemboleh ubah yang anda sertakan dalam kod anda perlu disokong oleh Liquid tersuai.
Anda hanya boleh menggunakan peranti desktop untuk mencipta bahagian Liquid tersuai.
Pemboleh ubah unsubscribe_link atau unsubscribe_url diwajibkan dalam e-mel Liquid tersuai. Jika anda telah mengaktifkan penjejakan buka, pemboleh ubah open_tracking juga diwajibkan. Ketahui lebih lanjut tentang menambahkan pemboleh ubah yang diwajibkan pada e-mel anda.
Kod yang anda masukkan mempunyai had berikut:
- Maksimum 50 kilobait (KB) untuk bahagian Liquid tersuai.
- Maksimum 500 KB untuk e-mel Liquid berkod tersuai.

Mencipta e-mel berkod tersuai dengan Liquid

Jika anda ingin menggunakan kod Liquid tersuai semasa anda mencipta e-mel, anda boleh sama ada menambahkan bahagian Liquid tersuai, atau mencipta e-mel sepenuhnya daripada kod Liquid tersuai dengan memilih Kod anda sendiri semasa anda mencipta kempen Shopify Messaging.

Pemboleh ubah Liquid yang disokong dalam Liquid tersuai

Anda boleh menggunakan pemboleh ubah yang disokong untuk menyesuaikan mesej e-mel Shopify Messaging anda dengan Liquid. Anda boleh menyemak senarai pemboleh ubah Liquid yang disokong untuk jenis templat yang berikut:

Pemboleh ubah Liquid disokong untuk semua templat e-mel

Anda boleh menggunakan pemboleh ubah yang berikut untuk menyesuaikan mana-mana mesej e-mel Shopify Messaging anda dengan Liquid.

Perihalan pemboleh ubah Liquid yang disokong Shopify Messaging
Pemboleh ubah	Perihalan
all_products	Semua produk di kedai anda.
customer.accepts_marketing	Mengembalikan nilai `true` jika pelanggan menerima pemasaran dan mengembalikan nilai `false` jika tidak.
customer.addresses	Mengembalikan semua alamat yang diikat pada pelanggan.
customer.addresses_count	Mengembalikan bilangan alamat yang diikat pada pelanggan.
customer.b2b?	Mengembalikan nilai `true` jika pelanggan merupakan pelanggan B2B dan mengembalikan nilai `false` jika tidak.
customer.current_location	Mengembalikan lokasi syarikat yang sedang dipilih untuk pelanggan.
customer.default_address	Mengembalikan alamat lalai pelanggan.
customer.email	Mengembalikan alamat e-mel pelanggan.
customer.first_name	Mengembalikan nama pertama pelanggan.
customer.has_account	Mengembalikan nilai `true` jika e-mel pelanggan diikat pada akaun pelanggan dan mengembalikan nilai `false` jika tidak.
customer.has_avatar?	Mengembalikan nilai `true` jika pelanggan mempunyai avatar yang diikat pada akaun mereka dan mengembalikan nilai `false` jika tidak.
customer.id	Mengembalikan ID pelanggan.
customer.last_name	Mengembalikan nama akhir pelanggan.
customer.last_order	Mengembalikan pesanan terakhir yang dibuat oleh pelanggan, tidak termasuk pesanan ujian.
customer.name	Mengembalikan nama penuh pelanggan.
customer.orders	Mengembalikan semua pesanan yang telah dibuat oleh pelanggan.
customer.orders_count	Mengembalikan jumlah pesanan yang telah dibuat oleh pelanggan.
customer.payment_methods	Mengembalikan kaedah pembayaran pelanggan yang disimpan.
customer.phone	Mengembalikan nombor telefon pelanggan. Nombor telefon ini diisi hanya jika pelanggan menggunakan nombor telefon semasa pembayaran, telah ikut serta dalam pemberitahuan SMS, atau jika anda telah menambahkannya secara manual pada akaun pelanggan mereka.
customer.store_credit_account.balance	Mengembalikan baki kredit kedai pelanggan dalam mata wang yang dikaitkan dengan konteks yang berkaitan. Sebagai contoh: `{{customer.store_credit_account.balance \| money_with_currency}}`
customer.tags	Mengembalikan tag yang dikaitkan dengan pelanggan.
customer.tax_exempt	Mengembalikan `true` jika pelanggan dikecualikan daripada cukai, dan mengembalikan `false` jika tidak.
customer.total_spent	Mengembalikan jumlah amaun yang telah dibelanjakan oleh pelanggan pada semua pesanan dari kedai anda.
email.*	Pemboleh ubah ini memberikan akses kepada sifat e-mel yang berikut: `subject` memaparkan baris subjek e-mel. `preview_text` memaparkan teks pratonton e-mel.
open_tracking	Pemboleh ubah ini memberikan akses kepada blok penjejakan buka yang dipraformat. Pemboleh ubah ini diperlukan jika anda mencipta e-mel yang dikodkan secara tersuai dan telah mengaktifkan penjejakan buka.
shop.*	Pemboleh ubah ini memberikan akses kepada sifat kedai yang berikut: `name` memaparkan nama kedai. `domain` memaparkan domain utama kedai. `url` memaparkan URL kedai. `shopify_domain` memaparkan domain Shopify kedai. `address` memaparkan alamat kedai, yang memberikan akses kepada sifat alamat yang berikut: `address1` `address2` `city` `country` `phone` `province` `zip`
unsubscribe_url	Pemboleh ubah ini memberikan akses kepada URL nyahlanggan mentah, dan boleh disesuaikan. Jika anda mencipta e-mel yang dikodkan secara tersuai, maka anda dikehendaki memasukkan pemboleh ubah `unsubscribe_url` atau `unsubscribe_link`. Kedua-dua `unsubscribe_url` dan `unsubscribe_link` akan sentiasa menghala ke domain kedai dalam talian utama dan tidak boleh diubah suai untuk diarahkan ke tempat lain.

Pemboleh ubah Liquid yang disokong untuk e-mel pembayaran yang ditinggalkan

Anda boleh menggunakan pemboleh ubah yang berikut untuk menyesuaikan mesej e-mel Shopify Messaging pembayaran yang ditinggalkan anda dengan Liquid.

Pemboleh ubah abandoned_checkout diisi hanya jika e-mel ialah sebahagian daripada automasi pemasaran pembayaran yang ditinggalkan. Jika tidak, pemboleh ubah tersebut ialah null.

Penerangan tentang pemboleh ubah Liquid yang disokong oleh Shopify Messaging untuk pelayaran, troli dan pembayaran yang ditinggalkan
Pemboleh ubah	Perihalan
abandoned_checkout.*	Pemboleh ubah ini memberikan akses kepada sifat yang berikut bagi pembayaran yang ditinggalkan: `url` memaparkan URL bagi pembayaran yang ditinggalkan. `line_items` memaparkan lima item baris pertama bagi pembayaran yang ditinggalkan. Selain itu, setiap `line_items` objek mengandungi sifat yang berikut tentang setiap produk: `components` `image_url` `product_title` `variant_title` `quantity` `line_items.components` memaparkan komponen bagi pembayaran yang ditinggalkan. Selain itu, setiap `components` objek mengandungi sifat yang berikut tentang setiap komponen: `image_url` `quantity` `product_title` `variant_title` `remaining_products_count` memaparkan kiraan item baris yang tinggal, jika terdapat lebih daripada lima item baris dalam pembayaran yang ditinggalkan.
id (checkout ID)	ID unik bagi pembayaran untuk kegunaan dalaman.
shop	Nama kedai Shopify anda.
name	Nama bagi pembayaran yang ditinggalkan, juga dikenali sebagai nombor pembayaran.
total_price	Jumlah harga pesanan (subjumlah + kos penghantaran - diskaun penghantaran + cukai).
shipping_price	Harga penghantaran. Contoh: `{{ shipping_price \| money }}`
shipping_address	Alamat penghantaran.
billing_address	Alamat pengebilan.
line_items	Senarai bagi semua item baris dalam pembayaran yang ditinggalkan.
unavailable_line_items	Senarai bagi semua item baris dalam pembayaran yang ditinggalkan yang tidak tersedia.
note	Nota yang dilampirkan pada pembayaran yang ditinggalkan.
landing_site	Laluan tapak pendaratan yang pelanggan gunakan. Ini ialah halaman pertama yang diakses oleh pelanggan apabila mereka tiba di kedai. Contoh: `/products/great-product?ref=my-tracking-token`
landing_site_ref	Mengekstrak parameter rujukan dari tapak pendaratan. Parameter rujukan boleh berupa: `ref`, `source`, `r`. Jika `landing_site` ialah `/products/great-product?ref=my-tracking-token`, maka `landing_site_ref` ialah `my-tracking-token`. Anda boleh melakukan tindakan tertentu jika parameter rujukan anda sama dengan nilai tertentu: {% if landing_site_ref == 'my-tracking-token' %} My action... {% endif %}
referring_site	URL perujuk yang membawa pelanggan ke kedai anda. Contoh: `https://www.google.com/?s=great+products`
created_at	Tarikh dan masa pelanggan mencipta pembayaran yang mereka tinggalkan.
closed_at	Tarikh dan masa apabila pembayaran ditutup.
customer_locale	Kod bahasa dua atau tiga huruf untuk penempatan pelanggan, diikuti dengan pengubah suai rantau secara pilihan. Sebagai contoh, en , en-CA
item_count	Hasil tambah bagi semua kuantiti item.
unique_gateways	Senarai penyedia pembayaran unik yang tersedia pada pembayaran.
discount	Diskaun yang digunakan pada troli atau item baris dalam pembayaran yang ditinggalkan.
discounts	Senarai diskaun yang digunakan pada pembayaran.
successfully_applied_discounts	Diskaun yang berjaya digunakan pada pembayaran.
discounts_amount	Amaun dolar bagi diskaun yang digunakan oleh semua diskaun. Contoh: +$5.00
discounts_savings	Amaun dolar bagi penjimatan yang disebabkan oleh semua diskaun. Contoh: -$5.00
buyer_accepts_marketing	Mengembalikan true atau false bergantung pada sama ada pelanggan menerima pemasaran semasa pembayaran yang ditinggalkan.
subtotal_line_items	Item baris yang digunakan untuk mengira harga subjumlah pada pembayaran, tidak termasuk sebarang item baris tip.
requires_shipping	Mengembalikan true jika terdapat sekurang-kurangnya satu item pada pembayaran yang memerlukan pengiriman.
subtotal_price	Harga subjumlah item baris pada pembayaran.
email	E-mel yang dikaitkan dengan pembayaran yang ditinggalkan.
shop_name	Nama kedai anda.
tax_lines	Cukai yang dipecahkan mengikut jenis cukai: {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}
tax_price	Cukai gabungan semua item pada pembayaran.
attributes	Sebarang atribut yang dilampirkan pada pembayaran yang ditinggalkan. Contoh: `{{ attributes.gift-note }}`
shipping_method	Maklumat tentang kaedah pengiriman pertama yang tersedia pada pembayaran.
shipping_methods	Kaedah pengiriman yang tersedia pada pembayaran.
free	Mengembalikan true if the total price of the checkout is zero.
free_shipping	Mengembalikan true jika pembayaran tidak memerlukan pengiriman atau jika harga untuk pengiriman ialah sifar.
different_billing_address	Mengembalikan true atau false berdasarkan sama ada alamat penghantaran adalah sama dengan alamat pengebilan.
customer	Objek pelanggan yang mengandungi atribut output pelanggan.
gift_cards	Kad hadiah yang digunakan pada pembayaran.
gift_cards_amount	Amaun harga pembayaran yang akan dibayar menggunakan kad hadiah.
transactions	Transaksi pembayaran.
shareable_url	URL produk pertama dalam item baris.
shareable_title	Tajuk produk item baris pertama.
total_tip	Jumlah tip yang ditambahkan oleh pelanggan pada pembayaran.
discount_applications	Menerangkan sebab dan cara item diberikan diskaun pada pembayaran.
cart_level_discount_applications	Pemakaian diskaun khusus troli untuk troli.
currency	Mata wang pembayaran yang ditinggalkan.
line_items_subtotal_price	Jumlah harga semua item baris pembayaran, selepas sebarang diskaun item baris dipakai.

Pemboleh ubah Liquid untuk e-mel pelayaran yang ditinggalkan dan e-mel troli yang ditinggalkan

Pemboleh ubah abandoned_visit.* diisi hanya jika e-mel merupakan sebahagian daripada automasi pemasaran troli yang ditinggalkan atau semakan produk terbengkalai. Semak sifat berikut yang diberikan akses oleh pemboleh ubah ini.

Perihalan pemboleh ubah Liquid yang disokong Shopify Messaging
Pemboleh ubah	Perihalan
abandoned_visit.*	Pemboleh ubah ini memberikan akses kepada sifat troli atau pelayaran yang ditinggalkan yang berikut: `url` memaparkan URL troli atau pelayaran yang ditinggalkan. `products_added_to_cart` memaparkan lima item baris produk pertama yang ditambahkan pada troli lawatan yang ditinggalkan. Selain itu, setiap `products_added_to_cart` objek mengandungi sifat berikut mengenai setiap produk: `title` `image_url` `variant_title` `quantity` `products_viewed` memaparkan lima produk pertama yang dilihat semasa lawatan yang ditinggalkan. Selain itu, setiap `products_viewed` objek mengandungi sifat berikut mengenai setiap produk: `title` `description` `image_url` `url` `image_alt_text` `remaining_cart_products_count` memaparkan baki kiraan item baris, jika terdapat lebih daripada lima item baris dalam pembayaran yang ditinggalkan.

Menggunakan pemboleh ubah yang diwajibkan

Apabila anda mencipta e-mel Liquid tersuai, pemboleh ubah unsubscribe_link atau unsubscribe_url adalah diwajibkan. Jika anda telah mengaktifkan penjejakan buka, maka pemboleh ubah open_tracking juga diwajibkan.

Walaupun pemboleh ubah ini boleh disisipkan di mana-mana sahaja dalam kod untuk e-mel anda, tempat yang paling biasa untuk menambahkan pemboleh ubah ini adalah di bahagian pengaki e-mel, seperti dalam contoh yang berikut:

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

Contoh kod Liquid tersuai

Anda boleh menambah Liquid atau HTML tersuai anda dalam editor kod. Kod berikut merupakan contoh tentang cara anda boleh menambah kod Liquid untuk memaparkan nama kedai anda, butang tersuai dan imej bersaiz tersuai dalam mesej e-mel.

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