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

สร้างแคมเปญ Wallet Pass

แคมเปญ Wallet Pass ช่วยให้คุณสามารถออกแบบเทมเพลตพาส Apple Wallet หรือ Google Wallet เพียงเทมเพลตเดียว ออกพาสให้กับผู้ใช้หลายคน และจัดการการอัปเดตจากส่วนกลาง

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

สิ่งที่คุณสามารถทำได้ด้วยแคมเปญ Wallet Pass

Anchor link to
  • ออกแบบพาสเดียวในแคมเปญ แทนที่จะต้องตั้งค่าพาสแต่ละใบด้วยตนเองในตัวสร้างพาสของ Apple Wallet หรือ Google Wallet
  • เลือกว่าฟิลด์ใดจะอัปเดตทุกที่ (shared) และฟิลด์ใดจะคงอยู่ตามพาสแต่ละใบ (personal)
  • ดูว่าการแก้ไขฟิลด์จะส่งผลกระทบต่อพาสที่ออกไปแล้วกี่ใบก่อนที่คุณจะบันทึก
  • แทนที่ฟิลด์ที่แชร์ในพาสใบเดียว แล้วคืนการควบคุมกลับไปยังแคมเปญในภายหลัง
  • แนบพาสที่ออกนอกแคมเปญเพื่อให้เริ่มติดตามฟิลด์ที่แชร์ของแคมเปญนั้น
  • ติดตามการแก้ไขแคมเปญและสถานะการจัดส่งของการอัปเดตแต่ละครั้ง

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

Anchor link to

แคมเปญใช้การตั้งค่าครั้งเดียวเช่นเดียวกับพาสแบบสแตนด์อโลน:

Apple Wallet:

Google Wallet:

สร้างแคมเปญ

Anchor link to

ในการเริ่มสร้างแคมเปญ ให้ไปที่ Campaigns → Wallet Passes → Campaigns และคลิก Create campaign

รายการแคมเปญที่ว่างเปล่าใน Wallet Passes โดยมีปุ่ม Create campaign ถูกไฮไลต์

ตั้งค่ารายละเอียดแคมเปญและแพลตฟอร์ม

Anchor link to
  • Platform: เลือก Apple Wallet หรือ Google Wallet ที่ด้านบนของหน้า การเลือกนี้จะเป็นการถาวรสำหรับแคมเปญ
  • Campaign: ป้อน Name และ Description (ไม่บังคับ) สำหรับการอ้างอิงภายในของคุณ ทั้งสองอย่างนี้จะไม่ปรากฏบนพาส
  • Pass format: ภายใต้ Pass Style (Apple) หรือ Pass Type (Google) ให้เลือกเลย์เอาต์สำหรับพาสของคุณ:
    • Apple Wallet: Boarding Pass, Coupon, Event Ticket, Store Card, Generic ดู Choose a pass style
    • Google Wallet: Generic, Offer, Loyalty card, Event ticket, Gift card, Flight, Transit ไม่สามารถเปลี่ยนแปลงได้หลังจากการสร้าง ดู Choose a pass type
ฟอร์มสร้างแคมเปญใหม่ที่แสดงฟิลด์ Name และ Description และตัวเลือก Pass Style

กำหนดค่าการออกแบบพาสและการสร้างแบรนด์

Anchor link to

กำหนดค่าส่วนมาตรฐานของพาส:

ตั้งค่าฟิลด์ที่แชร์และฟิลด์ส่วนตัว

Anchor link to

ในส่วน Shared and personal fields ให้กำหนดค่าว่าฟิลด์ใดจะอัปเดตทั่วโลกในทุกพาส และฟิลด์ใดจะเก็บค่าที่ไม่ซ้ำกันสำหรับผู้ใช้แต่ละคน สิ่งนี้จะควบคุมสิ่งที่จะเกิดขึ้นเมื่อคุณแก้ไขแคมเปญในภายหลัง: ฟิลด์ที่แชร์จะอัปเดตในทุกพาสที่ออกไปแล้ว ในขณะที่ฟิลด์ส่วนตัวจะยังคงไม่เปลี่ยนแปลง

เปิดสวิตช์ Personal สำหรับฟิลด์ใดๆ ที่ควรเก็บค่าที่ไม่ซ้ำกันสำหรับผู้ใช้แต่ละคน

