การใช้ตัวแปรในโปรเจกต์ รายการตัวแปรที่ใช้ได้

ข้อมูลทั่วไปเกี่ยวกับตัวแปร

ตัวแปรเป็นวิธีที่สะดวกในการแทรกข้อมูลเฉพาะบุคคลลงในองค์ประกอบต่างๆ ของโปรเจกต์ของคุณ โดยสามารถใช้ได้ในตำแหน่งต่างๆ เช่น:

1. Webhook ในระบบอัตโนมัติ

สามารถแทรกตัวแปรได้:

• ใน URL ของ webhook ตัวอย่างเช่น:
  https://example.com/hook?user={user.email}
  

• ในพารามิเตอร์เนื้อหาคำขอ

• ในส่วนหัว

ช่วยให้ส่งข้อมูลส่วนบุคคลไปยังบริการของบุคคลที่สามได้โดยอัตโนมัติ

2. CTA (คำกระตุ้นให้ดำเนินการ)

ในปุ่มและลิงก์ สามารถใช้ตัวแปรเพื่อ:

• ปรับข้อความปุ่มให้เหมาะกับแต่ละบุคคล

• ส่งต่อข้อมูลผ่านลิงก์ เช่น ID ผู้ใช้หรือแท็ก UTM
  

3. ในพารามิเตอร์

สามารถใช้ตัวแปรในพารามิเตอร์ของแบบฟอร์มหรือองค์ประกอบอื่นๆ ได้:

• อีเมลผู้ใช้

• 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}

6. ในบล็อกข้อมูลบทเรียน

ตัวแปรและบล็อกเงื่อนไขทำงานภายในข้อความกล่องข้อมูล ตัวอย่างเช่น:

• การเรียกชื่อ: สวัสดี {user.first_name}!

• แสดงชื่อคอร์ส วันที่ สถานะ เป็นต้น

• ข้อมูลติดต่อ: {contact.name}, {contact.email} และฟิลด์อื่นๆ

• ข้อมูลบทเรียนปัจจุบัน: {lesson.title}, {lesson.slug} และฟิลด์บทเรียนอื่นๆ

• บล็อกเงื่อนไข @if/@endif: แสดงเนื้อหาที่แตกต่างกันตามว่าผู้ติดต่อมีแท็ก สิทธิ์เข้าถึงข้อเสนอ เป็นต้น

7. ในอีเมล

การใช้ตัวแปรในอีเมลช่วยให้การสื่อสารมีความเฉพาะบุคคลและมีประสิทธิภาพมากขึ้น ด้วยตัวแปร เช่น {name}, {date} หรือ {course_name} อีเมลจะดูเหมือนส่งถึงลูกค้าโดยเฉพาะ ซึ่งช่วยเพิ่มความน่าเชื่อถือ การมีส่วนร่วม และโอกาสที่ผู้ใช้จะอ่านอีเมลจนจบหรือดำเนินการตามที่ต้องการ นอกจากนี้ ตัวแปรยังช่วยให้การส่งอีเมลจำนวนมากแบบอัตโนมัติทำได้ง่ายขึ้นโดยไม่สูญเสียความเป็นเฉพาะบุคคล

8. ในการแจ้งเตือน

เมื่อตั้งค่าการแจ้งเตือนในการดำเนินการอัตโนมัติ ตัวแปรช่วยให้คุณแทรกข้อมูลลงในการแจ้งเตือนได้แบบไดนามิก เช่น ชื่อผู้ใช้ หมายเลขคำสั่งซื้อ หรือชื่อข้อเสนอ ซึ่งช่วยให้กระบวนการสร้างการแจ้งเตือนง่ายและรวดเร็วยิ่งขึ้น ทำให้เข้าใจง่ายและปรับใช้กับสถานการณ์ต่างๆ ได้

รายการตัวแปรที่ใช้ได้

ตัวแปรที่ใช้ได้ทุกที่ที่สามารถใช้ตัวแปรได้

