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

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

Άρθρα:

Αυτό το άρθρο εξηγεί πώς να χρησιμοποιείτε μεταβλητές στο έργο σας — πού να τις εφαρμόσετε, ποια δεδομένα είναι διαθέσιμα και πώς να τις χρησιμοποιήσετε για αυτοματοποίηση και εξατομίκευση. Περιλαμβάνει λίστα με περιγραφές και παραδείγματα για 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. Στα infoblocks των μαθημάτων

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

  • Χαιρετισμός με όνομα: Γεια, {user.first_name}!

  • Εμφάνιση τίτλου μαθήματος, ημερομηνίας, κατάστασης κ.λπ.

6. Στα emails

Η χρήση μεταβλητών στα emails επιτρέπει την πιο εξατομικευμένη και αποτελεσματική επικοινωνία. Με τη βοήθεια μεταβλητών όπως {όνομα}, {ημερομηνία} ή {τίτλος μαθήματος}, το email φαίνεται προσωπικά απευθυνόμενο στον πελάτη. Αυτό αυξάνει την εμπιστοσύνη, την εμπλοκή και την πιθανότητα ο χρήστης να διαβάσει το email μέχρι το τέλος ή να εκτελέσει την επιθυμητή ενέργεια. Επιπλέον, οι μεταβλητές απλοποιούν την αυτοματοποίηση μαζικών αποστολών χωρίς απώλεια της ατομικής προσέγγισης.

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

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

Μεταβλητή Τιμή
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

Μεταβλητές που μπορούν να χρησιμοποιηθούν επιπλέον στο 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)

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

Μεταβλητή Τιμή
referrer Αναφορά από την πρώτη γνωστή επίσκεψη της επαφής (Kwiga / σελίδα προορισμού με CTA)
initial_page Url της πρώτης γνωστής επίσκεψης της επαφής (Kwiga / σελίδα προορισμού με CTA)
reg_from Url της σελίδας από την οποία έγινε η εγγραφή (Kwiga / σελίδα προορισμού με CTA)
tags Ετικέτες επαφής (διαχωριστής ", ")
description Περιγραφή του γεγονότος που ενεργοποίησε την αυτοματοποίηση. Για παράδειγμα: Προστέθηκε ετικέτα test_tag στην επαφή

Μεταβλητές CTA φόρμας

Μεταβλητή Τιμή
cta.id ID CTA φόρμας
cta.uuid UUID CTA φόρμας
cta.title Όνομα CTA φόρμας
cta_request.form_data Λίστα δεδομένων που εισήγαγε ο χρήστης (χωρισμένα με αλλαγές γραμμής)
Η λίστα μπορεί να επεκταθεί.

Διαθέσιμα κατά την ενεργοποίηση των ακόλουθων συμβάντων:

  • Αίτηση υποβλήθηκε CTA

Μεταβλητές προϊόντος

Μεταβλητή Τιμή
product.id ID προϊόντος
product.title Όνομα προϊόντος
product.productable_type Τύπος προϊόντος. Μπορεί να είναι: course, webinar, closed_group, custom_product
product.productable_id ID μαθήματος/webinar/κλειστής ομάδας/προσαρμοσμένου προϊόντος

Διαθέσιμα κατά την ενεργοποίηση των ακόλουθων συμβάντων:

  • Η πρόσβαση στο προϊόν άνοιξε
  • Η πρόσβαση στο προϊόν έκλεισε
  • Εγγραφή σε webinar
  • Ολοκλήρωση μαθήματος
  • Ολοκλήρωση κουίζ
  • Ακύρωση προηγούμενου αποτελέσματος κουίζ
  • Το κουίζ μεταφέρθηκε σε κατάσταση
  • Έναρξη πρόσβασης με συνδρομή
  • Τέλος πρόσβασης με συνδρομή
  • Ξεκίνησε να παρακολουθεί το μάθημα
  • Παρακολούθησε το μάθημα
  • Άνοιξε η πρόσβαση στο μάθημα
  • Η πρακτική στο μάθημα ολοκληρώθηκε

Μεταβλητές παραγγελίας

Μεταβλητή Τιμή
order.id ID παραγγελίας
order.price Τελική τιμή. Παράδειγμα 10.99
order.currency_code Νόμισμα παραγγελίας σε κωδικό μορφή. Παράδειγμα: USD
order.currency_symbol Νόμισμα παραγγελίας σε μορφή συμβόλου. Παράδειγμα: $
order.currency_short_title Νόμισμα παραγγελίας σε συντομευμένη ονομασία. Παράδειγμα: usd
order.order_stage_id ID κατάστασης χωνιού
order.order_stage_title Όνομα κατάστασης χωνιού
order.funnel_id ID χωνιού
order.funnel_title Όνομα χωνιού
order.paid_status Κατάσταση πληρωμής παραγγελίας not_paid / partial_paid / paid
order.paid_status_title Κατάσταση πληρωμής στα αγγλικά
Η λίστα μπορεί να επεκταθεί.

Διαθέσιμα κατά την ενεργοποίηση των ακόλουθων συμβάντων:

  • Η συνδρομή ξεκίνησε
  • Η συνδρομή ανανεώθηκε
  • Επιτυχής πληρωμή παραγγελίας
  • Νέα παραγγελία
  • Επιτυχής πληρωμή προσφοράς
  • Επιστροφή πληρωμής προσφοράς
  • Η πρόσβαση στο προϊόν άνοιξε
  • Έναρξη πρόσβασης με συνδρομή
  • Τέλος πρόσβασης με συνδρομή

