ออก Wallet Pass

องค์ประกอบ Issue Wallet Pass จะสร้างพาส Apple Wallet หรือ Google Wallet สำหรับนักเดินทางจาก Wallet Pass Campaign หลังจากที่ทำงานแล้ว คุณสามารถแทรกลิงก์ติดตั้งหรือบันทึกไว้ในข้อความในภายหลังใน journey เดียวกันได้

หมายเหตุ

องค์ประกอบนี้จะออกพาสเท่านั้น ไม่ได้ส่งมอบให้กับผู้ใช้ เพิ่มองค์ประกอบ Send Push หรือ Send Email หลังจากนั้นเพื่อส่งลิงก์ติดตั้ง ดูที่ ส่งมอบพาสให้กับนักเดินทาง ด้านล่าง

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

บัตรขึ้นเครื่องหลังการเช็คอิน

ออกบัตรขึ้นเครื่อง Apple หรือ Google Wallet เมื่อนักเดินทางเช็คอิน ปรับแต่งที่นั่งและประตูขึ้นเครื่องจาก event การเช็คอิน จากนั้นส่งลิงก์ติดตั้งผ่าน push ก่อนออกเดินทาง

• ทริกเกอร์: CheckInCompleted
• ฟิลด์ส่วนตัว: แมป Seat และ Gate กับแอตทริบิวต์ event ที่ตรงกัน
• การส่งมอบ: Send Push ด้วย apple_install_link หรือ google_save_link

บัตรสะสมคะแนนเมื่อสมัครสมาชิก

ออกบัตรสะสมคะแนนในครั้งแรกที่นักเดินทางเข้าร่วมโปรแกรมรางวัล ปรับแต่งด้วยยอดคะแนนเริ่มต้นของพวกเขา

• ทริกเกอร์: LoyaltySignup
• ฟิลด์ส่วนตัว: แมป Points กับแอตทริบิวต์ points ของ event
• การส่งมอบ: Send Email ทันทีหลังจากนั้น พร้อมลิงก์บันทึกในข้อความต้อนรับ

ตั๋วเข้างานหลังการซื้อ

ออกตั๋วเมื่อนักเดินทางทำการซื้อตั๋วเสร็จสิ้น ปรับแต่งที่นั่งหรือแถวจากคำสั่งซื้อ

• ทริกเกอร์: TicketPurchased
• ฟิลด์ส่วนตัว: แมป Seat และ Row กับแอตทริบิวต์ของคำสั่งซื้อ
• การส่งมอบ: อีเมลยืนยันพร้อม apple_install_link เพื่อให้นักเดินทางสามารถเพิ่มตั๋วได้ด้วยการแตะเพียงครั้งเดียว

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

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

• Wallet Pass Campaign: สร้างอย่างน้อยหนึ่ง Wallet Pass Campaign สำหรับแอปพลิเคชัน Issue Wallet Pass สามารถออกพาสจากแคมเปญที่มีอยู่แล้วเท่านั้น ไม่สามารถออกแบบใหม่ได้
• Apple Wallet: เชื่อมต่อ แพลตฟอร์ม iOS และทำการ ตั้งค่าพาส Apple Wallet สำหรับแอปพลิเคชันให้เสร็จสิ้น ดูเพิ่มเติมที่ เริ่มต้นใช้งานพาส Apple Wallet
• Google Wallet: กำหนดค่า Google Wallet สำหรับ Android สำหรับแอปพลิเคชัน ดูเพิ่มเติมที่ เริ่มต้นใช้งานพาส Google Wallet

ข้อกำหนดเบื้องต้นทั้งหมดของแคมเปญสำหรับทั้งสองแพลตฟอร์ม: ข้อกำหนดเบื้องต้นของ Wallet Pass Campaigns

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

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

เคล็ดลับ

การเลือกทั้งสองแพลตฟอร์มช่วยให้ขั้นตอน journey เดียวกันครอบคลุมนักเดินทางทั้ง iPhone และ Android ในคราวเดียว แต่ละแพลตฟอร์มจะออก (หรือใช้ซ้ำ ดู การเข้าซ้ำและเงื่อนไขการดรอป ด้านล่าง) พาสของตนเองอย่างอิสระสำหรับนักเดินทางคนเดียวกัน

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

หมายเหตุ

แคมเปญ Draft ยังคงแสดงอยู่ในรายการและออกพาสได้เหมือนกับแคมเปญ Active ดังนั้นการเปลี่ยนแคมเปญออกจากสถานะ Draft จึงไม่ใช่ข้อกำหนดเบื้องต้นที่นี่

กรอกฟิลด์ส่วนตัว

ภายใต้ Personal fields on the pass ให้ตั้งค่าสำหรับแต่ละฟิลด์ที่ปรากฏขึ้น

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

