從航班預訂電子郵件匯入登機證

開發人員或商家將 Google 錢包與航班預訂系統整合後，就能驗證所有登機資訊是否可供存取，大幅提升顧客體驗。

背景

將 Google 錢包與航班預訂系統整合，可驗證所有登機資訊是否都能存取，大幅提升顧客體驗。Google 錢包與 Gmail 整合後，使用者收到符合資格的電子郵件時，系統會自動建立數位票證。

如要達成這項無縫整合，有兩種方法：(1) 在電子郵件內文中加入相關資訊，或 (2) 在傳送給顧客的電子郵件中使用結構化標記，特別是著重於 ticketToken 欄位。

這份文件提供必要資訊，您可以在下一封電子郵件 / 客戶關係管理系統廣告活動中加入這些資訊，讓使用者在 Google 錢包中自動產生登機證。

從登機證電子郵件匯入登機證資訊，提升 Google 錢包整合體驗

Gmail 匯入的憑證功能是輕量機制，可將使用者的登機證數位化並儲存到 Google 錢包。系統會自動從電子郵件內容擷取資訊，盡量減少使用者作業阻礙，並提高採用率。

這項解決方案的設計宗旨是與現有的 Google 錢包 API 產品互補。Gmail 匯入的票證會為使用者提供最基本的資訊：

從 Gmail 匯入的憑證 整合 Google Wallet API
  • 使用者資訊：
    • 乘客姓名
    • 飛行常客號碼
  • 航班資訊：
    • 起飛機場
    • 出發時間
    • 航班號碼
    • 座位號碼
    • 登機門
    • 抵達時間
    • 降落機場
  • 從 Gmail 匯入的憑證中所有使用者資訊
  • 推播通知會反映最新異動
  • 自動連結的票證
  • 通過加值機會
  • 其他優點

我們的目標是提高貴航空公司數位憑證的採用率，並為尚未點選「新增至 Google 錢包」按鈕的使用者，提供從您傳送的電子郵件自動產生的登機證。

選項 1：電子郵件內文

在電子郵件內文中加入相關資訊，系統就能自動偵測並擷取電子郵件。

必填欄位 (純文字)

如要啟用自動偵測功能，請在電子郵件內文或附件中清楚加入下列欄位：

  1. 乘客資訊：
    • 乘客姓名 (例如「JOHN DOE」)
  2. 航班資訊
    • 預訂參考編號或票號
    • 出發機場 (例如洛杉磯的 IATA 代碼為「LAX」)
    • 出發日期和時間
    • 抵達機場 (例如洛杉磯的 IATA 代碼為「LAX」)
    • 抵達日期和時間
    • 航班號碼
    • 座位號碼
    • 登機門
  3. 登機證 QR code：登機證 QR code 本身的內嵌圖片或圖片附件。建議使用 QR_CODE 或 PDF417 類型的 QR code。建議使用的圖片 MIME 類型為 PNG 和 JPG。

選填欄位

你也可以根據登機證資訊產生會員卡，提升使用者體驗。如要啟用自動偵測功能，請在電子郵件內文中清楚加入下列欄位：

  1. 商家名稱 (例如「ABC 航空公司」)
  2. 飛行常客 ID (例如「1234567890」)
  3. 飛行常客或航空公司會員方案名稱 (例如「Mileage Plus Rewards」)

詳情請參閱「會員方案說明」頁面 (連結至會員方案網頁)。

以下是電子郵件範例 (例如登機證電子郵件)

主旨：航班 GG123 的登機證 (預訂參考編號：P8F8R8)

內文：

旅客您好：
您的登機證已順利產生！

航班摘要
出發地
出發機場代碼
出發時間：2025 年 7 月 9 日 23:00

目的地
抵達機場代碼
抵達時間：2025 年 7 月 10 日 05:00

航班
GG123

座位
1A

預訂參考編號
P8F8R8

票號
987654321

登機證 QR code
登機證 QR code 範例

