ข้ามไปยังเนื้อหา
เอกสารสำหรับนักพัฒนา คู่มือวิธีการ การสนับสนุน ขอสาธิต เข้าสู่ระบบ
Pushwoosh.com

Issue Wallet Pass

ใช้องค์ประกอบ Issue Wallet Pass เพื่อมอบ pass สำหรับ Apple Wallet หรือ Google Wallet ให้ผู้ใช้ เช่น บัตรสะสมแต้ม ตั๋ว หรือคูปอง องค์ประกอบนี้จะสร้าง pass ส่วนตัวสำหรับผู้ใช้แต่ละคนจาก Wallet Pass Campaign

กรณีการใช้งาน

Anchor link to
  • บัตรขึ้นเครื่องหลังเช็คอิน: เมื่อผู้ใช้เช็คอิน ให้ออกบัตรขึ้นเครื่องพร้อมที่นั่งและประตูขึ้นเครื่อง และส่งด้วย push ก่อนออกเดินทาง
  • บัตรสะสมแต้มเมื่อสมัคร: เมื่อมีคนเข้าร่วมโปรแกรมสะสมแต้มของคุณ ให้ออกบัตรพร้อมยอดคะแนนเริ่มต้นและเพิ่มลงในอีเมลต้อนรับ ดู วิธีออก wallet pass เมื่อสมัคร สำหรับคำแนะนำแบบเต็ม
  • ตั๋วอีเวนต์หลังการซื้อ: หลังจากการซื้อ ให้ออกตั๋วพร้อมที่นั่งและแถว และรวมไว้ในการยืนยันคำสั่งซื้อ
  • Pass เมื่อเข้าสู่ geozone ของร้านค้า: เมื่อผู้ซื้อเข้าสู่ geozone ของร้านค้า ให้ออก pass และส่งลิงก์ pass ทันทีด้วย push ดู วิธีออก wallet pass เมื่อเข้าสู่ geozone สำหรับคำแนะนำแบบเต็ม

ข้อกำหนดเบื้องต้น

Anchor link to

ก่อนเพิ่มองค์ประกอบนี้:

เพิ่มองค์ประกอบ

Anchor link to

คุณจะพบ Issue Wallet Pass ภายใต้ Channels ใน journey builder หากต้องการออกแบบ pass เอง ดู Wallet Pass Campaigns

  1. ลาก Issue Wallet Pass ไปยังผืนผ้าใบที่จุดที่ผู้ใช้ควรได้รับ pass
  2. ดับเบิลคลิกที่องค์ประกอบเพื่อเปิดการตั้งค่า
  3. ป้อนชื่อที่จดจำได้ใน Step Name เช่น Loyalty card คุณจะใช้ชื่อนี้ในภายหลังเมื่อคุณแทรกลิงก์ pass ลงในองค์ประกอบ Send Push หรือ Send Email
  4. ใน Apple Wallet campaign และ Google Wallet campaign ให้เลือกแคมเปญสำหรับแพลตฟอร์มใดแพลตฟอร์มหนึ่งหรือทั้งสอง เว้นดรอปดาวน์ไว้ว่างเพื่อข้ามแพลตฟอร์มนั้น

Apple Wallet campaign ตั้งค่าเป็น Coffee discount และ Google Wallet campaign ปล่อยว่าง

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

กรอกฟิลด์ส่วนบุคคล

Anchor link to

ฟิลด์ส่วนบุคคลคือส่วนต่างๆ ของ pass ที่อาจแตกต่างกันไปในแต่ละผู้ใช้ ที่นี่คุณเลือกว่าแต่ละฟิลด์จะได้ค่าจากที่ใด

ภายใต้ Personal fields on the pass คุณจะเห็นฟิลด์ที่ต้องการค่าสำหรับแคมเปญที่คุณเลือก นี่คือฟิลด์เดียวกับที่คุณกรอกในกล่องโต้ตอบ Issue pass ของแคมเปญ หากคุณเลือกแคมเปญอื่น รายการจะเปลี่ยนให้ตรงกัน

ฟิลด์ที่กรอกโดยอัตโนมัติจะไม่แสดงในรายการ:

  • Tag placeholder: ฟิลด์เช่น {Seat} จะถูกกรอกจากแท็กของผู้ใช้ที่มีชื่อเดียวกัน
  • Shared fields: ค่าเดียวกันในทุก pass ตั้งค่าเพียงครั้งเดียวในแคมเปญเอง

สำหรับแต่ละฟิลด์ ให้เลือกว่าค่าของฟิลด์มาจากที่ใด:

  • Static value: ค่าเดียวกันในทุก pass ที่องค์ประกอบนี้ออก ตัวอย่างเช่น SUMMER2026 ในฟิลด์ OFFER

Personal fields on the pass โดย OFFER ตั้งค่าเป็น Static value และ VALUE พิมพ์เป็น SUMMER2026

  • Event from the journey: ค่าจากอีเวนต์ก่อนหน้าใน journey เพื่อให้ผู้ใช้แต่ละคนได้รับค่าของตนเอง เลือกอีเวนต์ จากนั้นเลือก Attribute เช่น offer_code จากอีเวนต์การเข้า