สำหรับแต่ละฟิลด์ ให้เปิดดรอปดาวน์ค่าและเลือกหนึ่งในตัวเลือกต่อไปนี้:

• Static value: พิมพ์ค่าเดียวสำหรับนักเดินทางทุกคนที่มาถึงองค์ประกอบนี้ ตัวอย่างเช่น พิมพ์ SUMMER2026 ลงในฟิลด์ OFFER เพื่อให้พาสทุกใบที่องค์ประกอบนี้ออกมีรหัสโปรโมชั่นเดียวกัน

• event จากช่วงก่อนหน้าในเส้นทางของนักเดินทางผ่าน journey จากนั้นเลือก Attribute เพื่อดึงค่าของฟิลด์ ตัวอย่างเช่น เลือก event การเข้าและแอตทริบิวต์ offer_code เพื่อกรอกฟิลด์ OFFER ด้วยค่าของนักเดินทางแต่ละคนแทนที่จะเป็นค่าเดียวสำหรับทุกคน Pushwoosh จะอ่านแอตทริบิวต์นั้นจากข้อมูล event ของนักเดินทางเองเมื่อองค์ประกอบนี้ทำงาน ดังนั้นพาสของนักเดินทางแต่ละคนจะได้รับค่าของตนเอง

หมายเหตุ

ฟิลด์สองประเภทไม่แสดงอยู่ที่นี่ เนื่องจากไม่ต้องการข้อมูลจากคุณ:

• ฟิลด์ที่เขียนเป็นเพียง {Seat} จะเติมข้อมูลเองสำหรับนักเดินทางแต่ละคนโดยอัตโนมัติ
• ฟิลด์ Shared ของแคมเปญจะมีค่าเดียวกันในทุกพาส คุณตั้งค่าดังกล่าวเพียงครั้งเดียวในตัวแคมเปญเอง

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

หมายเหตุ

หาก event ต้นทางไม่เคยเกิดขึ้นสำหรับนักเดินทาง หรือแอตทริบิวต์ว่างเปล่า พาสจะใช้ค่าของแคมเปญเองสำหรับฟิลด์นั้นแทน ซึ่งตั้งค่าไว้ใน Set shared and personal fields นักเดินทางจะไม่ถูกดรอป

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

การเข้าซ้ำและเงื่อนไขการดรอป

หากนักเดินทางคนเดียวกันมาถึงองค์ประกอบนี้อีกครั้ง เช่น หลังจากวนกลับมาใน journey, Pushwoosh จะส่งคืนพาสที่ออกให้แล้วแทนที่จะสร้างใหม่ นักเดินทางแต่ละคนจะมีพาสได้ไม่เกินหนึ่งใบต่อแคมเปญ

Issue Wallet Pass จะดรอปนักเดินทางโดยไม่มีการลองซ้ำอัตโนมัติในสองกรณี:

• นักเดินทางไม่มี User ID เลย แม้แต่ HWID ของอุปกรณ์เริ่มต้นที่เซสชัน SDK ปกติจะตั้งค่าโดยอัตโนมัติ สิ่งนี้เกิดขึ้นเมื่อนักเดินทางเข้าสู่ journey โดยไม่มี User ID เช่น ผ่านการเข้าแบบ API-based หรือ payload ของ event ที่ไม่มีฟิลด์ User ID
• การออกพาสล้มเหลวสำหรับแคมเปญที่กำหนดค่าไว้ เช่น เนื่องจากถูกลบหรือเก็บถาวรหลังจากที่คุณเพิ่มองค์ประกอบ เมื่อกำหนดค่าทั้งสองแพลตฟอร์ม ระบบจะพยายามกับ Apple ก่อน หากล้มเหลว นักเดินทางจะถูกดรอปก่อนที่จะพยายามกับ Google เลย ดังนั้นผลลัพธ์บางส่วนจะไม่เกิดขึ้น

ดู No User ID และ Pass issuance failed เพื่อตรวจสอบ

ส่งมอบพาสให้กับนักเดินทาง

เมื่อคุณปรับแต่ง push หรืออีเมลในภายหลัง คุณสามารถดึงค่าจากขั้นตอน Issue Wallet Pass นี้ได้โดยใช้ Step Name ที่คุณตั้งไว้ นี่คือแอตทริบิวต์ที่คุณสามารถแทรกได้:

แอตทริบิวต์	แพลตฟอร์ม	ประกอบด้วย
apple_install_link	Apple Wallet	URL สำหรับติดตั้งพาส
google_save_link	Google Wallet	URL สำหรับบันทึกพาส

เฉพาะแอตทริบิวต์สำหรับแพลตฟอร์มที่คุณกำหนดค่าบนองค์ประกอบเท่านั้นที่จะพร้อมใช้งาน

ข้อควรระวัง

