KWIGA დახმარების ცენტრი სერვისები, ინტეგრაციები, API, პარამეტრები ზოგადი პარამეტრები ცვლადების გამოყენება პროექტში, ხელმისაწვდომი ცვლადების სია

ცვლადების გამოყენება პროექტში, ხელმისაწვდომი ცვლადების სია

სტატიები:

ეს სტატია აგიხსნით, როგორ გამოიყენოთ ცვლადები თქვენს პროექტში — სად შეიძლება მათი გამოყენება, რა მონაცემებია ხელმისაწვდომი და როგორ გამოიყენოთ ისინი ავტომატიზაციისა და პერსონალიზაციისთვის. მოცემულია აღწერილი სია მაგალითებით ელფოსტებისთვის, ვებჰუკებისთვის, ღილაკებისთვის, გაკვეთილებისთვის და სხვა ელემენტებისთვის.


ამ სტატიაში:


ზოგადი ინფორმაცია ცვლადების შესახებ

ცვლადები არის მოსახერხებელი გზა, რომ ჩასვათ პერსონალიზებული მონაცემები თქვენი პროექტის სხვადასხვა ელემენტში. ისინი შეიძლება გამოყენებულ იქნან შემდეგ ადგილებში:

1. ვებჰუკები ავტომატიზაციებში

ცვლადების ჩასმა შესაძლებელია:

  • ვებჰუკის URL-ში, მაგალითად:
    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. გაკვეთილების ინფობლოკებში

ცვლადები მუშაობს ინფობლოკების ტექსტებში. მაგალითად:

  • მიმართვა სახელით: გამარჯობა, {user.first_name}!

  • კურსის სახელწოდების, თარიღის, სტატუსის და ა.შ. ჩვენება

6. წერილებში

ცვლადების გამოყენება წერილებში საშუალებას გაძლევთ კომუნიკაცია გახადოთ უფრო პერსონალიზებული და ეფექტური. ცვლადების, როგორიცაა {სახელი}, {თარიღი} ან {კურსის სახელწოდება} გამოყენებით, წერილი გამოიყურება პერსონალურად მიმართული მომხმარებლისთვის. ეს ზრდის ნდობას, ჩართულობას და ალბათობას, რომ მომხმარებელი წერილს ბოლომდე წაიკითხავს ან შეასრულებს საჭირო მოქმედებას. გარდა ამისა, ცვლადები ამარტივებს მასობრივი გაგზავნის ავტომატიზაციას ინდივიდუალური მიდგომის დაკარგვის გარეშე.

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

ცვლადები, რომლებიც დამატებით შეიძლება გამოყენებულ იქნან 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 რეფერერი, რომელიც იყო ლენდინგზე, როცა გაგზავნეს განაცხადი

ასევე გარკვეულ ფორმებში ხელმისაწვდომია ქვემოთ აღწერილი ცვლადები ავტომატიზაციის ვებჰუკებში ხელმისაწვდომი ცვლადები

შეკვეთით ({order.*}) - თუ არჩეულია ფორმის ვარიანტი პროდუქტის ხელმისაწვდომობა (სრული ხელმისაწვდომობა/წინადადებით)

პროდუქტით({product.*}) - თუ არჩეულია ფორმის ვარიანტი პროდუქტის ხელმისაწვდომობა + სრული ხელმისაწვდომობა

წინადადებით ({offer.*}) - თუ არჩეულია ფორმის ვარიანტი პროდუქტის ხელმისაწვდომობა + წინადადებით

კასტომიზირებული ველები

{field_<id>}

მაგალითი {contact.field_123}

<id> - ველის id, რომელიც შეგიძლიათ მიიღოთ კონტაქტის ველების პარამეტრებში (მაგალითი https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

თუ გვერდზე, სადაც განთავსებულია CTA ან Kwiga-ს სკრიპტი ვიზიტების ტრეკინგისთვის, იყო ვიზიტები utm ნიშნებით, და კლიენტმა დატოვა განაცხადი ლენდინგზე უკვე utm ნიშნების გარეშე, მაშინ ამ ცვლადებში ისინი არ იქნება. მაგრამ ისინი ხელმისაწვდომი იქნება ცვლადებში {contact.utm_...}, რომლებიც აღწერილია ზემოთ.

ცვლადები ხელმისაწვდომია ავტომატიზაციის ვებჰუკებში (url, პარამეტრები, წერილები)

ხელმისაწვდომი ცვლადების სია

ცვლადი მნიშვნელობა
referrer რეფერერი კონტაქტის პირველი ცნობილი ვიზიტიდან (Kwiga / ლენდინგი CTA-ით)
initial_page კონტაქტის პირველი ცნობილი ვიზიტის Url (Kwiga / ლენდინგი CTA-ით)
reg_from გვერდის Url, საიდანაც მოხდა რეგისტრაცია (Kwiga / ლენდინგი CTA-ით)
tags კონტაქტის ტეგები (გამყოფი ", ")
description მოვლენის აღწერა, რომლის მიხედვითაც ავტომატიზაცია ამოქმედდა. მაგალითად: კონტაქტს დაემატა ტეგი test_tag

ფორმის CTA ცვლადები

ცვლადი მნიშვნელობა
cta.id ფორმის CTA ID
cta.uuid ფორმის CTA UUID
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

ხელმისაწვდომია შემდეგი მოვლენების დროს:

  • პროდუქტზე წვდომა გახსნილია
  • პროდუქტზე წვდომა დახურულია
  • დარეგისტრირდა ვებინარზე
  • კურსი დასრულებულია
  • კვიზის გავლა
  • წინა კვიზის შედეგის გაუქმება
  • კვიზი გადავიდა სტატუსში
  • ხელმისაწვდომობის დაწყება გამოწერით
  • ხელმისაწვდომობის დასრულება გამოწერით
  • დაიწყო გაკვეთილის ყურება
  • გაკვეთილი ნანახია
  • გაკვეთილზე წვდომა გახსნილია
  • გაკვეთილის ყველა პრაქტიკა გავლილია

შეკვეთის ცვლადები

ცვლადი მნიშვნელობა
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
payment.number გადახდის რიგითი ნომერი შეკვეთაში
სია შეიძლება დაემატოს.

ხელმისაწვდომია შემდეგი მოვლენების დროს:

  • შეთავაზების წარმატებული გადახდა
  • შეთავაზების წარუმატებელი გადახდა
  • შეთავაზების გადახდის დაბრუნება

შეთავაზების ცვლადები

ცვლადი მნიშვნელობა
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 გაკვეთილის სახელი
სია შეიძლება დაემატოს.

ხელმისაწვდომია შემდეგი მოვლენების დროს:

  • კვიზის გავლა
  • წინა კვიზის შედეგის გაუქმება
  • კვიზი გადავიდა სტატუსში
  • დაიწყო გაკვეთილის ყურება
  • გაკვეთილი ნანახია
  • გაკვეთილზე წვდომა გახსნილია
  • გაკვეთილის ყველა პრაქტიკა გავლილია