ส่วนการกำหนดค่าฟิลด์ที่แชร์และฟิลด์ส่วนตัวพร้อมสวิตช์ Personal ข้างแต่ละฟิลด์
ประเภทฟิลด์
พฤติกรรม
ตัวอย่าง
Sharedขับเคลื่อนโดยแคมเปญ การอัปเดตฟิลด์นี้จะซิงค์ค่าใหม่ไปยังทุกพาสบนอุปกรณ์ของผู้ใช้วันที่จัดงาน, หมายเลขประตู, ที่อยู่ร้านค้า, เปอร์เซ็นต์ส่วนลด
Personalไม่ซ้ำกันสำหรับผู้ใช้แต่ละคน แคมเปญจะไม่เขียนทับค่าเหล่านี้เมื่อมีการอัปเดตชื่อผู้ใช้, หมายเลขที่นั่ง, รหัสสมาชิก, ยอดคะแนนสะสม

ค่าของฟิลด์ส่วนตัวสามารถรวมตัวยึดตำแหน่งแท็ก {tag} หรือ {tag|format|fallback} (ตัวอย่างเช่น {Seat}) ได้ Pushwoosh จะเติมค่าจาก แท็ก ของผู้รับเมื่อให้บริการพาส หากผู้รับไม่มีค่าสำหรับแท็กนั้น Pushwoosh จะใช้ค่าสำรองจากตัวยึดตำแหน่ง หรือปล่อยให้ฟิลด์ว่างไว้เมื่อตัวยึดตำแหน่งไม่มีค่าสำรอง

  • แค่แท็กอย่างเดียว ไม่มีอย่างอื่น เช่น {Seat}: ฟิลด์จะไม่ปรากฏในกล่องโต้ตอบ Issue pass
  • แท็กผสมกับข้อความอื่น เช่น Seat {Seat} หรือไม่มีแท็กเลย: ฟิลด์จะปรากฏเป็นอินพุตที่แก้ไขได้ในกล่องโต้ตอบ Issue pass โดยมีค่าเริ่มต้นนั้นๆ แท็กใดๆ ที่อยู่ภายในจะยังคงถูกแทนที่ตามผู้รับแต่ละคนเมื่อ Pushwoosh ให้บริการพาส

อัปโหลดรูปภาพแคมเปญ

Anchor link to
  1. ในส่วน Campaign images คลิก Choose an image ข้างช่องรูปภาพ
  2. เลือกรูปภาพที่มีอยู่จาก Media Store ของคุณ หรือลากและวางไฟล์ใหม่เพื่ออัปโหลด
  3. ทำซ้ำสำหรับช่องรูปภาพที่มีอยู่ทั้งหมด:
    • Apple Wallet: Icon, Logo, Background, Footer, Strip, และ Thumbnail (ดู Apple Wallet images)
    • Google Wallet: Logo และ Hero image
ส่วนรูปภาพแคมเปญพร้อมช่องอัปโหลดสำหรับไอคอน โลโก้ และภาพพาสที่กำหนดเอง

ดูตัวอย่างและสร้างแคมเปญ

Anchor link to
  1. ตรวจสอบแผง Preview as user ทางด้านขวาเพื่อดูว่าการ์ดมีลักษณะอย่างไร คุณสามารถป้อน User ID ทดสอบเพื่อดูตัวอย่างฟิลด์ส่วนตัวได้
แผงแสดงตัวอย่างพาสสดพร้อมฟิลด์ Preview as user และการ์ดพาสดิจิทัลที่แสดงผล
  1. คลิก Create campaign ที่ด้านล่างของหน้า

Pushwoosh จะสร้างแคมเปญในสถานะ Draft และเปิดพื้นที่ทำงานของแคมเปญ ซึ่งมีแท็บ Design, Passes, และ History

ออกพาสให้กับผู้ใช้

Anchor link to

ออกพาสจากแคมเปญ

Anchor link to
  1. บนแท็บ Passes คลิก Issue pass
  2. ป้อน User ID ของผู้รับใน Pushwoosh
กล่องโต้ตอบ Issue a pass พร้อมฟิลด์ Pushwoosh User ID และปุ่มยืนยัน Issue pass
  1. คลิก Issue pass เพื่อยืนยัน

