Μεταβλητές μηνυμάτων

Εξατομικεύστε οποιοδήποτε μήνυμα journey (email, SMS, push, WhatsApp, webhook) με placeholders Liquid. Μια μεταβλητή χωρίς τιμή αποδίδεται ως κενό κείμενο - δεν αποτελεί ποτέ σφάλμα.

Οι δύο χώροι ονομάτων συμβάντων

Τα journeys σάς δίνουν δύο χώρους ονομάτων συμβάντων, και η διαφορά έχει σημασία:

• trigger - πώς εισήλθαν. Το συμβάν εισόδου, σταθερό για ολόκληρη την εκτέλεση.
• event - το τελευταίο πράγμα που έκαναν. Το πιο πρόσφατο συμβάν που προώθησε το journey, όπως η απάντηση που επέλυσε έναν Διαχωρισμό βάσει συμπεριφοράς. Ξεκινά ίσο με το trigger και έπειτα επαναδεσμεύεται κάθε φορά που επιλύεται μια αναμονή.

Επομένως, για το «τι μόλις απάντησε η επαφή», χρησιμοποιήστε το event (ή τα ψευδώνυμα reply παρακάτω) - όχι το trigger.

Χρήστης - προεπιλεγμένα έναντι προσαρμοσμένων γνωρισμάτων

Προεπιλεγμένα γνωρίσματα - τυπικά πεδία, γραμμένα ως {{ user.firstName }}:

Μεταβλητή	Τιμή
user.firstName, user.lastName	Γνωρίσματα ονόματος
user.email, user.phone	Πεδία επικοινωνίας
user.id	Το ίδιο το id επαφής του Joryio
user.externalId	Το δικό σας εξωτερικό id
user.whatsappName	Όνομα προφίλ WhatsApp συγχρονισμένο στην επαφή

Προσαρμοσμένα γνωρίσματα - οτιδήποτε άλλο στην επαφή, κάτω από τον χώρο ονομάτων custom, π.χ. {{ user.custom.plan }}:

Μεταβλητή	Τιμή
user.custom.<attribute>	Οποιοδήποτε προσαρμοσμένο γνώρισμα (π.χ. user.custom.plan)

σημείωση

Η παλαιότερη επίπεδη μορφή {{ user.<attribute> }} εξακολουθεί να επιλύεται για συμβατότητα, αλλά η {{ user.custom.<attribute> }} είναι ο προτεινόμενος τρόπος αναφοράς σε προσαρμοσμένα γνωρίσματα - τα κρατά οπτικά διακριτά από τα προεπιλεγμένα πεδία.

σημείωση

Τα ονόματα των προεπιλεγμένων γνωρισμάτων είναι δεσμευμένα - δεν μπορείτε να δημιουργήσετε προσαρμοσμένο γνώρισμα με το ίδιο όνομα με ένα προεπιλεγμένο (π.χ. email, country, firstName), ώστε τα δύο να μη συγκρούονται ποτέ και ο επιλογέας να μην εμφανίζει ποτέ ένα όνομα δύο φορές.

Εισαγωγή μεταβλητών

Οι επεξεργαστές WhatsApp, SMS, push και webhook έχουν κουμπί + Εξατομίκευση που ανοίγει τον επιλογέα Προσθήκη εξατομίκευσης. Επιλέξτε τύπο, διαλέξτε το γνώρισμα, προσθέστε προαιρετική προεπιλεγμένη τιμή και μετά κάντε Εισαγωγή του παραγόμενου αποσπάσματος:

