Tilpass Shopify Messaging-kampanjene dine med Liquid

Liquid er Shopifys enkle og brukervennlige programmeringsspråk, og det er det samme programmeringsspråket som temaer fra Shopify Theme Store er bygget med.

Du kan bruke tilpasset Liquid til å forbedre Shopify Messaging-meldingene dine ved å opprette en e-post som er fullstendig kodet eller ved å legge til en egendefinert Liquid-seksjon i en mal. Disse alternativene lar deg legge inn egendefinert Liquid eller HTML.

Du kan bruke egendefinert Liquid til å vise egendefinerte ressurser, som bilder side om side, egendefinerte knapper, bilder med egendefinert størrelse og egendefinerte seksjonsstørrelser.

På denne siden

Viktige hensyn

Se gjennom følgende hensyn før du begynner å legge til tilpasset Liquid i Shopify Messaging-meldingene dine:

Variablene du inkluderer i koden din må være støttet av tilpasset Liquid.
Du kan bare bruke en stasjonær datamaskin til å opprette en egendefinert Liquid-seksjon.
Variabelen unsubscribe_link eller unsubscribe_url er obligatorisk i e-poster med tilpasset Liquid. Hvis du har aktivert sporing av åpnede, er variabelen open_tracking også obligatorisk. Finn ut mer om hvordan du legger til obligatoriske variabler i e-posten.
Koden du angir har følgende begrensninger:
- Maksimalt 50 kilobyte (KB) for egendefinerte Liquid-seksjoner.
- Maksimalt 500 KB for tilpassede kodede Liquid-e-poster.

Opprette en tilpasset kodet e-post med Liquid

Hvis du vil bruke tilpasset Liquid-kode når du oppretter en e-post, kan du enten legge til en egendefinert Liquid-seksjon, eller opprette en e-post som er fullstendig basert på tilpasset Liquid-kode ved å velge Kode selv når du oppretter en Shopify Messaging-kampanje.

Liquid-variabler som støttes i tilpasset Liquid

Du kan bruke støttede variabler til å tilpasse Shopify Messaging-e-postmeldingene dine med Liquid. Du kan se gjennom listene over støttede Liquid-variabler for følgende typer maler:

Liquid-variabler som støttes for alle e-postmaler

Du kan bruke følgende variabler til å tilpasse hvilken som helst av Shopify Messaging-e-postmeldingene dine med Liquid.

Beskrivelse av støttede Liquid-variabler for Shopify Messaging
Variabel	Beskrivelse
all_products	Alle produktene i butikken din.
customer.accepts_marketing	Returnerer `true` hvis kunden godtar markedsføring, og `false` hvis ikke.
customer.addresses	Returnerer alle adressene som er knyttet til kunden.
customer.addresses_count	Returnerer antallet adresser som er knyttet til kunden.
customer.b2b?	Returnerer `true` hvis kunden er en B2B-kunde, og `false` hvis ikke.
customer.current_location	Returnerer det valgte bedriftsstedet for kunden.
customer.default_address	Returnerer kundens standardadresse.
customer.email	Returnerer kundens e-postadresse.
customer.first_name	Returnerer kundens fornavn.
customer.has_account	Returnerer `true` hvis kundens e-postadresse er knyttet til en kundekonto, og `false` hvis ikke.
customer.has_avatar?	Returnerer `true` hvis kunden har en avatar knyttet til kontoen sin, og returnerer `false` hvis ikke.
customer.id	Returnerer ID-en til kunden.
customer.last_name	Returnerer kundens etternavn.
customer.last_order	Returnerer den siste bestillingen kunden har lagt inn, med unntak av testbestillinger.
customer.name	Returnerer kundens fulle navn.
customer.orders	Returnerer alle bestillingene kunden har lagt inn.
customer.orders_count	Returnerer totalt antall bestillinger kunden har lagt inn.
customer.payment_methods	Returnerer kundens lagrede betalingsmåter.
customer.phone	Returnerer kundens telefonnummer. Telefonnummeret fylles bare ut hvis kunden brukte et telefonnummer i kassen, har samtykket til SMS-varsler, eller hvis du har lagt det til manuelt i kundekontoen.
customer.store_credit_account.balance	Returnerer saldoen på kundens butikkvaluta i valutaen som er knyttet til den relevante konteksten. For eksempel: `{{customer.store_credit_account.balance \| money_with_currency}}`
customer.tags	Returnerer taggene som er knyttet til kunden.
customer.tax_exempt	Returnerer `true` hvis kunden er fritatt for avgifter, og returnerer `false` hvis ikke.
customer.total_spent	Returnerer totalbeløpet kunden har brukt på alle bestillinger fra butikken din.
email.*	Denne variabelen gir tilgang til følgende e-postegenskaper: `subject` viser emnelinjen i e-posten. `preview_text` viser forhåndsvisningsteksten i e-posten.
open_tracking	Denne variabelen gir tilgang til den forhåndsformaterte blokken for sporing av åpnede. Denne variabelen er påkrevd hvis du oppretter en tilpasset kodet e-postmelding og har aktivert sporing av åpnede.
shop.*	Denne variabelen gir tilgang til følgende butikkegenskaper: `name` viser butikknavnet. `domain` viser butikkens primære domene. `url` viser butikkens URL-adresse. `shopify_domain` viser butikkens Shopify-domene. `adresse` viser butikkadressen, som gir tilgang til følgende adresseegenskaper: `address1` `address2` `city` `country` `phone` `province` `zip`
unsubscribe_url	Denne variabelen gir tilgang til den rå URL-adressen for å avslutte abonnement, og kan tilpasses. Hvis du oppretter en tilpasset kodet e-postmelding, må du inkludere variabelen `unsubscribe_url` eller `unsubscribe_link`. Både `unsubscribe_url` og `unsubscribe_link` vil alltid peke til nettbutikkens primærdomene og kan ikke endres til å peke et annet sted.

