# ออกแบบพาส Google Wallet ในเครื่องมือสร้างพาส

เครื่องมือสร้างพาส Google Wallet เป็นเครื่องมือออกแบบภาพใน Control Panel คุณสามารถเลือกประเภทพาส กรอกข้อมูลแบรนด์ ฟิลด์ และบาร์โค้ด ดูตัวอย่างสด และสร้างพาสได้ เมื่อคุณสร้างพาส Pushwoosh จะสร้างอ็อบเจกต์พาสใน Google Wallet และส่งคืนลิงก์สำหรับบันทึก "Add to Google Wallet"

## สร้างพาส

<Aside type="note" title="ต้องกำหนดค่าก่อน">
เครื่องมือสร้างจะใช้งานได้ก็ต่อเมื่อ Google Wallet ได้รับการกำหนดค่าสำหรับแอปพลิเคชันแล้ว (Issuer ID และ service account key) หากยังไม่ได้กำหนดค่า ให้ตั้งค่าก่อน: [การกำหนดค่าพาส Google Wallet สำหรับ Android](/th/developer/first-steps/connect-messaging-services/android-configuration/android-google-wallet-configuration/)
</Aside>

ใน Control Panel ไปที่ **Campaigns → Wallet Passes** เปิดแท็บ **Google Wallet** และคลิก **Create pass**

<img src="/google-wallet-passes-pass-builder-1.webp" alt="หน้า Wallet Passes ที่เปิดแท็บ Google Wallet และเห็นปุ่ม Create pass"/>

## กำหนดค่าพาส

*   **จากเริ่มต้น:** เริ่มต้นด้วยพาสเปล่า เลือกประเภทพาส จากนั้นตั้งค่าฟิลด์ ลักษณะ บาร์โค้ด และตัวเลือกอื่นๆ ด้วยตนเองในส่วนด้านล่าง
*   **จากเทมเพลต:** คลิก **Load template** เลือกพาสที่สร้างไว้แล้วใน **Select Template** (ทั่วไป, ข้อเสนอ, สมาชิก, ตั๋วงานอีเวนต์, บัตรของขวัญ, เที่ยวบิน, หรือการเดินทาง) และยืนยัน แบบฟอร์มจะเติมประเภทพาส, ฟิลด์, สี, และบาร์โค้ดให้โดยอัตโนมัติ แก้ไขค่าใดๆ หรือเปลี่ยนประเภทได้ตามต้องการ

### เลือกประเภทพาส

ใต้ **PASS TYPE** เลือกหนึ่งในเจ็ดประเภทพาสของ Google Wallet ประเภทพาสจะควบคุมเลย์เอาต์ของบัตรและฟิลด์ที่ใช้งานได้ พาสตามประเภทจะใช้เลย์เอาต์ดั้งเดิมของ Google ส่วนพาสทั่วไปจะเป็นแบบอิสระ

*   **Generic:** บัตรแบบอิสระจากฟิลด์ของคุณเอง
*   **Offer:** คูปองและส่วนลด
*   **Loyalty card:** บัตรสมาชิกและสะสมคะแนน
*   **Event ticket:** ตั๋วสำหรับงานอีเวนต์
*   **Gift card:** บัตรของขวัญและบัตรเติมเงิน
*   **Flight:** บอร์ดดิ้งพาส
*   **Transit:** ตั๋วรถไฟ, รถบัส, รถราง, และเรือเฟอร์รี่

### กรอกฟิลด์ของพาส

ฟิลด์ที่คุณเห็นจะขึ้นอยู่กับประเภทของพาส ฟิลด์ที่จำเป็นจะถูกทำเครื่องหมายไว้ ฟิลด์ทั่วไปตามประเภท:

