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

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

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

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

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

Anchor link to
  • ออกแบบพาสเดียวในแคมเปญ แทนที่จะต้องตั้งค่าพาสแต่ละใบด้วยตนเองใน Apple Wallet หรือ Google Wallet pass builder
  • เลือกฟิลด์ที่จะอัปเดตทุกที่ (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) ให้เลือกเลย์เอาต์สำหรับพาสของคุณ:
ฟอร์มสร้างแคมเปญใหม่ที่แสดงฟิลด์ 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

ในส่วน Tag sync ให้เปิด Update pass fields from tags เพื่อให้ Pushwoosh ตรวจสอบ ตัวยึดตำแหน่งแท็ก ที่ใช้ในฟิลด์ของแคมเปญเป็นระยะ และพุชค่าใหม่ไปยังพาสใดๆ ที่แท็กมีการเปลี่ยนแปลง

  • Interval (minutes): ความถี่ที่ Pushwoosh จะอ่านแท็กซ้ำ ค่าเริ่มต้นคือ 60 และไม่สามารถต่ำกว่า 5 ได้ พาสจะได้รับการรีเฟรชอย่างมากที่สุดหนึ่งครั้งต่อช่วงเวลา ไม่ว่าแท็กจะเปลี่ยนแปลงกี่ครั้งในระหว่างนั้น
  • Notification (Google Wallet เท่านั้น): เลือกว่าผู้ถือจะรับรู้เกี่ยวกับการรีเฟรชอย่างไร: Silently, Own message (กรอก Message text ซึ่งจะถูกส่งไปพร้อมกับการอัปเดต) หรือ Google field notification (การแจ้งเตือนการอัปเดตฟิลด์ของ Google เอง) Google จำกัดการแจ้งเตือนไว้ที่ 3 ครั้งต่อพาสต่อ 24 ชั่วโมง หากเกินกว่านั้น ค่าใหม่จะยังคงไปถึงพาส แต่จะไม่มีการแจ้งเตือน
ส่วน Tag sync ในสี่สถานะ: ปิด, Google พร้อมการรีเฟรชแบบเงียบ, Google พร้อมข้อความที่กำหนดเอง และ Apple ที่แสดงหมายเหตุ Change message แทนตัวเลือกการแจ้งเตือน

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

Anchor link to
  1. ในส่วน Campaign images คลิก Choose an image ข้างช่องรูปภาพ
  2. เลือกรูปภาพที่มีอยู่จาก คลังมีเดีย ของคุณ หรือลากและวางไฟล์ใหม่เพื่ออัปโหลด
  3. ทำซ้ำสำหรับช่องรูปภาพที่มีอยู่ทั้งหมด:
    • Apple Wallet: Icon, Logo, Background, Footer, Strip และ Thumbnail (ดู รูปภาพ Apple Wallet)
    • 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
  1. บนแท็บ Design แก้ไขข้อมูลพื้นฐาน, สี, ประเภทบาร์โค้ด, การหมดอายุ, ตำแหน่ง, ฟิลด์ที่ใช้ร่วมกัน หรือรูปภาพแคมเปญ
  2. คลิก Save changes
  3. ในกล่องโต้ตอบ Apply the campaign edit ให้ยืนยันการอัปเดต:
    • ไม่มีพาสใดแทนที่ฟิลด์ที่เปลี่ยนแปลง: คลิก Update N, keep hand edits เพื่อพุชการแก้ไขไปยังพาสทั้งหมด N ใบ
    • บางพาสแทนที่ฟิลด์ที่เปลี่ยนแปลง: กล่องโต้ตอบจะระบุชื่อฟิลด์และจำนวนพาสที่แทนที่ฟิลด์นั้น คลิก Update N, keep hand edits เพื่อพุชการแก้ไขไปยังทุกพาสยกเว้นพาสเหล่านั้น หรือ Overwrite all N เพื่อพุชไปยังพาสทั้งหมด N ใบ รวมถึงพาสที่ถูกแทนที่ด้วย การเขียนทับจะลบการแทนที่นั้น
กล่องโต้ตอบ Apply the campaign edit ที่แสดงรายการฟิลด์ venue ที่ถูกแทนที่ใน 1 พาส พร้อมปุ่ม Update 3, keep hand edits และ Overwrite all 4

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

แท็บ History ที่ไฮไลต์แถว revision 2 ซึ่งแสดงคีย์ฟิลด์ที่เปลี่ยนแปลงและเวลาที่สร้าง

แทนที่ฟิลด์ที่ใช้ร่วมกันในพาสแต่ละใบ

Anchor link to

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

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

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

แท็บ Passes

Anchor link to

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

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

หาก tag sync เปิดอยู่ แท็บจะแสดงบรรทัด Tags synced เหนือตารางพร้อมวันที่และเวลาของการทำงานตามกำหนดเวลาครั้งล่าสุด หรือ not yet ก่อนการทำงานครั้งแรก

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

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

หากต้องการออกพาสใหม่หรือแนบพาสที่มีอยู่ ดู ออกพาสให้กับผู้ใช้

เปิดเมนูการดำเนินการของแถว (⋮) เพื่อจัดการพาสนั้น:

  • Edit: เปิดพาสในหน้าแก้ไขของแพลตฟอร์มเพื่อเปลี่ยนฟิลด์ส่วนตัวหรือแทนที่ฟิลด์ที่ใช้ร่วมกัน
  • Download: ในแคมเปญ Apple Wallet ให้ดาวน์โหลดไฟล์ .pkpass ที่ลงนามแล้ว แคมเปญ Google Wallet จะไม่แสดงตัวเลือกนี้ เนื่องจาก Google Wallet ไม่มีไฟล์ที่เทียบเท่าให้ดาวน์โหลด
  • Send message: เปิดตัวเขียน push แบบครั้งเดียวเพื่อส่งข้อความถึงผู้รับของพาสด้วย User ID ดู ส่งข้อความถึงผู้ถือ Wallet pass สำหรับทุกวิธีในการเข้าถึงพวกเขา
  • QR code: แสดง QR code การติดตั้งที่ผู้ใช้สามารถสแกนเพื่อเพิ่มพาสและลงทะเบียนอุปกรณ์สำหรับการอัปเดต
  • Copy install link: คัดลอก URL การติดตั้งเพื่อแชร์พาสในช่องทางการส่งข้อความของคุณ
  • Delete: ลบพาส ไม่สามารถยกเลิกได้ ใน Apple Wallet สำเนาที่ติดตั้งแล้วจะหยุดรับการอัปเดตและจะใช้งานไม่ได้ในการรีเฟรชครั้งถัดไป ใน Google Wallet, Google ไม่อนุญาตให้บังคับลบพาสที่บันทึกไว้ในอุปกรณ์แล้ว ดังนั้นพาสจะใช้งานไม่ได้และย้ายไปยัง Expired passes ของผู้ใช้ในขณะที่ Pushwoosh ลบบันทึกของมัน การลบพาสที่นี่จะไม่ลบแคมเปญหรือพาสอื่นใดที่ออกไปแล้ว

แท็บ History

Anchor link to

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

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

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

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

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

ลบแคมเปญ

Anchor link to

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

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

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