הפעלת התראות

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

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

רקע

אחרי שמשתמש מוסיף כרטיס, יכול להיות שתרצו לשלוח לו הודעה שקשורה לכרטיס ולוודא שהוא מקבל עליה הודעה. כשמשתמשים בבקשה של 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, כמו שמוסבר בשלבי השילוב.

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

התכונה הזו תציג התראה בדחיפה למשתמשים שהפעילו התראות והעניקו גישה מדויקת למיקום, שתמיד מופעלת, לאפליקציית 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. המשתמשים יכולים לסגור את ההתראה באמצעות החלקה. כשהמשתמש יעזוב את המיקום, ההתראה תיעלם.