| ประเภทพาส <div style="width:140px"></div> | ฟิลด์หลัก |
| :--- | :--- |
| **Generic** | ชื่อบัตร*, หัวเรื่อง*, หัวเรื่องรอง, ฟิลด์ของบัตร |
| **Offer** | ชื่อเรื่อง*, ผู้ให้บริการ*, รายละเอียด, ข้อกำหนดและเงื่อนไข, ช่องทางการแลกสิทธิ์ (ในร้าน / ออนไลน์ / ทั้งสอง), ชื่อผู้ออกบัตร |
| **Loyalty** | ชื่อโปรแกรม*, ชื่อสมาชิก, ID สมาชิก, ยอดคะแนน, ป้ายกำกับคะแนน, ระดับรางวัล, ป้ายกำกับระดับ, ชื่อผู้ออกบัตร |
| **Event ticket** | ชื่องานอีเวนต์*, สถานที่, ที่อยู่, วันที่และเวลาเริ่มต้น/สิ้นสุด, ผู้ถือตั๋ว, หมายเลขตั๋ว, ประเภท, ส่วน, แถว, ที่นั่ง, ประตู |
| **Gift card** | ชื่อร้านค้า*, หมายเลขบัตร*, PIN, ยอดคงเหลือ + สกุลเงิน |
| **Flight** | รหัส IATA ของสายการบิน*, หมายเลขเที่ยวบิน*, ต้นทาง*, ปลายทาง*, เวลาออกเดินทาง*, ชื่อผู้โดยสาร*, เวลาขึ้นเครื่อง, ที่นั่ง, ชั้น, กลุ่มขึ้นเครื่อง, รหัสยืนยัน |
| **Transit** | ประเภทการเดินทาง* (รถบัส / รถไฟ / รถราง / เรือเฟอร์รี่ / อื่นๆ), ผู้ให้บริการ*, ผู้โดยสาร*, ประเภทการเดินทาง, ช่วงการเดินทาง (ต้นทาง*, ปลายทาง*, เวลา, ชานชาลา, ตู้, ที่นั่ง) |

\* จำเป็นโดย Google

<Aside type="note" title="วันที่และเวลา">
พาสส่วนใหญ่ใช้ ISO 8601 พร้อมค่าออฟเซ็ต UTC (ตัวอย่างเช่น `2026-07-01T19:30:00+02:00`) ยกเว้นพาสเที่ยวบิน: Google กำหนดให้เวลาออกเดินทาง, เวลาขึ้นเครื่อง, และเวลาถึงที่หมายเป็นเวลา**ท้องถิ่น**ของสนามบิน**โดยไม่มี**ค่าออฟเซ็ต (ตัวอย่างเช่น `2026-09-01T06:30:00`)
</Aside>

#### ปรับแต่งเนื้อหาพาส

แต่ละพาสจะเชื่อมโยงกับ [User ID](/th/product/pushwoosh-knowledge-hub/users-userids/) หนึ่งรายการ ใช้ตัวยึดตำแหน่งแท็กเพื่อแสดงข้อมูลเฉพาะของผู้ใช้นั้นๆ เช่น ยอดคะแนนในบัตรสมาชิก หรือชื่อผู้รับในบัตรของขวัญ ออกพาสหนึ่งใบต่อ User ID เพื่อให้ผู้รับแต่ละคนได้รับค่าของตนเอง

ในการแทรกตัวยึดตำแหน่งแท็ก:

1.  ถัดจากฟิลด์ข้อความที่รองรับ (เช่น **Merchant**, **Card title**, หรือ **Header**) คลิก `{}` เพื่อแทรกแท็ก
2.  ใน **TAG** เลือก [tag](/th/product/audience-data-and-segmentation/user-data-tags/tags/) ที่จะแทรกเข้าไปในฟิลด์
3.  ใน **FORMAT** เลือกว่าจะแสดงค่าแท็กอย่างไร: **As is** (ใช้ค่าที่เก็บไว้), **Integer** (ปัดเป็นจำนวนเต็ม), **Price (0.00)** (แสดงทศนิยมสองตำแหน่ง), หรือ **Capitalize first letter** (ทำให้ตัวอักษรตัวแรกเป็นตัวพิมพ์ใหญ่)
4.  ใน **FALLBACK** สามารถป้อนข้อความที่จะแสดงเมื่อผู้รับไม่มีค่าสำหรับแท็กนั้น (ไม่บังคับ)
5.  คลิก **Insert**