ขึ้นอยู่กับว่าคุณกำหนดค่า Personal fields อย่างไร กล่องโต้ตอบจะจัดการกับฟิลด์เหล่านั้นดังนี้:

  • Editable fields: ปรากฏพร้อมค่าเริ่มต้นที่คุณสามารถเปลี่ยนแปลงได้สำหรับผู้ใช้รายนี้
  • Tag placeholders (เช่น {Seat}): ไม่ปรากฏในกล่องโต้ตอบ Pushwoosh จะเติมค่าจากแท็กของผู้ใช้โดยอัตโนมัติ

คุณยังสามารถแก้ไขฟิลด์ส่วนตัวใดๆ ในพาสแต่ละใบได้ตลอดเวลาหลังจากการออกพาส

Pushwoosh จะสร้างพาสจากการออกแบบปัจจุบันของแคมเปญและแสดงรายการไว้ใน แท็บ Passes และในตาราง All passes ของแอปพลิเคชัน (Apple Wallet หรือ Google Wallet)

แนบพาสที่มีอยู่กับแคมเปญ

Anchor link to

คุณสามารถแนบพาสแบบสแตนด์อโลน (ที่สร้างนอกแคมเปญใดๆ) กับแคมเปญเพื่อให้เริ่มรับการอัปเดตที่แชร์ได้

  1. บนแท็บ Passes คลิก Attach passes
  2. ค้นหาพาสด้วย User ID, หมายเลขซีเรียล หรือบาร์โค้ด
  3. เลือกพาสและยืนยัน

เมื่อแนบแล้ว:

  • Shared fields จะเริ่มติดตามแคมเปญและอัปเดตทุกครั้งที่คุณเปลี่ยนเทมเพลตพาส
  • Personal values ที่มีอยู่แล้วในพาส (เช่น รายละเอียดผู้ใช้หรือยอดคงเหลือที่ไม่ซ้ำกัน) จะถูกเก็บรักษาไว้

จัดการแคมเปญที่มีอยู่

Anchor link to

การเปิดแคมเปญที่สร้างขึ้นจาก Campaigns → Wallet Passes → Campaigns จะแสดงสถานะ, ตัวนับการแก้ไข, ตัวอย่างพาสสด และแท็บหลักสามแท็บ: Design, Passes, และ History

ส่วนหัวของแคมเปญพร้อมแท็บ Design, Passes และ History, ตัวนับการแก้ไข และเมนู Status ที่ตั้งค่าเป็น Draft

เปลี่ยนสถานะแคมเปญ

Anchor link to

ใช้สถานะเพื่อติดตามว่าแต่ละแคมเปญอยู่ในขั้นตอนใด: ยังอยู่ระหว่างการออกแบบ, กำลังออกพาสอย่างต่อเนื่อง หรือเสร็จสิ้นและถูกเก็บถาวรแล้ว

หากต้องการเปลี่ยนสถานะ ให้เลือกตัวเลือกจากเมนู Status ในส่วนหัวของแคมเปญ การเปลี่ยนแปลงจะถูกบันทึกทันทีโดยไม่มีขั้นตอนการยืนยันแยกต่างหาก:

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

แท็บ Design

Anchor link to

บนแท็บ Design คุณสามารถอัปเดตเทมเพลตพาส, เปลี่ยนสี, แก้ไขฟิลด์ที่แชร์และฟิลด์ส่วนตัว หรืออัปโหลดรูปภาพแคมเปญใหม่

อัปเดตการออกแบบและพุชการเปลี่ยนแปลงไปยังพาส

Anchor link to

เมื่อคุณแก้ไขฟิลด์ที่แชร์หรือเปลี่ยนรูปภาพแคมเปญและคลิก Save changes Pushwoosh จะแสดงกล่องโต้ตอบยืนยันที่แสดงจำนวนพาสที่ออกไปแล้วที่จะได้รับการอัปเดต

  • หากไม่มีพาสใดมีการแทนที่: คลิก Update เพื่อพุชการเปลี่ยนแปลงไปยังทุกพาสที่ออกไปแล้ว
  • หากบางพาสมีการแทนที่: เลือกว่าจะอัปเดตเฉพาะพาสมาตรฐาน (โดยคงการแทนที่ของผู้ใช้ไว้) หรือเขียนทับทุกพาส