Liquid-variabler som støttes for e-postmeldinger for forlatt kasse

Du kan bruke følgende variabler til å tilpasse e-postmeldingene for forlatt kasse i Shopify Messaging med Liquid.

abandoned_checkout-variabelen fylles bare ut hvis en e-postmelding er en del av en markedsføringsautomatisering for forlatt kasse. Hvis ikke, er variabelen null.

Beskrivelse av støttede Liquid-variabler i Shopify Messaging for avbrutt surfeøkt, forlatt handlekurv og forlatt kasse
Variabel	Beskrivelse
abandoned_checkout.*	Denne variabelen gir tilgang til følgende egenskaper for en forlatt kasse: `url` viser URL-adressen til den forlatte kassen. `line_items` viser de fem første postene i den forlatte kassen. I tillegg inneholder hvert `line_items` -objekt følgende egenskaper om hvert produkt: `components` `image_url` `product_title` `variant_title` `quantity` `line_items.components` viser komponentene i den forlatte kassen. I tillegg inneholder hvert `components` -objekt følgende egenskaper om hver komponent: `image_url` `quantity` `product_title` `variant_title` `remaining_products_count` viser antall gjenværende poster, hvis det er flere enn fem poster i den forlatte kassen.
id (checkout ID)	En unik ID for kassen for internt bruk.
shop	Shopify-butikknavnet ditt.
name	Navnet på den forlatte kassen, også kjent som kassenummeret.
total_price	Totalprisen for bestillingen (delsum + fraktomkostninger - fraktrabatt + avgift).
shipping_price	Fraktprisen. Eksempel: `{{ shipping_price \| money }}`
shipping_address	Leveringsadressen.
billing_address	Faktureringsadressen.
line_items	En liste over alle poster i den forlatte kassen.
unavailable_line_items	En liste over alle poster i den forlatte kassen som ikke er tilgjengelige.
note	Merknaden som er knyttet til den forlatte kassen.
landing_site	Banen til landingssiden kunden brukte. Dette er den første siden kunden besøkte da han/hun ankom butikken. Eksempel: `/products/great-product?ref=my-tracking-token`
landing_site_ref	Henter ut en referanseparameter fra landingssiden. Referanseparametere kan være: `ref`, `source`, `r`. Hvis `landing_site` er `/products/great-product?ref=my-tracking-token`, er `landing_site_ref` `my-tracking-token`. Du kan utføre en bestemt handling hvis referanseparameteren er lik en bestemt verdi: {% if landing_site_ref == 'my-tracking-token' %} My action... {% endif %}
referring_site	URL-adressen til referenten som førte kunden til butikken din. Eksempel: `https://www.google.com/?s=great+products`
created_at	Dato og klokkeslett da kunden opprettet kassen som ble forlatt.
closed_at	Dato og klokkeslett da kassen ble lukket.
customer_locale	Språkkoden på to eller tre bokstaver for kundens lokal, eventuelt etterfulgt av en områdemodifikator. For eksempel en , en-CA
item_count	Summen av antallet for alle varene.
unique_gateways	En liste over unike betalingsleverandører som er tilgjengelige i kassen.
discount	Rabatten som er brukt på handlekurven eller en post i den forlatte kassen.
discounts	En liste over rabatter som er brukt i kassen.
successfully_applied_discounts	Rabattene som ble brukt i kassen.
discounts_amount	Rabattbeløpet fra alle rabattene. Eksempel: +5,00 $
discounts_savings	Besparelsesbeløpet fra alle rabattene. Eksempel: –5,00 $
buyer_accepts_marketing	Returnerer true eller false avhengig av om kunden godtok markedsføring i den forlatte kassen.
subtotal_line_items	Postene som brukes til å beregne delsummen i kassen, ekskludert eventuelle poster for tips.
requires_shipping	Returnerer true hvis det er minst én vare i kassen som krever frakt.
subtotal_price	Delsummen for postene i kassen.
email	E-postadressen som er knyttet til den forlatte kassen.
shop_name	Navnet på butikken din.
tax_lines	Avgiftene, delt opp etter avgiftstype: {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}
tax_price	De samlede avgiftene for alle varene i kassen.
attributes	Eventuelle kjennemerker som var knyttet til den forlatte kassen. Eksempel: `{{ attributes.gift-note }}`
shipping_method	Informasjon om den første tilgjengelige fraktmetoden i kassen.
shipping_methods	Fraktmetodene som er tilgjengelige i kassen.
free	Returnerer true if the total price of the checkout is zero.
free_shipping	Returnerer true hvis kassen ikke krever frakt, eller hvis fraktprisen er null.
different_billing_address	Returnerer true eller false basert på om leveringsadressen er den samme som fakturaadressen.
customer	Kundeobjektet som inneholder kjennemerkene til kunde-resultatet.
gift_cards	Gavekortene som er brukt i kassen.
gift_cards_amount	Den delen av beløpet i kassen som betales med gavekort.
transactions	Transaksjonene i kassen.
shareable_url	URL-adressen til det første produktet i postene.
shareable_title	Produkttittelen til den første posten.
total_tip	Det totale tipset som kunden la til i kassen.
discount_applications	Beskriver hvorfor og hvordan en vare ble rabattert i kassen.
cart_level_discount_applications	Handlekurvspesifikk rabattbruk for handlekurven.
currency	Valutaen til den forlatte kassen.
line_items_subtotal_price	Summen av prisene på alle postene i kassen, etter at eventuelle postrabatter er trukket fra.

