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. წერილებში

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

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

ხელმისაწვდომი ცვლადების სია, რომლებიც ხელმისაწვდომია ყველა იმ ადგილას, სადაც ცვლადების გამოყენება შესაძლებელია.

ცვლადი მნიშვნელობა
contact.id კონტაქტის ID
contact.user_id მომხმარებლის ID
contact.first_name კონტაქტის სახელი
contact.last_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 გვარი განაცხადიდან
name სრული სახელი განაცხადიდან
email Email განაცხადიდან
phone ტელეფონი განაცხადიდან
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.*}) - თუ არჩეულია ფორმის ვარიანტი პროდუქტის ხელმისაწვდომობა + წინადადებით

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

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

ცვლადი მნიშვნელობა
cta.id ფორმის CTA ID
cta.uuid ფორმის CTA UUID
cta.title ფორმის CTA სახელი
cta_request.form_data მომხმარებლის შეყვანილი მონაცემების სია (გაყოფილი ხაზების გადატანით)
სია შეიძლება დაემატოს.

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

  • გატოვებულია CTA განაცხადი

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

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

პროდუქტის ცვლადები

ცვლადი მნიშვნელობა
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
платіж.номер გადახდის რიგითი ნომერი შეკვეთაში
სია შეიძლება დაემატოს.

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

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

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

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

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

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