התאמה אישית של קמפיינים ב-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 קילובייט (KB) עבור מקטעי Liquid מותאמים אישית.
- לכל היותר 500 KB עבור הודעות דוא"ל בקוד Liquid מותאם אישית.

יצירת הודעת דוא"ל בקוד מותאם אישית באמצעות Liquid

אם ברצונך להשתמש בקוד Liquid מותאם אישית בעת יצירת הודעת דוא"ל, באפשרותך להוסיף מקטע Liquid מותאם אישית, או ליצור הודעת דוא"ל המבוססת כולה על קוד Liquid מותאם אישית באמצעות בחירה באפשרות Code your own בעת יצירת קמפיין ב-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 נתמכים עבור הודעות דוא"ל של תשלום נטוש

באפשרותך להשתמש במשתנים הבאים כדי להתאים אישית את הודעות הדוא"ל של תשלום נטוש ב-Shopify Messaging באמצעות Liquid.

המשתנה abandoned_checkout מתאכלס רק אם הודעת הדוא"ל היא חלק מאוטומציה שיווקית של תשלום נטוש. אחרת, המשתנה הוא null.

תיאור של משתני Liquid שנתמכים ב-Shopify Messaging עבור עיון נטוש, סל נטוש ותשלום נטוש
משתנה	תיאור
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
discounts_savings	הסכום בדולרים של החיסכון כתוצאה מכל ההנחות. דוגמה: -$5.00
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	אובייקט הלקוח שמכיל את המאפיינים של הפלט 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 של הסל הנטוש או העיון הנטוש. `products_added_to_cart` מציג את חמשת פריטי השורה הראשונים של מוצרים שנוספו לסל בביקור הנטוש. בנוסף, כל אובייקט `products_added_to_cart` מכיל את המאפיינים הבאים לגבי כל מוצר: `title` `image_url` `variant_title` `quantity` `products_viewed` מציג את חמשת המוצרים הראשונים שנצפו במהלך הביקור הנטוש. בנוסף, כל אובייקט `products_viewed` מכיל את המאפיינים הבאים לגבי כל מוצר: `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>