Κέντρο βοήθειας KWIGA Υπηρεσίες, ενσωματώσεις, API, Ρυθμίσεις Γενικές ρυθμίσεις Χρήση μεταβλητών στο έργο, λίστα διαθέσιμων μεταβλητών

Χρήση μεταβλητών στο έργο, λίστα διαθέσιμων μεταβλητών

Άρθρα:

πριν 8 μήνες • Ενημερώθηκε

Αυτό το άρθρο εξηγεί πώς να χρησιμοποιείτε μεταβλητές στο έργο σας — πού να τις εφαρμόσετε, ποια δεδομένα είναι διαθέσιμα και πώς να τις χρησιμοποιήσετε για αυτοματοποίηση και εξατομίκευση. Περιλαμβάνει λίστα με περιγραφές και παραδείγματα για email, webhooks, κουμπιά, μαθήματα και άλλα.

Γενικές πληροφορίες για τις μεταβλητές

Οι μεταβλητές είναι ένας βολικός τρόπος για να εισάγετε εξατομικευμένα δεδομένα σε διάφορα στοιχεία του έργου σας. Μπορούν να χρησιμοποιηθούν σε τέτοια μέρη:

1. Webhooks στις αυτοματοποιήσεις

Οι μεταβλητές μπορούν να εισαχθούν:

στο URL του webhook, για παράδειγμα:
https://example.com/hook?user={user.email}
στις παραμέτρους του σώματος του αιτήματος
στις κεφαλίδες

Αυτό επιτρέπει την αυτόματη μεταφορά προσωπικών δεδομένων σε εξωτερικές υπηρεσίες.

2. CTA (Call to Action)

Στα κουμπιά και στους συνδέσμους, οι μεταβλητές μπορούν να χρησιμοποιηθούν για:

εξατομίκευση του κειμένου του κουμπιού
μεταφορά δεδομένων μέσω συνδέσμων, όπως το ID χρήστη ή οι ετικέτες UTM

3. Στις παραμέτρους

Οι μεταβλητές μπορούν να χρησιμοποιηθούν στις παραμέτρους των φορμών ή άλλων στοιχείων:

email χρήστη
ID συνδρομής
μοναδικοί κωδικοί και ετικέτες
οποιαδήποτε άλλη μεταβλητή διαθέσιμη στο πλαίσιο

4. Στον σύνδεσμο ανακατεύθυνσης (εάν δεν χρησιμοποιείται μετάβαση σε πληρωμή)

Μπορείτε να προσθέσετε μεταβλητές χειροκίνητα στον σύνδεσμο ανακατεύθυνσης:

https://my.site.com/thanks?email={user.email}&course={course.title}

5. Στον σύνδεσμο ανακατεύθυνσης επιτυχούς πληρωμής προσφοράς

Στον σύνδεσμο ανακατεύθυνσης μετά την επιτυχή πληρωμή της προσφοράς είναι διαθέσιμες οι μεταβλητές από τα μπλοκ contact.*, order.* και payment.*

Παράδειγμα: https://my.site.com/success?order_id={order.id}&email={contact.email}&payment_price={payment.price}

5. Στα infoblocks των μαθημάτων

Οι μεταβλητές και τα υπό συνθήκη μπλοκ λειτουργούν μέσα στα κείμενα των πληροφοριακών μπλοκ. Για παράδειγμα:

Χαιρετισμός με όνομα: Γεια, {user.first_name}!
Εμφάνιση τίτλου μαθήματος, ημερομηνίας, κατάστασης κ.λπ.
Στοιχεία επαφής: {contact.name}, {contact.email} και άλλα πεδία
Δεδομένα του τρέχοντος μαθήματος: {lesson.title}, {lesson.slug} και άλλα πεδία του μαθήματος
Μπλοκ υπό συνθήκη @if/@endif: εμφάνιση διαφορετικού περιεχομένου ανάλογα με το αν η επαφή έχει ετικέτα, πρόσβαση στην προσφορά κ.λπ.