<img src="/google-wallet-passes-pass-builder-2.webp" alt="ฟิลด์พาสพร้อมกล่องโต้ตอบ Insert a tag ที่เปิดอยู่ แสดงตัวเลือก Tag, Format, และ Fallback"/>

Pushwoosh จะเติมค่าแท็กเมื่อคุณสร้างพาสและรีเฟรชค่าเหล่านั้นทุกครั้งที่มีการอัปเดต

### ตั้งค่าลักษณะ

ใต้ **APPEARANCE** กำหนดค่าสี, รูปภาพ, ผู้ที่สามารถบันทึกพาส, และวันหมดอายุ

#### สี

ป้อนรหัส hex ใน **Background color** เช่น `#FFFFFF` สำหรับสีขาว ต้องมี `#` นำหน้าและอักขระหกตัว

#### รูปภาพ

<Aside type="caution" title="โฮสต์รูปภาพที่ URL HTTPS สาธารณะ">
Google Wallet ไม่ได้เก็บโลโก้หรือรูปภาพฮีโร่ของคุณ โฮสต์แต่ละไฟล์ที่ **URL HTTPS สาธารณะ** ที่ออนไลน์และเข้าถึงได้ตลอดเวลา จากนั้นวางลิงก์ลงในเครื่องมือสร้างพาส หาก URL เสียหายหรือไฟล์ถูกลบ รูปภาพจะหยุดโหลดบนพาส
</Aside>

วางลิงก์ HTTPS สาธารณะใน **Logo URL** จำเป็นสำหรับพาสสมาชิกและการเดินทาง

สามารถวางลิงก์ใน **Hero image URL** (ไม่บังคับ) สำหรับแบนเนอร์กว้างใต้รายละเอียดบัตรที่ด้านหน้าของพาส ขนาดที่แนะนำคือ 1032×336 px

<img src="/google-wallet-passes-pass-builder-3.webp" alt="ส่วน APPEARANCE พร้อมฟิลด์สีพื้นหลัง, URL โลโก้, URL รูปภาพฮีโร่, ใครสามารถบันทึกพาสได้, และวันหมดอายุ"/>