องค์ประกอบจะออกพาสสำหรับแพลตฟอร์มที่คุณกำหนดค่าไว้เท่านั้น ไม่ได้ขึ้นอยู่กับอุปกรณ์จริงของนักเดินทาง นักเดินทางที่ใช้แพลตฟอร์มอื่นจะยังคงไปยังผลลัพธ์เริ่มต้น แต่จะมีลิงก์ที่พวกเขาไม่สามารถใช้ได้ กำหนดค่าทั้ง Apple Wallet และ Google Wallet หากกลุ่มเป้าหมายของคุณใช้ทั้งสองแพลตฟอร์ม

1. เพิ่มองค์ประกอบ Send Push หรือ Send Email หลังจาก Issue Wallet Pass
2. ในเนื้อหาข้อความ ให้พิมพ์เพลสโฮลเดอร์ลิงก์ติดตั้งพร้อมเครื่องหมายขีดแนวตั้ง เช่น {apple_install_link|regular|} อย่าใช้ {apple_install_link} แบบธรรมดา ดู Dynamic Content or Liquid Templates สำหรับไวยากรณ์ทั้งหมด
3. เปิด Personalise message with event attributes
4. ในตาราง ให้เลือกช่อง Overwrite placeholder ถัดจากเพลสโฮลเดอร์ของคุณ ดรอปดาวน์ Source event และ Dynamic attribute จะยังคงปิดใช้งานอยู่จนกว่าคุณจะทำเช่นนั้น
5. ใน Source event ให้เลือกขั้นตอน Issue Wallet Pass ของคุณโดยใช้ Step Name ที่คุณตั้งไว้ เช่น Loyalty card
6. ใน Dynamic attribute ให้เลือก apple_install_link หรือ google_save_link ให้ตรงกับเพลสโฮลเดอร์ที่คุณใช้

หมายเหตุ

สำหรับ Send Push ให้เลือกพรีเซ็ตอีกครั้งหลังจากที่คุณแก้ไขข้อความเพื่อให้การแมปตรวจพบเพลสโฮลเดอร์ใหม่ สำหรับ Send Email เพลสโฮลเดอร์ที่มีเครื่องหมายขีดแนวตั้งจะทำงานในหัวเรื่องด้วย ไม่ใช่แค่ในเนื้อหาข้อความ

พาสที่ออกแต่ละใบยังมีหมายเลขซีเรียล (apple_serial_number หรือ google_serial_number ในบริบทของจุด) ส่งต่อไปยังระบบของคุณเองด้วยองค์ประกอบ Data to app หรือ Webhook เช่น เพื่อบันทึกใน CRM หรือเครื่องมือสนับสนุน หากต้องการค้นหาพาสที่ตรงกันใน Pushwoosh ด้วยหมายเลขซีเรียล ให้ใช้แท็บ Passes ของ Wallet Pass Campaign หรือ AttachPasses API เมื่อคุณต้องการ แนบพาสเดี่ยวเข้ากับแคมเปญ

ข้อควรระวัง

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

สถานการณ์ตัวอย่าง: ข้อเสนอสะสมคะแนนร้านกาแฟ

ร้านกาแฟต้องการต้อนรับสมาชิกใหม่ทุกคนด้วยพาสส่วนลดที่พวกเขาสามารถเพิ่มลงใน wallet ของโทรศัพท์ได้

1. สร้าง event CoffeeClubJoined และตรวจสอบให้แน่ใจว่ามีแอตทริบิวต์สำหรับข้อเสนอต้อนรับ เช่น offer_code เรียนรู้เพิ่มเติมเกี่ยวกับการสร้าง events
2. ตั้งค่า event นี้เป็นทริกเกอร์สำหรับ journey เพื่อให้สมาชิกใหม่ทุกคนเข้าสู่ journey ทันทีที่เข้าร่วม

3. เพิ่ม Issue Wallet Pass หลังจากทริกเกอร์
4. ตั้งชื่อว่า Loyalty card
5. เลือกแคมเปญสะสมคะแนน เช่น Coffee discount สำหรับ Apple Wallet campaign (และ Google Wallet campaign ด้วย หากคุณรองรับ Android)
6. ภายใต้ Personal fields on the pass ให้ตั้งค่า OFFER เป็น event การเข้าทริกเกอร์
7. เลือก offer_code เป็น Attribute

8. เพิ่มองค์ประกอบ Send Email ทันทีหลังจาก Issue Wallet Pass
9. ปรับแต่งด้วย apple_install_link (หรือ google_save_link) เพื่อให้อีเมลต้อนรับมีลิงก์แตะครั้งเดียวเพื่อเพิ่มพาส

เมื่อ CoffeeClubJoined ทำงาน นักเดินทางจะเข้าสู่ journey, Issue Wallet Pass จะออกพาสของพวกเขาด้วย offer_code ของ event นั้น และ Send Email จะส่งข้อความต้อนรับพร้อมลิงก์เพื่อเพิ่มพาส