ตัวแปร	ค่า
contact.id	ID ผู้ติดต่อ
contact.user_id	ID ผู้ใช้
contact.first_name	ชื่อผู้ติดต่อ
contact.last_name	นามสกุลผู้ติดต่อ
contact.middle_name	ชื่อกลางของผู้ติดต่อ
contact.name	ชื่อเต็มของผู้ติดต่อ
contact.email	อีเมลผู้ติดต่อ
contact.phone	โทรศัพท์ติดต่อ
contact.country	ประเทศของผู้ติดต่อ ตัวอย่าง: Ukraine
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	แหล่งที่มาของการเข้าชม
ตัวแปรเหล่านี้พร้อมใช้งานในลิงก์เปลี่ยนเส้นทางเมื่อชำระเงินสำหรับข้อเสนอสำเร็จ

วิธีเปลี่ยนค่าของตัวแปร

คุณสามารถเพิ่มตัวเลือกต่อท้ายตัวแปรเพื่อเปลี่ยนรูปแบบการแสดงผลได้ เช่น เพิ่มข้อความ ทำให้ตัวอักษรเป็นตัวพิมพ์ใหญ่ หรือจัดรูปแบบวันที่

รูปแบบทั่วไป: {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

บล็อกเงื่อนไข @if / @endif

ช่วยให้คุณแสดงหรือซ่อนข้อความบางส่วนตามเงื่อนไข หากเงื่อนไขเป็นจริง บล็อกจะแสดงขึ้น มิฉะนั้นจะถูกลบออกทั้งหมด

ไวยากรณ์: @if(condition)...text...@endif

ตัวอย่าง:
@if({contact.has|offer:123})เข้าถึงเนื้อหา@endif

เงื่อนไข contact.has — การตรวจสอบผู้ติดต่อ

ช่วยให้คุณตรวจสอบว่าผู้ติดต่อเป็นไปตามเงื่อนไขที่กำหนดหรือไม่ ส่งคืนค่า true หรือ false โดยปกติใช้ร่วมกับบล็อกเงื่อนไข @if/@endif

ไวยากรณ์: {contact.has|type:value}

ประเภท	ค่า	คำอธิบาย
offer	ID ข้อเสนอ	ผู้ติดต่อมีสิทธิ์เข้าถึงข้อเสนอ
order	ID คำสั่งซื้อ	ผู้ติดต่อมีคำสั่งซื้อที่มี ID นี้
product	ID ผลิตภัณฑ์	ผู้ติดต่อมีสิทธิ์เข้าถึงผลิตภัณฑ์
tag	ID หรือชื่อแท็ก	ผู้ติดต่อมีแท็ก (รองรับอักษรซีริลลิกและช่องว่างในชื่อ)
list	ID รายการ	ผู้ติดต่ออยู่ในรายการ
course	ID คอร์ส	ผู้ติดต่อได้ลงทะเบียนในคอร์ส
marathon	ID คอร์ส	ชื่อเรียกอื่นของคอร์ส (bootcamp เป็นประเภทย่อยของคอร์ส)
webinar	ID เว็บบินาร์	ผู้ติดต่อมีสิทธิ์เข้าถึงเว็บบินาร์
closed_group	ID กลุ่มปิด	ผู้ติดต่อมีสิทธิ์เข้าถึงกลุ่มปิด

ตัวอย่างการใช้งาน:

{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	อีเมลจากใบสมัคร
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.*}) — หากเลือกตัวเลือกแบบฟอร์ม "ตามข้อเสนอ" + "สิทธิ์เข้าถึงผลิตภัณฑ์"

หากมีการเข้าชมพร้อมแท็ก UTM ในหน้าที่วาง CTA หรือสคริปต์ติดตามการเข้าชมของ Kwiga และลูกค้าส่งคำขอในหน้าแลนดิ้งเพจโดยไม่มีแท็ก UTM แท็กเหล่านั้นจะไม่ปรากฏในตัวแปรเหล่านี้ อย่างไรก็ตาม จะพร้อมใช้งานในตัวแปร {contact.utm_...} ที่อธิบายไว้ข้างต้น

ตัวแปรที่ใช้ได้ใน webhook ของระบบอัตโนมัติ (url, พารามิเตอร์, อีเมล)

รายการตัวแปรที่ใช้ได้

