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.

Cập nhật trường và thông báo

Thông tin khái quát

Sau khi người dùng thêm thẻ và vé, bạn có thể muốn kích hoạt thông báo đẩy khi cập nhật một số trường nhất định. Thông báo sẽ xuất hiện trên màn hình khoá của người dùng và cho họ biết rằng thẻ/vé của họ có thông tin cập nhật. Thông báo này sẽ chỉ kích hoạt cho một nhóm nhỏ các trường cụ thể được xác định bên dưới bằng cách sử dụng các phương thức API UPDATE và PATCH. Sau khi bạn thực hiện một lệnh gọi API để cập nhật thẻ và thẻ được cập nhật, những điều sau đây sẽ xảy ra:

  1. Thông báo đẩy sẽ được kích hoạt và hiển thị trên màn hình khoá của người dùng, thông báo cho họ về bản cập nhật 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 nội dung cập nhật".
  3. Khi nhấp vào nút này, người dùng sẽ được chuyển đến một màn hình nơi họ có thể xem các trường đã thay đổi do bản cập nhật.

Một số điều cần cân nhắc khi gửi thông báo cập nhật trườ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 thông tin cập nhật.
  • Bạn có thể gửi tối đa 3 bản cập nhật kích hoạt 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 nội dung 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.
  • Trường notifyPreference là một trường tạm thời chỉ tồn tại trong yêu cầu này. Đối với các yêu cầu trong tương lai khi muốn kích hoạt một thông báo, bạn sẽ phải đặt lại trường này trên yêu cầu về lớp hoặc đối tượng.

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

Để kích hoạt những thông báo này, bạn cần sử dụng các lệnh gọi UPDATE hoặc PATCH hiện có và chỉ định notifyPreference. Khi cập nhật một trường trên một lớp hoặc đối tượng, bạn có thể thêm một trường mới (notifyPreference) vào yêu cầu lớp hoặc đối tượng để kích hoạt thông báo.

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

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

Việc đặt notifyPreference thành notifyOnUpdate sẽ kích hoạt một thông báo, miễn là trường được cập nhật hiện được hỗ trợ.

Các trường được hỗ trợ

EventTicketClass
  • eventName
  • eventVenue.name
  • eventvenue.address
  • eventDateTime.doorsOpen
  • eventDateTime.start
EventTicketObject
  • eventSeat.seat
  • eventSeat.row
  • eventSeat.section
  • eventSeat.gate

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.

Thông báo tự động do Google Wallet kích hoạt

Thông báo sắp tới

Google Wallet sẽ gửi thông báo cho người dùng 3 giờ trước khi sự kiện diễn ra. Thời gian diễn ra sự kiện được xác định bằng class.dateTime.start.

Để nhận được thông báo này, người dùng phải bật thông báo. Để kiểm tra, họ có thể chuyển đến phần Cài đặt > Thông báo rồi xem chế độ Thông tin cập nhật về thẻ và vé của bạn có đang bật hay không.

Thông báo sẽ xuất hiện trong vùng thông báo và trên màn hình khoá nếu người dùng đã bật thông báo cho màn hình khoá.

Thông báo có định dạng sau đây và bạn không thể sửa đổi: 

  class.eventName

Nếu trẻ nhấn vào thông báo và mở khoá thiết bị, thẻ và vé của trẻ sẽ xuất hiện trong ứng dụng Google Wallet.

Nếu người dùng có nhiều thẻ và vé, thì chỉ thẻ và vé có thể sử dụng sớm nhất mới xuất hiện. Nếu họ đã thêm thẻ và vé theo nhóm theo hướng dẫn Nhóm nhiều vé sự kiện, thì thông báo chỉ hiển thị một trong các thẻ và vé trong nhóm. Tuy nhiên, khi nhấn vào thẻ này, người dùng có thể vuốt sang trái và phải để xem các thẻ khác trong nhóm đó.

Thông báo sẽ được ghim và không tự động đóng sau khi người dùng mở thông báo. Thông báo sẽ tự động đóng sau 60 phút kể từ thời điểm class.dateTime.start.