การยืนยันการอัปเดตจะเพิ่มตัวนับการแก้ไขของแคมเปญ (ตัวอย่างเช่น เป็น Revision 2) และซิงค์การเปลี่ยนแปลงไปยังอุปกรณ์ของผู้ใช้โดยอัตโนมัติ

แทนที่ฟิลด์ที่แชร์ในพาสแต่ละใบ

Anchor link to

หากคุณต้องการปรับแต่งฟิลด์ที่แชร์สำหรับผู้ใช้รายใดรายหนึ่ง ให้แก้ไขฟิลด์นั้นโดยตรงบนพาสของแต่ละบุคคล (จากแท็บ Passes หรือ All passes):

  • สร้างการแทนที่: การบันทึกค่าที่กำหนดเองบนพาสแต่ละใบจะแยกฟิลด์นั้นออกจากการอัปเดตทั่วทั้งแคมเปญ การอัปเดตแคมเปญในอนาคตจะข้ามพาสนี้สำหรับฟิลด์นั้นๆ
  • ลบการแทนที่: หากต้องการคืนการควบคุมของแคมเปญ ให้แก้ไขพาสและคลิก Use the campaign value ข้างฟิลด์ที่ถูกแทนที่
หน้าจอแก้ไขพาสที่แสดงฟิลด์ From campaign พร้อมปุ่ม Use the campaign value ที่ถูกไฮไลต์

คุณสามารถติดตามว่าพาสใดมีค่าที่กำหนดเองได้บน แท็บ Passes ใต้คอลัมน์ Overrides

แท็บ Passes

Anchor link to

แท็บ Passes จะแสดงรายการพาสทุกใบที่ออกโดยแคมเปญ รวมถึงหมายเลขซีเรียล, User ID ของผู้รับ, การแทนที่ที่ใช้งานอยู่, การแก้ไขปัจจุบัน และวันที่อัปเดตล่าสุด

แท็บ Passes แสดงตารางพาสที่ออกไปแล้วพร้อม User ID, การแทนที่, การแก้ไข และปุ่มการดำเนินการ

ใช้ตัวกรองตารางเพื่อค้นหาพาสที่ต้องการ:

  • With overrides: แสดงพาสที่มีฟิลด์ที่แก้ไขเองอย่างน้อยหนึ่งฟิลด์
  • Behind the revision: แสดงพาสที่ยังไม่ได้รับการอัปเดตแคมเปญล่าสุด

หากต้องการออกพาสใหม่หรือแนบพาสที่มีอยู่ ดู Issue passes to users

แท็บ History

Anchor link to

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

แท็บ History แสดงรายการการแก้ไขแคมเปญตามลำดับเวลาและคีย์ฟิลด์ที่เปลี่ยนแปลง

สถานะการจัดส่งของการอัปเดตล่าสุดจะปรากฏใต้แท็บ:

  • Cancel: หยุดส่งการอัปเดตไปยังพาสที่ยังไม่ได้รับ พาสเหล่านี้จะยังคงอยู่ในการแก้ไขก่อนหน้า
  • Retry failed: พยายามส่งอีกครั้งสำหรับพาสที่อัปเดตไม่สำเร็จ (ถูกทำเครื่องหมายว่าล้มเหลวหลังจากการพยายาม 5 ครั้ง)

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

ลบแคมเปญ

Anchor link to

เปิดแคมเปญและคลิก Delete campaign ที่ด้านบนขวาของหน้า

ส่วนหัวของพื้นที่ทำงานแคมเปญพร้อมปุ่ม Delete campaign ที่ถูกไฮไลต์ที่ด้านบนขวา

การลบแคมเปญจะไม่ลบหรือทำให้พาสที่ออกไปแล้วใช้งานไม่ได้ พาสที่ออกไปแล้วจะยังคงเนื้อหาและรูปภาพปัจจุบันไว้ แต่จะหยุดรับการอัปเดตที่แชร์ การเปลี่ยนแปลงใดๆ ในอนาคตจะต้องทำบนพาสแต่ละใบแยกกัน