Personal fields on the pass โดย OFFER ตั้งค่าเป็นอีเวนต์ Trigger entry และ Attribute ตั้งค่าเป็น offer_code

เมื่อเลือกแคมเปญสำหรับทั้งสองแพลตฟอร์ม รายการจะแสดงฟิลด์จากทั้งคู่ ฟิลด์ที่มีอยู่ในแคมเปญเดียวเท่านั้นจะถูกกรอกเฉพาะใน pass ของแพลตฟอร์มนั้น

เมื่อเสร็จแล้ว คลิก Apply เพื่อบันทึกการตั้งค่าองค์ประกอบ

สิ่งที่เกิดขึ้นในขั้นตอนนี้

Anchor link to
สถานการณ์สิ่งที่เกิดขึ้น
Pass ถูกออกแล้วผู้ใช้ไปยังองค์ประกอบถัดไป
ผู้ใช้มี pass จากแคมเปญนี้อยู่แล้ว เช่น หลังจาก loop ใน journeyองค์ประกอบจะนำ pass นั้นกลับมาใช้แทนการสร้างใหม่ และผู้ใช้ดำเนินต่อไป ผู้ใช้แต่ละคนมี pass ได้สูงสุดหนึ่งใบต่อแคมเปญ
ผู้ใช้ไม่มี User IDผู้ใช้หลุดออกจาก journey โดยค่าเริ่มต้น SDK ใช้ HWID ของอุปกรณ์เป็น User ID ดังนั้นสิ่งนี้ส่วนใหญ่จะเกิดขึ้นเมื่อผู้ใช้เข้ามาผ่าน API หรือด้วยอีเวนต์ที่ไม่มี User ID
ไม่สามารถออก pass ได้ เช่น เพราะแคมเปญถูกลบหรือเก็บถาวรหลังจากที่คุณเพิ่มองค์ประกอบผู้ใช้หลุดออกจาก journey

ผู้ใช้ที่หลุดออกจะไม่ถูกลองใหม่โดยอัตโนมัติ หากกำหนดค่าทั้งสองแพลตฟอร์ม จะลอง Apple ก่อน หาก Apple ล้มเหลว ผู้ใช้จะหลุดออกก่อนที่จะลอง Google หาก Apple สำเร็จแต่ Google ล้มเหลว ผู้ใช้ก็ยังคงหลุดออก และ pass ของ Apple ยังคงถูกออกอยู่

ส่งลิงก์ pass

Anchor link to

หลังจาก Issue Wallet Pass ให้เพิ่ม push หรือ email พร้อมลิงก์ที่ผู้ใช้แตะเพื่อเพิ่ม pass ลงในกระเป๋าเงินของตน ลิงก์นี้ใช้ได้เฉพาะสำหรับแพลตฟอร์มที่คุณเลือกในองค์ประกอบเท่านั้น ใช้ apple_install_link สำหรับ Apple Wallet และ google_save_link สำหรับ Google Wallet

  1. เพิ่มองค์ประกอบ Send Push หรือ Send Email หลังจาก Issue Wallet Pass

  2. ในข้อความ ให้พิมพ์ placeholder ด้วยแถบแนวตั้ง เช่น {apple_install_link|regular|} อย่าใช้ {apple_install_link} ธรรมดา regular เป็นตัวปรับรูปแบบที่จำเป็นซึ่งแทรกค่าโดยไม่ปรับเปลี่ยน ดังนั้นให้คงไว้ตามเดิม ดู Dynamic Content หรือ Liquid Templates สำหรับไวยากรณ์แบบเต็ม ใน Send Email คุณสามารถใช้ placeholder ในบรรทัดหัวเรื่องได้ด้วย ไม่ใช่แค่ในเนื้อหาข้อความ

  3. เปิด Personalise message with event attributes

  4. ในตาราง ให้ทำเครื่องหมาย Overwrite placeholder ข้างๆ placeholder ของคุณ การทำเช่นนี้จะปลดล็อกดรอปดาวน์ Source event และ Dynamic attribute

  5. ใน Source event ให้เลือกขั้นตอน Issue Wallet Pass ของคุณตาม Step Name ที่คุณตั้งไว้ เช่น Loyalty card

  6. ใน Dynamic attribute ให้เลือก apple_install_link หรือ google_save_link ให้ตรงกับ placeholder ที่คุณใช้

ตาราง Personalise message with event attributes จับคู่ apple_install_link กับขั้นตอน Loyalty card

ติดตามผลลัพธ์

Anchor link to

แผงขององค์ประกอบแสดงการเข้าและการหลุดออก รวมถึงเหตุผลที่ผู้ใช้หลุดออก: No User ID หรือ Pass issuance failed ผู้ใช้ที่ผ่านองค์ประกอบโดยไม่หลุดออกจะมี pass ที่ถูกออกหรือนำกลับมาใช้ใหม่ หากต้องการตรวจสอบว่าลิงก์ไปถึงผู้ใช้แล้วหรือไม่ ให้ดูสถิติขององค์ประกอบ Send Push หรือ Send Email ถัดไป

หมายเลขซีเรียล

Anchor link to

Pass ที่ออกแต่ละใบมีหมายเลขซีเรียล: apple_serial_number หรือ google_serial_number ใช้เพื่อ: