שימוש במזהה קיבוץ
כברירת מחדל, הוספה של כמה כרטיסים לקישור הוספה ל-Google Wallet לא תקבץ את הכרטיסים האלה באפליקציית Google Wallet של המשתמש. עם זאת, אפשר לקבץ כרטיסים יחד. לשם כך, צריך לוודא שלכולם יש אותו מזהה קיבוץ. כרטיסים מקובצים יופיעו יחד באפליקציית Google Wallet. כשבוחרים קבוצת כרטיסים, כל כרטיס יוצג בקרוסלה.
אפשר לקבץ כרטיסים יחד:
כדי להוסיף אישור לקבוצה, צריך להגדיר את המאפיין groupingInfo.groupingId
של אובייקט ההעברה. כל אובייקטי ההעברה שיש להם ערך groupingId
זהה יקובצו יחד באופן אוטומטי, גם אם הם נוספו בנפרד.
בדוגמה הבאה אפשר לראות שכרטיס מועדון לקוחות והמבצע מקובצים יחד כדי לעודד את המשתמשים להשתמש בשניהם ברכישה הבאה.
loyaltyObject = { "classId": "ISSUER_ID.GIFT_CARD_CLASS_SUFFIX", "id": "ISSUER_ID.GIFT_CARD_OBJECT_SUFFIX", "state": "ACTIVE", "groupingInfo": { # Note the same groupingId value "groupingId": "combinedGiftCardAndOfferId", "sortIndex": 1 }, "barcode": { "type": "QR_CODE", "value": "QR code" }, "accountId": "Account id", "accountName": "Account name", "loyaltyPoints": { "label": "Points", "balance": { "int": 800 } } } offerObject = { "classId": "ISSUER_ID.OFFER_CLASS_SUFFIX", "id": "ISSUER_ID.OFFER_OBJECT_SUFFIX", "state": "ACTIVE", "groupingInfo": { # Note the same groupingId value "groupingId": "combinedGiftCardAndOfferId", "sortIndex": 2 }, "barcode": { "type": "QR_CODE", "value": "QR code", }, }
קיבוץ אוטומטי של כרטיסים לאירועים
לפעמים משתמשים בכרטיסים לאירועים בקבוצה, ולא בנפרד. אחד מהמצבים האלה הוא קיבוץ של כרטיסים לכמה בני משפחה.
לכרטיסים לאירועים יש לוגיקה נוספת שמאפשרת קיבוץ אוטומטי בהתאם למאפיינים הבאים:
EventClass.eventId
EventClass.eventName
EventClass.dateTime.start
- החלק של מזהה המנפיק של
EventObject.id
קיבוץ עם EventClass.eventId
האובייקטים של כרטיסים לאירועים מקובצים באופן אוטומטי כשיש להם ערכים זהים במאפיינים הבאים:
EventClass.eventId
- החלק של מזהה המנפיק של
EventObject.id
כשאובייקטים של כרטיסים לאירועים עומדים בקריטריונים האלה, הם יקובצו גם אם יש הבדל בין EventClass.eventName
לבין EventClass.dateTime.start
.
קיבוץ ללא EventClass.eventId
אם לא מגדירים את EventClass.eventId
, הם יקובצו באופן אוטומטי אם המאפיינים הבאים זהים.
EventClass.eventName
EventClass.dateTime.start
- החלק של מזהה המנפיק של
EventObject.id