Tilpass Shopify Email-kampanjer med Liquid

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

Du kan bruke egendefinert Liquid for å forbedre Shopify Email-meldingene ved å opprette en helt egendefinert kodet e-postmelding, eller ved å legge til en egendefinert Liquid-seksjon i en mal. Ved hjelp av disse alternativene kan du legge inn egendefinert Liquid eller HTML-kode.

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

På denne siden

Hensyn

Gå gjennom følgende hensyn før du begynner å legge til egendefinert Liquid i Shopify Email-meldinger:

Variablene du inkluderer i koden må støttes av egendefinert Liquid.
Du kan bare bruke en datamaskin til å opprette en seksjon for egendefinert Liquid-kode.
Variabelen unsubscribe_link eller unsubscribe_url kreves i tilpassede Liquid-e-poster. Hvis du har aktivert sporing av åpnede, er også variabelen open_tracking obligatorisk. Finn ut mer om å legge til nødvendige variabler i e-postmeldinger.
Koden du angir har følgende grenser: - Maksimalt 50 kilobyte (KB) for egendefinerte Liquid-seksjoner. - Maksimalt 500 KB for egendefinerte Liquid-e-postmeldinger.

Liquid-variabler som støttes i egendefinert Liquid

Du kan bruke støttede variabler for å tilpasse e-postmeldinger med Liquid i Shopify. Du kan gå 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 en Shopify-e-postmelding med Liquid.

Beskrivelse av Shopify Email-støttede Liquid-variabler
Variabel	Beskrivelse
all_products	Alle produkter i butikken.
customer.accepts_marketing	Returnerer `sann` om kunden godtar markedsføring, og returnerer `usann` om ikke.
customer.addresses	Returnerer alle adressene tilknyttet kunden.
customer.addresses_count	Returnerer antall adresser tilknyttet kunden.
customer.b2b?	Returnerer `sann` hvis kunden er B2B-kunde, og returnerer `usann` om ikke.
customer.current_location	Returnerer kundens valgte bedriftslokalisasjon.
customer.default_address	Returnerer kundens standardadresse.
customer.email	Returnerer kundens e-postadresse.
customer.first_name	Returnerer kundens fornavn.
customer.has_account	Returnerer `sann` hvis kundens e-post er tilknyttet en kundekonto, og returnerer `usann` om ikke.
customer.has_avatar?	Returnerer `usann` hvis kunden har en avatar tilknyttet kontoen sin, og returnerer `usann` om ikke.
customer.id	Returnerer ID-en til kunden.
customer.last_name	Returnerer kundens etternavn.
customer.last_order	Returnerer siste bestilling fra kunden, ikke inkludert testbestillinger.
customer.name	Returnerer kundens fulle navn.
customer.orders	Returnerer alle bestillinger som kunden har lagt inn.
customer.orders_count	Returnerer totalt antall bestillinger en kunde har lagt inn.
customer.payment_methods	Returnerer kundens lagrede betalingsmåter.
customer.phone	Returnerer kundens telefonnummer. Telefonnummeret fylles kun ut dersom kunden har brukt et telefonnummer i kassen, har registrert seg for SMS-varsler, eller hvis du manuelt har lagt det til kundens konto.
customer.store_credit_account.balance	Returnerer kundens butikkvalutasaldo i valutaen knyttet til den relevante konteksten. For eksempel: `{{customer.store_credit_account.balance \| money_with_currency}}`
customer.tags	Returerner taggene tilknyttet kunden.
customer.tax_exempt	Returnerer `sann` om kunden er fritatt fra avgifter, og returnerer `usann` om ikke.
customer.total_spent	Returnerer det totale beløpet kunden har brukt på alle bestillinger fra butikken din.
email.*	Denne variabelen gir tilgang til følgende e-postegenskaper: `subject` viser emnefeltet for e-postmeldingen. `preview_text` viser forhåndsvisningsteksten for e-postmeldingen.
open_tracking	Denne variabelen gir tilgang til den forhåndsformaterte åpningssporingsblokken . Denne variabelen er obligatorisk hvis du oppretter en egendefinert kodet e-post og har aktivert åpen sporing.
shop.*	Denne variabelen gir tilgang til følgende butikkegenskaper: `name` viser butikkens navn. `domain` viser butikkens primære domene. `url` viser butikkens URL-adresse. `shopify_domain` viser butikkens Shopify-domene. `address` viser butikkens adresse, som gir tilgang til følgende adresseegenskaper: `address1` `address2` `city` `land` `telefon` `province` `postnummer`
unsubscribe_url	Denne variabelen gir tilgang til den rå URL-adressen for avmelding, og den kan tilpasses. Hvis du oppretter en e-post med egendefinert kode, må du inkludere variabelen `unsubscribe_url` eller `unsubscribe_link`. Både `unsubscribe_url` og `unsubscribe_link` vil alltid peke til det primære nettbutikkdomenet og kan ikke endres for å styres andre steder.

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

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

Variabelen abandoned_checkout fylles bare ut hvis en e-post er en del av en markedsføringsautomasjon for forlatt kasse. Ellers er variabelen null.

