קיבוץ כרטיסים מרובים לאירועים

שימוש במזהה קיבוץ

כברירת מחדל, הוספה של כמה כרטיסים לקישור הוספה ל-Google Wallet לא תקבץ את הכרטיסים האלה באפליקציית Google Wallet של המשתמש. עם זאת, אפשר לקבץ כרטיסים יחד. לשם כך, צריך לוודא שלכולם יש אותו מזהה קיבוץ. כרטיסים מקובצים יופיעו יחד באפליקציית Google Wallet. כשבוחרים קבוצת כרטיסים, כל כרטיס יוצג בקרוסלה.

אפשר לקבץ כרטיסים יחד:

  • במהלך ניהול התצורה הראשוני
  • באמצעות השיטה update או patch

כדי להוסיף אישור לקבוצה, צריך להגדיר את המאפיין 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