• Τελευταίο συμβάν - το πιο πρόσφατο συμβάν που προώθησε το journey. Επιλέξτε πηγή: Απάντηση (WhatsApp) (τα φιλικά ψευδώνυμα reply.*) ή Προσαρμοσμένο συμβάν (event.*).
• Έναυσμα (είσοδος) - πώς εισήλθαν. Επιλέξτε πηγή: Μήνυμα WhatsApp ή Προσαρμοσμένο συμβάν.
• Προεπιλεγμένα γνωρίσματα - {{ user.firstName }}, {{ user.email }} και τα υπόλοιπα βασικά πεδία (η ίδια λίστα με τον επιλογέα «προεπιλεγμένων γνωρισμάτων» των τμημάτων).
• Προσαρμοσμένα γνωρίσματα - μόνο τα προσαρμοσμένα γνωρίσματα του οργανισμού σας (τα προεπιλεγμένα εμφανίζονται στον δικό τους τύπο, ποτέ και στα δύο), εισάγονται ως {{ user.custom.<attribute> }}.
• Κατάλογος προϊόντων - εγγραφές από τον συγχρονισμένο κατάλογο του καταστήματός σας μέσω μιας Επιλογής (Selection) προϊόντων, εισάγονται ως ετικέτα assign όπως {% assign products = 'featured' | products %} την οποία στη συνέχεια διατρέχετε με {% for item in products %} … {% endfor %}.
• Προσαρμοσμένη οντότητα - εγγραφές από μια προσαρμοσμένη οντότητα μέσω μιας αποθηκευμένης Επιλογής, εισάγονται ως {% assign items = 'tv_series' | entity: 'latest' %} και διατρέχονται με τον ίδιο τρόπο.

Η προαιρετική προεπιλεγμένη τιμή προσθέτει ένα φίλτρο | default: "…", ώστε ένα κενό γνώρισμα να επιστρέφει στο κείμενό σας αντί να αποδίδεται κενό.

Email και εντός εφαρμογής

Οι οπτικοί επεξεργαστές email και εντός εφαρμογής έχουν κουμπί Εξατομίκευση που ανοίγει τον ίδιο επιλογέα σε λειτουργία αντιγραφής: δημιουργήστε το απόσπασμα, αντιγράψτε το και επικολλήστε το όπου θέλετε στη σχεδίασή σας. (Τα Απάντηση / Τελευταίο συμβάν / Έναυσμα δεν προσφέρονται εκεί - αυτά επιλύονται μόνο μέσα σε ένα journey.)

Έναυσμα (συμβάν εισόδου)

Μεταβλητή	Τιμή
trigger.properties.<field>	Οποιαδήποτε ιδιότητα μετέφερε το συμβάν εισόδου
trigger.properties.content.text	Το εισερχόμενο κείμενο, αν η είσοδος ήταν μήνυμα WhatsApp

Συμβάν (τελευταίο προωθητικό συμβάν) και ψευδώνυμα reply

Μετά από έναν Διαχωρισμό βάσει συμπεριφοράς που περιμένει απάντηση, το event είναι αυτή η απάντηση. Τα ψευδώνυμα reply είναι φιλικές συντομεύσεις για εισερχόμενα μηνύματα - λειτουργούν το ίδιο τόσο για απάντηση WhatsApp όσο και για απάντηση SMS. Μετά από Διαχωρισμό βάσει συμπεριφοράς Εισερχόμενου μηνύματος SMS, το reply.text είναι το τελευταίο εισερχόμενο κείμενο SMS της επαφής.

Μεταβλητή	Ψευδώνυμο	Τιμή
event.properties.content.text	reply.text	Το κείμενο της απάντησης
event.properties.type	reply.type	Τύπος εισερχόμενου μηνύματος (κείμενο, εικόνα, κουμπί…)
event.properties.profile.name	reply.profile.name	Όνομα προφίλ WhatsApp
event.name	-	Το όνομα του συμβάντος
event.properties.<field>	-	Οποιαδήποτε άλλη καταγεγραμμένη ιδιότητα

Παράδειγμα - απάντηση WhatsApp μετά από Διαχωρισμό βάσει συμπεριφοράς

Thanks {{ reply.profile.name | default: "there" }} - you said
"{{ reply.text }}". We'll follow up shortly.

συμβουλή

Χρησιμοποιήστε το trigger.* για το πώς εισήλθαν και τα event.* / reply.* για το τι μόλις έκαναν. Σε ένα journey με προγραμματισμένη είσοδο, το trigger δεν έχει εισερχόμενο περιεχόμενο - η απάντηση μετά από έναν διαχωρισμό βρίσκεται στα event / reply.