הפעלת התראות

התראות שמופעלות על ידי שותף

הוספת הודעה ושליחת התראה

רקע

אחרי שמשתמש מוסיף כרטיס, יכול להיות שתרצו לשלוח לו הודעה שקשורה לכרטיס ולוודא שהוא מקבל עליה הודעה. כשמשתמשים בבקשה של Add Message API עם message_type ששווה ל-TEXT_AND_NOTIFY, מתרחש הדבר הבא:

1. פריט הודעה נוסף ל'גב הכרטיס' (שנקרא גם תבנית פרטים), ונשלחת התראה ב-push למשתמשים ששמרו את הכרטיס.
2. כשמשתמש מקיש על ההתראה, נפתחת אפליקציית Google Wallet בחלק הקדמי של הכרטיס (כלומר, תצוגת הכרטיס), ובחלק העליון של המסך מופיע בועת הסבר עם הלחצן 'הצגת ההודעה'.
3. לחיצה על ההסבר הקצר תעביר את המשתמשים לחלק האחורי של הכרטיס, שבו יודגשו הודעות חדשות שלא נקראו.

שיקולים שכדאי לקחת בחשבון כששולחים הודעות עם התראות למשתמשים

• כדי שהמשתמשים יקבלו התראות פוש שקשורות להודעות, הם צריכים להפעיל את ההתראות בכרטיסים שלהם.
• ההודעות יכולות להכיל כתובות URI לאתר או לאפליקציה שלכם. ההיפר-קישורים צריכים להיות לאתר או לאפליקציה שקשורים לכרטיס. שליחת משתמשים לקישורים שלא קשורים לכרטיס מהווה הפרה של מדיניות השימוש המקובל.
• אתם יכולים לשלוח לכל היותר 3 הודעות שמפעילות התראה בנייד בפרק זמן של 24 שעות. יכול להיות ש-Google תגביל את מכסת המסירה של הודעות ה-Push שלכם אם היא תסבור שאתם שולחים ספאם למשתמשים.
• ההתראה שמוצגת למשתמשים במסך הנעילה נשלטת על ידי Google Wallet.
• אפשר להשתמש בשיטות UPDATE או PATCH כדי לערוך או להסיר נתוני הודעות באמצעות נקודת הקצה הרגילה של המחלקה או האובייקט.

שלבי ההטמעה

אם רוצים להודיע למשתמשים על הודעה חדשה של מנפיק שנוספה באמצעות AddMessage API, צריך לעדכן את AddMessageRequest כך שMessage שמכיל את הטקסט החדש יקבל את הערך TEXT_AND_NOTIFY במקום TEXT ב-MessageType.

דוגמה לבקשת JSON להוספת הודעה ושליחת התראה בכרטיס מועדון

  …
  "id": ISSUER_ID.CLASS_ID",
  "message":
    {
        "header":"My Class message header",
        "body": "My Class message body with a <a href="https://wallet.google">Hyperlink<\a>",
        "id": "message_id",
        "message_type": "TEXT_AND_NOTIFY"
    },
  …

דוגמה לבקשת JSON להוספת הודעה ושליחת התראה באובייקט של כרטיס

  …
  "id": OBJECT_ID",
  "classId": "ISSUER_ID.CLASS_ID",
  "message":
    {
        "header":"My Object message header",
        "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
        "id": "message_id",
        "message_type": "TEXT_AND_NOTIFY"
    },
  …

דוגמה לתגובה להוספת הודעה ושליחת התראה לגבי כרטיס מועדון

  // The updated resource
  …
    {
      "kind": "walletobjects#walletObjectMessage",
      "header": "My Object message header",
      "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
      "id": "message_id",
      "messageType": "textAndNotify"
    },
  …

טיפול בחריגים

כל ניסיון לשלוח התראה יותר מ-3 פעמים יחזיר תגובה מסוג QuotaExceededException . אם רוצים לעדכן את הכרטיס, צריך להשתמש ב-TEXT במקום ב-TEXT_AND_NOTIFY, כמו שמוסבר בשלבי השילוב.

עדכון השדה ושליחת הודעה

רקע

אחרי שמשתמש מוסיף כרטיס, יכול להיות שתרצו להפעיל התראה בדחיפה כשאתם מעדכנים שדות מסוימים. ההתראה תופיע במסך הנעילה של המשתמש ותיידע אותו שיש עדכון בכרטיס שלו. ההתראה הזו תופעל רק עבור קבוצת משנה ספציפית של שדות שמוגדרים בהמשך באמצעות שיטות ה-API‏ UPDATE ו-PATCH. אחרי שמבצעים קריאה ל-API כדי לעדכן את הכרטיס, מתרחשים הדברים הבאים:

1. התראה על עדכון הכרטיס מופיעה במסך הנעילה של המשתמש.
2. כשהמשתמש מקיש על ההתראה, נפתחת אפליקציית Google Wallet עם הכרטיס בחזית (כלומר, תצוגת הכרטיס), ובחלק העליון של המסך מופיע בועת הסבר עם הלחצן 'בדיקת עדכון'.
3. כשלוחצים על הכפתור, המשתמש מועבר למסך שבו הוא יכול לראות את השדות ששונו בעדכון.

היבטים שכדאי לקחת בחשבון כששולחים התראות על עדכון שדות

