Tilpas dine Shopify Messaging-kampagner ved hjælp af Liquid

Liquid er Shopifys enkle og brugervenlige programmeringssprog. Det er det samme programmeringssprog, som temaer fra Shopify Theme Store er udviklet med.

Du kan bruge tilpasset Liquid til at forbedre dine Shopify Messaging-beskeder ved at oprette en mail, der udelukkende er kodet med tilpasset kode, eller ved at tilføje et afsnit med tilpasset Liquid til en skabelon. Disse valgmuligheder giver dig mulighed for at angive tilpasset Liquid eller HTML.

Du kan bruge tilpasset Liquid til at vise tilpassede aktiver, f.eks. billeder side om side, tilpassede knapper, billeder i tilpasset størrelse og tilpassede afsnitsstørrelser.

På denne side

Overvejelser

Gennemgå følgende overvejelser, før du begynder at føje tilpasset Liquid til dine Shopify Messaging-beskeder:

De variabler, du inkluderer i din kode, skal understøttes af tilpasset Liquid.
Du kan kun bruge en computer til at oprette et afsnit med tilpasset Liquid.
Variablen unsubscribe_link eller unsubscribe_url er påkrævet i mails med tilpasset Liquid. Hvis du har aktiveret sporing af åbninger, er variablen open_tracking også påkrævet. Få mere at vide om at føje påkrævede variabler til din mail.
Den kode, du angiver, har følgende begrænsninger:
- Højst 50 kilobyte (KB) for afsnit med tilpasset Liquid.
- Højst 500 KB for mails med tilpasset Liquid-kode.

Opret en mail med tilpasset kode ved hjælp af Liquid

Hvis du vil bruge tilpasset Liquid-kode, når du opretter en mail, kan du enten tilføje et afsnit med tilpasset Liquid eller oprette en mail udelukkende med tilpasset Liquid-kode ved at vælge Din egen kode, når du opretter en Shopify Messaging-kampagne.

Liquid-variabler, der understøttes i tilpasset Liquid

Du kan bruge understøttede variabler til at tilpasse dine Shopify Messaging-mails med Liquid. Du kan gennemgå listerne over understøttede Liquid-variabler for følgende typer af skabeloner:

Liquid-variabler, der understøttes for alle mailskabeloner

Du kan bruge følgende variabler til at tilpasse enhver af dine Shopify Messaging-mails med Liquid.

Beskrivelse af understøttede Liquid-variabler i Shopify Messaging
Variabel	Beskrivelse
all_products	Alle produkter i din butik.
customer.accepts_marketing	Returnerer `true`, hvis kunden accepterer markedsføring, og returnerer `false`, hvis ikke.
customer.addresses	Returnerer alle de adresser, der er knyttet til kunden.
customer.addresses_count	Returnerer antallet af adresser, der er knyttet til kunden.
customer.b2b?	Returnerer `true`, hvis kunden er en B2B-kunde, og returnerer `false`, hvis ikke.
customer.current_location	Returnerer den aktuelt valgte firmalokation for kunden.
customer.default_address	Returnerer kundens standardadresse.
customer.email	Returnerer kundens mailadresse.
customer.first_name	Returnerer kundens fornavn.
customer.has_account	Returnerer `true`, hvis kundens mail er knyttet til en kundekonto, og returnerer `false`, hvis ikke.
customer.has_avatar?	Returnerer `true`, hvis kunden har en avatar knyttet til sin konto, og `false` i modsat fald.
customer.id	Returnerer kundens id.
customer.last_name	Returnerer kundens efternavn.
customer.last_order	Returnerer den seneste ordre, som kunden har afgivet, eksklusive testordrer.
customer.name	Returnerer kundens fulde navn.
customer.orders	Returnerer alle de ordrer, som kunden har afgivet.
customer.orders_count	Returnerer det samlede antal ordrer, som kunden har afgivet.
customer.payment_methods	Returnerer kundens gemte betalingsmetoder.
customer.phone	Returnerer kundens telefonnummer. Telefonnummeret udfyldes kun, hvis kunden har brugt et telefonnummer ved betaling, har tilmeldt sig SMS-notifikationer, eller hvis du manuelt har føjet det til vedkommendes kundekonto.
customer.store_credit_account.balance	Returnerer kundens saldo for tilgodebeviser i den valuta, der er knyttet til den relevante kontekst. For eksempel: `{{customer.store_credit_account.balance \| money_with_currency}}`
customer.tags	Returnerer de tags, der er knyttet til kunden.
customer.tax_exempt	Returnerer `true`, hvis kunden er fritaget for skat, og `false` i modsat fald.
customer.total_spent	Returnerer det samlede beløb, som kunden har brugt på alle ordrer fra din butik.
email.*	Denne variabel giver adgang til følgende egenskaber for mailen: `subject` viser mailens emnelinje. `preview_text` viser mailens eksempeltekst.
open_tracking	Denne variabel giver adgang til den forudformaterede blok til sporing af åbninger. Denne variabel er påkrævet, hvis du opretter en specialkodet mail og har aktiveret sporing af åbninger.
shop.*	Denne variabel giver adgang til følgende egenskaber for butikken: `name` viser butiksnavnet. `domain` viser butikkens primære domæne. `url` viser butikkens webadresse. `shopify_domain` viser butikkens Shopify-domæne. `address` viser butikkens adresse, hvilket giver adgang til følgende egenskaber for adressen: `address1` `address2` `city` `country` `phone` `province` `zip`
unsubscribe_url	Denne variabel giver adgang til den rå webadresse til afmelding og kan tilpasses. Hvis du opretter en specialkodet mail, skal du inkludere variablen `unsubscribe_url` eller `unsubscribe_link`. Både `unsubscribe_url` og `unsubscribe_link` peger altid på webshoppens primære domæne og kan ikke ændres til at henvise andre steder hen.

