הפעלת התראות

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

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

רקע

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

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

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

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

שלבי ההטמעה

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

דוגמה לבקשת 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"
    },
  …

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

  // 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 תפעיל התראה, בתנאי שהשדה המעודכן נתמך כרגע.

שדות נתמכים

FlightObject
  • boardingAndSeatingInfo.seatNumber
  • boardingAndSeatingInfo.seatAssignment

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

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

שלבי ההטמעה

אופן השימוש

כדי להשתמש בתכונה הזו, צריך להוסיף מיקומים לכיתות ולאובייקטים. אפשר להוסיף עד 10 מיקומים לכל כרטיס ועד 10 מיקומים לכל אובייקט. משתמשים ב-MerchantLocations בהגדרה של הכיתה או האובייקט. אפשר להוסיף את המיקומים האלה כשמשתמשים ב-methods 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.localScheduledDepartureDateTime.

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

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

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

  Boarding pass for your flight to class.destination.airportIataCode

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

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

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

התראות על עדכונים בטיסות

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

הטרמינל והשער של נקודת המוצא

אם משנים את class.origin.terminal או את class.origin.gate, ומתקיים התנאי הבא, נשלחת התראה על כך שהשדה השתנה.

  • נותרו פחות משלוש שעות עד class.localScheduledDepartureDateTime.

ההתראה תהיה בפורמט הבא: "חברת התעופה Sample Airlines עדכנה את השער שלך ל-A1". אי אפשר לשנות את הפורמט.

שעת העלייה למטוס ושעת היציאה

אם משנים את class.localBoardingDateTime או את class.localEstimatedOrActualDepartureDateTime, והתנאים שבהמשך מתקיימים, נשלחת התראה על כך שהשדה השתנה.

  • נותרו פחות מ-24 שעות עד class.localScheduledDepartureDateTime.
  • השעה הרלוונטית משתנה ב-10 דקות לפחות.

ההודעה תהיה בפורמט הבא: "_חברת התעופה 'דוגמה איירליינס' עדכנה את שעת העלייה למטוס שלך ל-6:00 בערב._" אי אפשר להתאים אישית את הפורמט או השפה.