Gegevens doorgeven vanuit Shopify Flow

De opmaak van uw e-mail bestaat uit een vorm met openingen. Met behulp van variabelen (JSON) vult Shopify Flow die openingen op.

Dit is de fout die het vaakst wordt gemaakt, dus het is de moeite waard om er vijf minuten aan te besteden.

De twee helften

Waar	Wat u schrijft	Voorbeeld
In de opmaak van uw e-mail	De plaatshouder	Hi {{ variables.firstName }}
De actie ‘In de flow’	De JSON-gegevens die hiervoor dienen	{"firstName": "{{ order.customer.firstName }}"}

De sleutel aan de linkerkant van de JSON-code moet exact overeenkomen met de naam na variables. in uw lay-out - dezelfde spelling, dezelfde hoofdlettergebruik. firstName en firstname zijn twee verschillende variabelen.

Laat de app de JSON voor u genereren

U hoeft dit niet met de hand te schrijven, en dat zou u waarschijnlijk ook niet moeten doen.

Open uw lay-out. In de zijbalk (of op het tabblad ‘Testvariabelen’ in de visuele builder) vindt u een kaart met de tekst ‘Gebruiken in Shopify Flow’ die de exacte JSON-code voor die lay-out bevat, waarbij alle sleutels al correct zijn ingesteld. Klik op ‘JSON kopiëren’ en plak de code vervolgens in het veld ‘Variabelen (JSON)’ van uw actie ‘Transactionele e-mail verzenden’.

De app vult de eigenschap „Shopify Flow“ in voor velden die zij herkent - klantnaam, bestelnummer, totaalbedrag van de bestelling, URL van de statuspagina en dergelijke. Alles wat de app niet kan afleiden, wordt weergegeven als <pick a Flow variable>, zodat u dit zelf kunt invullen.

Hoe de JSON eruit moet zien

{
  "firstName": "{{ order.customer.firstName }}",
  "orderName": "{{ order.name }}",
  "statusPageUrl": "{{ order.statusPageUrl }}"
}

Regels die u moet kennen:

• Zet elke Shopify Flow-waarde tussen dubbele aanhalingstekens. "orderName": {{ order.name }} is ongeldige JSON; "orderName": "{{ order.name }}" is correct.
• Komma’s tussen de vermeldingen, geen komma na de laatste vermelding.
• U kunt zelf de namen van de sleutels kiezen. Ze moeten alleen overeenkomen met uw indeling. Als in uw indeling {{ variables.kunde }} staat, is de sleutel kunde.
• Waarden worden als tekst weergegeven. Getallen en datums worden weergegeven zoals Shopify Flow ze heeft omgezet.

De meest voorkomende fout: artikelen

Een bestelling bestaat uit vele afzonderlijke artikelen, zodat er geen enkel variant.title is dat kan worden gelezen. Dit levert geen resultaat op:

{{ order.lineItems.variant.title }}

U hebt twee goede opties.

Optie 1 - een lus binnen de lay-out. Verzend de lijst en doorloop deze vervolgens. In de Shopify Flow-actie:

{
  "items": "{{ order.lineItems | json }}"
}

Gebruik in uw lay-out een Loop-blok:

{% for item in variables.items %}
  <tr>
    <td>{{ item.title }}</td>
    <td>{{ item.quantity }}</td>
  </tr>
{% endfor %}

Optie 2 - het in Shopify Flow samenvoegen. Als u slechts één regel tekst nodig hebt, stelt u deze in Shopify Flow samen met een for-lus en verstuurt u de voltooide tekenreeks:

{
  "itemList": "{% for li in order.lineItems %}{{ li.title }} x{{ li.quantity }}{% unless forloop.last %}, {% endunless %}{% endfor %}"
}

Als de app een variabele detecteert die lijkt op gegevens van artikelen - alles met de naam variant, product, item, sku of quantity - waarschuwt de app u hierover op de kaart ‘Gebruik in Shopify Flow’.

Testwaarden zijn geen actuele waarden

Dit brengt bijna iedereen in de war.

• Testvariabelen in de lay-outeditor zijn uitsluitend van invloed op het voorbeeld en de functie ‘Test-e-mail verzenden’.
• Een live Shopify Flow-run negeert deze volledig en gebruikt wat de Shopify Flow-actie ook maar verstuurt.

Een test-e-mail die er perfect uitziet, bewijst dus dat uw ontwerp werkt. Dit zegt echter niets over de configuratie van uw Shopify Flow. Controleer dit altijd door een echte workflow uit te voeren.

Wanneer een variabele geen waarde bevat

Vanaf versie 1.10.0 geeft de app u hierover duidelijk informatie, zodat u niet meer hoeft te gissen.

Indien een live-verzending een variabele tot nul terugbrengt, wordt bij het betreffende item in de geschiedenis het label ‘Lege variabelen’ weergegeven; wanneer u dit opent, wordt precies aangegeven welke variabelen dit betreft, onderverdeeld in twee gevallen:

Zaak	Betekenis	Oplossing
Verzonden door Shopify Flow, maar leeg	De sleutel stond in uw JSON, maar Shopify Flow leverde geen waarde op	Het pad van de eigenschap ‘Flow’ is onjuist of daadwerkelijk leeg voor deze bestelling (bij een checkout als gast is er geen customer.firstName)
Dit bericht is helemaal niet verzonden door Shopify Flow	De sleutel ontbreekt volledig in uw JSON	Voeg het toe - via de knop ‘JSON kopiëren’ krijgt u de volledige set

Voorkomen van lege waarden

Zorg ervoor dat voor alle optionele elementen een alternatief in de lay-out wordt opgenomen, zodat de klant nooit een leeg scherm te zien krijgt:

Hi {{ variables.firstName | default: "there" }}

Wanneer het filter default: is ingesteld, beschouwt de app een lege waarde als opzettelijk en geeft zij hierover geen waarschuwing.

Checklist

1. Kopieer de JSON uit de kaart ‘Gebruik in Shopify Flow’ op uw lay-out.
2. Plak dit in het veld ‘Variabelen (JSON)’ van de Shopify Flow-actie.
3. Vervang alle <pick a Flow variable> met behulp van de variabelekiezer van Shopify Flow.
4. Doorloop de artikelen in plaats van ze rechtstreeks te lezen.
5. Voeg | default: toe aan alles wat optioneel is.
6. Voer de workflow daadwerkelijk uit en controleer vervolgens in de Geschiedenis of er een badge ‘Lege variabelen’ wordt weergegeven.

Gerelateerd

• Variabelen en vloeistoffen - de volledige referentiegids voor sjablonen.
• Een e-mailopmaak opstellen - het ontwerpen van de lay-out zelf.
• Geschiedenis en probleemoplossing - het lezen van een mislukte of lege verzending.