Beskrivelse av Shopify Email-støttede Liquid-variabler for forlatt kikking, handlekurv og 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 varelinjene i den forlatte kassen. I tillegg inneholder hvert `line_items`-objekt følgende egenskaper om hvert produkt: `komponenter` `image_url` `product_title` `variant_title` `antall` `line_items.components` viser komponentene i den forlatte kassen. I tillegg inneholder hvert `components`-objekt følgende egenskaper for hver komponent: `image_url` `antall` `product_title` `variant_title` `remaining_products_count` viser gjenstående antall varelinjer, hvis det er mer enn fem varelinjer i den forlatte kassen.
id (checkout ID)	En unik ID for kassen for intern bruk.
shop	Ditt Shopify-butikknavn.
name	Navnet på den forlatte kassen, også kalt kassenummer.
total_price	Totalprisen for bestillingen (delsum + fraktkostnad – fraktrabatt + avgift).
shipping_price	Fraktprisen. Eksempel`{{ shipping_price \| money }}`
shipping_address	Leveringsadressen.
billing_address	Fakturaadressen.
line_items	En liste over alle varelinjer i den forlatte kassen.
unavailable_line_items	En liste over alle varelinjer i den forlatte kassen som ikke er tilgjengelig.
note	Merknaden som er knyttet til den forlatte kassen.
landing_site	Banen til målsiden kunden brukte. Dette er den første siden kunden åpnet da de kom til butikken. Eksempel: `/products/great-product?ref=my-tracking-token`
landing_site_ref	Trekker ut en referanseparameter fra målsiden. Referanseparametre 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 referanseparameteret tilsvarer en bestemt verdi: {% if landing_site_ref == 'my-tracking-token' %} Min handling ... {% endif %}
referring_site	URL-adressen til referenten som sendte kunden til butikken. Eksempel: `https://www.google.com/?s=great+products`
created_at	Datoen og klokkeslettet kunden opprettet kassen de forlot.
closed_at	Datoen og klokkeslettet da kassen ble lukket.
customer_locale	Språkkoden på to eller tre bokstaver for kundens lokale innstillinger, alternativt etterfulgt av en regionmodifikator. For eksempel nb , en-CA
item_count	Summen over alle vareantallene.
unique_gateways	En liste over unike betalingsleverandører som er tilgjengelige i kassen.
discount	Rabatten som gjelder for handlekurven eller en varelinje i den forlatte kassen.
discounts	En liste over rabatter som er brukt for kassen.
successfully_applied_discounts	Rabattene som er lagt til i kassen.
discounts_amount	Dollarbeløpet for rabatten som er lagt til for alle rabatter. Eksempel: +$5,00
discounts_savings	Dollarbeløpet i besparelser forårsaket av alle rabatter. Eksempel: -$5.00
buyer_accepts_marketing	Returer sann eller usann avhengig av om kunden godtok markedsføring under den forlatte kassen.
subtotal_line_items	Varelinjene som brukes til å beregne delsummen i kassen, ekskludert eventuelle tipslinjer.
requires_shipping	Returer sann hvis det er minst én vare i kassen som krever frakt.
subtotal_price	Delsummen for varelinjene i kassen.
email	E-postadressen knyttet til den forlatte kassen.
shop_name	Navnet på butikken din.
tax_lines	Avgifter brutt ned på type avgift: {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}
tax_price	Kombinerte avgifter for alle varer i kassen.
attributes	Eventuelle attributter knyttet til den forlatte kassen. Eksempel`{{ attributes.gift-note }}`
shipping_method	Informasjon om den første fraktmetoden som er tilgjengelig i kassen.
shipping_methods	Leveringsmetodene som er tilgjengelige i kassen.
free	Returer sann hvis totalprisen i kassen er null.
free_shipping	Returer sann hvis kassen ikke krever frakt, eller hvis prisen for frakt er null.
different_billing_address	Returer sann eller usann basert på hvorvidt leveringsadressen er den samme som fakturaadressen.
customer	Kundeobjektet som inneholder attributtene for utdataen fra customer.
gift_cards	Gavekortene som er lagt til i kassen.
gift_cards_amount	Beløpet for kasseprisen som ville vært betalt med gavekort.
transactions	Transaksjonene i kassen.
shareable_url	URL-adressen for det første produktet i varelinjene.
shareable_title	Produkttittelen for den første varelinjen.
total_tip	Det totale tipsbeløpet som kunden la til i kassen.
discount_applications	Beskriver hvorfor og hvordan en vare ble rabattert i kassen.
cart_level_discount_applications	De handlekurvspesifikke rabattbrukene for handlekurven.
currency	Valutaen for den forlatte kassen.
line_items_subtotal_price	Summen av prisene for alle varelinjer i kassen, etter at eventuelle varelinjerabatter er lagt til.

Liquid-variabler for e-poster om forlatt kikking og forlatt handlekurv

Variabelen abandoned_visit.*er bare utfylt hvis en e-postmelding er en del av en markedsføringsautomasjon for forlatt handlekurv eller forlatt kikking på produkter. Se gjennom følgende egenskaper som denne variabelen gir tilgang til.

Beskrivelse av Shopify Email-støttede Liquid-variabler
Variabel	Beskrivelse
abandoned_visit.*	Denne variabelen gir tilgang til følgende egenskaper for en forlatt handlekurv eller et forlatt besøk: `url` viser URL-adressen for den forlatte handlekurven eller kikkingen. `products_added_to_cart` viser de fem første produktvarelinjene som er lagt i handlekurven i det forlatte besøket. I tillegg inneholder hvert `products_added_to_cart` objekt følgende egenskaper for hvert produkt: `tittel` `image_url` `variant_title` `antall` `products_viewed` viser de fem første produktene som ble vist under det forlatte besøket. I tillegg inneholder hvert `products_viewed`-objekt følgende egenskaper om hvert produkt: `tittel` `beskrivelse` `image_url` `url` `image_alt_text` `remaining_cart_products_count` viser gjenstående antall varelinjer, hvis det er mer enn fem varelinjer i den forlatte kassen.

Bruke nødvendige variabler

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

Selv om disse variablene kan legges inn hvor som helst i koden for e-postmeldingen, er det vanligst å legge dem inn i bunnteksten i e-postmeldingen, 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 redigeringsprogrammet for kode. Følgende kode er et eksempel på hvordan du kan legge til Liquid-kode for å vise butikknavn, en tilpasset 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>