Μεταβλητές πληρωμής

Μεταβλητή Τιμή
payment.id ID πληρωμής
payment.price Τιμή πληρωμής
payment.currency_code Νόμισμα πληρωμής σε κωδικό μορφή. Παράδειγμα: USD
payment.currency_symbol Νόμισμα πληρωμής σε μορφή συμβόλου. Παράδειγμα: $
payment.currency_short_title Νόμισμα πληρωμής σε συντομευμένη ονομασία. Παράδειγμα: usd
payment.created_at Ημερομηνία δημιουργίας πληρωμής. Μορφή YYYY-MM-DD HH:mm:ss
payment.paid_at Ημερομηνία πληρωμής. Μορφή YYYY-MM-DD HH:mm:ss
payment.schedule_payment_at Προγραμματισμένη ημερομηνία πληρωμής. Μορφή YYYY-MM-DD HH:mm:ss
платіж.номер Σειριακός αριθμός πληρωμής στην παραγγελία
Η λίστα μπορεί να επεκταθεί.

Διαθέσιμα κατά την ενεργοποίηση των ακόλουθων συμβάντων:

  • Επιτυχής πληρωμή προσφοράς
  • Επιστροφή πληρωμής προσφοράς

Μεταβλητές προσφοράς

Μεταβλητή Τιμή
offer.id ID προσφοράς
offer.title Όνομα προσφοράς
Η λίστα μπορεί να επεκταθεί.

Διαθέσιμα κατά την ενεργοποίηση των ακόλουθων συμβάντων:

  • Επιτυχής πληρωμή προσφοράς
  • Επιστροφή πληρωμής προσφοράς
  • Αποδοχή δωρεάν προσφοράς
  • Η συνδρομή ξεκίνησε
  • Η συνδρομή ανανεώθηκε
  • Επιτυχής πληρωμή παραγγελίας
  • Νέα παραγγελία
  • Η πρόσβαση στο προϊόν άνοιξε
  • Έναρξη πρόσβασης με συνδρομή
  • Τέλος πρόσβασης με συνδρομή

Μεταβλητές συνδρομής στο προϊόν

Μεταβλητή Τιμή
subscription.id ID συνδρομής προϊόντος
subscription.start_at Ημερομηνία έναρξης συνδρομής. YYYY-MM-DD HH:mm:ss
subscription.end_at Τελική ημερομηνία λήξης συνδρομής. YYYY-MM-DD HH:mm:ss
subscription.order_end_at Ημερομηνία λήξης συνδρομής, λαμβάνοντας υπόψη μόνο τις πληρωμένες πληρωμές. YYYY-MM-DD HH:mm:ss
subscription.paid_at Ημερομηνία πρώτης πληρωμής συνδρομής. YYYY-MM-DD HH:mm:ss
Η λίστα μπορεί να επεκταθεί.

Διαθέσιμα κατά την ενεργοποίηση των ακόλουθων συμβάντων:

  • Η πρόσβαση στο προϊόν άνοιξε
  • Έναρξη πρόσβασης με συνδρομή
  • Τέλος πρόσβασης με συνδρομή

Μεταβλητές προσπάθειας κουίζ

Μεταβλητή Τιμή
quiz_attempt.id ID προσπάθειας
quiz_attempt.number_version Αριθμός έκδοσης ολοκλήρωσης
quiz_attempt.quiz_id ID κουίζ
quiz_attempt.course_id ID μαθήματος
quiz_attempt.course_lesson_id ID μαθήματος
quiz_attempt.status_id ID κατάστασης
quiz_attempt.status Κατάσταση σε κείμενο
quiz_attempt.scores Συγκεντρωμένοι πόντοι
quiz_attempt.created_at Έναρξη προσπάθειας. Μορφή YYYY-MM-DD HH:mm:ss
quiz_attempt.finished_at Τέλος προσπάθειας. Μορφή YYYY-MM-DD HH:mm:ss
quiz_attempt.count_questions Αριθμός ερωτήσεων στο κουίζ
quiz_attempt.count_questions_incorrect Αριθμός ερωτήσεων με λάθος απαντήσεις
quiz_attempt.count_questions_correct Αριθμός σωστών απαντήσεων
quiz.title Τίτλος κουίζ
Η λίστα μπορεί να επεκταθεί.

Διαθέσιμα κατά την ενεργοποίηση των ακόλουθων συμβάντων:

  • Ολοκλήρωση κουίζ
  • Ακύρωση προηγούμενου αποτελέσματος κουίζ
  • Το κουίζ μεταφέρθηκε σε κατάσταση

Μεταβλητές μαθήματος

Μεταβλητή Τιμή
lesson.id ID μαθήματος
lesson.title Τίτλος μαθήματος
Η λίστα μπορεί να επεκταθεί.

Διαθέσιμα κατά την ενεργοποίηση των ακόλουθων συμβάντων:

  • Ολοκλήρωση κουίζ
  • Ακύρωση προηγούμενου αποτελέσματος κουίζ
  • Το κουίζ μεταφέρθηκε σε κατάσταση
  • Ξεκίνησε να παρακολουθεί το μάθημα
  • Παρακολούθησε το μάθημα
  • Άνοιξε η πρόσβαση στο μάθημα
  • Η πρακτική στο μάθημα ολοκληρώθηκε