6. Στα emails

Η χρήση μεταβλητών στα email επιτρέπει την πιο προσωποποιημένη και αποτελεσματική επικοινωνία. Με τη βοήθεια μεταβλητών, όπως {имя}, {дата} ή {название курса}, το email φαίνεται να απευθύνεται προσωπικά στον πελάτη. Αυτό αυξάνει την εμπιστοσύνη, τη συμμετοχή και την πιθανότητα ο χρήστης να διαβάσει το email μέχρι το τέλος ή να εκτελέσει την επιθυμητή ενέργεια. Επιπλέον, οι μεταβλητές απλοποιούν την αυτοματοποίηση μαζικών αποστολών χωρίς απώλεια της ατομικής προσέγγισης.

7. Στις ειδοποιήσεις

Κατά τη ρύθμιση ειδοποιήσεων σε αυτοματοποιημένες ενέργειες, οι μεταβλητές επιτρέπουν τη δυναμική εισαγωγή πληροφοριών στις ειδοποιήσεις, όπως το όνομα χρήστη, ο αριθμός παραγγελίας ή ο τίτλος της προσφοράς. Αυτό απλοποιεί και επιταχύνει τη διαδικασία δημιουργίας ειδοποιήσεων, καθιστώντας τις πιο διαισθητικές και προσαρμοστικές για διάφορα σενάρια.

Λίστα διαθέσιμων μεταβλητών

Λίστα διαθέσιμων μεταβλητών που είναι διαθέσιμες σε όλα τα μέρη όπου μπορούν να χρησιμοποιηθούν μεταβλητές.

Μεταβλητή	Τιμή
contact.id	ID επαφής
contact.user_id	ID χρήστη
contact.first_name	Όνομα επαφής
contact.last_name	Επώνυμο επαφής
contact.middle_name	Πατρώνυμο επαφής
contact.name	Πλήρες όνομα επαφής
contact.email	Email επαφής
contact.phone	Τηλέφωνο επαφής
contact.country	Χώρα επαφής. Για παράδειγμα: Ουκρανία
contact.timezone	Ζώνη ώρας επαφής. Για παράδειγμα: Europe/Kyiv
contact.currency	Νόμισμα επαφής. Για παράδειγμα: USD
contact.city	Πόλη επαφής
contact.utm_source	Λίστα μοναδικών utm_source επαφής (διαχωριστής ", ")
contact.utm_medium	Λίστα μοναδικών utm_medium επαφής (διαχωριστής ", ")
contact.utm_campaign	Λίστα μοναδικών utm_campaign επαφής (διαχωριστής ", ")
contact.utm_term	Λίστα μοναδικών utm_term επαφής (διαχωριστής ", ")
contact.utm_content	Λίστα μοναδικών utm_content επαφής (διαχωριστής ", ")
contact.field_<id>	Προσαρμοσμένα πεδία (περιγραφή παρακάτω)
datetime	Ημερομηνία και ώρα σε UTC σε μορφή YYYY-MM-DD HH:mm:ss
contact.visit_source	Πηγή επίσκεψης
Αυτές οι μεταβλητές είναι διαθέσιμες στον σύνδεσμο ανακατεύθυνσης επιτυχούς πληρωμής προσφοράς.

Προσαρμοσμένα πεδία

{contact.field_<id>}

Παράδειγμα {contact.field_123}