ตัวแปร	ค่า
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	รายการข้อมูลที่ผู้ใช้กรอก (คั่นด้วยการขึ้นบรรทัดใหม่)
สามารถขยายรายการได้

ตัวแปรสินค้า

ตัวแปร	ค่า
product.id	รหัสผลิตภัณฑ์
product.title	ชื่อผลิตภัณฑ์
product.productable_type	ประเภทผลิตภัณฑ์ ตัวเลือกที่เป็นไปได้: course, webinar, closed_group, custom_product
product.productable_id	รหัสของคอร์ส/เว็บบินาร์/กลุ่มปิด/ผลิตภัณฑ์กำหนดเอง

ตัวแปรคำสั่งซื้อ

ตัวแปร	ค่า
order.id	รหัสคำสั่งซื้อ
order.price	ราคาสุทธิ ตัวอย่าง: 10.99
order.currency_code	สกุลเงินของคำสั่งซื้อในรูปแบบรหัส ตัวอย่าง: USD
order.currency_symbol	สกุลเงินของคำสั่งซื้อในรูปแบบสัญลักษณ์ ตัวอย่าง: $
order.currency_short_title	สกุลเงินของคำสั่งซื้อในชื่อย่อ ตัวอย่าง: usd
order.order_stage_id	รหัสสถานะ Funnel
order.order_stage_title	ชื่อสถานะ Funnel
order.funnel_id	รหัส Funnel
order.funnel_title	ชื่อ Funnel
order.paid_status	สถานะการชำระเงินของคำสั่งซื้อ not_paid / partial_paid / paid
order.paid_status_title	สถานะการชำระเงินเป็นภาษาอังกฤษ
order.utm_source	utm_source ของคำสั่งซื้อ
order.utm_medium	utm_medium ของคำสั่งซื้อ
order.utm_campaign	utm_campaign ของคำสั่งซื้อ
order.utm_term	utm_term ของคำสั่งซื้อ
order.utm_content	utm_content ของคำสั่งซื้อ
order.next_scheduled_payment_at	วันที่ชำระเงินตามกำหนดครั้งถัดไป (สำหรับการสมัครสมาชิกและแผนผ่อนชำระ) รูปแบบ YYYY-MM-DD HH:mm:ss
ตัวแปรเหล่านี้พร้อมใช้งานในลิงก์เปลี่ยนเส้นทางเมื่อชำระเงินสำหรับข้อเสนอสำเร็จ
สามารถขยายรายการได้

ตัวแปรการชำระเงิน

ตัวแปร	ค่า
payment.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	รหัสข้อเสนอ
offer.title	ชื่อข้อเสนอ
สามารถขยายรายการได้

ตัวแปรการสมัครสมาชิกสินค้า

ตัวแปร	ค่า
subscription.id	รหัสการสมัครสมาชิกผลิตภัณฑ์
subscription.order_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	รหัสการทำแบบทดสอบ
quiz_attempt.number_version	หมายเลขเวอร์ชันของการเสร็จสิ้น
quiz_attempt.quiz_id	รหัสแบบทดสอบ
quiz_attempt.course_id	รหัสคอร์ส
quiz_attempt.course_lesson_id	รหัสบทเรียน
quiz_attempt.status_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	รหัสบทเรียน
lesson.title	ชื่อบทเรียน
lesson.slug	ส่วน URL ของบทเรียน
สามารถขยายรายการได้

ตัวแปรใบรับรอง

ตัวแปร	ค่า
certificate_template.title	ชื่อเทมเพลตใบรับรองที่ใช้ในการออกใบรับรอง (ตามที่แสดงในรายการเทมเพลต)
certificate_template.public_title	ชื่อเทมเพลตที่นักเรียนเห็น (ช่อง "ชื่อจากฝั่งนักเรียน")
certificate.number	หมายเลขใบรับรองที่ออก
certificate.issued_at	วันที่ออกใบรับรองในรูปแบบ YYYY-MM-DD HH:mm:ss
certificate.uuid	UUID ของใบรับรอง ซึ่งใช้ในลิงก์ใบรับรองสาธารณะ