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.
unsubscribe_link	Denne variabelen gir tilgang til en forhåndsformatert blokk med kobling for avmelding. Hvis du oppretter en e-post med egendefinert kode, må du inkludere variabelen `unsubscribe_link` eller `unsubscribe_url` .
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` .
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.
data.customer.*	Denne variabelen gir tilgang til følgende kundeopplysningsegenskaper: `first_name` `last_name` `e-post` `city` `state` `land` `<p>Disse egenskapene kan ikke brukes i <a href="https://shopify.dev/api/liquid/filters">Liquid-filtre</a> eller <a href="https://shopify.dev/api/liquid/tags/conditional-tags">Liquid-betingelser</a>.`
email.*	Denne variabelen gir tilgang til følgende e-postegenskaper: `subject` viser emnefeltet for e-postmeldingen. `preview_text` viser forhåndsvisningsteksten for e-postmeldingen.
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` `branding` viser butikkens merkevarebygging, som gir tilgang til følgende egenskaper: `accent_section_color` `background_primary_color` `background_border_color` `body_text_color` `button_background_and_link_color` `button_label_color` `footer_link_color` `footer_text_color` `footer_background_color` `social_link_facebook` `social_link_twitter` `social_link_instagram` `social_link_pinterest` `shop_name` `logo`, som gjengis som en `img`-tagg direkte.

### Liquid-variabler som støttes for e-postmeldinger for forlatt kasse {#abandoned-checkout}

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 {#abandoned-visits}

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 {#required-variables}

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.

<style>
  body {
    text-align: center;
  }

  p#welcome {
    margin: 0;
    padding: 3rem;
    color: white;
    font-weight: 700;
    font-size: 26px;
    font-family: 'Futura';
  }

  div#image_wrapper img {
    max-width: 70%;
    border-radius: 60px;
    box-shadow: -2px 6px 0px rgba(227, 111, 59, 0.7);
  }

  div#button_wrapper {
    padding: 1rem;
  }

  div#button_wrapper a {
    padding: 1rem 2rem;
    border-radius: 24px;
    display: inline-block;
    background: linear-gradient(120deg, #F6A179, #865CFF);
    box-shadow: -2px 4px 0px rgba(96, 54, 173, 0.9);
    font-weight: 700;
    font-size: 16px;
    font-family: 'Futura';
    color: white;
  }

  div#footer {
    font-weight: 700;
    font-size: 16px;
    font-family: 'Futura';
    padding: 2rem;
  }

  div#button_wrapper:hover a {
    box-shadow: -4px 6px 0px rgba(96, 54, 173, 0.8);
  }

  div#custom_section {
    background: linear-gradient(120deg, #FF9F73, #FFC7AD);
    padding:0 0 2rem 0;
    border-radius: 4rem;
  }
</style>
<div id="custom_section">
  <p id="welcome">
    Hello from {{shop.name}}<strong></strong>!
  </p>
  <div id="image_wrapper">
    <img src="https://burst.shopifycdn.com/photos/a-trio-of-natural-soaps.jpg" alt="" />
  </div>
  <div id="button_wrapper">
    <a href="">Shop now</a>
  </div>
  <div id="footer">{{ unsubscribe_link }} {{ open_tracking_block }}</div>
</div>