Liquid-variabler, der understøttes i mails om forladt betaling

Du kan bruge følgende variabler til at tilpasse dine mails om forladt betaling i Shopify Messaging med Liquid.

Variablen abandoned_checkout udfyldes kun, hvis en mail er en del af en marketingautomatisering for forladt betaling. Ellers er variablen null.

Beskrivelse af understøttede Liquid-variabler i Shopify Messaging for forladt browsing, forladt indkøbskurv og forladt betaling
Variabel	Beskrivelse
abandoned_checkout.*	Denne variabel giver adgang til følgende egenskaber for en forladt betaling: `url` viser webadressen på den forladte betaling. `line_items` viser de første fem varelinjer i den forladte betaling. Hvert `line_items` objekt indeholder følgende egenskaber for hvert produkt: `components` `image_url` `product_title` `variant_title` `quantity` `line_items.components` viser komponenterne i den forladte betaling. Hvert objekt i `components` indeholder følgende egenskaber om hver komponent: `image_url` `quantity` `product_title` `variant_title` `remaining_products_count` viser antallet af resterende varelinjer, hvis der er mere end fem varelinjer i den forladte betaling.
id (checkout ID)	Et unikt id for betalingen til internt brug.
shop	Navnet på din Shopify-butik.
name	Navnet på den forladte betaling, også kendt som betalingsnummeret.
total_price	Den samlede pris for ordren (subtotal + leveringsomkostninger - leveringsrabat + skat).
shipping_price	Leveringsprisen. Eksempel: `{{ shipping_price \| money }}`
shipping_address	Leveringsadressen.
billing_address	Faktureringsadressen.
line_items	En liste over alle varelinjer i den forladte betaling.
unavailable_line_items	En liste over alle varelinjer i den forladte betaling, der ikke er tilgængelige.
note	Noten, der er knyttet til den forladte betaling.
landing_site	Stien til den landingsside, som kunden brugte. Dette er den første side, som kunden åbnede, da vedkommende kom ind i butikken. Eksempel: `/products/great-product?ref=my-tracking-token`
landing_site_ref	Udtrækker en referenceparameter fra landingssiden. Referenceparametre kan være: `ref`, `source`, `r`. Hvis `landing_site` er `/products/great-product?ref=my-tracking-token`, er den `landing_site_ref` `my-tracking-token`. Du kan udføre en bestemt handling, hvis din referenceparameter er lig med en bestemt værdi: {% if landing_site_ref == 'my-tracking-token' %} My action... {% endif %}
referring_site	Webadressen på den henviser, der førte kunden til din butik. Eksempel: `https://www.google.com/?s=great+products`
created_at	Dato og klokkeslæt for, hvornår kunden oprettede den betaling, som vedkommende forlod.
closed_at	Dato og klokkeslæt for, hvornår betalingen blev lukket.
customer_locale	Sprogkoden på to eller tre bogstaver for kundens landestandard, eventuelt efterfulgt af en områdemodifikator. For eksempel en , en-CA
item_count	Summen af antallet for alle varer.
unique_gateways	En liste over unikke betalingsudbydere, der er tilgængelige på betalingssiden.
discount	Den rabat, der er anvendt på indkøbskurven eller en varelinje i den forladte betaling.
discounts	En liste over rabatter, der er anvendt på betalingssiden.
successfully_applied_discounts	De rabatter, som er blevet anvendt på betalingssiden.
discounts_amount	Det samlede beløb for rabatterne. Eksempel: +5,00 USD
discounts_savings	Den samlede besparelse fra alle rabatter. Eksempel: -5,00 USD
buyer_accepts_marketing	Returnerer true eller false afhængigt af om kunden accepterede markedsføring under den forladte betaling.
subtotal_line_items	De varelinjer, der bruges til at beregne subtotalen ved betalingssiden, eksklusive eventuelle varelinjer med drikkepenge.
requires_shipping	Returnerer true hvis der er mindst én vare på betalingssiden, der kræver forsendelse.
subtotal_price	Subtotalen for varelinjerne ved betalingssiden.
email	Den mail, der er knyttet til den forladte betaling.
shop_name	Navnet på din butik.
tax_lines	Afgifterne opdelt efter afgiftstype: {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}
tax_price	De samlede afgifter for alle varerne på betalingssiden.
attributes	Eventuelle attributter, der var knyttet til den forladte betaling. Eksempel: `{{ attributes.gift-note }}`
shipping_method	Oplysninger om den første tilgængelige leveringsmetode ved betalingssiden.
shipping_methods	De leveringsmetoder, der er tilgængelige ved betalingssiden.
free	Returnerer true if the total price of the checkout is zero.
free_shipping	Returnerer true hvis betalingssiden ikke kræver forsendelse, eller hvis prisen for forsendelse er nul.
different_billing_address	Returnerer true eller false baseret på, om leveringsadressen er den samme som faktureringsadressen.
customer	Kundeobjektet, der indeholder attributterne for kunde-outputtet.
gift_cards	De gavekort, der er anvendt ved betalingssiden.
gift_cards_amount	Den del af den samlede pris ved betaling, som dækkes af gavekort.
transactions	Transaktionerne for betalingen.
shareable_url	Webadressen på det første produkt i varelinjerne.
shareable_title	Produkttitlen for den første varelinje.
total_tip	Det samlede beløb i drikkepenge, som kunden tilføjede ved betalingssiden.
discount_applications	Beskriver, hvorfor og hvordan en vare fik rabat ved betalingssiden.
cart_level_discount_applications	De rabatanvendelser, der er specifikke for indkøbskurven.
currency	Valutaen for den forladte betaling.
line_items_subtotal_price	Den samlede pris for alle varelinjerne på betalingssiden, efter at eventuelle varelinjerabatter er fratrukket.

