הפעלת התראות

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

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

רקע

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

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

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