<id> - id πεδίου που μπορεί να ληφθεί από τις ρυθμίσεις πεδίων επαφής (παράδειγμα https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Πώς να αλλάξετε την τιμή της μεταβλητής

Μετά τη μεταβλητή μπορείτε να προσθέσετε επιλογές, για να αλλάξετε την εμφάνισή της: να προσθέσετε κείμενο, να κάνετε τα γράμματα κεφαλαία ή να μορφοποιήσετε την ημερομηνία.

Γενική μορφή: {variable|option:value|option}. Για παράδειγμα: {order.id|prefix:ORDER-} ή {payment.paid_at|format:DD.MM.YYYY}.

Τι θέλετε να πετύχετε	Τι να γράψετε
Προσθήκη κειμένου πριν από την τιμή	`{order.id\|prefix:ORDER-}` -> θα γίνει `ORDER-123`
Προσθήκη κειμένου μετά την τιμή	`{order.id\|suffix:-EU}` -> θα γίνει `123-EU`
Να έχει ο αριθμός σταθερό μήκος	`{payment.number\|pad:6}` -> θα γίνει `000001`
Συμπλήρωση όχι με μηδενικά, αλλά με δικό σας σύμβολο	`{payment.number\|pad:6\|padchar:_}` -> θα γίνει `_____1`
Να γίνουν όλα τα γράμματα κεφαλαία	`{contact.city\|upper}` -> `KYIV`
Να γίνουν όλα τα γράμματα πεζά	`{contact.city\|lower}` -> `kyiv`
Να γίνει κεφαλαίο μόνο το πρώτο γράμμα	`{contact.city\|ucfirst}` -> `Kyiv`
Εμφάνιση της ημερομηνίας στην επιθυμητή μορφή	`{payment.paid_at\|format:DD.MM.YYYY}` -> θα γίνει `24.12.2026`

Αν θέλετε δικό σας πρότυπο ημερομηνίας, μπορείτε να δείτε έτοιμες σημάνσεις στην ανοιχτή τεκμηρίωση: για μορφές όπως DD.MM.YYYY, MMMM YYYY, dddd είναι κατάλληλη η τεκμηρίωση του Carbon. Για μορφές όπως Y-m-d και H:i:s είναι κατάλληλη η επίσημη τεκμηρίωση της PHP.

Σημαντικό: αν χρησιμοποιείται το pad, πρώτα η τιμή συμπληρώνεται στο απαιτούμενο μήκος και μόνο μετά εφαρμόζονται οι υπόλοιπες επιλογές.

Μπλοκ υπό συνθήκη @if / @endif

Σας επιτρέπουν να εμφανίζετε ή να αποκρύπτετε μέρος του κειμένου ανάλογα με μια συνθήκη. Αν η συνθήκη είναι αληθής, το μπλοκ εμφανίζεται· αν όχι — αφαιρείται πλήρως.

Σύνταξη: @if(συνθήκη)...κείμενο...@endif

Παράδειγμα:
@if({contact.has|offer:123})Αποκτήστε πρόσβαση στο υλικό@endif

Η συνθήκη μέσα στο @if() είναι οποιαδήποτε μεταβλητή που επιστρέφει true ή false. Προς το παρόν υποστηρίζεται το {contact.has|...} (έλεγχος συμμετοχής επαφής).

Συνθήκη contact.has — έλεγχος επαφής

Σας επιτρέπει να ελέγχετε αν η επαφή πληροί συγκεκριμένες συνθήκες. Επιστρέφει true ή false. Συνήθως χρησιμοποιείται μαζί με μπλοκ υπό συνθήκη @if/@endif.

Σύνταξη: {contact.has|τύπος:τιμή}

Τύπος	Τιμή	Περιγραφή
`offer`	ID προσφοράς	Η επαφή έχει πρόσβαση στην προσφορά
`order`	ID παραγγελίας	Η επαφή έχει παραγγελία με αυτό το ID
`product`	ID προϊόντος	Η επαφή έχει πρόσβαση στο προϊόν
`tag`	ID ή όνομα ετικέτας	Η επαφή έχει ετικέτα (υποστηρίζονται κυριλλικά και κενά στο όνομα)
`list`	ID λίστας	Η επαφή ανήκει στη λίστα
`course`	ID μαθήματος	Η επαφή είναι εγγεγραμμένη στο μάθημα
`marathon`	ID μαθήματος	Ψευδώνυμο για το course (το marathon — υποτύπος μαθήματος)
`webinar`	ID webinar	Η επαφή έχει πρόσβαση στο webinar
`closed_group`	ID κλειστής ομάδας	Η επαφή έχει πρόσβαση στην κλειστή ομάδα

Μπορείτε να ορίσετε πολλές συνθήκες μέσω του | — όλες πρέπει να ισχύουν ταυτόχρονα (λογική AND). Για παράδειγμα: {contact.has|offer:123|tag:VIP}

Παραδείγματα χρήσης:

{contact.has\|offer:123}	ελέγχει την ύπαρξη προσφοράς με ID 123
{contact.has\|tag:VIP}	ελέγχει την ετικέτα βάσει ονόματος
{contact.has\|tag:тест тег}	ετικέτα με κενό και κυριλλικά
{contact.has\|offer:123\|tag:VIP}	και οι δύο συνθήκες ταυτόχρονα (AND)

Μεταβλητές που μπορούν να χρησιμοποιηθούν επιπλέον στο CTA

στις παραμέτρους
στον σύνδεσμο ανακατεύθυνσης (εάν δεν χρησιμοποιείται μετάβαση σε πληρωμή)

Μεταβλητή	Τιμή
first_name	Όνομα από την αίτηση
last_name	Επώνυμο από την αίτηση
middle_name	Πατρώνυμο από την αίτηση
name	Πλήρες όνομα από την αίτηση
email	Email από την αίτηση
phone	Τηλέφωνο από την αίτηση
field_<id>	Προσαρμοσμένα πεδία Τηλέφωνο από την αίτηση (περιγραφή παρακάτω)
utm_source	utm_source - συγκεκριμένα από την επίσκεψη από την οποία έγινε η αίτηση
utm_medium	utm_medium - συγκεκριμένα από την επίσκεψη από την οποία έγινε η αίτηση
utm_campaign	utm_campaign - συγκεκριμένα από την επίσκεψη από την οποία έγινε η αίτηση
utm_term	utm_term - συγκεκριμένα από την επίσκεψη από την οποία έγινε η αίτηση
utm_content	utm_content - συγκεκριμένα από την επίσκεψη από την οποία έγινε η αίτηση
widget_landing	Url της σελίδας προορισμού από την οποία στάλθηκε η αίτηση
widget_landign_referer	Αναφορά που υπήρχε στη σελίδα προορισμού όταν στάλθηκε η αίτηση
Επίσης, σε ορισμένες φόρμες μπορεί να είναι διαθέσιμες οι μεταβλητές που περιγράφονται παρακάτω στις Μεταβλητές διαθέσιμες στους αυτοματισμούς webhook Κατά παραγγελία ({order.}) - Εάν επιλεγεί η επιλογή φόρμας Πρόσβαση στο προϊόν (Πλήρης πρόσβαση/Κατά προσφορά) Κατά προϊόντος({product.}) - Εάν επιλεγεί η επιλογή φόρμας Πρόσβαση στο προϊόν + Πλήρης πρόσβαση Κατά προσφοράς ({offer.*}) - Εάν επιλεγεί η επιλογή φόρμας Πρόσβαση στο προϊόν + Κατά προσφορά

Προσαρμοσμένα πεδία

{field_<id>}

Παράδειγμα {contact.field_123}

<id> - id πεδίου που μπορεί να ληφθεί από τις ρυθμίσεις πεδίων επαφής (παράδειγμα https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Εάν στη σελίδα όπου βρίσκεται το CTA ή το script Kwiga για την παρακολούθηση επισκέψεων υπήρχαν επισκέψεις με utm tags και ο πελάτης άφησε αίτηση στη σελίδα προορισμού χωρίς utm tags, τότε σε αυτές τις μεταβλητές θα απουσιάζουν. Αλλά θα είναι διαθέσιμες στις μεταβλητές {contact.utm_...}, που περιγράφονται παραπάνω.

Μεταβλητές διαθέσιμες στα webhooks αυτοματοποίησης (url, παράμετροι, emails)