<Aside type="tip" title="URL ของ Media store">
คุณสามารถวาง URL รูปภาพสาธารณะจาก [Media store](/th/product/content/media-store/) รวมถึง [variant](/th/product/content/media-store/#create-image-variants) ที่ปรับขนาดให้เหมาะสมกับการวาง

**หมายเหตุ:** หากคุณลบรูปภาพใน Media store รูปภาพนั้นจะหยุดโหลดบนพาส
</Aside>

#### ใครสามารถบันทึกพาสได้

ใน **Who can save the pass** เลือกว่าใครสามารถเพิ่มพาสไปยัง Google Wallet ได้:

*   **One user, all their devices** (ค่าเริ่มต้น): พาสจะเชื่อมโยงกับบัญชี Google หนึ่งบัญชีและซิงค์ข้ามอุปกรณ์ของบัญชีนั้น
*   **One user, one device:** พาสจะถูกบันทึกไว้ในอุปกรณ์เดียวเท่านั้น
*   **Anyone with the link:** ทุกบัญชี Google ที่เปิดลิงก์บันทึกจะได้รับอ็อบเจกต์พาสที่แชร์ร่วมกัน เมื่อคุณอัปเดตพาส Google จะส่งการเปลี่ยนแปลงไปยังผู้ถือทุกคนโดยอัตโนมัติ

<Aside type="note" title="Anyone with the link">
ใช้ตัวเลือกนี้สำหรับพาสที่ผู้ถือทุกคนเห็นเนื้อหาเดียวกัน เช่น ข้อเสนอทั่วทั้งร้านค้า หรือตั๋วงานอีเวนต์สาธารณะที่ไม่มีการกำหนดที่นั่ง หลีกเลี่ยงการใช้กับบัตรสมาชิก, บัตรของขวัญ, หรือพาสใดๆ ที่เนื้อหาต้องเป็นส่วนตัวสำหรับผู้ใช้แต่ละคน Pushwoosh จะติดตามเพียงอุปกรณ์เดียวสำหรับอ็อบเจกต์ที่แชร์ ดังนั้นผู้ถือแต่ละคนจะไม่สามารถมองเห็นและไม่สามารถกำหนดเป้าหมายแยกกันได้
</Aside>

#### วันหมดอายุ

ตั้งค่า **Expiration date** เป็นวันที่ Google ควรจะทำให้พาสหมดอายุ หรือเว้นว่างไว้หากไม่มีวันหมดอายุ

### เพิ่มบาร์โค้ด

ใต้ **BARCODE** เลือกรูปแบบและป้อนค่าที่จะเข้ารหัส:

1.  **Format:** เลือกลักษณะของบาร์โค้ดและประเภทของเครื่องสแกนที่สามารถอ่านได้
    *   **QR_CODE:** โค้ดสี่เหลี่ยมที่โทรศัพท์และเครื่องสแกนส่วนใหญ่อ่านได้ง่าย เหมาะสำหรับพาสส่วนใหญ่
    *   **PDF_417:** บาร์โค้ดกว้างที่ประกอบด้วยแถวของเส้นหลายแถว มักจำเป็นสำหรับบอร์ดดิ้งพาส
    *   **AZTEC:** โค้ดสี่เหลี่ยมขนาดกะทัดรัด คล้ายกับ QR Code พบได้บ่อยในตั๋วงานอีเวนต์และการเดินทาง
    *   **CODE_128** / **EAN_13:** บาร์โค้ด 1D เลือกใช้เฉพาะเมื่อเครื่องสแกนหรือระบบ POS ของคุณต้องการ
2.  **Value:** ข้อมูลที่เข้ารหัสในบาร์โค้ด (เช่น หมายเลขตั๋วหรือหมายเลขสมาชิก) หากต้องการใช้ค่าที่ไม่ซ้ำกันสำหรับผู้ใช้แต่ละคน ให้คลิก `{}` ถัดจากฟิลด์และแทรก [ตัวยึดตำแหน่งแท็ก](#personalize-pass-content)
3.  **Alt Text:** ข้อความที่แสดงใต้บาร์โค้ดบนพาส

<img src="/google-wallet-passes-pass-builder-5.webp" alt="ส่วน BARCODE พร้อมฟิลด์ Format, Value, และ Alt Text"/>

### เพิ่มฟิลด์รายละเอียดและลิงก์

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

*   **Text modules:** บล็อกข้อความเพิ่มเติมที่ด้านหลังของพาส ตั้งค่า **header** (ชื่อส่วน) และ **body** (ข้อความ) ใช้สำหรับข้อกำหนด, คำแนะนำ, หรือข้อมูลอื่นๆ ที่ไม่พอดีกับด้านหน้า
*   **Links:** ลิงก์ที่สามารถแตะได้ที่ด้านหลังของพาส ตั้งค่า **URL** และ **description** สั้นๆ (เช่น "ค้นหาสาขา" หรือ "ข้อกำหนดและเงื่อนไข")

<img src="/google-wallet-passes-pass-builder-6.webp" alt="ส่วน TEXT MODULES และ LINKS พร้อมฟิลด์ header, body, URL, และ description"/>

### เพิ่มลิงก์แอป *(ไม่บังคับ)*

ใต้ **APP LINK** เพิ่มปุ่มที่ด้านหน้าของพาสซึ่งจะเปิดหน้าเว็บหรือแอป Android ของคุณเมื่อแตะ คุณสามารถตั้งค่า **URL**, **Android package name**, หรือทั้งสองอย่าง

หากคุณตั้งค่าเฉพาะ URL ปุ่มจะเปิดที่อยู่เว็บนั้นบนอุปกรณ์ใดก็ได้ หากคุณตั้งค่าเฉพาะ package name ปุ่มจะทำงานบนอุปกรณ์ Android ที่ติดตั้งแอปไว้ โดยไม่มีเว็บสำรอง

<img src="/google-wallet-passes-pass-builder-4.webp" alt="ส่วน APP LINK พร้อมฟิลด์ URL และ Android package name"/>

### เพิ่มตำแหน่งที่ตั้ง *(ไม่บังคับ)*

ใต้ **Location-based relevance** เพิ่มจุดสนใจ Google จะแสดงการแจ้งเตือนตามตำแหน่งทางภูมิศาสตร์เมื่อผู้ใช้อยู่ใกล้ตำแหน่งที่คุณเพิ่ม ตัวอย่างเช่น แสดงบัตรสมาชิกใกล้ร้านค้าของคุณ, ตั๋วงานอีเวนต์ใกล้สถานที่จัดงาน, หรือบอร์ดดิ้งพาสใกล้สนามบิน

คุณสามารถเพิ่มตำแหน่งได้สูงสุด **10** แห่ง โดยแต่ละแห่งตั้งค่าด้วยละติจูดและลองจิจูด

<img
  src="/google-wallet-passes-pass-builder-7.webp"
  alt="ส่วน LOCATIONS พร้อมฟิลด์ละติจูดและลองจิจูดสำหรับการเพิ่มจุดสนใจ"
  style={{ maxWidth: "480px", width: "100%", height: "auto" }}
/>

<Aside type="note" title="ตำแหน่งที่ตั้งบน Google Wallet">
Google ควบคุมรัศมีการแจ้งเตือนตามตำแหน่งและตัดสินใจว่าจะแสดงการแจ้งเตือนเมื่อใด คุณไม่สามารถตั้งค่าระยะทางสูงสุดต่อตำแหน่งได้
</Aside>

### ป้อน User ID

ป้อน Pushwoosh [User ID](/th/product/pushwoosh-knowledge-hub/users-userids/#how-are-users-and-devices-related) สำหรับบุคคลที่จะได้รับพาสนี้

Pushwoosh จะออกพาสให้กับผู้ใช้นั้นและแสดงรายการไว้ใต้ **USER** ในหน้า [**All passes**](/th/product/messaging-channels/wallet-passes/google-wallet/#view-and-manage-existing-passes)

### ดูตัวอย่างและตรวจสอบความถูกต้อง

**ตัวอย่างสด** จะอัปเดตขณะที่คุณแก้ไข เพื่อให้คุณเห็นภาพคร่าวๆ ว่าพาสจะมีลักษณะอย่างไรใน Google Wallet

<Aside type="note" title="ตัวอย่างอาจแตกต่างกันในอุปกรณ์จริง">
ตัวอย่างเป็นเพียงการประมาณ พาสตามประเภทจะใช้เลย์เอาต์ดั้งเดิมของ Google ดังนั้นพาสอาจดูแตกต่างไปในอุปกรณ์จริง บาร์โค้ดที่แสดงเป็นเพียงตัวยึดตำแหน่ง
</Aside>

หากต้องการตรวจสอบพาสเทียบกับข้อกำหนดของ Google โดยไม่ต้องสร้าง ให้คลิก **Validate** เครื่องมือสร้างจะแจ้งเตือนฟิลด์ที่จำเป็นที่ขาดหายไปและปัญหาอื่นๆ

## สร้างพาส

คลิก **Generate** Pushwoosh จะตรวจสอบพาสและสร้างใน Google Wallet คุณจะได้รับลิงก์บันทึก **Add to Google Wallet** เพื่อแชร์กับผู้ใช้ ภายในไม่กี่วินาที พาสจะปรากฏใน [**All passes**](/th/product/messaging-channels/wallet-passes/google-wallet/#view-and-manage-existing-passes)

สำหรับการแก้ไข, การรับลิงก์บันทึก, การทำให้พาสใช้งานไม่ได้, และการลบพาสหลังจากการสร้าง โปรดดูที่ [จัดการพาสที่มีอยู่](/th/product/messaging-channels/wallet-passes/google-wallet/#view-and-manage-existing-passes)

## จัดการพาสผ่าน API

ทุกสิ่งที่เครื่องมือสร้างพาสทำได้ยังมีให้ใช้งานผ่าน [Google Wallet API](/th/developer/api-reference/google-wallet-api/) ด้วย: สร้าง, อัปเดต, แสดงรายการ, รับลิงก์บันทึก, ตั้งค่าสถานะ, และลบพาส

<LinkCard title="Google Wallet API" href="/developer/api-reference/google-wallet-api/" />