ข้ามไปยังเนื้อหา
เอกสารสำหรับนักพัฒนา การสนับสนุน ขอสาธิต เข้าสู่ระบบ
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 จะเติมค่าจาก tag ของผู้รับเมื่อให้บริการพาส หากผู้รับไม่มีค่าสำหรับแท็กนั้น 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 จะแสดงกล่องโต้ตอบยืนยันที่แสดงจำนวนพาสที่ออกแล้วที่จะได้รับการอัปเดต:

  • ข้อมูลพื้นฐาน, สี หรือประเภทบาร์โค้ด
  • การหมดอายุหรือตำแหน่ง
  • ฟิลด์ที่แชร์
  • รูปภาพแคมเปญ

ยืนยันการอัปเดต:

  • หากไม่มีพาสใดมีการแทนที่: คลิก 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, overrides, revision และปุ่มดำเนินการ

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

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

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

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

  • Edit: เปิดพาสในหน้าแก้ไขของแพลตฟอร์มเพื่อเปลี่ยนฟิลด์ส่วนตัวหรือแทนที่ฟิลด์ที่แชร์
  • Download: ในแคมเปญ Apple Wallet ให้ดาวน์โหลดไฟล์ .pkpass ที่ลงนามแล้ว แคมเปญ Google Wallet จะไม่แสดงตัวเลือกนี้ เนื่องจาก Google Wallet ไม่มีไฟล์ที่สามารถดาวน์โหลดได้เทียบเท่า
  • Send message: เปิดเครื่องมือสร้าง push แบบครั้งเดียวเพื่อส่งข้อความถึงผู้รับพาสด้วย User ID ดู Message Wallet pass holders สำหรับทุกวิธีในการเข้าถึงพวกเขา
  • 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 ที่ถูกไฮไลท์ที่มุมบนขวา

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