Kích hoạt thông báo đẩy

Thông báo do đối tác kích hoạt

Thêm tin nhắn và thông báo

Thông tin khái quát

Sau khi người dùng thêm thẻ/vé, bạn có thể muốn gửi cho họ một thông báo liên quan đến thẻ/vé và đảm bảo họ nhận được thông báo về thẻ/vé đó. Khi sử dụng yêu cầu Add Message API với message_type bằng TEXT_AND_NOTIFY, những điều sau sẽ xảy ra:

  1. Một mục "Tin nhắn" sẽ được thêm vào "mặt sau của thẻ và vé" (còn gọi là Mẫu chi tiết) và một thông báo đẩy sẽ được gửi đến những người dùng đã lưu thẻ và vé.
  2. Sau khi người dùng nhấn vào thông báo, Google Wallet sẽ mở ở phía trước thẻ/vé (còn gọi là Chế độ xem thẻ) và người dùng sẽ thấy một chú thích ở đầu màn hình có nút "Xem tin nhắn".
  3. Khi nhấp vào chú thích, người dùng sẽ được đưa đến mặt sau của thẻ và các tin nhắn mới chưa đọc sẽ được làm nổi bật.

Một số điều cần cân nhắc khi gửi tin nhắn có thông báo cho người dùng

  • Người dùng phải bật thông báo cho thẻ và vé để nhận được thông báo đẩy liên quan đến tin nhắn.
  • Tin nhắn có thể chứa URI đến trang web hoặc ứng dụng của bạn. Siêu liên kết phải là một trang web hoặc ứng dụng liên quan đến thẻ và vé. Việc đưa người dùng đến các đường liên kết không liên quan đến thẻ/vé là hành vi vi phạm Chính sách sử dụng hợp lý.
  • Bạn có thể gửi tối đa 3 thông báo đẩy trong khoảng thời gian 24 giờ. Google có thể điều chỉnh hạn mức gửi thông báo đẩy của bạn nếu cho rằng bạn đang gửi thư rác cho người dùng.
  • Thông báo đẩy mà người dùng thấy trên màn hình khoá do Google Wallet kiểm soát.
  • Bạn có thể sử dụng các phương thức UPDATE hoặc PATCH để chỉnh sửa hoặc xoá dữ liệu thông báo bằng cách sử dụng điểm cuối đối tượng hoặc lớp thông thường.

Các bước tích hợp

Khi muốn thông báo cho người dùng về một thông báo mới của đơn vị phát hành được thêm bằng API AddMessage, bạn sẽ cần cập nhật AddMessageRequest để Message chứa văn bản mới của bạn có MessageType là TEXT_AND_NOTIFY thay vì TEXT.

Ví dụ về yêu cầu JSON để thêm thông báo và thông báo trong Lớp học về thẻ và vé

  …
  "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"
    },
  …

Ví dụ về yêu cầu JSON để thêm thông báo và thông báo trong Đối tượng thẻ và vé

  …
  "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"
    },
  …

Ví dụ về Phản hồi để thêm thông báo và thông báo cho một Lớp thẻ và vé

  // 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"
    },
  …

Xử lý ngoại lệ

Nếu bạn cố gắng thông báo quá 3 lần, hệ thống sẽ trả về phản hồi QuotaExceededException . Bạn có thể thiết lập mọi nội dung cập nhật khác cho thẻ và vé bằng cách sử dụng "TEXT" thay vì "TEXT_AND_NOTIFY" như đã thảo luận trong phần Các bước tích hợp.

Thông báo lân cận

Tính năng này sẽ gửi thông báo đẩy cho những người dùng đã bật thông báo và cấp quyền truy cập thông tin vị trí chính xác mọi lúc cho ứng dụng Google Wallet, nhắc họ rằng họ đã lưu một thẻ/vé liên quan đến vị trí hiện tại của họ.

Các bước tích hợp

Cách dùng

Để sử dụng tính năng này, bạn cần thêm vị trí vào các lớp và đối tượng. Bạn có thể thêm tối đa 10 vị trí cho mỗi lớp và 10 vị trí cho mỗi đối tượng. Sử dụng MerchantLocations trong định nghĩa lớp hoặc đối tượng của bạn. Bạn có thể thêm những vị trí này khi sử dụng các phương thức insert, patch hoặc update.

Sau khi bạn thêm vị trí vào một lớp hoặc đối tượng, Google sẽ gửi thông báo cho người dùng khi họ ở gần. Google quyết định khoảng cách mà người dùng cần ở gần và khoảng thời gian họ cần ở trong khu vực trước khi thông báo được gửi. Google cũng kiểm soát nội dung của thông báo.

Ví dụ về LoyaltyClass có MerchantLocations được đặt: 
{
  "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
    },
  ]
}

Hành vi dự kiến

Người dùng sẽ nhận được thông báo cố định về thẻ và vé khi họ ở một trong những MerchantLocation được chỉ định. Nếu họ nhấp vào thông báo, thẻ/vé sẽ mở trong Google Wallet. Người dùng có thể loại bỏ thông báo bằng cử chỉ vuốt. Khi người dùng rời khỏi vị trí đó, thông báo sẽ biến mất.