Liquid-variabler for mails om forladt browsing og forladt indkøbskurv

Variablen abandoned_visit.* udfyldes kun, hvis en mail er en del af en automatisering af markedsføring for en forladt indkøbskurv eller forladt produktbrowsing. Gennemgå følgende egenskaber, som denne variabel giver adgang til.

Beskrivelse af understøttede Liquid-variabler i Shopify Messaging
Variabel	Beskrivelse
abandoned_visit.*	Denne variabel giver adgang til følgende egenskaber for en forladt indkøbskurv eller browsing: `url` viser webadressen på den forladte indkøbskurv eller browsing. `products_added_to_cart` viser de første fem produktvarelinjer, der er føjet til indkøbskurven for det forladte besøg. Derudover indeholder hvert `products_added_to_cart` -objekt følgende egenskaber for hvert produkt: `title` `image_url` `variant_title` `quantity` `products_viewed` viser de første fem produkter, der blev set under det forladte besøg. Derudover indeholder hvert `products_viewed` -objekt følgende egenskaber for hvert produkt: `title` `description` `image_url` `url` `image_alt_text` `remaining_cart_products_count` viser antallet af resterende varelinjer, hvis der er mere end fem varelinjer i den forladte betaling.

Brug af påkrævede variabler

Når du opretter en tilpasset Liquid-mail, er variablen unsubscribe_link eller unsubscribe_url påkrævet. Hvis du har aktiveret sporing af åbninger, er variablen open_tracking også påkrævet.

Selvom disse variabler kan indsættes hvor som helst i koden til din mail, er det mest almindeligt at tilføje dem i mailens sidefod, som i følgende eksempel:

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

Eksempel på tilpasset Liquid-kode

Du kan tilføje din tilpassede Liquid- eller HTML-kode i kodeeditoren. Følgende kode er et eksempel på, hvordan du kan tilføje Liquid-kode for at vise dit butiksnavn, en tilpasset knap og et billede i en tilpasset størrelse i en mail.

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