• כדי לקבל התראות פוש על עדכונים, המשתמשים צריכים להפעיל את ההתראות בכרטיסים שלהם.
• אתם יכולים לשלוח לכל היותר 3 עדכונים שגורמים לשליחת התראה בנייד בפרק זמן של 24 שעות. יכול להיות ש-Google תגביל את מכסת המסירה של הודעות ה-Push שלכם אם היא תסבור שאתם שולחים ספאם למשתמשים.
• ההתראה בדחיפה שמוצגת למשתמשים במסך הנעילה נשלטת על ידי Google Wallet.
• השדה notifyPreference הוא שדה זמני שקיים רק בבקשה הזו. בבקשות עתידיות שבהן תרצו להפעיל התראה, תצטרכו לאפס את השדה הזה בכיתה או בבקשת האובייקט.

שלבי ההטמעה

כדי להפעיל את ההתראות האלה, צריך להשתמש בקריאות ה-API הקיימות UPDATE או PATCHולציין את notifyPreference. כשמעדכנים שדה בכרטיס או באובייקט, אפשר להוסיף שדה חדש, notifyPreference, לבקשה של הכרטיס או האובייקט כדי להפעיל את ההתראה.

דוגמה לבקשת JSON לעדכון ולשליחת התראה בכיתה

    …
    "dateTime":
        {
            "kind": "walletobjects#eventDateTime",
            "doorsOpen": "2024-09-23T19:20:50.00"
        },
    "multipleDevicesAndHoldersAllowedStatus": "multipleHolders",
    "notifyPreference": "notifyOnUpdate",
    …
  

הגדרת notifyPreference לערך notifyOnUpdate תפעיל התראה, בתנאי שהשדה המעודכן נתמך כרגע.

שדות נתמכים

EventTicketClass

• eventName
• eventVenue.name
• eventvenue.address
• eventDateTime.doorsOpen
• eventDateTime.start

EventTicketObject

• eventSeat.seat
• eventSeat.row
• eventSeat.section
• eventSeat.gate

התראות בקרבת מקום

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

שלבי ההטמעה

אופן השימוש

כדי להשתמש בתכונה הזו, צריך להוסיף מיקומים לכיתות ולאובייקטים. אפשר להוסיף עד 10 מיקומים לכל כרטיס ועד 10 מיקומים לכל אובייקט. משתמשים ב-MerchantLocations בהגדרה של הכיתה או האובייקט. אפשר להוסיף את המיקומים האלה כשמשתמשים בשיטות insert, patch או update.

אחרי שמוסיפים מיקומים לכיתה או לאובייקט, Google שולחת התראות למשתמשים כשהם נמצאים בקרבת מקום. ‫Google מחליטה כמה קרוב המשתמש צריך להיות וכמה זמן הוא צריך להישאר באזור לפני שההתראה נשלחת. Google גם שולטת בטקסט של ההתראה.

דוגמה ל-LoyaltyClass עם ההגדרה MerchantLocations:

{
  "kind": "walletobjects#loyaltyClass",
  "programLogo": {
  "kind": "walletobjects#image",
  "sourceUri": {
    "uri":
    ...
  }
  },
  "localizedProgramName": {
    "kind": "walletobjects#localizedString",
    "defaultValue": {
      "kind": "walletobjects#translatedString",
      "language": "en",
      "value": "Program Name",
    }
  },
  "id": Id1234,
  "version": "1",
  "allowMultipleUsersPerObject": true,
  "reviewStatus": "underReview",
  "enableSmartTap": false,
  "localizedIssuerName": {
    "kind": "walletobjects#localizedString",
    "defaultValue": {
      "kind": "walletobjects#translatedString",
      "language": "en",
      "value": "Issuer Name"
    }
  },
  "multipleDevicesAndHoldersAllowedStatus": "multipleHolders",
  "merchantLocations": [
    {
      "latitude": 37.79020867928078,
      "longitude": -122.39004
    },
    {
      "latitude": 37.42587,
      "longitude": -122.08620
    },
  ]
}

התנהגות צפויה

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

התראות אוטומטיות שמופעלות על ידי Google Wallet

ההתראה הבאה

‫Google Wallet שולח התראה למשתמש שלוש שעות לפני האירוע. השעה של האירוע מוגדרת על ידי class.dateTime.start.

כדי לקבל את ההתראה הזו, המשתמש צריך להפעיל את ההתראות. כדי לבדוק את זה, הם יכולים לעבור אל הגדרות > התראות ולראות אם האפשרות עדכונים לגבי הכרטיסים שלך מופעלת.

ההתראה מופיעה באזור ההתראות ובמסך הנעילה, אם המשתמש הפעיל את ההתראות במסך הנעילה.

ההתראה היא בפורמט הבא, שלא ניתן לשינוי:

  class.eventName
  

אם הם יקישו על ההתראה ויבטלו את נעילת המכשיר, הכרטיס יופיע באפליקציית Google Wallet.

אם למשתמש יש כמה כרטיסים, מוצג רק הכרטיס שניתן להשתמש בו הכי בקרוב. אם הם הוסיפו כרטיסים מקובצים בהתאם להוראות במאמר קיבוץ של כמה כרטיסים לאירוע, בהתראה יוצג רק אחד מהכרטיסים בקבוצה. אבל כשהמשתמש מקיש על הכרטיס, הוא יכול להחליק ימינה ושמאלה כדי לראות את שאר הכרטיסים בקבוצה.

ההתראה מוצמדת ולא נסגרת אוטומטית אחרי שהמשתמש פותח אותה. ההודעה תיסגר אוטומטית 60 דקות אחרי class.dateTime.start.