提醒事項：
  • 請攜帶登機證的列印或數位副本前往機場。
  • 在機場安檢和登機門分別出示身分證件，供工作人員檢查。
  • 行李託運。如有託運行李，請前往行李託運櫃檯；如無，請直接前往登機門。建議您在航班預定起飛時間前至少 2 小時抵達機場。我們的辦理登機手續櫃檯會在起飛前 60 分鐘關閉。
  • 登機門會在起飛前 25 分鐘關閉。

祝您飛行愉快又安全！

敬祝
Fake Air 團隊

這是 Google 錢包中的相關登機證

Gmail 登機證 範例

加入 Google 錢包

1. 製作電子郵件宣傳活動：設計並傳送電子郵件宣傳活動給使用者群，確認電子郵件內文中清楚列出必要欄位部分提及的票證產生作業所需的所有資訊。

2. 將實際的電子郵件樣本轉寄至專用剖析器：parser-sample+wallet_partner_boardingpass@google.com

3. 收到電子郵件範本後，我們的團隊會審查並設定剖析邏輯。一般情況下，您會在五 (5) 個工作天內，看到提交的電子郵件範本成功推出這項功能。

注意：我們可能會使用您傳送電子郵件的地址與您聯絡。請確認用於轉寄範例的電子郵件地址可以接收內送郵件。

選項 2：Gmail 微資料

如要達成這項無縫整合，關鍵在於在傳送給顧客的電子郵件中使用結構化標記，特別是著重於 ticketToken 欄位。

為什麼要嵌入標記？

在航班確認電子郵件中嵌入標記，系統就能自動辨識預訂詳細資料，並匯入顧客的 Google 錢包 (如果已啟用這項功能)。這項程序會透過 Schema.org 格式的結構化資料，自動新增相關航班資訊，進而提升 Google 錢包的功能。

關鍵欄位：ticketToken

ticketToken 欄位至關重要，因為通常包含安全程式碼類型和原始值，可直接算繪為可掃描的程式碼。這個欄位可確保顧客的 Google 錢包中立即顯示所有必要的登機資訊。此外，原始值必須符合BCBP (條碼登機證) 規定。您可以使用解碼器解碼權杖值。商家必須確保 JSON 中的值與解碼值一致。

以下列舉部分支援的代碼類型：

  • barcode128
  • pdf417
  • qrCode
  • aztecCode

以下是一些有效的 ticketTokens 值範例：

barcode128:M1HANFENG/ZHU          EMWLPJ SFOAUSGG  123 350J25A 614a 10A1973966772
pdf417:M1HANFENG/ZHU          EMWLPJ SFOAUSGG  123 350J25A 614a 10A1973966772
qrCode:M1HANFENG/ZHU          EMWLPJ SFOAUSGG  123 350J25A 614a 10A1973966772
aztecCode:M1HANFENG/ZHU          EMWLPJ SFOAUSGG  123 350J25A 614a 10A1973966772

電子郵件標記的結構如下：

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "FlightReservation",
  "reservationNumber": "RXJ34P",
  "reservationStatus": "http://schema.org/Confirmed",
  "underName": {
    "@type": "Person",
    "name": "HANFENG/ZHU"
  },
  "reservationFor": {
    "@type": "Flight",
    "flightNumber": "123",
    "airline": {
      "@type": "Airline",
      "name": "United",
      "iataCode": "GG"
    },
    "departureAirport": {
      "@type": "Airport",
      "name": "San Francisco Airport",
      "iataCode": "SFO"
    },
    "departureTime": "2027-03-04T20:15:00-08:00",
    "arrivalAirport": {
      "@type": "Airport",
      "name": "Austin-Bergstorm International Airport",
      "iataCode": "AUS"
    },
    "arrivalTime": "2027-03-05T06:30:00-05:00"
  },
  "airplaneSeat": "9A",
  "airplaneSeatClass": {
    "@type": "AirplaneSeatClass",
    "name": "Business"
  },
  "ticketToken": "qrCode:M1HANFENG/ZHU          EMWLPJ SFOAUSGG  123 350J25A 614a 10A1973966772"
}
</script>