Liquid-variabler for e-poster om avbrutt surfeøkt og forlatt handlekurv

Variabelen abandoned_visit.* fylles bare ut hvis en e-post er en del av en markedsføringsautomatisering for forlatt handlekurv eller avbrutt surfeøkt. Se gjennom følgende egenskaper som denne variabelen gir tilgang til.

Beskrivelse av støttede Liquid-variabler for Shopify Messaging
Variabel	Beskrivelse
abandoned_visit.*	Denne variabelen gir tilgang til følgende egenskaper for en forlatt handlekurv eller surfeøkt: `url` viser URL-adressen til den forlatte handlekurven eller surfeøkten. `products_added_to_cart` viser de fem første produktpostene som ble lagt til i handlekurven under det avbrutte besøket. I tillegg inneholder hvert `products_added_to_cart` produktobjekt følgende egenskaper for hvert produkt: `title` `image_url` `variant_title` `quantity` `products_viewed` viser de fem første produktene som ble sett på under det avbrutte besøket. I tillegg inneholder hvert `products_viewed` produktobjekt følgende egenskaper for hvert produkt: `title` `description` `image_url` `url` `image_alt_text` `remaining_cart_products_count` viser antallet gjenværende poster, hvis det er mer enn fem poster i den forlatte kassen.

Bruk av påkrevde variabler

Når du oppretter en egendefinert Liquid-e-post, er variabelen unsubscribe_link eller unsubscribe_url påkrevd. Hvis du har aktivert sporing av åpnede, er variabelen open_tracking også påkrevd.

Selv om disse variablene kan settes inn hvor som helst i koden for e-posten, er det vanligste stedet å legge dem til i bunnteksten til en e-post, som i følgende eksempel:

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

Eksempel på egendefinert Liquid-kode

Du kan legge til egendefinert Liquid eller HTML i koderedigeringsprogrammet. Følgende kode er et eksempel på hvordan du kan legge til Liquid-kode for å vise butikknavnet, en egendefinert knapp og et bilde med egendefinert størrelse i en e-postmelding.

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