רקע
התכונה מאפשרת לחברות תעופה לשלוח כרטיסי עלייה למטוס באופן אוטומטי ל-Google Wallet של המשתמש. התכונה הזו תועיל במיוחד לנוסעים מתמידים, שיוכלו להוסיף את כרטיסי העלייה למטוס ל-Wallet בצורה פשוטה יותר ועם פחות חיכוך, כי הם טסים בתדירות גבוהה יותר.
הפעולה הזו מתבצעת באופן אוטומטי, ללא קשר לערוץ הצ'ק-אין (למשל, אתר, אפליקציה או עמדת צ'ק-אין בשדה התעופה). חברות תעופה שותפות יכולות להשתמש במספר חשבון במועדון לקוחות של המשתמש כדי ליצור קורלציה ולדחוף את הכרטיס ל-Wallet.
איך התכונה פועלת
שלב 1: מאפשרים לנוסע המתמיד להוסיף ל-Wallet את כרטיס המועדון שלו בתוכנית הנוסע המתמיד.
שלב 2: מוסיפים אוטומטית כרטיסי עלייה למטוס חדשים לנוסע המתמיד על ידי קישור שלהם לכרטיס מועדון הלקוחות ב-Wallet.
שיטות מומלצות
-
כדי לאפשר הרשמה חלקה למועדון הנוסעים המתמידים לנוסעים שטסים לעיתים קרובות, כדאי להפעיל תהליך הרשמה או כניסה באמצעות חשבון Google. לאחר מכן, המשתמשים יוכלו לגלות את תהליך ההצטרפות למועדון הלקוחות של חברת התעופה דרך מגוון נקודות כניסה ב-Google Wallet, כולל כרטיסי עלייה למטוס.
- כדאי להפעיל הרשמה בלחיצה אחת לחברים קיימים במועדון הלקוחות באפליקציית Android ובאתר שלכם.
הערה: התכונה הזו היא יישום ספציפי של היכולת 'כרטיסים מקושרים אוטומטית'. בהקשר הזה, הכרטיס הראשי הוא כרטיס מועדון לקוחות והכרטיס המקושר הוא כרטיס עלייה למטוס. בהמשך המסמך הזה נשתמש במינוח הכללי יותר – כרטיסים שמקושרים אוטומטית, כרטיס ראשי וכרטיס מקושר – כדי לתאר את הפונקציונליות הזו.
שיקולים לשימוש בכרטיסים שמקושרים אוטומטית
- האובייקט הראשי והאובייקט המקושר חייבים להשתמש באותו issuerId.
- אין ערובה לכך שהכרטיסים המקושרים יועברו אוטומטית, והפעולה הזו נחשבת כמאמץ הכי טוב שאפשר. המשתמשים יכולים לבטל את ההסכמה לקבלת כרטיסים שמקושרים אוטומטית. אם תרחיש השימוש הוא קריטי והמשתמש חייב לקבל את הכרטיס המקושר, מומלץ לתקשר איתו בערוץ אחר כדי לוודא שהוא יוסיף את הכרטיס.
- העדכונים למדיניות השימוש המקובל של Google Wallet כוללים הנחיות לשימוש בכרטיסים שמקושרים אוטומטית, וחובה לפעול בהתאם להנחיות האלה.
שלבי ההטמעה
אם כבר יצרתם אובייקט ראשי, אתם יכולים לדלג על שלב 1.
- יוצרים אובייקט מכל סוג כרטיס שמופיע ברשימה עם הפרמטרים הנדרשים. זהו אובייקט primary.
- יצירת אובייקט נוסף מכל סוג כרטיס שמופיע ברשימה. זה יהיה האובייקט המקושר.
- לפני או אחרי ששומרים את האובייקט הראשי, מעדכנים את האובייקט הראשי עם המזהה של האובייקט המקושר בפרמטר linkedObjectIds.
כדי להגדיר את המזהים של האובייקטים המקושרים בכרטיס הראשי, צריך להגדיר מטען ייעודי מינימלי. שלושת הפרמטרים הנדרשים כוללים:
- ISSUERID.PRIMARY_OBJECT_ID
- ISSUERID.PRIMARY_CLASS_ID
- ISSUERID.LINKED_OBJECT_ID
דוגמה לבקשת JSON להוספת אובייקט מקושר לאובייקט כרטיס
… { "id": "ISSUERID.PASS_OBJECTID", "classId": "ISSUERID.PASS_CLASSID", "barcode": { "type": "qrCode", "value": "QR code" }, "linkedObjectIds": ["ISSUERID.LINKED_PASS_OBJECTID"] } …
דוגמה לתגובת JSON אחרי קישור אובייקט לאובייקט כרטיס
…
"state": "active",
"linkedObjectIds": {
"ISSUERID.LINKED_PASS_OBJECTID"
}
…טיפול בחריגים
יכול להיות שיתרחשו שגיאות פוטנציאליות כתוצאה משימוש לא נכון ב-API, כולל:
| Message | סיבה |
|---|---|
| לאובייקט הראשי ולאובייקט המקושר אין אותו מזהה מנפיק. | אי אפשר לצרף אובייקט מקושר לאובייקט של מנפיק אחר. |
| האובייקט הראשי והאובייקט המקושר הם אותו אובייקט. | אי אפשר לצרף את אותו אובייקט כ-linkedObject. |
| האובייקט המקושר לא קיים. | האובייקט המקושר צריך להיות כבר מוכנס ל-Wallet API. |
| לאובייקט המקושר כבר יש אובייקט מקושר אחר. אי אפשר להוסיף אובייקטים מקושרים מוטמעים. | אי אפשר לקשר אובייקט מקושר לאובייקט מקושר אחר. |
| האובייקט כבר מקושר לאובייקט אחר. אי אפשר להוסיף אובייקטים מקושרים מוטמעים. | האובייקט הראשי לא יכול להיות אובייקט מקושר בפני עצמו. |